action.skip
Megaportのドキュメンテーション
API を使用した MCR VXC の作成

API を使用した MCR VXC の作成

このトピックでは、MCR VXC を作成するための API 手順を順を追って説明します。最初の例では、より複雑な設定の1つである米国市場- でAWSホスト型接続を作成します。他のCSPのテンプレートは、トピックの後半に表示されます。

ホスト型接続を使用した MCR と AWS 間への VXC の作成

この例では、米国市場でAWSホスト型接続を作成します。手順には、次の方法が含まれます。

  • MCR製品IDを取得する
  • 利用可能な米国市場のロケーションIDを見つける
  • VXCを検証して注文する
  • 2つの静的ルートを設定する
  • BGPボーダー ゲートウェイ プロトコル。
    インターネット上の自律システム (AS) 間で経路および到達可能性情報を交換するために設計された標準化されたルーティング プロトコル。     接続を構成する – MEDMulti-Exit Discriminator。
    広報する自律システム (AS) が候補経路で同じであり、その AS に複数のエントリ ポイントがある場合に、優先経路を選択するために BGP ネイバーに影響を与えることができる BGP 経路属性。     および BFD双方向フォワーディング検出。
    BFD プロトコルは、直接接続された BGP ネイバー間のあらゆる経路障害を検出し、BGP 経路の再コンバージェンス時間を短縮できる。     の詳細がある接続とない接続を 1 つずつ

始める前に、有効なアクセス トークンを取得します。詳細については、API キーの作成を参照してください。

VXCを作成するには、MCRの「productUid」が必要です。

MCRのproductUidを取得するには

  1. 製品リストを取得してください。 

    GET {baseUrl}/v2/products/

  2. 返された製品の詳細から、接続するMCRの「productUid」値を見つけます。

    この例では、次の値を使用します：fee85cc0-f06f-4ad7-bce7-36aef7dbe0d0

次に、AWSホスト型接続をサポートしている、必要な米国市場のロケーションIDを見つけます。

AWSホスト型接続が利用可能な米国市場でlocationIdを見つけるには

  1. Megaportがクラウドサービスプロバイダーで持つすべてのインターフェイスのリストを取得します。 

    GET {baseUrl}/v2/dropdowns/partner/megaports

    「connectType」と「vxcPermitted」で結果をフィルタリングできます。

    GET {baseUrl}/v2/dropdowns/partner/megaports?connectType=AWSHC&vxcPermitted=true

  2. 虫眼鏡をクリックして、応答を検索し、ロケーションの条件に一致するサイトを探します。

    この例では、「locationId」：57を使用して「US West (Oregon) (us-west-2) [DZ-RED]」を選択します。

{
            "connectType": "AWSHC",
            "productUid": "f274bd09-1796-43af-8837-28fa4fa2a1ab",
            "vxcPermitted": true,
            "companyUid": "605cb850-dfb4-4a05-a171-8bf17757b3a2",
            "companyName": "AWS",
            "title": "US West (Oregon) (us-west-2) [DZ-RED]",
            "locationId": 57,
            "speed": 10000,
            "rank": 275,
            "lag_id": 5,
            "lag_primary": true,
            "aggregation_id": 106462
        },

注意

[DZ-RED]は赤の多様性ゾーンを意味します。各AWSホスト型接続サイトは冗長性を提供するために、DZ-RedとDZ-Blueの2つの多様性ゾーンを提供します。

MCR IDとAWSロケーションIDを使用して、VXCを注文できます。

VXCを注文するには

  1. 次のURLで依頼を作成します。 

    POST {baseUrl}/v2/networkdesign/buy

    ヒント

    注文する前に依頼をテストするには、次を使用できます。 POST {API Server URL}/v2/networkdesign/validate

  2. これらのヘッダーを依頼に追加します。

    • コンテンツタイプ：application/json
    • 承認: Bearer {your accessToken}

  3. 設定の詳細を使用して依頼のボディを作成します。

    この例では、B-EndのAWSロケーションIDであるMCR製品IDを使用し、2つの静的ルートを作成し、BGP接続を設定します。1つはMEDとBFDの詳細を含む接続で、もう1つは含まない接続です。次のセクションでは、静的ルートとBGP接続について詳しく説明します。 

