資源列表查詢：彈性IP
更(geng)新時間 2023-07-19 11:41:00
最近更新時間: 2023-07-19 11:41:00
分享(xiang)文(wen)章
接口功能介紹
調用此接口可根(gen)據篩選條件查詢資源池下彈性ip的列(lie)表。
接口約束
regionID（資(zi)源池）存在(zai)。
URI
GET /v4/monitor/query-eip-list
請求參數
Query參數
| 參數 | 參數類型 | 是否必填 | 示例 | 說明 | 下級對象 |
|---|---|---|---|---|---|
| regionID | String | 是 | 81f7728662dd11ec810800155d307d5b | 資源池ID | |
| pageNo | Integer | 否 | 1 | 頁碼，默認為1 | |
| page | Integer | 否 | 1 | 頁碼，默認為1，建議使用pageNo，該參數后續會下線 | |
| pageSize | Integer | 否 | 1 | 頁大小，默認為10 |
響應參數
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| statusCode | Integer | 返回狀態碼（800為成功，900為失敗），默認值：800 | 800 | |
| errorCode | String | 失敗時的錯誤代碼，參見公共錯誤碼說明 | ||
| message | String | 失敗時的錯誤描述，一般為英文描述 | Success | |
| msgDesc | String | 失敗時的錯誤描述，一般為中文描述 | 成功 | |
| returnObj | Object | 返回對象 | returnObj |
表(biao)returnObj
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| eipList | Array of Objects | 彈性ip資源列表 | eip | |
| totalCount | Integer | 獲取對象數據條數 | 138 | |
| totalPage | Integer | 總頁數 | 1 | |
| currentCount | Integer | 當前頁記錄數 | 2 | |
| page | Integer | 頁碼，建議參考請求參數pageNo，該參數后續會下線 | 1 | |
| pageSize | Integer | 頁大小，建議參考請求參數pageSize，該參數后續會下線 | 10 |
表eip
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| instanceID | String | 彈性ip實例ID | eip-48rej8i7s6 | |
| instanceName | String | 彈性ip實例名稱 | eip-9ed7 | |
| deviceUUID | String | 唯一標識ID | eip-48rej8i7s6 | |
| IP | String | 彈性ip地址 | 100.124.2.99 |
請求示例
GET /v4/monitor/query-eip-list?regionID=81f7728662dd11ec810800155d307d5b&page=1&pageSize=5
響應示例
{
"statusCode":800,
"returnObj":{
"eipList":[
{
"instanceID":"eip-48rej8i7s6",
"instanceName":"eip-9ed7",
"deviceUUID":"eip-48rej8i7s6",
"ipAddress":"100.124.2.99"
},
{
"instanceID":"eip-u14qi19bpj",
"instanceName":"eip-fa21",
"deviceUUID":"eip-u14qi19bpj",
"ipAddress":"100.124.1.166"
},
{
"instanceID":"eip-0fxol66mk0",
"instanceName":"eip-97db",
"deviceUUID":"eip-0fxol66mk0",
"ipAddress":"100.124.1.165"
},
{
"instanceID":"eip-bfq723ce5u",
"instanceName":"eip-2f84",
"deviceUUID":"eip-bfq723ce5u",
"ipAddress":"100.124.1.164"
},
{
"instanceID":"eip-wb8cmg81xp",
"instanceName":"eip-be96",
"deviceUUID":"eip-wb8cmg81xp",
"ipAddress":"100.124.1.27"
}
],
"totalCount":14,
"totalPage":3,
"currentCount":5,
"page":1,
"pageSize":5
},
"errorCode":"",
"message":"Success",
"msgDesc":"成功"
}
狀態碼
| 狀態碼 | 描述 |
|---|---|
| 200 | 請求成功 |
錯誤碼
| errorCode | 描述 |
|---|---|
| 其他 | 參見公共錯誤碼說明 |
