API を使用したポートと Microsoft Azure 間での VXC の作成
このトピックでは、APIの手順を使用して、ポートからMicrosoft Azure ExpressRouteへのVXCを作成します。これには、Azureのポートのロケーションを検索してVXCを注文する方法も含まれます。
ポートからAzureへの構築には、次のタスクが含まれます。
-
AzureコンソールでExpressRoute回線を設定します。
構築すると、サービスキーを取得します。サービスキーは、Azureで割り当てられたポートにリンクされています。サービスキーを検証すると、応答にはAzureで割り当てられたプライマリポートとセカンダリポートが表示されます。サービスキーを2回使用して、- 1回目はプライマリに接続し、2回目はセカンダリポートへの別の接続を作成できます。
詳細については、Microsoftヘルプトピックチュートリアルを参照してください。ExpressRoute回線を作成および変更します。 -
サービス キーを使用して、Megaport Portal から VXC を作成して構築します。
このステップでは API – を使用します。他のステップは、Azure 環境の Megaport 外部にあります。 -
回路にVXCを構築したら、Azureポータルでピアリングを設定します。
ピアリング情報は、ピアに割り当てられた内部VLANと同様に、プライマリ回線とセカンダリ回線の間で共有されます。
詳細については、Microsoftのヘルプトピック「ExpressRoute回線のピアリングの作成と変更」を参照してください。 -
顧客宅内機器(CPE)デバイスを構成します。
始める前に、有効なアクセス トークンを取得します。詳細については、API キーの作成を参照してください。
サービス キーの検証
APIを使用してAzureサービスキーを検証すると、応答には関連付けられたポートとピアのExpressRouteの詳細が含まれます。VXCを作成するには、ポートの詳細が必要です。
Postman コレクションのサービス キーを検証するには
-
Postman で、左側のナビゲーションで「Cloud Connectivity (クラウド接続)」>「Port (ポート)」>「Azure」を展開し、「GET Look Up Azure Service Key (ルック アップ Azure サービス キーを取得)」を選択します。
-
エンドポイントにサービス キーを追加します。
-
「Send(送信)」をクリックして、APIサーバーにGET依頼を送信します。
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": []
}
}
「megaports:vxc」値は両方のポートでnullであり、新規VXCで使用できることを示します。
各応答フィールドの詳細については、「Azureサービスキーの応答フィールド」を参照してください。
VXC の作成
サービスキーの詳細を使用して、プライマリポートにVXCを作成し、セカンダリポートに別のVXCを作成します。
VXC を作成するには
-
「POST Create VXC to Azure (Azure への VXC の作成の発行)」を選択します。
ヒント
注文する前に依頼をテストして価格の詳細を確認するには、次を使用できます。 POST {API Server URL}/v2/networkdesign/validate
-
依頼のボディを、ポートの「productUid」、VXCの名前、プライマリAzureポートの「productUid」、およびサービスキーで更新します。最大速度(「rateLimit」)は、サービスキー応答の帯域幅値で定義されます。この場合は200です。
-
「Send(送信)」をクリックして依頼を発行します。
POST {baseUrl}/v2/networkdesign/buy
[
{
"productUid": "1544f278-ec03-11e5-9ce9-5e5517507c66", //port UID of your Megaport (A End)
"associatedVxcs": [
{
"productName": "Primary Azure VXC",
"rateLimit": 200,
"aEnd": {
"vlan": 102
},
"bEnd": {
"productUid": "a7ae8a35-433e-44aa-87cb-a1b7995ab008", //retrieved port UID from the Azure service key lookup
"partnerConfig" : {
"connectType": "AZURE",
"serviceKey": "3e2480b2-b4d5-424b-976a-7b0de65a1b62" //service key from lookup response
}
}
}
]
}
]
プライマリおよびセカンダリVXCをAzureポートに設定すると、別のサービスキールックアップにAzureポートに関連付けられたVXCが表示されます。VXC は ID 番号で識別されます (「megaports: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": 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ポータルでピアリングを設定し、CPEデバイスを設定します。