功能介紹
使用標(biāo)簽過濾實(shí)例。
調(diào)試
您可以在API Explorer中調(diào)試該接口,支持自動(dòng)認(rèn)證鑒權(quán)。API Explorer可以自動(dòng)生成SDK代碼示例,并提供SDK代碼示例調(diào)試功能。
URI
POST /v2.0/{project_id}/publicips/resource_instances/action
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
項(xiàng)目ID,獲取項(xiàng)目ID請(qǐng)參見獲取項(xiàng)目ID |
請(qǐng)求參數(shù)
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
tags |
否 |
包含標(biāo)簽,最多包含10個(gè)key。 每個(gè)key下面的value最多10個(gè),結(jié)構(gòu)體不能缺失,key不能為空或者空字符串。 Key不能重復(fù),同一個(gè)key中values不能重復(fù)。 |
|
|
limit |
否 |
Integer |
查詢記錄數(shù)(action為count時(shí)無此參數(shù))如果action為filter默認(rèn)為1000,limit最多為1000,不能為負(fù)數(shù),最小值為1 最小值:1 最大值:1000 |
|
offset |
否 |
Integer |
索引位置, 從offset指定的下一條數(shù)據(jù)開始查詢。 查詢第一頁數(shù)據(jù)時(shí),不需要傳入此參數(shù),查詢后續(xù)頁碼數(shù)據(jù)時(shí),將查詢前一頁數(shù)據(jù)時(shí)響應(yīng)體中的值帶入此參數(shù)(action為count時(shí)無此參數(shù))如果action為filter默認(rèn)為0,必須為數(shù)字,不能為負(fù)數(shù) 最小值:0 |
|
action |
是 |
String |
操作標(biāo)識(shí)(僅限于filter,count):filter(過濾),count(查詢總條數(shù)) 如果是filter就是分頁查詢,如果是count只需按照條件將總條數(shù)返回即可。 枚舉值:
|
|
matches |
否 |
搜索字段,key為要匹配的字段,當(dāng)前僅支持resource_name。value為匹配的值。此字段為固定字典值。 |
響應(yīng)參數(shù)
狀態(tài)碼: 200
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
resources |
resource對(duì)象列表 |
|
|
total_count |
Integer |
總記錄數(shù) |
請(qǐng)求示例
-
action為filter時(shí)請(qǐng)求體。
{ "offset" : 0, "limit" : 100, "action" : "filter", "matches" : [ { "key" : "resource_name", "value" : "resource1" } ], "tags" : [ { "key" : "key1", "values" : [ "value1", "value2" ] } ] } -
action為count時(shí)請(qǐng)求體。
{ "action" : "count", "tags" : [ { "key" : "key1", "values" : [ "value1", "value2" ] }, { "key" : "key2", "values" : [ "value1", "value2" ] } ], "matches" : [ { "key" : "resource_name", "value" : "resource1" } ] }
響應(yīng)示例
狀態(tài)碼: 200
GET操作正常返回
{
"total_count" : 1000,
"resources" : [ {
"resource_detail" : null,
"resource_id" : "cdfs_cefs_wesas_12_dsad",
"resource_name" : "resouece1",
"tags" : [ {
"value" : "value1",
"key" : "key1"
}, {
"value" : "value1",
"key" : "key2"
} ]
} ]
}
狀態(tài)碼
|
狀態(tài)碼 |
描述 |
|---|---|
|
200 |
GET操作正常返回 |
錯(cuò)誤碼
請(qǐng)參見錯(cuò)誤碼。
最新文章
- GaussDB標(biāo)簽_GaussDB數(shù)據(jù)庫(kù)標(biāo)簽_高斯數(shù)據(jù)庫(kù)標(biāo)簽_華為云
- 彈性公網(wǎng)IP有什么作用_彈性公網(wǎng)IP多少錢_如何切換彈性公網(wǎng)IP
- 什么是彈性公網(wǎng)IP_彈性公網(wǎng)IP有什么優(yōu)勢(shì)_彈性公網(wǎng)IP如何計(jì)費(fèi)
- 彈性公網(wǎng)的功能_華為云EIP是什么_彈性公網(wǎng)EIP怎么用
- EIP多少錢_低成本EIP_EIP有什么功能
- 彈性公網(wǎng)IP的作用是什么_如何切換彈性公網(wǎng)IP-華為云
