更新时间:2022-09-29 GMT+08:00
分享

批量删除裸金属服务器标签

功能介绍

  • 为指定裸金属服务器批量删除标签。
  • TMS使用该接口批量管理裸金属服务器的标签。

此接口为幂等接口,删除时,如果删除的标签不存在,默认处理成功。

约束与限制

每个裸金属服务器最多20个标签。

URI

POST /v1/{project_id}/baremetalservers/{server_id}/tags/action

参数说明请参见表1

表1 参数说明

参数

参数类型

是否必选

描述

project_id

String

项目ID。

server_id

String

裸金属服务器ID。

请求消息

  • 请求参数

    参数

    参数类型

    是否必选

    描述

    tags

    List <resource_tag>[1]

    标签列表,详见表 tags字段数据结构说明

    action

    String

    操作标识(仅支持小写):delete(删除)

    表2 [1] tags字段数据结构说明

    参数

    参数类型

    是否必选

    描述

    key

    String

    • 最大长度127个unicode字符,不能为空。

    value

    String

    • 每个值最大长度255个unicode字符,可以为空字符串。
    • 不能包含以下ASCII非打印字符:“=”,“*”,“<”,“>”,“\”,“|”,“/”,“,”
  • 请求样例

    POST /v1/{project_id}/baremetalservers/{resource_id}/tags/action

    请求体
    {
        "action": "delete",
        "tags": [
            {
                "key": "key1",
                "value": "value1"
            },
            {
                "key": "key2",
                "value": "value3"
            }
        ]
    }

响应消息

返回值

  • 正常

    返回值

    说明

    204

    No Content

  • 异常

    返回值

    说明

    400

    标签等参数非法

    401

    鉴权失败

    403

    权限不足

    404

    资源未找到

    500

    系统异常

分享:

    相关文档

    相关产品