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"
}
]
}
}
以下表格說明回應中的各個欄位。
| 屬性 | 說明 | 值 |
|---|---|---|
| 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 (對等端) 表格（如下）。 |
Ports
| 屬性 | 說明 |
|---|---|
| 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 詳細資料會出現在服務金鑰驗證回應中。
| 屬性 | 說明 | 值 |
|---|---|---|
| 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 or private |