[
  {
    "productUid": "fee85cc0-f06f-4ad7-bce7-36aef7dbe0d0",
    "associatedVxcs": [
      {
        "rateLimit": 100,
        "productName": "awshc",
        "aEnd": {
          "locationId": 320,
          "vlan": 0,
          "partnerConfig": {
            "connectType": "VROUTER",
            "interfaces": [
              {
                "ipAddresses": [
                  "10.191.0.25/29"
                ],
                "bfd": {
                  "txInterval": 300,
                  "rxInterval": 300,
                  "multiplier": 3
                },
                "bgpConnections": [
                  {
                    "peerAsn": 62512,
                    "localIpAddress": "10.191.0.25",
                    "peerIpAddress": "10.191.0.26",
                    "password": "cnn6eaeaETSjvjvjvjv",
                    "shutdown": false,
                    "description": "BGP with MED and BFD enabled",
                    "medIn": 100,
                    "medOut": 100,
                    "bfdEnabled": true
                  },
                  {
                    "peerAsn": 62511,
                    "localIpAddress": "10.191.0.27",
                    "peerIpAddress": "10.191.0.28",
                    "password": "cnn23049asdkfj",
                    "shutdown": false,
                    "description": "BGP without MED or BFD",
                    "medIn": null,
                    "medOut": null,
                    "bfdEnabled": false
                  }
                ],
                "ipRoutes": [
                  {
                    "prefix": "10.0.0.0/24",
                    "nextHop": "10.191.0.26",
                    "description": "test static route 1"
                  },
                  {
                    "prefix": "10.0.1.9/24",
                    "nextHop": "10.191.0.27",
                    "description": "test static route 2"
                  }
                ],
                "natIpAddresses": []
              }
            ]
          }
        },
        "bEnd": {
          "locationId": 57,
          "ownerUid": "605cb850-dfb4-4a05-a171-8bf17757b3a2",
          "productUid": "d5518ee1-e915-4e3d-a4e1-a2c7e04f2fdd",
          "vlan": 0,
          "partnerConfig": {
            "name": "awshc",
            "ownerAccount": "684021030471",
            "connectType": "AWSHC"
          }
        },
        "productType": "VXC",
        "connectType": "AWSHC"
      }
    ]
  }
]

静的経路

A-Endパートナー設定オブジェクトのインターフェイス配列に「ipRoutes」配列を追加することにより、インターフェイスごとに複数の静的ルートを作成できます。

"ipRoutes": [
  {
    "prefix": "10.0.0.0/24",
    "nextHop": "10.191.0.26",
    "description": "test static route 1"
  },
  {
    "prefix": "10.0.1.9/24",
    "nextHop": "10.191.0.27",
    "description": "test static route 2"
 }
],
空のipRoutes配列は、静的ルートがないことを示します。

属性 説明 必須 有効な入力
prefix nextHopにルーティングするIPプレフィックス（V4 & V6） はい IPプレフィックスv4/v6 - マスクが提示されていない場合、アドレスはホストアドレスとして扱われます（/32）
nextHop Next Hop（ネクスト ホップ）アドレス はい IPアドレスv4/v6- インターフェイスIPではなく、インターフェイスと同じサブネットにある必要があります
description 静的ルートのオプションの説明 いいえ 文字列- 最大長100文字

BGP 接続

A-Endパートナー設定オブジェクトのインターフェイス配列に「bgpConnections」配列を追加することにより、インターフェイスごとに複数のBGP接続を作成できます。

"bgpConnections": [
  {
    "peerAsn": 62512,
    "localIpAddress": "10.191.0.25",
    "peerIpAddress": "10.191.0.26",
    "password": "cnn6eaeaETSjvjvjvjv",
    "shutdown": false,
    "description": "BGP with MED and BFD enabled",
    "medIn": 100,
    "medOut": 100,
    "bfdEnabled": true
  },
  {
    "peerAsn": 62511,
    "localIpAddress": "10.191.0.27",
    "peerIpAddress": "10.191.0.28",
    "password": "cnn23049asdkfj",
    "shutdown": false,
    "description": "BGP without MED or BFD",
    "asPathPrependCount": "3",
    "bfdEnabled": false
  }
],
属性 説明 必須 有効な入力
peerAsn リモートBGPピアのASN。 はい 有効なASN - 次の間の整数：1 - 4294967294
localAsn ローカルASNは、このBGPピアのMCRのASNを上書きできます。ほとんどの場合、デフォルトのままにしておく必要があります。 いいえ 有効なASN - 次の間の整数：1 - 4294967294

peerAsn == mcrAsnの場合、localAsnは設定できません

