功能介紹
為指定實(shí)例批量添加或刪除標(biāo)簽 標(biāo)簽管理服務(wù)需要使用該接口批量管理實(shí)例的標(biāo)簽。 一個(gè)資源上最多有10個(gè)標(biāo)簽。 此接口為冪等接口： 創(chuàng)建時(shí)如果請(qǐng)求體中存在重復(fù)key則報(bào)錯(cuò)。 創(chuàng)建時(shí)，不允許重復(fù)key，如果 數(shù)據(jù)庫(kù) 存在就覆蓋。 刪除時(shí)，允許重復(fù)key。 刪除時(shí)，如果刪除的標(biāo)簽不存在，默認(rèn)處理成功,刪除時(shí)不對(duì)標(biāo)簽字符集范圍做校驗(yàn)。key長(zhǎng)度127個(gè)字符，value為255個(gè)字符。刪除時(shí)tags結(jié)構(gòu)體不能缺失，key不能為空，或者空字符串。
調(diào)試
您可以在API Explorer中調(diào)試該接口，支持自動(dòng)認(rèn)證鑒權(quán)。API Explorer可以自動(dòng)生成SDK代碼示例，并提供SDK代碼示例調(diào)試功能。
URI
POST /v3/{project_id}/vault/{vault_id}/tags/action
|
參數(shù) |
是否必選 |
參數(shù)類(lèi)型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
項(xiàng)目id |
|
vault_id |
是 |
String |
資源id |
請(qǐng)求參數(shù)
|
參數(shù) |
是否必選 |
參數(shù)類(lèi)型 |
描述 |
|---|---|---|---|
|
tags |
否 |
標(biāo)簽列表。 tags不允許為空列表。 tags中最多包含10個(gè)key。 tags中key不允許重復(fù)。 |
|
|
sys_tags |
否 |
系統(tǒng)標(biāo)簽列表。 op_service權(quán)限可以訪問(wèn)，和tags二選一。 目前TMS調(diào)用時(shí)只包含一個(gè)resource_tag結(jié)構(gòu)體 ，key固定為：_sys_enterprise_project_id。 value是UUID或0,value為0表示默認(rèn)企業(yè)項(xiàng)目。 現(xiàn)在僅支持create操作。 |
|
|
action |
是 |
String |
操作標(biāo)識(shí)：僅限于create（創(chuàng)建）、delete（刪除） 枚舉值：
|
|
參數(shù) |
是否必選 |
參數(shù)類(lèi)型 |
描述 |
|---|---|---|---|
|
key |
是 |
String |
鍵。 key最大長(zhǎng)度為36個(gè)字符。 key不能為空字符串。 key前后空格會(huì)被丟棄。 key不能包含非打印字符ASCII(0-31)，“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。 key只能由中文，字母，數(shù)字，“-”，“_”組成。 |
|
value |
是 |
String |
值。 添加標(biāo)簽時(shí)value值必選，刪除標(biāo)簽時(shí)value值可選。 value最大長(zhǎng)度為43個(gè)字符。 value可以為空字符串。 value前后的空格會(huì)被丟棄。 value不能包含非打印字符ASCII(0-31)，“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。 value只能由中文，字母，數(shù)字，“-”，“_”，“.”組成。 |
響應(yīng)參數(shù)
狀態(tài)碼： 400
|
參數(shù) |
參數(shù)類(lèi)型 |
描述 |
|---|---|---|
|
error_code |
String |
請(qǐng)參見(jiàn)錯(cuò)誤碼。 |
|
error_msg |
String |
錯(cuò)誤信息 |
請(qǐng)求示例
批量創(chuàng)建tag
POST https://{endpoint}/v3/{project_id}/vault/{vault_id}/tags/action
{
"tags" : [ {
"key" : "string",
"value" : "string"
}, {
"key" : "string1",
"value" : "string2"
} ],
"action" : "create"
}
響應(yīng)示例
無(wú)
狀態(tài)碼
|
狀態(tài)碼 |
描述 |
|---|---|
|
204 |
No Content |
|
400 |
Bad Request |
錯(cuò)誤碼
請(qǐng)參見(jiàn)錯(cuò)誤碼。
最新文章
- GaussDB標(biāo)簽_GaussDB數(shù)據(jù)庫(kù)標(biāo)簽_高斯數(shù)據(jù)庫(kù)標(biāo)簽_華為云
- 華為云CodeArts API_批量添加請(qǐng)求體參數(shù)
- 數(shù)據(jù)庫(kù)安全服務(wù)添加數(shù)據(jù)庫(kù)_數(shù)據(jù)庫(kù)安全服務(wù)添加Agent_數(shù)據(jù)庫(kù)安全服務(wù)添加安全組規(guī)則
- CDN怎么添加_添加CDN加速域名
- 數(shù)據(jù)庫(kù)安全服務(wù)配置審計(jì)規(guī)則_數(shù)據(jù)庫(kù)安全服務(wù)添加審計(jì)范圍_數(shù)據(jù)庫(kù)安全服務(wù)添加風(fēng)險(xiǎn)操作
- 云備份_云備份功能_云備份在哪里打開(kāi)