メインコンテンツに移動

SDWANデバイスの作成

前提条件​

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

ステップ2: デバイスタイプとアカウントの取得​

Get Device Types APIを呼び出して、NEプラットフォームで起動できるWANデバイスを検索する。これらのデバイスが利用可能なメトロ()、利用可能なコア数()、coreソフトウェアパッケージ(packageCodeと)、versionおよび可能なすべてのライセンスとスループットオプションについて学ぶ。metroCode

欲しいデバイスがすでに決まっている場合は、このステップを飛ばしても構いません。

Get Accounts{metro} APIaccountReferenceIdを呼び出して、仮想デバイスを使用するメトロ内のアカウント番号(または)とステータスを確認する。課金上の理由から、仮想デバイスが必要なメトロ内のアカウント（アクティブまたは保留中の状態）が必要である。アカウントの作成方法については、「請求先アカウント管理」を参照。

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

アカウント番号(またはaccountReferenceId)と ステータスがすでにわかっている場合は、この手順をスキップすることができる。

ステップ3: ライセンスを構成する​

今のところ、BYOL (Bring Your Own License) が SD-WAN デバイスで利用可能な唯一のライセンスオプションであり、BYOL へのプロセスはベンダーごとに異なります。

Cisco SD WANデバイスのライセンスを設定するには、次の手順を実行する。

  • Cisco vManageプラットフォームでブートストラップファイルを生成します。
  • C8000V-SDWANを作成するには、Upload Fileを呼び出してCiscoブートストラップファイルをアップロードする。回答にはAがある。fileUuidペイロード作成のフィールドに値を入力して、day0TextFileId仮想C8000V-SDWANデバイスを作成する。

Prismaデバイスのライセンスを構成するには、次の手順を実行する。

  • Prisma Orchestratorでライセンスキー(ionキー)とライセンスシークレット(シークレットキー)を生成する。
  • Equinix CREATE DEVICE APIを呼び出してプリズマWANデバイスを作成する際に、ライセンスキー(IONキー)とシークレット(シークレットキー)を入力する。

Fortinetデバイスの作成時にライセンスは必須ではない。トークンがある場合は、 フィールドに入力する。licenseTokenFortinet SD WANデバイスのライセンスファイルを構成するには、 次の手順を実行する。

  • Fortinetポータルでライセンスファイルを生成します。
  • Post License Fileを呼び出して、Equinixポータルにライセンスファイルをアップロードする。仮想SD WANデバイスの作成に使用できるを入手する。fileId

Versaデバイスを構成するには、VersaディレクタでVNFデバイステンプレートを作成し、シリアル 番号を書き留めておく。

Network Edge プラットフォームで Aruba デバイスを設定するためにライセンスファイルは必要ありません。

Juniper WANのライセンスをアップロードするには：

  • Juniper ポータルでライセンスファイルを生成します。
  • Post License Fileを呼び出して、Equinixポータルにライセンスファイルをアップロードする。ジュニパーのWANデバイスの作成に使用できるを入手する。fileId

ステップ4: ベンダー固有のパラメータ​

各 SD-POST WANベンダーは、ステップ5のPOST API定義の一部としてリストされている共通パラメータ以外の独自のパラメータセットを必要とする。 手順で新しいデバイスを作成する際に、ベンダーのパラメータを確認し、vendorConfig{}オブジェクトにパラメータを渡してください 5.

シスコSD - WAN​

Cisco vendorConfig{}のパラメータ必須タイプ例可能な値説明
サイトIDはい文字列12345サイトID。Cisco WANデバイスの場合は必須。サイトIDは、支社やキャンパスなど、ビプテラのオーバーレイネットワーク内の特定の物理的な場所である。
systemIpAddress (システム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キー)。Palo Alto Networksデバイスで必須。
licenseSecret (シークレットキー)はい文字列ec68e425-f973-452e-a866-76be5844d0baライセンスシークレット(シークレットキー)。Palo Alto Networksデバイスで必須。

Versa VERSA_SDWAN​

Versa vendorConfig{}パラメータ必須タイプ例可能な値説明
ローカルIDはい文字列SDWAN-Branch@Versa.com支店のEメールアドレス
リモートIDはい文字列Controller-01-staging@Versa.comコントローラー側のメールアドレス。
シリアル番号はい文字列12345Versaダイレクタでデバイステンプレートを設定するときに'シリアル番号を選択するVersaダイレクタのステージング後デバイスのシリアル番号は'この入力と一致する必要がある
コントローラ1はい文字列54.219.248.29SD-WANコントローラ1のIPアドレス。
コントローラ2はい文字列54.177.220.115SD-WANコントローラーのIPアドレス2。

FortiGate FG-SDWAN *​

FortiGate vendorConfig{}パラメータ必須タイプ例可能な値説明
adminPassword (管理パスワード)はい文字列パスワード9パスワード。このパスワードは6文字以上で、大文字と数字を含める必要がある。
コントローラ1はい文字列1.1.1.1システムIPアドレス。FortiGate WANデバイスで必須。

*FortiGate SD-WANデバイスにもホスト名が必要ですが、これはvendorConfigオブジェクトの一部ではなく、deviceTypeCode、accountNumberなどのパラメータとして渡されます。

Arista VELOCLOUD-SDWAN​

Arista vendorConfig{}パラメータ必須タイプ例可能な値説明
アクティブ化キーはい文字列GJUK-JM2X-59BJ-SAMPLEアクティベーションキー。VeloCloudオーケストレーションポータルで利用可能。
コントローラFqdnはい文字列demo.velocloud.netVeloCloud SD - WANゲートウェイ。デバイスのACLのリストで、controllerFqdnに関連付けられた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デバイスを作成したい場合は、次のようにします：

  1. オプションのセカンダリオブジェクトのパラメータを設定する。vendorConfig

    • リクエストボディのペイロードにCisco SD-WANの2つのlicenseFileIdsをプロバイダする。
    • CloudGenixの冗長化には、2つのライセンスキー（IONキー）とライセンスシークレット（シークレットキー）が必要です。 リクエストボディのペイロードのデバイス
    • 冗長なアリスタ・ヴェロクラウドWANエッジデバイス用に2つのactivationKeyを提供する。

  2. セカンダリデバイスでは、ACLテンプレート、アカウント番号、additionalBandwidth、metroCode、および通知が異なる場合があります。

  3. リセラーが顧客用に冗長デバイスを作成しようとしている場合は、プライマリメトロとセカンダリメトロの両方が同じ国にあることを確認する。また、一次口座と二次口座番号は同じでなければならない。リセラーのアカウントには請求が発生するが、このAPIはお客様のアカウント番号を受け入れて、お客様用のデバイスを作成する。各顧客がリセラーの請求先アカウントに関連付けられているため、上記の制限が必要である。

必要な情報がすべて揃っていない場合でも、その情報を下書きとして保存することができる。

下書きを保存するには、deviceTypeCode、AccountNumber/accountReferenceId、およびmetroCodeを指定する必要がある。

メモ

仮想デバイスを作成することで、注文条件に同意したことになる。注文条件の取得に電話して詳細を確認する。

サンプル請求​

冗長 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デバイスはプロビジョニング解除/削除される。
このページは役に立ちましたか？