peerAsn != mcrAsnの場合、localAsnはpeerAsnと一致できません
localIpAddress BGPピアとの通信に使用するこのインターフェイスのIPv4またはIPv6アドレス。 はい 有効なIPアドレスv4/v6。インターフェイスのIPアドレスである必要があります
peerIpAddress BGPピアのIPアドレス。 はい 有効なIPアドレスv4/v6
password 最大32文字のBGPピアの認証に使用される共有キー。 いいえ 0～32文字
shutdown デフォルトでは、BGP接続が有効になっており、ピアへの接続をアクティブに試行します。シャットダウンを選択して、BGPセッションを削除せずに一時的に無効にします。これは、フェイルオーバーシナリオのトラブルシューティングまたはテストに役立ちます。 いいえ true/false - デフォルトはfalse
description BGP接続のオプションの説明 いいえ 0～100文字
medIn MEDは、このBGP接続で受信されたすべてのルートに適用されます。BGPピアから受信した値を使用するには、空白のままにします。最小値のルートが優先されます。 いいえ 0と4,294,967,295の間の値をサポートします
medOut MEDは、このBGP接続で送信されるすべてのルートに適用されます。隣接する自律システムは、その裁量で最小値を優先する場合があります。 いいえ 0と4,294,967,295の間の値をサポートします
asPathPrependCount asPathPrependCount は、ピアへの発信 BGP 通知でローカル AS 番号が追加される回数を表す整数です。 いいえ 受け入れ可能な値は 1～10 の範囲です
bfdEnabled 双方向フォワーディング検出により、このBGP接続での迅速な障害検出が可能になります。接続が中断されると、BGP保留タイマーの期限が切れるのを待たずにBGPセッションが切断されます。BFD では、複数のルートが利用可能な場合、フェイルオーバーの時間が改善される可能性があります。 いいえ true/false -
デフォルトはfalse
オプション

双方向フォワーディング検出 (BFD)

「bfd」設定オブジェクトは、「bfdEnabled = true」を持つインターフェイス上のすべてのBGP接続に適用されます。BGP接続に「bfdEnabled」がある場合は、「bfd」オブジェクトが必須です。それ以外の場合はオプションです。

注意

これらの設定は、BFDが有効になっているVXC上のすべてのBGP接続に使用されます。

1つの「bfd」オブジェクトが各インターフェイスに追加されます。

"bfd": {
  "txInterval": 300,
  "rxInterval": 300,
  "multiplier": 3
},
属性 説明 必須 有効な入力
txInterval BFDパケットをネイバーに送信する間の最小時間。サポートされる範囲は300msから9000msです。 はい 300-9000
rxInterval ネイバーが送信するBFDパケット間の最小時間。サポートされる範囲は300msから9000msです。 はい 300-9000
multiplier この数の連続したBFDパケットがネイバーから受信されない場合、BGPセッションは切断されます。 はい 3-50

AWS、Azure、Google での自動構成

Azure、AWSホスト型VIF、Googleの場合、MegaportはMCR側とCSP側の両方でIPアドレスとBGPの詳細をセットアップして、BGPセットアップが機能するようにすることができます。これにより、CSPポータルとMegaportポータル間の切り替えの量も最小限に抑えられます。

ポータルはデフォルトで自動設定を処理しますが、APIを使用してBGP自動設定をトリガーすることもできます。 この機能は、partnerConfigのインターフェイスキーが存在しないか、nullの場合にトリガーされます。

CSPのBGPピアリングを設定するには

  1. 次のURLで依頼を作成します。 

    POST {baseUrl}/v2/networkdesign/buy

  2. これらのヘッダーを依頼に追加します。

    • コンテンツタイプ：application/json
    • 承認: Bearer {your accessToken}

  3. 設定の詳細を使用して依頼のボディを作成します。

    ここでは、最も人気のあるCSP用のさまざまなテンプレートを利用できます。

AWS ホスト型 VIF

{
"productUid": "{{mcrid}}",
"associatedVxcs": [
 {
   "productName": "Test AWS VIF VXC",
   "rateLimit": 100,
   "aEnd": {
     "vlan": 0
   },
   "bEnd": {
     "productUid": "{{awsPortUid}}",
     "partnerConfig": {
       "connectType": "AWS",
       "type": "private",
       "ownerAccount": "{{yourAWSAccountNumber}}"
     }
   }
 }
]
}

Google Cloud

{
   "productUid": "{{mcrid}}",
   "associatedVxcs": [
    {
     "productName": "Test Google VXC",
     "rateLimit": 100,
     "aEnd": {
       "vlan": 0
     },
     "bEnd": {
       "productUid": "{{googlePortUid}}",
       "partnerConfig": {
         "connectType": "GOOGLE",
         "pairingKey": "{{googlekey}}"
       }
     },
     "productType": "VXC"
    }
   ]
}

Microsoft Azure

Azure設定の詳細については、「APIを使用したMCRとMicrosoft Azure間へのVXCの作成」を参照してください。