创建设备链接组
设备链接组可包括任何已配置和注册的虚拟设备,除非设备 接口已满。要了解有关设备链接的更多信息,请参阅Network Edge指南。要使用API创建设备链接组,您必须具备以下条件:
-
至少有两台已配置且具有注册许可证的虚拟设备。您必须拥有
deviceUuids``metroCodes设备所在位置。 -
如果尚未设置ASN,则需要为设备提供ASN。如果设备已有ASN,请致电获取虚拟设备来检索ASN。
-
Equinix开票账号。您的账户必须处于“活跃”或“待定”状态。您必须为创建的每个链接提供账号。
-
为组选择子网。选择子网时,必须考虑要添加到组中的设备数量。当您尝试创建链接组时,此字段并非必填字段;但是,您必须提供此字段才能具有功能链接组。
-
提供
metroLinks信息(账号,吞吐量,metroCode),除非设备在中 同一地铁。
先决条件
验证-提交您的用户凭据,客户端ID和客户端机密以进行OAuth2验证。有关如何致电OAuth API以验证和验证您的凭据的说明,请参阅API验证。
步骤2:获取虚拟设备
如需获取虚拟设备的详细信息,请致电获取虚拟设备。回应将包括:
virtualDeviceUuidsmetroCodes,ASNsaccountNumbers.
步骤3:创建设备链接
POST /ne/v1/links | |
|---|---|
| 方法 | POST |
| URL 或端点 | /ne/v1/links |
| 标题 | Authorization,Content-Type |
| 路径参数 | 不适用 |
| 身体参数 | groupName,subnet,redundancyType linkDevices[deviceUuid, asn, interfaceId],,metroLinks[ {accountNumber, throughput, throughputUnit, metroCode}] |
用于在两个不同都会区的两个设备之间创建设备链接组的示例 curl 请求。
curl -X
POST "https://api.equinix.com/ne/v1/links"
-H "content-type: application/json"
-H "Authorization: Bearer <token>"
-d '{
"groupName": "test-link",
"subnet": "10.0.0.0/27",
"redundancyType": "SECONDARY",
"linkDevices": [
{
"deviceUuid": "d186dc1a-29e7-4829-bb5e-50fa57aca923",
"asn": 65414,
"interfaceId": 6
},
{
"deviceUuid": "ea128600-1875-4f7a-80e9-307a5bbeac51",
"asn": 100,
"interfaceId": 6
}
],
"metroLinks": [
{
"accountNumber": "23945678",
"metroCode": "SV",
"throughput": 1000,
"throughputUnit": "Mbps"
},
{
"accountNumber": "2395123",
"metroCode": "SY",
"throughput": 1000,
"throughputUnit": "Mbps"
}
]
}'
用于在都会区的两个设备之间创建设备链接的 curl 请求示例。
curl -X
POST "https://api.equinix.com/ne/v1/links"
-H "content-type: application/json"
-H "Authorization: Bearer <token>"
-d '{
"groupName": "test-link",
"subnet": "10.0.0.0/27",
"redundancyType": "SECONDARY",
"linkDevices": [
{
"deviceUuid": "d186dc1a-29e7-4829-bb5e-50fa57aca923",
"asn": 65414,
"interfaceId": 6
},
{
"deviceUuid": "ea128600-1875-4f7a-80e9-307a5bbeac51",
"asn": 100,
"interfaceId": 6
}
],
"metroLinks": []
}'
参数和选项的完整列表,请参见API参考手册。
示例响应
{
"uuid": "85ebe7b7-6182-45a1-be51-cb194f2f1e39"
}
响应负载:
| 字段 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| 唯一标识符 | 字符串 | b43ba509-a7d9-4334-8dee-dc4f29bf2e77 | 设备链接组的唯一ID。 |
设备状态
创建设备链接组时,它会通过各种状态转换,这些状态可使用获取设备链接方法的Response属性进行监控status。您必须先配置链接组,然后才能开始执行其他操作(如添加或移除设备)。
| 状态 | 描述 |
|---|---|
PROVISIONING | 设备链接组正在启动。 |
FAILED | 链接创建失败。 |
PROVISIONED | 设备链接组已准备就绪。 |
DEPROVISIONING | 正在取消配置设备链接组。 |
DEPROVISIONED | 设备链接组已取消配置。 |
您可以使用更新设备链接来更新链接组。
如果您使用删除设备链接方法删除设备链接组,该组将过渡到以下状态:
| 状态 | 描述 |
|---|---|
DEPROVISIONING | Equinix接受了客户删除设备链接组的请求。 |
DEPROVISIONED | 设备链接已删除。 |