使用 API 在 MVE 与 AWS 之间创建 VXC
本文介绍从 MVE 到 AWS 创建 VXC 的 API 操作流程，包括如何查询 AWS 位置以及在指定 vNIC 上订购 VXC。
您可以为 MVE 设置两种类型的 AWS 连接：AWS 托管 VIF 和 AWS 托管连接（Hosted Connection）。
可以通过 connectType 属性区分合作伙伴位置支持的连接类型。托管 VIF 的 connectType=AWS，托管连接的 connectType=AWSHC。
MVE 到 AWS 的部署包括以下任务：
-
查找 AWS 位置详细信息
要创建到 AWS 的 VXC，您首先需要确定要连接的端口的
productUid。您可以使用
v2/dropdowns/partner/megaports端点查询连接 B 端的 AWS 位置。 -
创建并部署 VXC
在确定端口详细信息后，您可以从 MVE 向 AWS 创建 VXC。
配置详细信息在请求的 Body 中指定。需要指定的一些关键信息包括 MVE 的
productUid、AWS 端口的productUid，以及 AWS 账户 ID。
开始之前，请获取有效的访问令牌。有关详细信息，请参见 创建 API 密钥。
查找 AWS 位置详细信息
使用 API 查询要连接的端口的 productUid。响应包括可用端口的详细信息。您需要这些端口详细信息来创建 VXC。
在 API 响应中，能接受 VXC 的可用端口会显示为 “vxcPermitted”: true。
查找 AWS 位置详细信息的方法
-
展开左侧导航中的 Locations（位置） 文件夹，然后单击 GET Partner Megaports（获取合作伙伴 Megaports）。
-
单击 Send（发送），向 API 服务器发起 GET 请求。
GET {baseUrl}/v2/dropdowns/partner/megaports此请求会返回 Megaport 与各云服务提供商的所有接口。您可以单击放大镜图标，在搜索框中输入位置、数据中心或其他参数进行搜索。
connectType 表示云服务提供商。AWS 中，托管 VIF 的值为 “AWS”，托管连接的值为 “AWSHC”。
您可以通过
connectType和vxcPermitted来筛选结果。GET {baseUrl}/v2/dropdowns/partner/megaports?connectType=AWS&vxcPermitted=true此示例使用区域 eu-west-2（伦敦）中可接受 VXC 的一个端口（
“vxcPermitted”: true）。
{
"productUid": "b9dcbdca-b73a-4fc9-9ac9-98cecde81ba2",
"companyUid": "605cb850-dfb4-4a05-a171-8bf17757b3a2",
"companyName": "AWS",
"title": "EU (London) (eu-west-2)",
"locationId": 90,
"speed": 10000,
"maxVxcSpeed": 10000,
"vxcPermitted": true,
"diversityZone": null,
"rank": 378,
"lag_id": null,
"lag_primary": false,
"aggregation_id": null,
"connectType": "AWS"
},
创建和部署 VXC 托管 VIF
获取端口详细信息后，从 MVE 创建到 AWS 的 VXC。
您需要在请求的 Body 中指定配置详情。第一个 productUid 标识 MVE 的 ID，bEnd: productUid 标识来自合作伙伴 Megaport 查询的 AWS 端口位置。您还需在请求中提供您的 AWS 账号。
本示例使用托管 VIF 连接类型，connectType=AWS。
提示
若要在下订单前测试请求并查看价格详情，请使用 /v3/networkdesign/validate 端点，并采用相同的 Body 配置。
创建 VXC
-
使用 POST Buy AWS - Hosted VIF (v3) 端点创建请求：
POST {baseUrl}/v3/networkdesign/buy -
将 MVE 的
productUid、VXC 的名称、AWS 端口的productUid以及 AWS 账户 ID（ownerAccount）填入请求的 Body。
您还可以修改其他参数，例如速率限制、合同期限、VLAN ID、ASN 值、authKey 及 IP 地址配置。vNIC 由vNicIndex决定，innerVlan 用于标识 vNIC 内部运行的 VLAN 号，本例为 103。注意
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": "Test AWS VIF MVE VXC",
"rateLimit": "100",
"term": 12,
"shutdown": false,
"promoCode": "promox3mnthfree2",
"aEnd": {
"vNicIndex":2,
"vlan": null,
"innerVlan": 103
},
"bEnd": {
"productUid": "{{ awsPortUid }}",
"partnerConfig": {
"connectType": "AWS",
"Name": "Test Megaport",
"type": "private",
"asn": 65105,
"ownerAccount": "XXXXXXXXXXXX",
"authKey": "123455",
"customerIpAddress": null,
"amazonIpAddress": null
}
}
}
]
}
]
发送请求后，当 VXC 订购成功，您将收到成功响应。
以下为示例响应：
{
"message": "VXC [0d22feee-8d06-4041-98be-5b827c33c78a] created.",
"terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
"data": [
{
"createDate": 1709811450016,
"vxcOrderId": 139933,
"payerMegaPortId": 190079,
"nonPayerMegaPortId": 6199,
"payerMegaPortName": "MVE for VNIC config",
"nonPayerMegaPortName": "EU (London) (eu-west-2)",
"payerCompanyId": 1153,
"nonPayerCompanyId": 117,
"payerLocationId": 89,
"nonPayerLocationId": 89,
"salesId": null,
"payerCompanyName": "Megaport Lab",
"nonPayerCompanyName": "AWS",
"payerMegaPortNsId": 510708,
"nonPayerMegaPortNsId": 13055,
"payerVlanId": 0,
"nonPayerVlanId": 0,
"payerInnerVlanId": 103,
"nonPayerInnerVlanId": null,
"payerApproverName": "name",
"payerApproverId": number,
"nonPayerApproverName": "name",
"nonPayerApproverId": number,
"payerApproval": number,
"nonPayerApproval":number,
"fixedTerm": true,
"duration": 1,
"rollover": true,
"serviceName": "from MVE for VNIC config to EU (London) (eu-west-2)",
"payerStatus": "APPROVED",
"nonPayerStatus": "APPROVED",
"speed": 100,
"distanceBand": "METRO",
"intercapPath": "",
"awsId": null,
"promoCode": null,
"dealUid": null,
"rateType": "MONTHLY",
"vxcJTechnicalServiceId": 190085,
"vxcJTechnicalServiceUid": "0d22feee-8d06-4041-98be-5b827c33c78a",
"provisionDate": 1709811449985,
"orderType": "NEW",
"monthlyDiscountAmount": null,
"discountMonths": null,
"amazonDirectConnectConfigDto": {
"type": "private",
"asn": 65105,
"ownerAccount": "aws account ID",
"authKey": "123455",
"customerIpAddress": null,
"amazonIpAddress": null,
"prefixes": null,
"name": 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": "Test AWS VIF MVE VXC",
"name": "Test AWS VIF MVE VXC",
"secondaryName": null,
"technicalServiceId": 190085,
"technicalServiceUid": "0d22feee-8d06-4041-98be-5b827c33c78a",
"requestedDate": 1709811449985,
"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": 181633,
"billableUsageAlgorithm": null,
"productType": "VXC",
"provisioningStatus": "DEPLOYABLE",
"failedReason": null,
"inAdvanceBillingStatus": null,
"provisioningItems": [],
"tags": [],
"vxcDistanceBand": "METRO",
"intercapPath": "",
"marketplaceVisibility": true,
"vxcPermitted": true,
"vxcAutoApproval": false,
"createDate": 1709811450003,
"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": "AWS",
"payerConfig": {},
"nonPayerConfig": {},
"attributeTags": {},
"serviceLicense": null,
"originDomain": null,
"fullyApproved": true
}
]
}
VXC 现在会显示在 Megaport Portal 中。
对于本例，AWS 托管 VIF 将在 AWS 管理控制台账户下 Direct Connect - Virtual Interfaces 中显示。账户持有者可以接受虚拟接口，并将其连接到虚拟私有网关（Virtual Private Gateway）或 Direct Connect 网关，然后再绑定到他们的 VPC 上。
创建和部署 VXC 托管连接
获取端口详细信息后，从 MVE 创建到 AWS 的 VXC。
您需要在请求的 Body 中指定配置详情。第一个 productUid 标识 MVE 的 ID，bEnd: productUid 标识来自合作伙伴 Megaport 查询的 AWS 端口位置。您还需在请求中提供您的 AWS 账号。
本示例使用托管连接类型，connectType=AWSHC。
提示
若要在下订单前测试请求并查看价格详情，请使用 /v3/networkdesign/validate 端点，并采用相同的 Body 配置。
创建 VXC
-
使用 POST Buy AWS - Hosted Connection (v3) 端点创建请求：
POST {baseUrl}/v3/networkdesign/buy -
将 MVE 的
productUid、VXC 的名称、AWS 端口的productUid以及 AWS 账户 ID（ownerAccount）填入请求的 Body。
您还可以修改其他参数，例如速率限制、合同期限、VLAN ID、ASN 值、authKey 及 IP 地址配置。vNIC 由vNicIndex决定，innerVlan 用于标识 vNIC 内部运行的 VLAN 号，本例为 666。注意
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": "Test AWS over Vnic2",
"rateLimit": 100,
"term": 12,
"shutdown": false,
"promoCode": "promox3mnthfree2",
"aEnd": {
"vNicIndex":2,
"vlan":null,
"innerVlan":666
},
"bEnd": {
"productUid": "{{ awshcPortUid }}",
"partnerConfig": {
"connectType":"AWSHC",
"ownerAccount": "XXXXXXXXXXXX",
"name": "AWS link MVE link 2"
}
}
}
]
}
]
发送请求后，当VXC已被订购时，您将收到一个成功的响应。
以下是一个响应示例：
{
"message": "VXC [5668c467-17eb-47e3-beba-87b9e7784a17] created.",
"terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
"data": [
{
"createDate": 1709812459883,
"vxcOrderId": 139936,
"payerMegaPortId": 190079,
"nonPayerMegaPortId": 114147,
"payerMegaPortName": "MVE for VNIC config",
"nonPayerMegaPortName": "EU (London) (eu-west-2)",
"payerCompanyId": 1153,
"nonPayerCompanyId": 117,
"payerLocationId": 89,
"nonPayerLocationId": 90,
"salesId": null,
"payerCompanyName": "Megaport Lab",
"nonPayerCompanyName": "AWS",
"payerMegaPortNsId": 510708,
"nonPayerMegaPortNsId": 271398,
"payerVlanId": 0,
"nonPayerVlanId": 0,
"payerInnerVlanId": 666,
"nonPayerInnerVlanId": null,
"payerApproverName": "David Sloan",
"payerApproverId": 41315,
"nonPayerApproverName": "David Sloan",
"nonPayerApproverId": 41315,
"payerApproval": number,
"nonPayerApproval": number,
"fixedTerm": true,
"duration": 1,
"rollover": true,
"serviceName": "from MVE for VNIC config to EU (London) (eu-west-2)",
"payerStatus": "APPROVED",
"nonPayerStatus": "APPROVED",
"speed": 100,
"distanceBand": "METRO",
"intercapPath": "",
"awsId": null,
"promoCode": null,
"dealUid": null,
"rateType": "MONTHLY",
"vxcJTechnicalServiceId": 190089,
"vxcJTechnicalServiceUid": "5668c467-17eb-47e3-beba-87b9e7784a17",
"provisionDate": 1709812459853,
"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": "Test AWS over Vnic2",
"name": "Test AWS over Vnic2",
"secondaryName": null,
"technicalServiceId": 190089,
"technicalServiceUid": "5668c467-17eb-47e3-beba-87b9e7784a17",
"requestedDate": 1709812459853,
"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": 181637,
"billableUsageAlgorithm": null,
"productType": "VXC",
"provisioningStatus": "DEPLOYABLE",
"failedReason": null,
"inAdvanceBillingStatus": null,
"provisioningItems": [],
"tags": [],
"vxcDistanceBand": "METRO",
"intercapPath": "",
"marketplaceVisibility": true,
"vxcPermitted": true,
"vxcAutoApproval": false,
"createDate": 1709812459869,
"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": "AWSHC",
"payerConfig": {},
"nonPayerConfig": {},
"attributeTags": {},
"serviceLicense": null,
"originDomain": null,
"fullyApproved": true
}
]
}
现在，VXC 将显示在 Megaport Portal 中。
在此示例中，AWS 托管连接将显示在 AWS 门户账户的 Direct Connect - connection 下。账户持有人可以接受该托管连接，并创建一个私有 VIF、一个公有 VIF 或一个传输 VIF，将其连接到 Virtual Private Gateway、Direct Connect Gateway 或 Transit Gateway，然后再连接到其 VPC。