# クラスタデバイスの起動 ![](https://docs.equinix.com/ja/assets/images/LaunchClusterDevice-8cbbed9f9cbc2854ae5a7b777f1f7935.png) ## 前提条件[​](#前提条件 "への直接リンク前提条件") 1. 認証-ユーザー認証情報、クライアントID、クライアントシークレットを送信してOauth2認証を行います。認証情報を検証および認証するためにOAuth APIを呼び出す方法については、「[API認証」を](https://docs.equinix.com/ja/equinix-api/api-authentication.md)参照してください。 2. [Get Device Typesを](https://docs.equinix.com/ja/api-catalog/network-edgev1/availability-and-metros/getvirtualdevicetypes)呼び出して、NEプラットフォームで起動するクラスタデバイス(ルータやファイアウォールなど)を検索します。仮想デバイスが利用可能な都市圏の地域、デバイスのベンダー、利用可能なコア数、ソフトウェアパッケージとそのバージョンについて学びます。`deviceTypeCode`、`metroCode`、`core`、、、を選択します。`packageCode``version` 3. Get Allowed Interfacesを呼び出して、[](https://docs.equinix.com/ja/api-catalog/network-edgev1/availability-and-metros/getallowedinterfaces)選択したコアで許可されているインターフェースの数を確認します。sshInterfaceIdとして、使用可能な任意のデバイスインターフェースを選択できます。 そうでない場合、Equinixは最初に使用可能なインターフェースを選択します。 4. [Get Accounts{metro}](https://docs.equinix.com/ja/api-catalog/network-edgev1/availability-and-metros/getaccountswithstatus)に電話して、`acountReferenceId`仮想デバイスを使用する都市圏の(または)とステータスを確認します。`account number`請求上の理由から、仮想デバイスを使用する都市圏のアカウントが、アクティブまたは保留中の状態である必要があります。[アカウントをお持ちで](https://docs.equinix.com/ja/network-edge/billing/ne-billing-account-creation.md)ない場合は、[アカウントを](https://docs.equinix.com/ja/network-edge/billing/ne-billing-account-creation.md)作成してください。 **リセラーが**お客様用のデバイスを作成しようとしている場合は、お客様のアカウントと(リセラーの)アカウントの両方が「アクティブ」または「保留中」のステータスになっていることを確認する必要があります。アカウントには請求が発生しますが、お客様用のデバイスを作成するには、お客様のアカウント番号をPOST APIに送信する必要があります。 ## ライセンスオプション[​](#ライセンスオプション "への直接リンクライセンスオプション") 現在のところ、クラスタにはBYOL(ライセンス持ち込み)オプションしか提供していません。 * **ジュニパークラスター**-ジュニパークラスターのライセンスファイルをアップロードする必要はありません。ただし、2つのライセンスファイルをアップロードできます。2つのライセンスファイルをアップロードするには、Post License [Fileを](https://docs.equinix.com/ja/api-catalog/network-edgev1/availability-and-metros/uploadlicense)2回呼び出します。クラスタの作成に使用できる応答にライセンスファイルIDSが表示されます。 * **Palo Alto Cluster** -ベンダから2つのライセンストークンをアップロードする必要があります。ライセンストークンは同じでも異なる場合もあります。 * **Fortinetクラスター**-トークンやライセンスを入力する必要はありません。ライセンスファイルをアップロードする場合は、2つの異なるライセンスファイルをアップロードする必要があります。2つのライセンスファイルをアップロードするには、Post License [Fileを](https://docs.equinix.com/ja/api-catalog/network-edgev1/availability-and-metros/uploadlicense)2回呼び出します。クラスタの作成に使用できる応答にライセンスファイルIDSが表示されます。 * **アリスタ・ヴェロクラウドSD - WANエッジクラスター**ライセンスファイルやトークンをアップロードする必要はありません。ただし、アクティベーションキーを提供する必要があります。デバイスの作成後にライセンスの登録に失敗した場合は、デバイスにログインしてライセンスをアップロードする必要があります。次に、ステータス値で[仮想デバイスの更新を](https://docs.equinix.com/ja/api-catalog/network-edgev1/virtual-device/updatevirtualdevicebyuuid)呼び出します。`PROVISIONED` ## クラスターデバイスの作成[​](#クラスターデバイスの作成 "への直接リンククラスターデバイスの作成") | | POST/NE/v1/デバイス | | ----------------------- | --------------------------------------- | | 方法 | `POST` | | URLまたはエンドポイント | `/ne/v1/devices` | | ヘッダー | `Authorization`トークン、`Content-Type` | | クエリーパラメータ | `draft`、`draftUuid` | 注:仮想デバイスを作成することで、オーダー条件に同意したものとみなされます。[オーダー条件の取得に](https://docs.equinix.com/ja/api-catalog/network-edgev1/availability-and-metros/getorderterms)電話して、詳細を確認してください。 デバイスの下書きを保存するには、`deviceTypeCode`、`accountNumber`または`accountReferenceId`、 およびを指定する必要があります。`metroCode` vSRX クラスタを作成するためのサンプル curl リクエスト: ``` curl -X POST "https://api.equinix.com/ne/v1/devices?draft=false" -H "content-type: application/json" -H "Authorization: Bearer " -d ' {     "deviceTypeCode": "VSRX",     "clusterDetails": {         "clusterName": "sroy-juniper",         "clusterNodeDetails": {             "node0": {                 "vendorConfig": {                     "hostname": "sr012"                 },                 "licenseFileId": "1274fe9f-511c-436f-bc0c-14c876ec55da"             },             "node1": {                 "vendorConfig": {                     "hostname": "sr123"                 },                 "licenseFileId": "65a9be3f-57fb-4c4d-a15b-40950951bc13"             }         }     },     "metroCode": "SV",     "termLength": "1",     "licenseMode": "BYOL",     "packageCode": "STD",     "virtualDeviceName": "Test-device-001-SROY",     "notifications": [         "test@equinix.com"     ],     "hostname": "sr012",     "aclDetails": [        {          "uuid": "fb2e69bb-cbd7-40c4-bc01-8bcc5fa741c2",          "interfaceType": "WAN"        }     ],     "accountNumber": "201148",     "version": "18.4R3-S2",     "interfaceCount": 8,     "agreeOrderTerms": true,     "deviceManagementType": "SELF-CONFIGURED",     "core": 5,     "userPublicKey": {         "username": "sroy",         "keyName": "keyLlhzL"     },     "additionalBandwidth": "100" } ' ``` Arista Velocloud SDWAN クラスタを作成するためのサンプル curl リクエスト: ``` curl -X POST "https://api.equinix.com/ne/v1/devices?draft=false" -H "content-type: application/json" -H "Authorization: Bearer " -d ' {     "metroCode": "SY",     "deviceTypeCode": "VELOCLOUD-SDWAN",     "termLength": "1",     "clusterDetails": {         "clusterName": "sroy-velo-cluster",         "vendorConfig": {             "node0": {                 "activationKey": "GJUK-JM2X-59BJ-SAMPLE",                 "controllerFqdn": "demo.velocloud.net",                 "rootPassword": "TestPassword!"             },             "node1": {                 "rootPassword": "TestPassword#"             }         }     },     "licenseMode": "BYOL",     "packageCode": "VeloCloud-4",     "virtualDeviceName": "velo-cluster",     "notifications": [         "test@equinix.com"     ],     "aclDetails": [        {          "uuid": "fb2e69bb-cbd7-40c4-bc01-8bcc5fa741c2",          "interfaceType": "WAN"        }     ],     "accountNumber": "2393479",     "version": "3.4.2",     "interfaceCount": 8,     "deviceManagementType": "SELF-CONFIGURED",     "agreeOrderTerms": true,     "core": 4,     "userPublicKey": {         "username": "sroy",         "keyName": "key7YFfL"     },     "additionalBandwidth": "200" } ' ``` Internet AccessのないPANWクラスタを作成するためのcurlリクエストのサンプル: ``` curl -X POST "https://api.equinix.com/ne/v1/devices?draft=false" -H "content-type: application/json" -H "Authorization: Bearer " -d ' {     "deviceTypeCode": "PA-VM",     "clusterDetails": {         "clusterName": "NEAut-",         "clusterNodeDetails": {             "node0": {             "vendorConfig": {                 "hostname": "PANCluster"             }             },             "node1": {             "vendorConfig": {                 "hostname": "PANCluster"             }             }         }     },     "metroCode": "#(supportedMetro)",     "zoneCode": "Zone1",     "termLength": "1",     "licenseMode": "BYOL",     "packageCode": "VM100",     "virtualDeviceName": "NEAut-",     "notifications": [         "t@t.com"     ],     "version": "10.1.3",     "interfaceCount": 10,     "deviceManagementType": "SELF-CONFIGURED",     "core": 2,     "connectivity": "PRIVATE" } ' ``` パラメータとオプションの完全なリストについては、『[APIリファレンス』を](https://docs.equinix.com/ja/api-catalog/network-edgev1/virtual-device/createvirtualdevice)参照してください。 ## 回答例[​](#回答例 "への直接リンク回答例") 回答例202:リクエストが承認されました。 ``` {     "uuid": "34b7838c-ec82-4166-ac19-efa03b4e34fe",     "deviceIds": {         "node0": "34b7838c-ec82-4166-ac19-efa03b4e34fe",         "node1": "f27f1475-3c7f-447f-b0db-e3bb3af3de16"     },     "clusterId": "27eea9aa-327b-431b-bf62-3cee4d880f2e" } ``` ## デバイスのステータス[​](#デバイスのステータス "への直接リンクデバイスのステータス") クラスタが作成されると、セルフ設定クラスタは Equinixインフラストラクチャ内のさまざまな状態を経て移行します。これらの状態は、[Get Virtual Device {uuid}](https://docs.equinix.com/ja/api-catalog/network-edgev1/virtual-device/getvirtualdevicebyuuid)メソッドのresponse属性を使用して監視できます。`status`このクラスターを使用してクラウドサービスプロバイダに接続する前に、クラスターをプロビジョニングし、ライセンスを登録する必要があります。 | **仮想デバイスの状態** | **説明** | | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `INITIALIZING` | エクイニクスは現在、リソースの予約とデバイスの作成を進めています。 | | `PENDING_ACCOUNT` | お客様のアカウントが承認されていません。アカウントが承認されると、デバイスの作成は続行されます。 | | `PROVISIONING` | デバイスが起動している。 | | `PENDING_ORDER` | このステータスは、SiebelからNEに送信されるオーダーにのみ適用されます。お客様はNetwork Edgeポータルにログインし、保留中のオーダーを送信する必要があります。 | | `PENDING_SIGNATURE` | お客様は、Network Edge の利用規約にまだ同意していません。 | | `CANCEL_ORDER` | シーベルからNEへの注文はキャンセルされる。このステータスは、SiebelからNetwork Edgeに送信されるオーダーにのみ適用されます。 | | `WAITING_FOR_PRIMARY` | セカンダリデバイスは準備ができていますが、プライマリデバイスは準備ができていません。この状態は、冗長デバイスをリクエストした場合に表示されることがあります。 | | `WAITING_FOR_SECONDARY` | プライマリデバイスは準備ができていますが、セカンダリデバイスは準備ができていません。この状態は、冗長デバイスをリクエストした場合に表示されることがあります。 | | `FAILED` | デバイスの作成に失敗しました。 | | `PROVISIONED` | デバイスは準備できている。 | | `DEPROVISIONING` | エクイニクスはお客様からの仮想デバイスの削除要求を受け入れました。 | | `DEPROVISIONED` | デバイスはプロビジョニング解除/削除される。 | ![](https://docs.equinix.com/ja/assets/images/LaunchClusterDeviceStatus-c01747a2fac38f81e3e43d32810dbc59.png) エンドユーザーが[仮想デバイスの削除](https://docs.equinix.com/ja/api-catalog/network-edgev1/virtual-device/deletevirtualdevicebyuuid)APIを使用してデバイスを削除すると、デバイスはEquinix インフラストラクチャ内で次の状態に移行します。 | ステータス | 説明 | | ---------------- | ------------------------------------------------------------------ | | `DEPROVISIONING` | エクイニクスはお客様からの仮想デバイスの削除要求を受け入れました。 | | `DEPROVISIONED` | デバイスはプロビジョニング解除/削除される。 |