デバイスリンクグループの作成

デバイスリンクグループには、デバイスインターフェイスがすでにフルでない限り、プロビジョニングされ登録された任意の仮想デバイスを含めることができます。デバイスリンクの詳細については、Network Edge ガイドを参照してください。APIを使用してデバイスリンクグループを作成するには、以下のものが必要です：

• ライセンスが登録されたプロビジョニング済みの仮想デバイスが2台以上。が必要です。 deviceUuidsとデバイスが配置されている metroCodes` です。

• ASNが設定されていない場合は、デバイスにASNを提供する必要があります。デバイスにすでに ASN が設定されている場合は、Get Virtual Device を呼び出して ASN を取得します。

• エクイニクスの請求アカウント番号。お客様のアカウントがアクティブまたは保留中である必要があります。作成するリンクごとにアカウント番号を提供する必要があります。

• グループのサブネットを選択します。グループに追加するデバイスの数を考慮してサブネットを選択する必要があります。リンキンググループを作成しようとする時点では、このフィールドは必須ではありませんが、機能的なリンキンググループを作成するには、このフィールドを提供する必要があります。

• メトロリンクスの情報（アカウント番号、スループット、メトロコード）をプロバイダに提供してください。 同じメトロ。

必須条件

Authenticate - OAuth2認証のためのユーザー認証情報、クライアントID、クライアントシークレットを送信します。OAuth APIを呼び出して認証情報を検証および認証する方法については、API Authenticationを参照してください。

ステップ 2: 仮想デバイスの取得

仮想デバイスの詳細を取得するには、Get Virtual Devices をコールします。応答には以下が含まれます：

• 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}]

2 つの異なるメトロにある 2 つのデバイス間にデバイスリンクグループを作成するための、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"  
    }  
  ]  
   
}'

メトロ内の 2 つのデバイス間にデバイスリンクを作成するための 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 Referenceを参照してください。

回答例

{  
    "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.

デバイスリンクの更新を使用してリンクグループを更新できます。

デバイスリンクの削除メソッドを使用してデバイスリンクグループを削除すると、グループは次の状態を経て遷移します：

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