action.skip

API を使用した MCR と Microsoft Azure 間への VXC の作成

ロケーションこのトピックでは、APIの手順を使用して、MCRからMicrosoft Azure ExpressRouteへのVXCを作成します。これには、Azureの相互接続のロケーションを検索してVXCを注文する方法も含まれます。

MCRからAzureへの構築には、次のタスクが含まれます。

  1. AzureコンソールでExpressRoute回線を設定します。

    構築すると、サービスキーを取得します。サービスキーを検証すると、プライマリポートとセカンダリポートが表示され、接続用のポートを選択できます。キーをもう一度使用して、未使用のポートへの別の接続を作成できます。

    詳細については、Microsoftヘルプトピックチュートリアルを参照してください。ExpressRoute回線を作成および変更します。

  2. サービスキーを使用して、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ピアリングの場合、ピアには次の行を使用します。

          "peers":[{"type":"microsoft"}]

Microsoftピアリングとプライベートピアリングの両方で、次の行を使用します。

          "peers":[{"type":"microsoft"}, {"type": "private"}]

プライマリ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"
            }
        ]
    }
}