文档首页/ 镜像服务 IMS/ API参考/ OpenStack原生API/ 镜像标签（OpenStack原生）/ 增加标签（OpenStack原生）
更新时间：2023-06-21 GMT+08:00
查看PDF
分享

增加标签（OpenStack原生）

功能介绍

该接口主要用于为某个镜像添加一个自定义标签。通过自定义标签，用户可以将镜像进行分类。

URI

PUT /v2/images/{image_id}/tags/{tag}

参数说明请参见表1。
表1 参数说明

参数

是否必选

参数类型

描述

image_id

是

String

镜像ID

tag

是

String

新增的tag。

字符串中不能包含“=”。

说明：

该接口只能添加标签键，如果需要添加标签值，请使用接口PUT /v1/cloudimages/tags ，详情请参考增加或修改标签。

请求消息

请求参数

无

请求示例

增加镜像标签。

PUT https://{Endpoint}/v2/images/4ca46bf1-5c61-48ff-b4f3-0ad4e5e3ba90/tags/aaaa

响应消息

  • 响应参数

    无

  • 响应样例 
    STATUS CODE 204

返回值

  • 正常

    204

  • 异常

    返回值

    说明

    400 Bad Request

    请求错误。

    401 Unauthorized

    鉴权失败。

    403 Forbidden

    没有操作权限。

    404 Not Found

    找不到资源。

    500 Internal Server Error

    服务内部错误。

    503 Service Unavailable

    服务不可用。