Azure 服务密钥 API 响应字段
本主题展示了对 Azure 服务密钥查询请求的响应，并说明了响应字段。
GET {baseUrl}/v2/secure/azure/{service_key}
{
"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"
}
]
}
}
这些表描述了响应中的每个字段。
| Attribute | Description | Values |
|---|---|---|
| managed | 指示 Megaport 是否管理对等体信息 | true/false |
| connectType | AZURE | |
| resource_type | csp_connection | |
| bandwidth | 在 Azure 门户中 ExpressRoute 配置所设置的带宽 | • 50 Mbps • 100 Mbps • 200 Mbps • 500 Mbps • 1 Gbps • 2 Gbps • 5 Gbps • 10 Gbps 有关更多信息，请参阅 Microsoft 帮助主题 bandwidth options。 |
| service_key | 服务密钥的 ID | UUID |
| vlan | VLAN ID | |
| megaports | 包含 Megaport 详细信息的数组，其中包括已附加的 VXC。该数组包含主用和备用端口的信息。 | 有关详细信息，请参阅 Ports (端口) 表（如下）。 |
| peers | 对等体信息的数组，最多包含两个：private 和 microsoft。未配置对等体时，将不会出现。 | 有关详细信息，请参阅 Peers (对等体) 表（如下）。 |
端口
| Attribute | Description |
|---|---|
| portSpeed | Port 的速率：1000、10000 或 100000 Mbps |
| name | Port 的名称 |
| state | Port 的位置（州） |
| description | Port 的描述 |
| productUid | Port 的 UUID——用于订购 |
| nServiceId | 由 Megaport 使用 |
| companyUid | 由 Megaport 使用 |
| country | Port 的位置（国家） |
| vxc | 与此密钥/Port 组合关联的 VXC 的数字 ID。未配置 VXC 时为 Null |
| port | Port 的数字 ID |
| companyName | 拥有该 Port 的公司名称 |
| locationId | 此 Port 所在位置的 ID |
| productId | 与 Port 相同 |
| companyId | 公司的数字 ID |
对等体
对于 Port，可通过 Azure 门户配置 Peering。配置完成后，Peering 详细信息会显示在响应中。
对于 MCR，可以通过 API 设置 Peering 类型，Megaport 会自动配置 BGP 详细信息。 配置完成后，这些 Peering 详细信息会显示在服务密钥验证响应中。
| Attribute | Description | Values |
|---|---|---|
| peer_asn | 对等体的 ASN | 有效的 ASN（请勿使用 65515） |
| shared_key | 共享 BGP 密钥 | Null 或最多 25 个字母数字字符 |
| prefixes | IP 地址前缀 | 与主用和备用子网关联的公共 IP 地址前缀的逗号分隔列表——仅在 Microsoft Peering 中出现。 |
| primary_subnet | 与此对等体类型关联的主用 IP 子网。 | IP 前缀 |
| secondary_subnet | 与此对等体类型关联的备用 IP 子网。 | IP 前缀 |
| vlan | 与此对等体类型关联的内部 VLAN | int |
| type | Peering 类型 | microsoft 或 private |