APIを使用したMCRとクラウドサービスプロバイダー間へのVXCの作成

このトピックでは、APIの手順を使用して、MCRからクラウドサービスプロバイダー（CSP）へのVXCを作成します。最初の例では、より複雑な設定の1つである米国市場- でAWSホスト型接続を作成します。他のCSPのテンプレートは、トピックの後半に表示されます。

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

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

MCR製品IDを取得する
利用可能な米国市場のロケーションIDを見つける
VXCを検証して注文する
2つの静的ルートを設定する
BGP接続を設定する– Multi-Exit Discriminator（MED）と双方向フォワーディング検出（BGP）の詳細を含む1つの接続と、含まない1つの接続

始める前に、ログインして有効なX-Auth-Tokenを取得してください。

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

MCRのproductUidを取得するには

製品リストを取得してください。
```
GET {baseUrl}/v2/product/
```
返された製品の詳細から、接続するMCRの「productUid」値を見つけます。

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

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

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

Megaportがクラウドサービスプロバイダーで持つすべてのインターフェイスのリストを取得します。
```
GET {baseUrl}/v2/dropdowns/partner/megaports
```
「connectType」と「vxcPermitted」で結果をフィルタリングできます。
```
GET {baseUrl}/v2/dropdowns/partner/megaports?connectType=AWSHC&vxcPermitted=true
```
虫眼鏡をクリックして、応答を検索し、ロケーションの条件に一致するサイトを探します。

この例では、「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を注文するには

次のURLで依頼を作成します。
```
POST {baseUrl}/v2/networkdesign/buy
```
ヒント

注文する前に依頼をテストするには、次を使用できます。 POST {API Server URL}/v2/networkdesign/validate
これらのヘッダーを依頼に追加します。
- コンテンツタイプ：application/json
- X-Auth-Token：{あなたのトークン}
設定の詳細を使用して依頼のボディを作成します。

この例では、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",
    "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の間の値をサポートします
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から9999msです。	はい	300-9999
rxInterval	ネイバーが送信するBFDパケット間の最小時間。サポートされる範囲は300msから9999msです。	はい	300-9999
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ピアリングを設定するには

次のURLで依頼を作成します。
```
POST {baseUrl}/v2/networkdesign/buy
```
これらのヘッダーを依頼に追加します。
- コンテンツタイプ：application/json
- X-Auth-Token：{{あなたのトークン}}
設定の詳細を使用して依頼のボディを作成します。

ここでは、最も人気のある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の作成」を参照してください。

最後の更新: