创建设备链接组

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

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

• 如果尚未设置ASN，则需要为设备提供ASN。如果设备已有ASN，请通过调用获取虚拟设备来检索ASN。

• Equinix帐单帐号。您的帐户必须处于"活动"或"待定"状态。您必须为创建的每个链接提供帐号。

• 为组选择子网。您必须选择一个子网，并记住要添加到组中的设备数量。这不是您尝试创建链接组时的必填字段；但是，您必须提供此字段才能具有功能链接组。

• 提供metroLinks信息(帐号，吞吐量，metroCode)，除非设备在中 同一地铁。

先决条件

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

步骤2：获取虚拟设备

要获取虚拟设备的详细信息，请调用获取虚拟设备。答复将包括：

• virtualDeviceUuids
• metroCodes,
• ASNs
• accountNumbers.

步骤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	设备链接组已取消配置。

您可以使用Update Device Link(更新设备链接)更新链接组。

如果使用"删除设备链接"方法删除设备链接组，组将通过以下状态过渡：

状态	描述
DEPROVISIONING	Equinix接受了客户删除设备链接组的请求。
DEPROVISIONED	设备链接已删除。