華為云計算 云知識 增加或修改標(biāo)簽CreateOrUpdateTags
增加或修改標(biāo)簽CreateOrUpdateTags

 

功能介紹

該接口主要用于為某個 鏡像 增加或修改一個自定義標(biāo)簽。通過自定義標(biāo)簽,用戶可以將鏡像進行分類。

調(diào)試

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

URI

PUT /v1/cloudimages/tags

請求消息

  • 請求參數(shù)

    參數(shù)

    是否必選

    參數(shù)類型

    描述

    image_id

    String

    鏡像ID。

    如何獲取鏡像ID,請參見查詢鏡像列表。

    tag

    String

    標(biāo)簽數(shù)據(jù)。

    tag和image_tag只能使用一個。

    image_tag

    Object

    新規(guī)范的鏡像標(biāo)簽列表。image_tag參數(shù)說明請參考鏡像標(biāo)簽數(shù)據(jù)格式。默認(rèn)為空。

    tag和image_tag只能使用一個。

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

    參數(shù)

    是否必選

    參數(shù)類型

    描述

    key

    String

    標(biāo)簽的鍵。

    value

    String

    標(biāo)簽的值。

請求示例

  • 使用tags標(biāo)簽數(shù)據(jù)格式,增加或修改標(biāo)簽。
    PUT https://{Endpoint}/v1/cloudimages/tags
    
    {
      "image_id": "62a15f6c-9197-44d2-89c7-708981c1bec1",
      "tag": "aaaa.1111"
    }
    
  • 使用image_tag標(biāo)簽數(shù)據(jù)格式,增加或修改標(biāo)簽。
    PUT https://{Endpoint}/v1/cloudimages/tags
    
    {
      "image_id": "67437ebd-2563-46e0-887e-ad1923977fa1",
      "image_tag": {"key":"key1","value":"value1"}
    }
    

響應(yīng)消息

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

  • 響應(yīng)樣例
    STATUS CODE 204

返回值

  • 正常

    204

  • 異常

    返回值

    說明

    400 Bad Request

    請求錯誤。

    401 Unauthorized

    鑒權(quán)失敗。

    403 Forbidden

    沒有操作權(quán)限。

    404 Not Found

    找不到資源。

    500 Internal Server Error

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

    503 Service Unavailable

    服務(wù)不可用。