查詢共享帶寬詳情
更新時間 2023-07-19 13:58:47
最近更新時間: 2023-07-19 13:58:47
分享文章
接口功能介紹
調用此接口可查詢共享帶寬實例詳情。
接口約束
無。
URI
GET /v4/bandwidth/describe
請求參數
Query 參數
| 參數 | 參數類型 | 是否必填 | 說明 | 示例 |
|---|---|---|---|---|
| regionID | String | 是 | 共享帶寬所在的區域id | 81f7728662dd11ec810800155d307d5b |
| projectID | String | 否 | 企業項目 ID，默認為"0" | 0 |
| bandwidthID | String | 是 | 查詢的共享帶寬id。 | bandwidth-sjwu65pf9t |
響應參數
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| statusCode | Integer | 返回狀態碼（800為成功，900為失敗） | 800 |
| message | String | statusCode為900時的錯誤信息; statusCode為800時為success, 英文 | success |
| description | String | statusCode為900時的錯誤信息; statusCode為800時為成功, 中文 | 成功 |
| errorCode | String | statusCode為900時為業務細分錯誤碼，三段式：product.module.code; statusCode為800時為SUCCESS | SUCCESS |
| returnObj | Object | object | 返回查詢的共享帶寬詳細信息。 |
表 returnObj
| 參數 | 參數類型 | 示例 | 說明 |
|---|---|---|---|
| id | String | bandwidth-sjwu65pf9t | 共享帶寬id。 |
| status | String | 共享帶寬狀態: ACTIVE / EXPIRED / FREEZING | ACTIVE |
| bandwidth | int | 5 | 共享帶寬的帶寬峰值， 單位：Mbps。 |
| name | String | share_ip_069f | 共享帶寬名稱。 |
| eips | Array of Objects | 綁定的彈性 IP 列表 ｜ 見下表 |
表 eips
| 參數 | 參數類型 | 示例 | 說明 |
|---|---|---|---|
| ip | String | 100.124.10.1 | 彈性 IP 的 IP |
| eipID | String | eip-ieeq36299f | 彈性 IP 的 ID |
請求示例
GET /v4/bandwidth/describe?regionID=81f7728662dd11ec810800155d307d5b&bandwidthID=bandwidth-sjwu65pf9t
請求體body
無。
響應示例
{
"statusCode": 800,
"errorCode": "SUCCESS",
"message": "success",
"description": "成功",
"returnObj": {
"id": "bandwidth-sjwu65pf9t",
"status": "ACTIVE",
"bandwidth": 5,
"name": "share_ip_069f",
"eips": [
{
"ip": "100.124.10.1",
"eipID": "eip-ieeq36299f"
}
]
}
}
狀態碼
| 狀態碼 | 描述 |
|---|---|
| 200 | 表示請求成功。 |
錯誤碼
請參考 錯誤碼說明。
