RemoveTagsFromResource--云数据库 veDB MySQL 版-火山引擎

文档中心

立即注册

导航

RemoveTagsFromResource

最近更新时间：2024.11.08 10:14:36首次发布时间：2023.08.16 10:05:30

调用 RemoveTagsFromResource 接口为一个或多个实例解绑标签。

请求类型

异步请求。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

名称类型是否必选示例值描述

名称	类型	是否必选	示例值	描述
InstanceIds	Array of String	是	["vedbm-r3xq0zdl****"]	需要解绑标签的实例 ID。说明您可以调用 DescribeDBInstances 接口查询目标地域下所有实例的基本信息，包括实例 ID。支持一次传入多个实例 ID，多个实例 ID 之间用英文逗号（,）分隔。最多同时传入 20 个实例 ID。
TagKeys	Array of String	否	["instancetype", "chargetype"]	需要解绑的标签键。说明支持一次传入多个标签键，多个标签键间用英文逗号（,）分隔。最多同时传入 20 个标签键。当 `InstanceIds` 为多个实例 ID 时，所有实例存在传入标签键的标签都会被解绑，请谨慎操作。
All	Boolean	否	false	是否解绑指定实例上的所有标签。取值范围： `true`：解绑指定实例上的所有标签。 `false`：不解绑指定实例上的所有标签（默认）。说明仅当 `TagKeys` 取值为空时，`All` 参数才生效。

InstanceIds

Array of String

是

["vedbm-r3xq0zdl****"]

需要解绑标签的实例 ID。

说明

您可以调用 DescribeDBInstances 接口查询目标地域下所有实例的基本信息，包括实例 ID。
支持一次传入多个实例 ID，多个实例 ID 之间用英文逗号（,）分隔。最多同时传入 20 个实例 ID。

TagKeys

Array of String

否

["instancetype", "chargetype"]

需要解绑的标签键。

说明

支持一次传入多个标签键，多个标签键间用英文逗号（,）分隔。最多同时传入 20 个标签键。
当 InstanceIds 为多个实例 ID 时，所有实例存在传入标签键的标签都会被解绑，请谨慎操作。

All

Boolean

否

false

是否解绑指定实例上的所有标签。取值范围：

true：解绑指定实例上的所有标签。
false：不解绑指定实例上的所有标签（默认）。

说明

仅当 TagKeys 取值为空时，All 参数才生效。

返回参数

null

请求示例

POST /?Action=RemoveTagsFromResource&Version=2022-01-01 HTTP/1.1
Content-Type: application/json
Host: vedbm.volcengineapi.com
X-Date: 20230801T101010Z
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20230801/cn-beijing/vedbm/request,SignedHeaders=x-date, Signature=6a593bf5f59e7c1109fb205c739d1cff4c672fe2d251963f4d48c8701d16****

{
    "InstanceIds":[
        "vedbm-d6rjf5ln****"
    ],
    "TagKeys":[
        "chargetype",
        "instancetype"
    ]
}

返回示例

正常返回示例

{
    "ResponseMetadata": {
        "RequestId": "2023080110134234A93678651E064CCD04",
        "Action": "RemoveTagsFromResource",
        "Version": "2022-01-01",
        "Service": "vedbm",
        "Region": "cn-beijing"
    },
    "Result": null
}

错误码

更多详情，请参见错误码。