文档中心

数据库传输服务

请输入

标签管理

AddTagsToResource

调用 AddTagsToResource 接口为任务添加标签。

请求类型

同步请求。

请求参数

参数	类型	是否必选	示例值	描述
TaskIds	Array of String	是	[ "18064de5e9d345dc965ee45217******" ]	需要绑定标签的任务 ID。说明您可以调用 DescribeTransmissionTasks 接口查看任务 ID。支持一次传入多个实例 ID，多个 ID 间用英文逗号（,）分隔。最多同时传入 20 个实例 ID。
Tags	Array of TagObject	是	[ { "Key":"key1", "Value":"value1" } ]	标签列表信息。说明支持一次传入多组标签键值对像，多组标签键值对像间用英文逗号（,）分隔。最多同时传入 20 组标签键值对。单个任务最多可绑定 50 个键值。

TagObject

参数	类型	是否必选	示例值	描述
Key	String	是	key1	标签的键信息。配置规格如下：支持任何语言、文字、数字、空格或符号（_.:/=+-@）。大小写敏感，且长度在 1~128 个字符内。使用 UTF-8 编码的 Unicode 格式。不支持设置以 volc: 开头的任何形式的 Key，例如 Volc:、VOLC:等。
Value	String	是	value1	标签的值信息。配置规格如下：支持任何语言、文字、数字、空格或符号（_.:/=+-@）。大小写敏感，且长度在 0~256 个字符内。使用 UTF-8 编码的 Unicode 格式。

返回参数

null

示例

请求示例

POST /?Action=AddTagsToResource&Version=2022-10-01 HTTP/1.1​
Content-Type: application/json​
Host: dts.cn-beijing.volcengineapi.com​
X-Date: 20221001T101010Z​
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20221001/cn-beijing/dts/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c645****​
{​
    "TaskIds": [​
        "18064de5e9d345dc965ee45217******"​
    ],​
    "Tags": [​
        {​
            "Key": "key1",​
            "Value": "value1"​
        }​
    ]​
}​

返回示例

{​
    "ResponseMetadata": {​
        "RequestId": "20230414161942CD08B59CEB1E16301017",​
        "Action": "AddTagsToResource",​
        "Version": "2022-10-01",​
        "Service": "dts",​
        "Region": "cn-beijing"​
    },​
    "Result": {}​
}​

错误码

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

最近更新时间：2026.02.03 14:24:30

这个页面对您有帮助吗？

有用

无用