華為云計(jì)算 云知識(shí) 刪除標(biāo)簽DeleteScalingTagInfo
刪除標(biāo)簽DeleteScalingTagInfo

 

功能介紹

創(chuàng)建或刪除指定資源的標(biāo)簽。

每個(gè)伸縮組最多添加10個(gè)標(biāo)簽。

調(diào)試

您可以在API Explorer中調(diào)試該接口。

URI

POST /autoscaling-api/v1/{project_id}/{resource_type}/{resource_id}/tags/action

表1 參數(shù)說(shuō)明

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

項(xiàng)目ID

resource_type

String

資源類型,枚舉類:

scaling_group_tag:資源類型為伸縮組。

resource_id

String

資源ID

請(qǐng)求參數(shù)

表2 請(qǐng)求參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

tags

Array of ResourceTag objects

標(biāo)簽列表。詳情請(qǐng)見(jiàn)表 ResourceTag字段數(shù)據(jù)結(jié)構(gòu)說(shuō)明。

action為delete時(shí),tags結(jié)構(gòu)體不能缺失,key不能為空,或者空字符串。

action

String

操作標(biāo)識(shí)(區(qū)分大小寫):

  • delete:刪除。
  • create:創(chuàng)建。若已經(jīng)存在相同的key值則會(huì)覆蓋對(duì)應(yīng)的value值。
表3 ResourceTag字段數(shù)據(jù)結(jié)構(gòu)說(shuō)明

參數(shù)

是否必選

參數(shù)類型

描述

key

String

資源標(biāo)簽鍵。同一資源的key值不能重復(fù)。

  • 最大長(zhǎng)度36個(gè)字符。字符集:A-Z,a-z,0-9,‘-’,‘_’,UNICODE字符(\u4E00-\u9FFF)。
  • action為delete時(shí),不校驗(yàn)標(biāo)簽字符集,最大長(zhǎng)度127個(gè)Unicode字符。

value

String

資源標(biāo)簽值。

  • 每個(gè)值最大長(zhǎng)度43個(gè)字符,可以為空字符串。字符集:A-Z,a-z,0-9,‘.’,‘-’,‘_’,UNICODE字符(\u4E00-\u9FFF)。
  • action為delete時(shí),不校驗(yàn)標(biāo)簽字符集,每個(gè)值最大長(zhǎng)度255個(gè)Unicode字符。如果value有值按照key/value刪除,如果value沒(méi)值,則按照key刪除。

請(qǐng)求示例

創(chuàng)建資源標(biāo)簽,在ID為e5d27f5c-dd76-4a61-b4bc-a67c5686719a的伸縮組下,一組資源鍵值對(duì)為key=ENV15,value=ENV15,另一組資源鍵值對(duì)key=ENV151,value=ENV151。

POST https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_group_tag/e5d27f5c-dd76-4a61-b4bc-a67c5686719a/tags/action

{ 
  "tags": [
    { 
        "key": "ENV15", 
        "value": "ENV15" 
    }, 
    { 
        "key": "ENV151", 
        "value": "ENV151" 
    }
    ], 
  "action": "create" 
}

響應(yīng)參數(shù)

無(wú)

響應(yīng)示例

無(wú)

返回值

  • 正常

    204

  • 異常

    返回值

    說(shuō)明

    400 Bad Request

    服務(wù)器未能處理請(qǐng)求。

    401 Unauthorized

    被請(qǐng)求的頁(yè)面需要用戶名和密碼。

    403 Forbidden

    對(duì)被請(qǐng)求的頁(yè)面訪問(wèn)禁止。

    404 Not Found

    服務(wù)器無(wú)法找到被請(qǐng)求的頁(yè)面。

    405 Method Not Allowed

    請(qǐng)求中指定的方法不被允許。

    406 Not Acceptable

    服務(wù)器生成的響應(yīng)無(wú)法被客戶端所接受。

    407 Proxy Authentication Required

    用戶必須首先使用代理服務(wù)器進(jìn)行驗(yàn)證,這樣請(qǐng)求才會(huì)被處理。

    408 Request Timeout

    請(qǐng)求超出了服務(wù)器的等待時(shí)間。

    409 Conflict

    由于沖突,請(qǐng)求無(wú)法被完成。

    500 Internal Server Error

    請(qǐng)求未完成,服務(wù)異常。

    501 Not Implemented

    請(qǐng)求未完成,服務(wù)器不支持所請(qǐng)求的功能。

    502 Bad Gateway

    請(qǐng)求未完成,服務(wù)器從上游服務(wù)器收到一個(gè)無(wú)效的響應(yīng)。

    503 Service Unavailable

    請(qǐng)求未完成,系統(tǒng)暫時(shí)異常。

    504 Gateway Timeout

    網(wǎng)關(guān)超時(shí)。

錯(cuò)誤碼

請(qǐng)參考錯(cuò)誤碼。