使用 API 在 MVE 與 Google Cloud 之間建立 VXC
本主題說明使用 API 將 MVE 連線到 Google Cloud 服務以建立 VXC 的流程。設定分為兩個步驟：首先，使用 Google 配對金鑰查詢連線詳細資料，接著在 MVE 上的特定 vNIC 建立 VXC。
備註
在建立連線到 Google Cloud 之前，必須先在 Google Cloud Console 或 gcloud CLI 建立 Partner Interconnect 附掛。建立附掛時會提供一組配對金鑰，其中包含 Google 連線詳細資料。
MVE 部署連線到 Google Cloud 包含以下工作：
-
在 Google Cloud Console 或 gcloud CLI 建立 Partner Interconnect 附掛
在 Google Cloud Console 或 gcloud CLI 建立 Partner Interconnect 附掛。複製在建立附掛時所提供的配對金鑰。
如需更多詳細資料，請參閱 Google 文件
Google Partner Interconnects。 -
驗證 Google 配對金鑰
在訂購 Google Cloud 服務時，請使用配對金鑰，並確認有可供連線的可用連接埠。
Google 要求 VXC 的頻寬必須符合配對金鑰查詢所回傳清單中的其中一個預先定義頻寬。
-
建立並部署 VXC
使用已驗證的配對金鑰與連接埠詳細資料，從 MVE 建立至 Google Cloud 的 VXC。
設定詳細資料需在要求的 Body 中指定。
開始之前，請先取得有效的存取權杖。詳細資訊請參閱建立 API 金鑰。
驗證 Google 配對金鑰
使用 API 驗證 Google Cloud 配對金鑰。回應包含相關連接埠與對等端的詳細資料。您需要連接埠詳細資料來建立 VXC。
在 API 回應中，可用的連接埠會列為 "vxc":null，而具有指派值的連接埠則不可用。
Google 要求 VXC 的頻寬必須符合配對金鑰查詢所回傳清單中的其中一個預先定義頻寬。
驗證配對金鑰
-
使用 GET Look Up Google Pairing Key (查詢 Google 配對金鑰) API，透過配對金鑰查詢 Google Cloud 位置詳細資料：
GET {baseUrl}/v2/secure/google/{pairing_key}
以下範例回應顯示具有可用連接埠的配對金鑰（vxc = null）。
{
"message": "查詢成功",
"terms": "本資料受可接受使用政策約束 https://www.megaport.com/legal/acceptable-use-policy",
"data": {
"bandwidths": [
50,
100,
200,
300,
400,
500,
1000,
2000,
5000,
10000,
20000,
50000
],
"megaports": [
{
"productId": 28845,
"productUid": "5b693428-8cc6-4634-a44a-2e9e6ba556af",
"name": "Stockholm (arn-zone1-208)",
"nServiceId": 65391,
"description": "Google inc.. 於 Interxion STO5",
"companyId": 90,
"companyUid": "29ba879b-45c8-48eb-bd97-618d0f20ea04",
"companyName": "Google inc..",
"portSpeed": 10000,
"locationId": 98,
"state": null,
"country": "Sweden",
"port": 28845,
"vxc": null
},
{
"productId": 45873,
"productUid": "832a017d-74ca-45e8-a225-e3d794a079d7",
"name": "Zurich (zrh-zone1-81)",
"nServiceId": 103010,
"description": "Google inc.. 於 Interxion ZH1",
"companyId": 90,
"companyUid": "{{ companyUid }}",
"companyName": "Google inc..",
"portSpeed": 10000,
"locationId": 557,
"state": null,
"country": "Switzerland",
"port": 45873,
"vxc": null
},
{
"productId": 81531,
"productUid": "6e587057-f012-4600-896f-9ee171fdd444",
"name": "Frankfurt (fra-zone1-683)",
"nServiceId": 181786,
"description": "Google inc.. 於 Equinix FR5",
"companyId": 90,
"companyUid": "{{ companyUid }}",
"companyName": "Google inc..",
"portSpeed": 100000,
"locationId": 131,
"state": null,
"country": "Germany",
"port": 81531,
"vxc": null
},
{
"productId": 84769,
"productUid": "f25e581b-3c0e-4069-8147-78cce082357e",
"name": "Amsterdam (ams-zone1-1236)",
"nServiceId": 188925,
"description": "Google inc.. 於 Equinix AM1",
"companyId": 90,
"companyUid": "29ba879b-45c8-48eb-bd97-618d0f20ea04",
"companyName": "Google inc..",
"portSpeed": 100000,
"locationId": 85,
"state": null,
"country": "Netherlands",
"port": 84769,
"vxc": null
},
{
"productId": 95335,
"productUid": "9fde43f5-2f00-41ed-bb60-45c446ea43df",
"name": "London (lhr-zone1-832)",
"nServiceId": 217347,
"description": "Google inc.. 於 Equinix LD5",
"companyId": 90,
"companyUid": "29ba879b-45c8-48eb-bd97-618d0f20ea04",
"companyName": "Google inc..",
"portSpeed": 100000,
"locationId": 90,
"state": null,
"country": "United Kingdom",
"port": 95335,
"vxc": null
},
{
"productId": 153623,
"productUid": "ae8d21b5-2db6-4f72-a465-624c914f4918",
"name": "Paris (cdg-zone1-1536)",
"nServiceId": 391882,
"description": "Google inc.. 於 Interxion PAR5",
"companyId": 90,
"companyUid": "29ba879b-45c8-48eb-bd97-618d0f20ea04",
"companyName": "Google inc..",
"portSpeed": 100000,
"locationId": 527,
"state": null,
"country": "France",
"port": 153623,
"vxc": null
},
{
"productId": 162678,
"productUid": "7d1cca03-eb3d-4be4-a145-de8e8dffec3f",
"name": "Frankfurt (fra-zone1-58)",
"nServiceId": 420550,
"description": "Google inc.. 於 Interxion FRA6",
"companyId": 90,
"companyUid": "29ba879b-45c8-48eb-bd97-618d0f20ea04",
"companyName": "Google inc..",
"portSpeed": 100000,
"locationId": 130,
"state": null,
"country": "Germany",
"port": 162678,
"vxc": null
}
],
"resource_type": "csp_connection",
"ports": [
{
"service_id": 38286,
"vxc_service_ids": []
},
{
"service_id": 65391,
"vxc_service_ids": []
},
{
"service_id": 103010,
"vxc_service_ids": []
},
{
"service_id": 125905,
"vxc_service_ids": []
},
{
"service_id": 154694,
"vxc_service_ids": []
},
{
"service_id": 181786,
"vxc_service_ids": []
},
{
"service_id": 188925,
"vxc_service_ids": []
},
{
"service_id": 217347,
"vxc_service_ids": []
},
{
"service_id": 391882,
"vxc_service_ids": []
},
{
"service_id": 420550,
"vxc_service_ids": []
}
]
}
}
建立並部署 VXC 至指定 vNIC
利用已驗證的配對金鑰和通訊埠詳細資料，從 MVE 建立連接至 Google Cloud 的 VXC。
您需要在請求的 Body 中指定組態詳細資訊。第一個 productUid 標示 MVE 的 ID，而 bEnd: productUid 則標示配對金鑰中的 Google Cloud 位置。您還需要在請求中提供您的 Google 配對金鑰。僅需指定 aEnd 的 innerVlan。
提示
若要在下單前測試您的請求並查看價格明細，請使用相同 Body 組態呼叫 /v3/networkdesign/validate 端點。
建立 VXC
-
以 POST 建立 VXC 至 Google Cloud（v3） 端點建立請求：
POST {baseUrl}/v3/networkdesign/buy -
在請求的 Body 中，填入 MVE 的
productUid、VXC 的名稱、Google Cloud port 的productUid，將vNicIndex設為 2（介面 3）以及配對金鑰。備註
vNIC 編號對應至以下 MVE 介面：
- vNIC 0 = 在 MVE 上的介面 1
- vNIC 1 = 在 MVE 上的介面 2
- vNIC 2 = 在 MVE 上的介面 3
- vNIC 3 = 在 MVE 上的介面 4
- vNIC 4 = 在 MVE 上的介面 5
以下是一個範例請求：
[
{
"productUid": "{{ mveid }}",
"associatedVxcs": [
{
"productName": "VXC to test VNIC",
"rateLimit": 100,
"term": 12,
"shutdown": false,
"promoCode": "promox3mnthfree2",
"aEnd": {
"vNicIndex":2,
"innerVlan": 144
},
"bEnd": {
"productUid" : "{{ googleProductUid }}",
"partnerConfig": {
"connectType": "GOOGLE",
"pairingKey": "{{ googlePairingKey }}"
}
}
}
]
}
]
完成並部署 VXC 之後，請回到 Google Cloud Console 並接受這個掛載。
發送請求後，當 VXC 訂購成功時，您將收到成功回應。
以下是一個範例回應：
{
"message": "VXC [27139b23-0afe-4e48-9322-eea95d2d6b74] 已建立。",
"terms": "本資料受可接受使用政策約束 https://www.megaport.com/legal/acceptable-use-policy",
"data": [
{
"createDate": 1709823461856,
"vxcOrderId": 139952,
"payerMegaPortId": 190079,
"nonPayerMegaPortId": 95335,
"payerMegaPortName": "MVE for VNIC config",
"nonPayerMegaPortName": "London (lhr-zone1-832)",
"payerCompanyId": 1153,
"nonPayerCompanyId": 90,
"payerLocationId": 89,
"nonPayerLocationId": 90,
"salesId": null,
"payerCompanyName": "Megaport Lab",
"nonPayerCompanyName": "Google inc..",
"payerMegaPortNsId": 510708,
"nonPayerMegaPortNsId": 217347,
"payerVlanId": 0,
"nonPayerVlanId": 0,
"payerInnerVlanId": 144,
"nonPayerInnerVlanId": null,
"payerApproverName": "David Sloan",
"payerApproverId": 41315,
"nonPayerApproverName": "David Sloan",
"nonPayerApproverId": 41315,
"payerApproval": 1709823461831,
"nonPayerApproval": 1709823461850,
"fixedTerm": true,
"duration": 1,
"rollover": true,
"serviceName": "from MVE for VNIC config to London (lhr-zone1-832)",
"payerStatus": "APPROVED",
"nonPayerStatus": "APPROVED",
"speed": 100,
"distanceBand": "METRO",
"intercapPath": "",
"awsId": null,
"promoCode": null,
"dealUid": null,
"rateType": "MONTHLY",
"vxcJTechnicalServiceId": 190111,
"vxcJTechnicalServiceUid": "27139b23-0afe-4e48-9322-eea95d2d6b74",
"provisionDate": 1709823461826,
"orderType": "NEW",
"monthlyDiscountAmount": null,
"discountMonths": null,
"amazonDirectConnectConfigDto": null,
"amsixConnectConfigDto": null,
"sdrcProvItem": null,
"rate": null,
"setup": null,
"asn": null,
"bgpPassword": null,
"usageAlgorithm": "POST_PAID_HOURLY_SPEED_METRO_VXC",
"costCentre": null,
"azureServiceKey": null,
"oracleVirtualCircuitId": null,
"serviceKey": null,
"vxc": {
"serviceName": "VXC to test VNIC",
"name": "VXC to test VNIC",
"secondaryName": null,
"technicalServiceId": 190111,
"technicalServiceUid": "27139b23-0afe-4e48-9322-eea95d2d6b74",
"requestedDate": 1709823461826,
"configuredDate": null,
"currentEstimatedDelivery": null,
"companyName": "Megaport Lab",
"companyId": 1153,
"billingContactName": null,
"billingContactId": null,
"adminContactName": null,
"adminContactId": null,
"technicalContactName": null,
"technicalContactId": null,
"salesName": null,
"salesId": null,
"billableId": 181659,
"billableUsageAlgorithm": null,
"productType": "VXC",
"provisioningStatus": "DEPLOYABLE",
"failedReason": null,
"inAdvanceBillingStatus": null,
"provisioningItems": [],
"tags": [],
"vxcDistanceBand": "METRO",
"intercapPath": "",
"marketplaceVisibility": true,
"vxcPermitted": true,
"vxcAutoApproval": false,
"createDate": 1709823461844,
"terminationDate": null,
"contractStartDate": null,
"contractTermMonths": 1,
"rateType": "MONTHLY",
"trialAgreement": false,
"payerCompanyId": null,
"nonPayerCompanyId": null,
"minimumSpeed": null,
"maximumSpeed": null,
"rateLimit": 100,
"errorMessage": null,
"lagId": null,
"aggregationId": null,
"lagPrimary": null,
"market": "UK",
"accountManager": null,
"promptUid": null,
"components": [],
"attributes": [],
"aLocation": null,
"bLocation": null,
"aMetro": null,
"aCountry": null,
"aLocationId": null,
"bLocationId": null,
"bMetro": null,
"bCountry": null,
"attributeTags": {},
"createdBy": "b0dedbd2-ecc7-4bad-a13b-6c34b4005115",
"buyoutPort": null,
"virtual": false,
"locked": false,
"adminLocked": false,
"bgpShutdownDefault": false,
"originDomain": null
},
"connectType": "GOOGLE",
"payerConfig": {},
"nonPayerConfig": {},
"attributeTags": {},
"serviceLicense": null,
"originDomain": null,
"fullyApproved": true
}
]
}