创建设备链接组

设备链接组可以包含任何已配置和注册的虚拟设备，除非该设备 接口已满。要了解有关设备链路的更多信息，请参阅网络边缘指南。要使用 API 创建设备链路组，您必须具备以下条件：

• 至少两个已配置并注册许可证的虚拟设备。您必须拥有 deviceUuids 和设备所在位置的 metroCodes。

• 如果尚未设置 ASN，则需要为设备提供 ASN。如果设备已有 ASN，则可通过调用 Get Virtual Device 来检索 ASN。

• Equinix账单账号。您的账户必须处于“有效”或“待处理”状态。您必须为创建的每个链接提供一个账号。

• 为组选择一个子网。选择子网时，必须考虑到要添加到组中的设备数量。创建链接组时，此字段并非必填字段；但是，您必须提供此字段才能使链接组正常运行。

• 除非设备位于……，否则请提供“metroLinks”信息（账号、吞吐量、metroCode）。 同一地铁。

先决条件

身份验证 - 请提交您的用户凭据、客户端 ID 和客户端密钥以进行 OAuth2 身份验证。有关如何调用 OAuth API 来验证和确认您的凭据的说明，请参阅API 身份验证。

第 2 步：获取虚拟设备

要获取虚拟设备的详细信息，请调用获取虚拟设备。响应将包含：

• virtualDeviceUuids
• metroCodes,
• ASNs
• accountNumbers.

步骤3：创建设备链接

	POST /ne/v1/links
Method	POST
URL or End Point	/ne/v1/links
Headers	Authorization, Content-Type
Path Parameters	NA
Body Parameters	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"  
}

响应负载：

Field	Type	Example Values	Description
uuid	string	b43ba509-a7d9-4334-8dee-dc4f29bf2e77	The unique ID of the device link group.

设备状态

创建设备链路组时，它会经历各种状态转换，您可以使用 Get Device Link 方法的 status 响应属性来监控这些状态转换。您必须先配置链路组，然后才能执行其他操作，例如添加或删除设备。

Status	Description
PROVISIONING	The device link group is booting.
FAILED	Link creation failed.
PROVISIONED	The device link group is ready.
DEPROVISIONING	The device link group is being de-provisioned.
DEPROVISIONED	The device link group is de-provisioned.

您可以使用 更新设备链接 更新链接组。

如果使用 Delete Device Link 方法删除设备链接组，则该组会经历以下状态转换：

Status	Description
DEPROVISIONING	Equinix accepted the customer's request to delete a device link group.
DEPROVISIONED	The device link is deleted.