華為云計算 云知識 創(chuàng)建標簽CreateScalingTagInfo
創(chuàng)建標簽CreateScalingTagInfo

 

功能介紹

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

每個伸縮組最多添加10個標簽。

調(diào)試

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

URI

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

表1 參數(shù)說明

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

項目ID

resource_type

String

資源類型,枚舉類:

scaling_group_tag:資源類型為伸縮組。

resource_id

String

資源ID

請求參數(shù)

表2 請求參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

tags

Array of ResourceTag objects

標簽列表。詳情請見表 ResourceTag字段數(shù)據(jù)結(jié)構(gòu)說明。

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

action

String

操作標識(區(qū)分大小寫):

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

參數(shù)

是否必選

參數(shù)類型

描述

key

String

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

  • 最大長度36個字符。字符集:A-Z,a-z,0-9,‘-’,‘_’,UNICODE字符(\u4E00-\u9FFF)。
  • action為delete時,不校驗標簽字符集,最大長度127個Unicode字符。

value

String

資源標簽值。

  • 每個值最大長度43個字符,可以為空字符串。字符集:A-Z,a-z,0-9,‘.’,‘-’,‘_’,UNICODE字符(\u4E00-\u9FFF)。
  • action為delete時,不校驗標簽字符集,每個值最大長度255個Unicode字符。如果value有值按照key/value刪除,如果value沒值,則按照key刪除。

請求示例

創(chuàng)建資源標簽,在ID為e5d27f5c-dd76-4a61-b4bc-a67c5686719a的伸縮組下,一組資源鍵值對為key=ENV15,value=ENV15,另一組資源鍵值對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ù)

響應(yīng)示例

返回值

  • 正常

    204

  • 異常

    返回值

    說明

    400 Bad Request

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

    401 Unauthorized

    被請求的頁面需要用戶名和密碼。

    403 Forbidden

    對被請求的頁面訪問禁止。

    404 Not Found

    服務(wù)器無法找到被請求的頁面。

    405 Method Not Allowed

    請求中指定的方法不被允許。

    406 Not Acceptable

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

    407 Proxy Authentication Required

    用戶必須首先使用代理服務(wù)器進行驗證,這樣請求才會被處理。

    408 Request Timeout

    請求超出了服務(wù)器的等待時間。

    409 Conflict

    由于沖突,請求無法被完成。

    500 Internal Server Error

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

    501 Not Implemented

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

    502 Bad Gateway

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

    503 Service Unavailable

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

    504 Gateway Timeout

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

錯誤碼

請參考錯誤碼