APIを使用してPortとMicrosoft Azureの間にVXCを作成する
このトピックでは、PortからMicrosoft Azure ExpressRouteへのVXCを作成するAPI手順、Azureポートの場所を検索しVXCを注文する方法について説明します。
PortからAzureへのデプロイメントは以下のタスクを含みます：
-
AzureコンソールでExpressRoute回線をセットアップする
デプロイされると、サービスキーが得られます。このサービスキーはAzure上の指定されたポートにリンクされています。サービスキーを検証すると、Azure上の指定されたプライマリおよびセカンダリのポートが表示されます。サービスキーは2回使用できます - プライマリに接続するために1回、セカンダリポートへの別の接続を作成するためにもう1回です。
詳細については、Microsoftのヘルプトピック「チュートリアル: ExpressRoute回線を作成および変更する」を参照してください。 -
サービスキーを使ってMegaport PortalからVXCを作成してデプロイする
このステップではAPIを使用します - 他のステップはMegaportの外のAzure環境で行われます。
-
サーキットにデプロイされたVXCで、Azureポータルにピアリングを構成する
ピアリング情報はプライマリおよびセカンダリ回線の間で共有され、ピアに割り当てられた内側VLANも同様です。
詳細については、Microsoftのヘルプトピック「ExpressRoute回線のピアリングを作成および変更する」を参照してください。 -
顧客拠点設置機器（CPE）デバイスを構成する
始める前に、有効なアクセストークンを取得してください。詳細については、APIキーの作成を参照してください。
サービスキーを検証する
APIを使用してAzureサービスキーを検証する場合、応答には関連ポートとピアのExpressRouteの詳細が含まれています。VXCを作成するにはポートの詳細が必要です。
Postmanコレクションでサービスキーを検証する方法
-
Postmanで、左のナビゲーションで Cloud Connectivity > Port > Azure を展開し、 GET Look Up Azure Service Key を選択します。
-
エンドポイントにサービスキーを追加します。
-
Send ボタンをクリックしてAPIサーバーへのGETリクエストを行います。
GET {baseUrl}/v2/secure/azure/{service_key}
こちらは新しいキー（構成済みのVXCなし）のサンプルレスポンスです：
{
"message": "Successful lookup",
"terms": "このデータは利用許諾ポリシーに従います 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": []
}
}
megaports:vxc の値が両方のポートで null となっているため、新しい VXC の作成が可能です。
各レスポンスフィールドの詳細については、Azure サービスキー API レスポンスフィールド を参照してください。
VXC の作成と展開
サービスキーの詳細を使用して、プライマリポートへの VXC とセカンダリポートへの別の VXC を作成します。
VXC を作成するには
-
POST Create VXC to Azure (v3) を選択します。
ヒント
注文前にリクエストをテストし、料金の詳細を確認するには、以下を使用できます。
POST {baseUrl}/v3/networkdesign/validate -
リクエストの Body を、ポートの
productUid、VXC の名前、プライマリ Azure ポートのproductUid、およびサービスキーで更新します。最大速度 (rateLimit) はサービスキーのレスポンスの帯域幅値で定義されています。この場合、200 です。 -
Send をクリックしてリクエストを送信します。
POST {baseUrl}/v3/networkdesign/buy
[
{
"productUid": "1544f278-ec03-11e5-9ce9-5e5517507c66", //あなたのMegaport (A-End)のポートUID
"associatedVxcs": [
{
"productName": "Primary Azure VXC",
"rateLimit": 200,
"term":12,
"shutdown": false,
"promoCode": "promox3mnthfree2",
"aEnd": {
"vlan": 102
},
"bEnd": {
"productUid": "a7ae8a35-433e-44aa-87cb-a1b7995ab008", //Azureサービスキー検索で取得したポートUID
"partnerConfig" : {
"connectType": "AZURE",
"serviceKey": "3e2480b2-b4d5-424b-976a-7b0de65a1b62" //検索応答からのサービスキー
}
}
}
]
}
]
プライマリおよびセカンダリの VXC を Azure ポートに設定すると、別のサービスキー照会で Azure ポートに関連付けられた VXC が表示されます。VXC は ID 番号（megaports:vxc）で識別されます。
{
"message": "Successful lookup",
"terms": "このデータは利用許諾ポリシーに従います 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": 60621,
"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": 60622,
"port": 16108,
"companyName": "Azure ExpressRoute",
"locationId": 67,
"productId": 16108,
"type": "secondary",
"companyId": 1475
}
],
"peers": []
}
}
構成を完了するには、AzureポータルでAzure portal を使用した ExpressRoute 回線のピアリングの作成と変更し、CPEデバイスを構成してください。