メインコンテンツにスキップ

クラスタデバイスの起動

前提条件​

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

  2. Get Device Typesを呼び出して、NEプラットフォームで起動するクラスタデバイス（ルータやファイアウォールなど）を検索します。仮想デバイスが利用可能な都市圏の地域、デバイスのベンダー、利用可能なコア数、ソフトウェアパッケージとそのバージョンについて学びます。deviceTypeCode、metroCode、core、、、を選択します。packageCode``version

  3. Get Allowed Interfacesを呼び出して、選択したコアで許可されているインターフェースの数を確認します。sshInterfaceIdとして、使用可能な任意のデバイスインターフェースを選択できます。 そうでない場合、Equinixは最初に使用可能なインターフェースを選択します。

  4. Get Accounts{metro}に電話して、acountReferenceId仮想デバイスを使用する都市圏の（または）とステータスを確認します。account number請求上の理由から、仮想デバイスを使用する都市圏のアカウントが、アクティブまたは保留中の状態である必要があります。アカウントをお持ちでない場合は、アカウントを作成してください。

    リセラーがお客様用のデバイスを作成しようとしている場合は、お客様のアカウントと（リセラーの）アカウントの両方が「アクティブ」または「保留中」のステータスになっていることを確認する必要があります。アカウントには請求が発生しますが、お客様用のデバイスを作成するには、お客様のアカウント番号をPOST APIに送信する必要があります。

ライセンスオプション​

現在のところ、クラスタにはBYOL（ライセンス持ち込み）オプションしか提供していません。

  • ジュニパークラスター-ジュニパークラスターのライセンスファイルをアップロードする必要はありません。ただし、2つのライセンスファイルをアップロードできます。2つのライセンスファイルをアップロードするには、Post License Fileを2回呼び出します。クラスタの作成に使用できる応答にライセンスファイルIDSが表示されます。

  • Palo Alto Cluster -ベンダから2つのライセンストークンをアップロードする必要があります。ライセンストークンは同じでも異なる場合もあります。

  • Fortinetクラスター-トークンやライセンスを入力する必要はありません。ライセンスファイルをアップロードする場合は、2つの異なるライセンスファイルをアップロードする必要があります。2つのライセンスファイルをアップロードするには、Post License Fileを2回呼び出します。クラスタの作成に使用できる応答にライセンスファイルIDSが表示されます。

  • アリスタ・ヴェロクラウドSD - WANエッジクラスターライセンスファイルやトークンをアップロードする必要はありません。ただし、アクティベーションキーを提供する必要があります。デバイスの作成後にライセンスの登録に失敗した場合は、デバイスにログインしてライセンスをアップロードする必要があります。次に、ステータス値で仮想デバイスの更新を呼び出します。PROVISIONED

クラスターデバイスの作成​

POST/NE/v1/デバイス
方法POST
URLまたはエンドポイント/ne/v1/devices
ヘッダーAuthorizationトークン、Content-Type
クエリーパラメータdraft、draftUuid

注：仮想デバイスを作成することで、オーダー条件に同意したものとみなされます。オーダー条件の取得に電話して、詳細を確認してください。

デバイスの下書きを保存するには、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 <token>"
-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 <token>"
-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 <token>"
-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リファレンス』を参照してください。

回答例​

回答例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}メソッドの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デバイスはプロビジョニング解除/削除される。

エンドユーザーが仮想デバイスの削除APIを使用してデバイスを削除すると、デバイスはEquinix インフラストラクチャ内で次の状態に移行します。

ステータス説明
DEPROVISIONINGエクイニクスはお客様からの仮想デバイスの削除要求を受け入れました。
DEPROVISIONEDデバイスはプロビジョニング解除/削除される。
このページは役に立ちましたか？