APIを使用したAWSへのVXC作成
このトピックでは、PortからAWSへのVXCを作成するAPI手順について説明します。クラウドインターコネクトの場所を検索し、接続を検証し、VXCを注文する方法を含みます。
このトピックの例では、500 MbpsのデータレートでAWSにHosted VIF接続を作成します。この例を順を追って実行するには、ステージング環境URLを使用してください。このURLを使用すると、接続を設定することはできますが、サービスの展開や課金は行いません。
開始する前に、有効なアクセストークンを取得してください。詳細については、APIキーの作成を参照してください。
ヒント
この例で使用されるリクエストのすべてのオプションを見るには、https://dev.megaport.comを参照してください。
AWSポートの場所の詳細を検索
AWSにVXCを作成するには、AWSポートの詳細を知る必要があります。APIを使用してクラウドサービスプロバイダーとのMegaportのインターフェイスを返し、必要なAWSポートの詳細を特定します。
PostmanコレクションでAWSポートの場所の詳細を検索する方法
-
左ナビゲーションで Locations フォルダを展開し、GET Partner Megaports をクリックします。
-
Send をクリックしてAPIサーバーへのGETリクエストを実行します。
GET {baseUrl}/v2/dropdowns/partner/megaportsこのリクエストは、クラウドサービスプロバイダーとのMegaportのすべてのインターフェイスを返します。検索フィールドで虫眼鏡をクリックし、場所、データセンター、またはその他のパラメーターを入力して検索することができます。
connectTypeはクラウドサービスプロバイダーを示します。AWSにはHosted VIFの場合は「AWS」が含まれ、Hosted Connectionsの場合は「AWSHC」が含まれます。
結果を
connectTypeとvxcPermittedでフィルタリングできます。GET {baseUrl}/v2/dropdowns/partner/megaports?connectType=AWS&vxcPermitted=trueこの例では、Interxion DUB2のPortを使用し、VXCを受け入れている (
“vxcPermitted”: true)、eu-west-1リージョン内にあるPortを使用します。
{
"connectType": "AWS",
"productUid": "6cc21ccb-5ecc-4869-ab0e-b3fa17f5110f",
"vxcPermitted": true,
"companyUid": "623cb950-abb4-4b07-b372-8cf55756c322",
"companyName": "AWS",
"title": "EU (Ireland) (eu-west-1)",
"locationId": 96,
"speed": 10000,
"rank": 61,
"lag_id": 2,
"lag_primary": true,
"aggregation_id": 54188
},
VXC の作成と展開
GET Partner Megaports API から取得した AWS ポートの詳細を使用して、VXC の検証および作成ができます。
注文のテストと検証方法
-
Postman で左ナビゲーションの Cloud Connectivity > Port > AWS Direct Connect を展開し、POST Validate AWS - Hosted VIF (v3) を選択します。
-
リクエストの Body を、Port の
productUid、AWS ポートのproductUid、および AWS アカウント ID で更新します。
また、名前、レート制限、契約期間、VLAN ID、ASN 値、authKey、IP アドレス設定などの追加値も変更可能です。 -
Send をクリックしてリクエストを POST します。
POST {baseUrl}/v3/networkdesign/validate
[
{
"productUid": "a49cf3f1-20a1-4390-93aa-5005bdafe3d7",
"associatedVxcs": [
{
"productName": "My Amazon Direct Connect",
"rateLimit": "500",
"term": 12,
"shutdown": false,
"promoCode": "promox3mnthfree2",
"aEnd": {
"vlan": 777
},
"bEnd": {
"productUid": "6cc21ccb-5ecc-4869-ab0e-b3fa17f5110f",
"partnerConfig": {
"connectType": "AWS",
"name": "Amazon name for service",
"type": "private",
"asn": 65105,
"amazonAsn": 64555,
"ownerAccount": "XXXXXXXXXXXX",
"authKey": "123456",
"prefixes": "10.0.1.0/24",
"customerIpAddress": null,
"amazonIpAddress": null
}
}
}
]
}
]
検証が完了すると、VXC の注文準備が整います。
VXC を作成するには
-
POST Validate AWS - Hosted VIF (v3) から検証済みの Body をコピーし、POST Buy AWS - Hosted VIF (v3) の Body に貼り付けます。
-
Send をクリックしてリクエストを POST します。
POST {baseUrl}/v3/networkdesign/buy
以下は成功したレスポンスの例です。
{
"message": "VXC [47d6cc4d-6a1a-4301-b06c-cebb5f9b8f3e] created. ",
"terms": "このデータは、適切な使用ポリシー https://www.megaport.com/legal/acceptable-use-policy に準拠しています",
"data": [
{
"createDate": 1588868593704,
"vxcOrderId": 42328,
"payerMegaPortId": 68124,
"nonPayerMegaPortId": 52786,
"payerMegaPortName": "API Port",
"nonPayerMegaPortName": "EU (Ireland) (eu-west-1)",
"payerCompanyId": 2278,
"nonPayerCompanyId": 117,
"payerLocationId": 89,
"nonPayerLocationId": 96,
"salesId": null,
"payerCompanyName": "Megaport Lab",
"nonPayerCompanyName": "AWS",
"payerMegaPortNsId": 138231,
"nonPayerMegaPortNsId": 221182,
"payerVlanId": 777,
"nonPayerVlanId": 0,
"payerApproverName": "Paul McGuinness",
"payerApproverId": 12695,
"nonPayerApproverName": "Paul McGuinness",
"nonPayerApproverId": 12684,
"payerApproval": 1582268553574,
"nonPayerApproval": 1228868693614,
"fixedTerm": true,
"duration": 1,
"rollover": true,
"serviceName": "from API Port to EU (Ireland) (eu-west-1)",
"payerStatus": "APPROVED",
"nonPayerStatus": "APPROVED",
"speed": 500,
"distanceBand": "ZONE",
"intercapPath": "",
"awsId": null,
"promoCode": null,
"rateType": "MONTHLY",
"vxcJTechnicalServiceId": 57115,
"vxcJTechnicalServiceUid": "47d6cc4d-6a1a-4301-b06c-cebb5f9b8f3e",
"provisionDate": 1588868593517,
"orderType": "NEW",
"monthlyDiscountAmount": null,
"discountMonths": null,
"amazonDirectConnectConfigDto": {
"type": "private",
"asn": 65105,
"ownerAccount": "XXXXXXXXXXXX",
"authKey": "123456",
"customerIpAddress": null,
"amazonIpAddress": null,
"prefixes": "10.0.1.0/24",
"name": "Amazon name for service"
},
"amsixConnectConfigDto": null,
"webAirProvItem": null,
"sdrcProvItem": null,
"rate": null,
"setup": null,
"asn": null,
"bgpPassword": null,
"usageAlgorithm": "POST_PAID_HOURLY_SPEED_LONG_HAUL_VXC",
"costCentre": null,
"azureServiceKey": null,
"oracleVirtualCircuitId": null,
"serviceKey": null,
"connectType": "AWS",
"payerConfig": {},
"nonPayerConfig": {},
"attributeTags": {},
"fullyApproved": true
}
]
}
PortとVXCは、Megaport Portalに表示されます.
この例では、AWS Hosted VIFは、Direct Connect - Virtual Interfacesの下でAWSポータルアカウントに表示されます。アカウント保有者は、Virtual Interfaceを承諾し、Virtual Private GatewayまたはDirect Connect Gatewayに接続して、その後VPCに接続できます。