メインコンテンツに移動

デバイスリンクグループを作成する

デバイスリンクグループには、プロビジョニングされて登録されている任意の仮想デバイスを含めることができる（デバイスインター フェイスがすでにいっぱいになっている場合を除く）。デバイスリンクの詳細については、『Network Edge』ガイドを参照。APIを使用してデバイスリンクグループを作成するには、

  • ライセンスが登録されているプロビジョニング済み仮想デバイスが少なくとも2つ必要なのは、 deviceUuidsおよびmetroCodesデバイスが配置されている場所。

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

  • Equinix請求アカウント番号。アカウントのステータスが「アクティブ」または「保留中」であること。作成するリンクごとにアカウント番号を指定する必要がある

  • グループのサブネットを選択する。グループに追加するデバイスの数を考慮してサブネットを選択する必要があるリンクグループを作成するときは必須フィールドではないが'機能リンクグループを作成するには必須フィールドである

  • metroLinksデバイスが 同じメトロだ

前提条件​

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

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

仮想デバイスの詳細を取得するには、Get Virtual Devices回答には次のものが含まれる。

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

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リファレンス』を参照。

回答例​

{  
    "uuid": "85ebe7b7-6182-45a1-be51-cb194f2f1e39"  
}

レスポンスのペイロード：

フィールドタイプ値の例説明
ユイド文字列b43ba509-a7d9-4334-8dee-dc4f29bf2e77デバイス・リンク・グループの一意のID。

デバイスステータス​

デバイスリンクグループが作成されると、デバイスリンク取得メソッドのresponse属性を使用して監視できるさまざまな状態が遷移する。statusデバイスの追加や削除などの他の操作を開始する前に、リンクグループをプロビジョニングする必要がある。

ステータス説明
PROVISIONINGデバイスリンクグループが起動しています。
FAILEDリンクの作成に失敗しました。
PROVISIONEDデバイスリンクグループの準備が整いました。
DEPROVISIONINGデバイスリンクグループはプロビジョニング解除中です。
DEPROVISIONEDデバイスリンクグループのプロビジョニングが解除されます。

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

デバイスリンクの削除方法を使用してデバイスリンクグループを削除すると、グループは次の状態に移行する。

ステータス説明
DEPROVISIONINGエクイニクスは、お客様からのデバイスリンクグループの削除リクエストを受け入れました。
DEPROVISIONEDデバイスリンクが削除されます。
このページは役に立ちましたか？