API を使用した MCR と Microsoft Azure 間への VXC の作成
ロケーションこのトピックでは、APIの手順を使用して、MCRからMicrosoft Azure ExpressRouteへのVXCを作成します。これには、Azureの相互接続のロケーションを検索してVXCを注文する方法も含まれます。
MCRからAzureへの構築には、次のタスクが含まれます。
-
AzureコンソールでExpressRoute回線を設定します。
構築すると、サービスキーを取得します。サービスキーを検証すると、プライマリポートとセカンダリポートが表示され、接続用のポートを選択できます。キーをもう一度使用して、未使用のポートへの別の接続を作成できます。
詳細については、Microsoftヘルプトピックチュートリアルを参照してください。ExpressRoute回線を作成および変更します。
-
サービスキーを使用して、VXCを作成して構築します。
VXC設定の一部として、ピアリングタイプを選択できます。
ピアリングタイプは、プライベートまたはMicrosoftのいずれかです。
定義されたピアリングタイプにより、Azure側とMegaport側の両方で一致するピアと自動的に設定されたピアリングと、既知の動作設定を持つ構築されたシステムが生成されます。構築したら、設定を変更できます。
始める前に、有効なアクセス トークンを取得します。詳細については、API キーの作成を参照してください。
サービス キーの検証
APIを使用してAzureサービスキーを検証すると、応答には関連付けられたポートとピアのExpressRouteの詳細が含まれます。VXCを作成するには、ポートの詳細が必要です。
GET {baseUrl}/v2/secure/azure/{service_key}
これは、新規キー(設定されたVXCなし)のサンプル応答です。
{
"message": "Successful lookup",
"terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
"data": {
"managed": false,
"connectType": "AZURE",
"resource_type": "csp_connection",
"bandwidth": 200,
"service_key": "3e2480b2-b4d5-424b-976a-7b0de65a1b62",
"vlan": 3289,
"megaports": [
{
"portSpeed": 10000,
"name": "Washington DC Primary",
"state": "VA",
"description": "Azure ExpressRoute at Equinix DC2/6",
"productUid": "a7ae8a35-433e-44aa-87cb-a1b7995ab008",
"nServiceId": 32832,
"companyUid": "c40de5ed-4707-4471-a78c-69436de2c505",
"country": "USA",
"vxc": null,
"port": 14570,
"companyName": "Azure ExpressRoute",
"locationId": 67,
"productId": 14570,
"type": "primary",
"companyId": 1475
},
{
"portSpeed": 10000,
"name": "Washington DC Secondary",
"state": "VA",
"description": "Azure ExpressRoute at Equinix DC2/6",
"productUid": "07ab0ee6-7f77-41ac-bbe6-335e3ee6d182",
"nServiceId": 36431,
"companyUid": "c40de5ed-4707-4471-a78c-69436de2c505",
"country": "USA",
"vxc": null,
"port": 16108,
"companyName": "Azure ExpressRoute",
"locationId": 67,
"productId": 16108,
"type": "secondary",
"companyId": 1475
}
],
"peers": []
}
}
各応答フィールドの詳細については、「Azureサービスキーの応答フィールド」を参照してください。
ピアリング オプション付きの VXC の注文
サービスキーの詳細を使用して、プライマリポートにVXCを作成し、セカンダリポートに別のVXCを作成します。サービスキールックアップ依頼から、Azureポートと同じリージョンのMCRを選択していることを確認してください。
VXCのAPI依頼でピアリングタイプを指定すると、MegaportはMCR側とAzure側の両方でIPアドレスとBGPの詳細を設定して、BGPセットアップが機能するようにします。
ピアリングタイプを指定するには、「partnerConfig」セクションのpeers配列にピアリングタイプを追加します。ピア配列が存在しない場合、ピアはAzureから取得されます。VXCの作成時にピアが指定されておらず、Azureにピアがない場合(通常は新規サービスキーの場合)、MCRピアリングは自動設定されません。
MCRは、設定されたピアリングタイプごとにVLANを作成します。プライベートピアリングオプションとMicrosoftピアリングオプションの両方が指定されている場合、MCRは2つの内部VLANを設定します。
注意
ピアリングタイプは記憶されており、以前にキーが使用されていた場合は変更できません。
VXCを注文するには
POST {baseUrl}/v2/networkdesign/buy
ヒント
注文する前に依頼をテストするには、次を使用できます。 POST {baseUrl}/v2/networkdesign/validate
依頼のボディを、MCRの「productUid」、VXCの名前、Azureポートの「productUid」、およびサービスキーで更新します。適切なピアリングオプションを含めます。最大速度(「rateLimit」)は、サービスキー応答の帯域幅値で定義されます。この場合は200です。
Azure VLAN(指定されている場合)は、Q-in-Qの外部タグVLANです。VLANを指定しない場合、自動プロビジョニングされます。
プライベートピアリングオプションでAzureキーを使用するには、次のテンプレートを使用します。
[
{
"productUid": "{{mcrid}}",
"associatedVxcs": [
{
"productName": "Azure Primary VXC",
"rateLimit": 200,
"aEnd": {
"vlan": 0
},
"bEnd": {
"productUid": "{{azurepuid}}",
"vlan": "{{azurevlan}}",
"partnerConfig" : {
"connectType": "AZURE",
"serviceKey": "{{azurekey}}",
"peers": [{"type": "private"}]
}
}
}
]
}
]
Microsoftピアリングの場合、ピアには次の行を使用します。
Microsoftピアリングとプライベートピアリングの両方で、次の行を使用します。
プライマリAzureポート用のVXCを作成したら、別のVXCを作成してセカンダリAzureポートの「productUid」に接続します(「productName」と「bEnd: productUid」を変更します)。
構成済み応答
ピアリングを使用してVXCを作成すると、別のサービスキー検証依頼に完全な設定が表示されます。
{
"message": "Successful lookup",
"terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
"data": {
"managed": true,
"connectType": "AZURE",
"resource_type": "csp_connection",
"bandwidth": 200,
"service_key": "3e2480b2-b4d5-424b-976a-7b0de65a1b62",
"vlan": 3289,
"megaports": [
{
"portSpeed": 10000,
"name": "Washington DC Primary",
"state": "VA",
"description": "Azure ExpressRoute at Equinix DC2/6",
"productUid": "a7ae8a35-433e-44aa-87cb-a1b7995ab008",
"nServiceId": 32832,
"companyUid": "c40de5ed-4707-4471-a78c-69436de2c505",
"country": "USA",
"vxc": 60574,
"port": 14570,
"companyName": "Azure ExpressRoute",
"locationId": 67,
"productId": 14570,
"type": "primary",
"companyId": 1475
},
{
"portSpeed": 10000,
"name": "Washington DC Secondary",
"state": "VA",
"description": "Azure ExpressRoute at Equinix DC2/6",
"productUid": "07ab0ee6-7f77-41ac-bbe6-335e3ee6d182",
"nServiceId": 36431,
"companyUid": "c40de5ed-4707-4471-a78c-69436de2c505",
"country": "USA",
"vxc": 60575,
"port": 16108,
"companyName": "Azure ExpressRoute",
"locationId": 67,
"productId": 16108,
"type": "secondary",
"companyId": 1475
}
],
"peers": [
{
"peer_asn": 133937,
"shared_key": null,
"primary_subnet": "169.254.167.176/30",
"secondary_subnet": "169.254.167.180/30",
"vlan": 100,
"type": "private"
},
{
"peer_asn": 133937,
"shared_key": null,
"prefixes": "117.18.81.116/30,117.18.81.120/30",
"primary_subnet": "117.18.81.116/30",
"secondary_subnet": "117.18.81.120/30",
"vlan": 200,
"type": "microsoft"
}
]
}
}