華為云計算 云知識 添加鏡像標簽添加鏡像標簽AddImageTag
添加鏡像標簽添加鏡像標簽AddImageTag

 

功能介紹

該接口用于為指定 鏡像 添加或更新指定的單個標簽。

約束與限制

  • 每個標簽由鍵值對組成,標簽的key的長度不超過36個字符,value的長度不超過43個字符。key不能為空或空白字符串,value不能為空,但可以是空白字符串。
  • 單個鏡像最多添加10個標簽。
  • 此接口為冪等接口:如果創(chuàng)建的標簽已經(jīng)存在,即key相同而value不同,則更新對應標簽;如果創(chuàng)建的標簽已經(jīng)存在,key/value均相同,則不重復添加此標簽,視為添加成功。

調(diào)試

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

URI

POST /v2/{project_id}/images/{image_id}/tags

參數(shù)說明請參見表1。
表1 參數(shù)說明

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

項目ID

image_id

String

鏡像ID

請求消息

  • 請求參數(shù)

    參數(shù)

    是否必選

    參數(shù)類型

    描述

    tag

    Object

    要添加或更新的標簽數(shù)據(jù),詳情請參見表2。

    表2 tag數(shù)據(jù)結(jié)構(gòu)說明

    參數(shù)

    是否必選

    參數(shù)類型

    描述

    key

    String

    標簽的鍵,鍵不能為空。

    value

    String

    標簽的值。

請求示例

添加鏡像標簽,其中,標簽鍵為“key1”對應的值為“value1”。

POST https://{Endpoint}/v2/fd73a4a14a4a4dfb9771a8475e5198ea/images/67e17426-359e-49fb-aa12-0bd1756ec240/tags

{
   "tag": {
      "value": "value1",
      "key": "key1"
   }
}

響應消息

  • 響應參數(shù)

  • 響應樣例
    STATUS CODE 204

返回值

  • 正常

    204

  • 異常

    返回值

    說明

    400 Bad Request

    請求錯誤。

    401 Unauthorized

    鑒權失敗。

    403 Forbidden

    沒有操作權限。

    404 Not Found

    找不到資源。

    500 Internal Server Error

    服務內(nèi)部錯誤。

    503 Service Unavailable

    服務不可用。