文档首页/ 组织 Organizations/ API参考/ API/ 标签管理/ 从指定资源类型中删除指定主键标签
更新时间:2024-10-21 GMT+08:00
分享

从指定资源类型中删除指定主键标签

功能介绍

从指定资源类型中删除具有指定主键的任何标签。您可以将标签绑定到组织中的账号、组织单元、根和策略。此操作只能由组织的管理账号调用。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

POST https://{endpoint}/v1/organizations/{resource_type}/{resource_id}/tags/delete

表1 路径参数

参数

是否必选

参数类型

描述

resource_type

String

资源类型。枚举值:organizations:policies(服务策略)、organizations:ous(组织OU)、organizations:accounts(账号信息) 、organizations:roots:(根)。

resource_id

String

根、组织单元、账号或策略的唯一标识符(ID)。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Security-Token

String

如果正在使用临时安全凭据,则此header是必需的,该值是临时安全凭据的安全令牌(会话令牌)。

表3 请求Body参数

参数

是否必选

参数类型

描述

tags

Array of TagDto objects

要添加到指定资源的标签列表。

表4 TagDto

参数

是否必选

参数类型

描述

key

String

标签键的密钥标识符或名称。

value

String

与标签键关联的字符串值。您可以将标签的值设置为空字符串,但不能将标签的值设置为NULL。

响应参数

请求示例

从指定资源类型中删除指定主键标签。

POST https://{endpoint}/v1/organizations/{resource_type}/{resource_id}/tags/delete

{
  "tags" : [ {
    "key" : "keystring",
    "value" : "valuestring"
  } ]
}

响应示例

状态码

状态码

描述

200

Successful.

错误码

请参见错误码

相关文档