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の作成」を参照してください。