SDWANデバイスの作成
前提条件
認証-ユーザー認証情報、クライアントID、クライアントシークレットを送信してOauth2認証を行います。認証情報を検証および認証するためにOAuth APIを呼び出す方法については、「API認証」を参照してください。
ステップ2: デバイスタイプとアカウントを取得
Get Device Types
APIを呼び出して、NEプラットフォームで起動できるWANデバイスを検索します。これらのデバイスが利用可能な都市圏()、利用可能なコア数()、coreソフトウェアパッケージ(packageCodeおよび)、versionおよび可能なすべてのライセンスとスループットオプションについて学びます。metroCode
欲しいデバイスがすでに決まっている場合は、このステップを飛ばしても構いません。
Get Accounts{metro} APIaccountReferenceIdに電話して、仮想デバイスを使用する都市圏のアカウント番号（または）とステータスを確認してください。請求上の理由から、仮想デバイスを使用する都市圏のアカウントが、アクティブまたは保留中の状態である必要があります。アカウントの作成方法については、「請求アカウント管理」を参照してください。
リセラーがお客様用のデバイスを作成しようとしている場合は、お客様のアカウントと（リセラーの）アカウントの両方が「アクティブ」または「保留中」のステータスになっていることを確認する必要があります。お客様のアカウントは請求されますが、お客様用のSD WANデバイスを作成するには、お客様のアカウント番号をPOST APIに送信する必要があります。
アカウント番号（またはaccountReferenceId）と
ステータスがすでにわかっている場合は、この手順をスキップできます。
ステップ3: ライセンスの設定
今のところ、BYOL (Bring Your Own License) が SD-WAN デバイスで利用可能な唯一のライセンスオプションであり、BYOL へのプロセスはベンダーごとに異なります。
Cisco SD WANデバイスのライセンスを設定するには、次の手順を実行します。
- Cisco vManageプラットフォームでブートストラップファイルを生成します。
- C8000V-SDWANを作成するには、Upload Fileを呼び出してCiscoブートストラップファイルをアップロードします。回答には「」が表示されます。
fileUuidペイロード作成のフィールドに値を入力して、day0TextFileId仮想C8000V-SDWANデバイスを作成できます。
Prismaデバイスのライセンスを設定するには、次の手順を実行します。
- Prisma Orchestratorでライセンスキー(IONキー)とライセンスシークレット(シークレットキー)を生成します。
- Equinix CREATE DEVICE APIを呼び出してPrisma WANデバイスを作成する際、ライセンスキー(IONキー)とシークレット(シークレットキー)を入力してください。
デバイス作成時にFortinetデバイスにはライセンスは必須ではありません。トークンがある場合は、
フィールドに入力します。licenseTokenFortinet SD WANデバイスのライセンスファイルを設定するには、
次の手順を実行します。
- Fortinetポータルでライセンスファイルを生成します。
- ライセンスファイルの発行後を呼び出して、Equinixポータルにライセンスファイルをアップロードします。仮想SD WANデバイスの作成に使用できるを入手します。
fileId
Versaデバイスを構成するには、VersaディレクタでVNFデバイステンプレートを作成し、シリアル 番号をメモします。
Network Edge プラットフォームで Aruba デバイスを設定するためにライセンスファイルは必要ありません。
Juniper WANのライセンスをアップロードするには、次の手順に従います。
- Juniper ポータルでライセンスファイルを生成します。
- ライセンスファイルの発行後を呼び出して、Equinixポータルにライセンスファイルをアップロードします。Juniper WANデバイスの作成に使用できるを入手します。
fileId
ステップ4: ベンダ固有のパラメータ
各SD WANベンダは、 ステップ5のPOST API定義の一部としてリストされている共通パラメータ以外の独自のパラメータセットを必要とします。 ステップで新しいデバイスを作成する際に、ベンダーのパラメータを確認し、vendorConfig{}オブジェクトにパラメータを渡してください 5.
Cisco SD - WAN
| Cisco vendorConfig{}のパラメータ | 必須 | タイプ | 例 | 指定可能な値 | 説明 |
|---|---|---|---|---|---|
| サイトID | はい | 文字列 | 12345 | サイトID。Cisco WANデバイスでは必須です。サイトIDは、支社やキャンパスなど、ヴィプテラのオーバーレイネットワーク内の特定の物理的な場所です。 | |
| システムIPアドレス | はい | 文字列 | 192.168.1.5 | システムIPアドレス。Cisco WANデバイスでは必須です。各vEdgeルーターおよびvSmartコントローラーには、システムIPアドレスが割り当てられます。IPv4アドレスと同様に、10進4部ドット表記である必要があります。 | |
| ホスト名 | 条件付 | 文字列 | SR-01 | ホスト名。C8000V-SDWANでは必須です。 |
パロアルトネットワークスPRISMA-SDWAN
| Palo Alto Networks vendorConfig{}パラメータ | 必須 | タイプ | 例 | 指定可能な値 | 説明 |
|---|---|---|---|---|---|
| licenseKey（イオンキー） | はい | 文字列 | <license_key> | ライセンスキー(IONキー)。パロアルトネットワークスデバイスでは必須です。 | |
| licenseSecret（シークレットキー） | はい | 文字列 | ec68e425-f973-452e-a866-76be5844d0ba | ライセンスシークレット(シークレットキー)。パロアルトネットワークスデバイスでは必須です。 |
Versa VERSA_SDWAN
| Versa vendorConfig{}パラメータ | 必須 | タイプ | 例 | 指定可能な値 | 説明 |
|---|---|---|---|---|---|
| ローカルID | はい | 文字列 | SDWAN-Branch@Versa.com | 支店のEメールアドレス | |
| リモートID | はい | 文字列 | Controller-01-staging@Versa.com | コントローラー側のメールアドレス。 | |
| シリアル番号 | はい | 文字列 | 12345 | お客様は、Versaダイレクタでデバイステンプレートを設定する際にシリアル番号を選択します。Versaディレクタのポストステージングデバイスのシリアル番号は、この入力と一致する必要があります。 | |
| コントローラ1 | はい | 文字列 | 54.219.248.29 | SD-WANコントローラ1のIPアドレス。 | |
| コントローラ2 | はい | 文字列 | 54.177.220.115 | SD-WANコントローラーのIPアドレス2。 |
FortiGate FG-SDWAN *
| FortiGate vendorConfig{}パラメータ | 必須 | タイプ | 例 | 指定可能な値 | 説明 |
|---|---|---|---|---|---|
| 管理パスワード | はい | 文字列 | パスワード9 | パスワード。このパスワードは6文字以上で、大文字と数字を含める必要があります。 | |
| コントローラ1 | はい | 文字列 | 1.1.1.1 | システムIPアドレス。FortiGate SD - WANデバイスでは必須です。 |
*FortiGate SD-WANデバイスにもホスト名が必要ですが、これはvendorConfigオブジェクトの一部ではなく、deviceTypeCode、accountNumberなどのパラメータとして渡されます。
Arista VELOCLOUD-SDWAN
| Arista vendorConfig{}パラメータ | 必須 | タイプ | 例 | 指定可能な値 | 説明 |
|---|---|---|---|---|---|
| アクティベーションキー | はい | 文字列 | GJUK-JM2X-59BJ-Sample | アクティベーションキー。VeloCloudオーケストレーションポータルで利用できます。 | |
| コントローラFQDN | はい | 文字列 | demo.velocloud.net | VeloCloud SD - WANゲートウェイデバイスのACLのリストで、コントローラFqdnに関連付けられたIPアドレスを入力してください。 | |
| ルートパスワード | いいえ | 文字列 | テストパスワード！ | デバイスの CLI パスワード。 |
HPEアルバEDGECONNECT-SDWAN
| Aruba vendorConfig{}パラメータ | 必須 | タイプ | 例 | 指定可能な値 | 説明 |
|---|---|---|---|---|---|
| アカウント名 | はい | 文字列 | アカウント名 | 口座の名前。 | |
| ホスト名 | はい | 文字列 | マイホスト名1 | 識別用のホスト名。これはFQDNとして含まれ、承認されたソースからデバイスに到達できるようにします。使用できるのは、a～z、A～Z、0～9、ハイフン（-）のみです。文字から始まり文字または数字で終わる必要があります。長さは2～30文字です。例外- FTDv 2-14、Aruba 2-24。 | |
| アカウントキー | はい | 文字列 | アカウントキー | アカウントの鍵 | |
| アプライアンスタグ | いいえ | 文字列 | アプライアンスタグ | 家電製品のタグ。 |
ステップ5：SD WANデバイスの作成
| POST/NE/v1/デバイス | |
|---|---|
| 方法 | POST |
| URLまたはエンドポイント | /ne/v1/devices |
| ヘッダー | Authorization、Content-Type |
| クエリーパラメータ | draft、draftUuid |
プライマリとセカンダリの2つのデバイスを持つ冗長SD-WANデバイスを作成したい場合は、次のようにします：
-
オプションのセカンダリオブジェクトのパラメータを設定します。
vendorConfig- リクエストボディのペイロードにCisco SD-WANの2つのlicenseFileIdsをプロバイダする。
- CloudGenixの冗長化には、2つのライセンスキー（IONキー）とライセンスシークレット（シークレットキー）が必要です。 リクエストボディのペイロードのデバイス
- 冗長構成のアリスタ・ヴェロクラウドWANエッジデバイスに2つのアクティベーションキーを提供します。
-
セカンダリデバイスでは、ACLテンプレート、アカウント番号、additionalBandwidth、metroCode、および通知が異なる場合があります。
-
リセラーがお客様用に冗長デバイスを作成しようとしている場合は、プライマリとセカンダリの両方の都市圏が同じ国にあることを確認してください。また、プライマリアカウント番号とセカンダリアカウント番号は同じである必要があります。リセラーのアカウントには請求が発生しますが、このAPIはお客様のアカウント番号を承認して、お客様用のデバイスを作成します。各顧客はリセラーの請求アカウントに関連付けられているため、上記の制限が必要です。
必要な情報がすべて揃っていない場合でも、情報を下書きとして保存できます。
下書きを保存するには、デバイスタイプコード、アカウント番号/アカウント参照ID、およびメトロコードを入力する必要があります。
仮想デバイスを作成することで、オーダー条件に同意したものとみなされます。オーダー条件の取得に電話して、詳細を確認してください。
サンプル請求
冗長 Cisco SD-WAN デバイスを作成するためのサンプル curl リクエスト。
curl -X POST
https://api.equinix.com/ne/v1/devices?draft=false
-H 'Authorization: Bearer <token>'
-H 'Content-Type: application/json'
-d '
{
"deviceTypeCode": "C8000V-SDWAN",
"projectId": "XXXXX",
"metroCode": "DC",
"termLength": "1",
"licenseMode": "BYOL",
"packageCode": "DNA",
"virtualDeviceName": "sroy-cisco-8v-controller",
"notifications": [
"test@equinix.com"
],
"version": "17.09.01a",
"interfaceCount": 10,
"deviceManagementType": "SELF-CONFIGURED",
"core": 4,
"vendorConfig": {
"systemIpAddress": "1.1.1.1",
"siteId": "4567",
"hostname": "SR-01"
},
"aclTemplateUuid": "3319e378-be2f-40e4-8e79-13ea2aed7a5f",
"day0TextFileId": "917f2621-11d4-468f-9a09-af8fd66c0e57",
"accountNumber": "201091",
"secondary": {
"metroCode": "DC",
"notifications": [
"test@equinix.com"
],
"virtualDeviceName": "sroy-cisco-8v-controller-secondary",
"additionalBandwidth": "100",
"vendorConfig": {
"systemIpAddress": "1.1.1.1",
"siteId": "9886",
"hostname": "SR-02"
},
"aclTemplateUuid": "3319e378-be2f-40e4-8e79-13ea2aed7a5f",
"day0TextFileId": "dec1dee5-eba9-4187-a029-ae76341e8874",
"accountNumber": "201091"
},
"additionalBandwidth": "100"
}
'
パラメータとオプションの完全なリストについては、『APIリファレンス』を参照してください。
回答例
単一デバイスの応答例202：リクエストが承認されました。
{
"uuid": "74d8c6b6-3153-4271-9f0e-45bdc7094dec"
}
冗長デバイス202の応答例：リクエストが承認されました。
{
"uuid": "74d8c6b6-3153-4271-9f0e-45bdc7094dec",
"secondaryUuid": "de5cf79b-3d16-4ccd-841b-3b68ecda2142"
}
Access Denied（アクセス拒否）」と表示された場合は、お近くのエクイニクスサービスデスクにお問い合わせください。
デバイスのステータス
SD WANデバイスが作成されると、デバイスはEquinixインフラストラクチャ内のさまざまな状態を経て移行します。これらの状態は、Get Virtual Device {uuid} APIの"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 | デバイスはプロビジョニング解除/削除される。 |