デバイスリンクグループを作成する
デバイスリンクグループには、プロビジョニングされて登録されている仮想デバイスを含めることができます。ただし、デバイス インターフェイスがすでにいっぱいになっている場合は除きます。デバイスリンクの詳細については、Network Edgeガイドを参照してください。APIを使用してデバイスリンクグループを作成するには、以下が必要です。
-
ライセンスが登録されている、プロビジョニングされた仮想デバイスが少なくとも2つ以上あります。必要なのは、
deviceUuidsおよびmetroCodesデバイスが配置されている場所。 -
ASNが設定されていない場合は、デバイスのASNを提供する必要があります。仮想デバイスに既にASNがある場合は、Get Virtual Deviceを呼び出してASNを取得します。
-
Equinix請求アカウント番号。アカウントのステータスは「アクティブ」または「保留中」である必要があります。作成するすべてのリンクにアカウント番号を入力する必要があります。
-
グループのサブネットを選択します。グループに追加するデバイスの数を考慮してサブネットを選択する必要があります。これは、リンクグループを作成しようとする時点では必須フィールドではありませんが、機能リンクグループを作成するには、このフィールドを指定する必要があります。
-
metroLinksデバイスが 同じ都市圏です。
前提条件
認証-ユーザー認証情報、クライアント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}] |
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 | デバイスリンクが削除されます。 |