增加或修改标签
功能介绍
该接口主要用于为某个镜像增加或修改一个自定义标签。通过自定义标签,用户可以将镜像进行分类。
调试
您可以在API Explorer中调试该接口。
URI
PUT /v1/cloudimages/tags
请求消息
- 请求参数
参数
是否必选
参数类型
描述
image_id
是
String
镜像ID。
如何获取镜像ID,请参见查询镜像列表。
tag
否
String
标签数据。
tag和image_tag只能使用一个。
image_tag
否
Object
新规范的镜像标签列表。image_tag参数说明请参考镜像标签数据格式。默认为空。
tag和image_tag只能使用一个。
表1 image_tag数据结构说明 参数
是否必选
参数类型
描述
key
是
String
标签的键。
value
是
String
标签的值。
- 请求样例
- 使用tag请求样例
PUT https://{Endpoint}/v1/cloudimages/tags
1 2 3 4
{ "image_id": "62a15f6c-9197-44d2-89c7-708981c1bec1", "tag": "aaaa.1111" }
- 使用image_tag请求样例
PUT https://{Endpoint}/v1/cloudimages/tags
1 2 3 4
{ "image_id": "67437ebd-2563-46e0-887e-ad1923977fa1", "image_tag": {"key":"key1","value":"value1"} }
- 使用tag请求样例
