批量添加或删除资源标签接口

功能介绍

为指定Endpoint Service或Endpoint批量添加或删除标签。

• 一个资源上最多有10个标签。

URI

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

参数说明如表1所示。

请求消息

• 参数说明

  表2 请求参数

  名称	是否必选	参数类型	描述
  tags	否	List<resource_tag>	标签列表。 租户权限时该字段必选。
  action	是	String	操作标识：仅限于create（创建）、delete（删除）。

  表3 resource_tag字段数据结构说明

  名称	是否必选	参数类型	描述
  key	是	String	键。最大长度36个unicode字符。 key需要满足标签字符集规范。
  value	（action为create时必选。action为delete时非必选）	String	值。每个值最大长度43个unicode字符，删除时如果value有值按照key/value删除，如果value没值，则按照key删除。 value需要满足标签字符集规范。

• 请求样例

  POST https://{endpoint}/v1/{project_id}/endpoint_service/{resource_id}/tags/action

  或https://{endpoint}/v1/{project_id}/endpoint/{resource_id}/tags/action

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

  {
      "action": "create",
      "tags": [
          {
              "key": "key1",
              "value": "value1"
          },
          {
              "key": "key",
              "value": "value3"
          }
  ]
  }

  或

  {
      "action": "delete",
      "tags": [
          {
              "key": "key1"
           },
          {
              "key": "key2",
              "value": "value3"
          }
  ]
  }

响应消息

无

状态码

状态码请参见状态码。