全部产品
Search
文档中心

密钥管理服务:TagResources - 绑定标签

更新时间:Aug 27, 2026

为密钥或凭据绑定标签。

接口说明

  • RAM 用户或 RAM 角色调用该 OpenAPI 需要被授予的权限策略详情,请参见访问控制

  • 支持一次为多个密钥或者多个凭据绑定多个标签。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称

类型

必填

描述

示例值

RegionId

string

资源所属的地域 ID。

说明

您可以调用 DescribeRegions 查看当前阿里云账号的可用地域列表。

cn-hangzhou

ResourceType

string

要绑定标签的资源类型。取值:

  • key:密钥

  • secret:凭据

key

ResourceId

array

要绑定标签的资源 ID 列表,最多可以输入 50 个资源 ID。

输入多个资源 ID 时,格式为["ResourceId.1","ResourceId.2",...]

string

要绑定标签的资源 ID 列表,最多可以输入 50 个资源 ID。

输入多个资源 ID 时,格式为["ResourceId.1","ResourceId.2",...]

key-hzz62f1cb66fa42qo****

Tag

array<object>

标签列表,最多可以输入 20 个标签。

每个标签由一个键值对(Key:Value)组成,包含标签键(Key)、标签值(Value)。 输入多个标签时,格式为[{"Key":"key1","Value":"value1"},{"Key":"key2","Value":"value2"},...]

object

标签列表,最多可以输入 20 个标签。

每个标签由一个键值对(Key:Value)组成,包含标签键(Key)、标签值(Value)。 输入多个标签时,格式为[{"Key":"key1","Value":"value1"},{"Key":"key2","Value":"value2"},...]

Key

string

标签键。每个标签由一个键值对(Key:Value)组成,包含标签键(Key)、标签值(Value)。

最多可以输入 20 个标签。输入多个标签时,格式为[{"Key":"key1","Value":"value1"},{"Key":"key2","Value":"value2"},...]

每个标签键最多支持 128 个字符,可以包含英文大小写字母、数字、正斜线(/)、反斜线(\)、下划线(_)、短划线(-)、半角句号(.)、加号(+)、等于号(=)、半角冒号(:)、字符 at(@)。

说明

标签键不能以 aliyun 或 acs:开头。

disk-encryption

Value

string

标签值。每个标签由一个键值对(Key:Value)组成,包含标签键(Key)、标签值(Value)。

最多可以输入 20 个标签。输入多个标签时,格式为[{"Key":"key1","Value":"value1"},{"Key":"key2","Value":"value2"},...]

每个标签值最多支持 128 个字符,可以包含英文大小写字母、数字、正斜线(/)、反斜线(\)、下划线(_)、短划线(-)、半角句号(.)、加号(+)、等于号(=)、半角冒号(:)、字符 at(@)。

true

返回参数

名称

类型

描述

示例值

object

Schema of Response

RequestId

string

本次调用请求的 ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。

598d0219-45cd-4477-84ad-85a52d9debcf

示例

正常返回示例

JSON格式

{
  "RequestId": "598d0219-45cd-4477-84ad-85a52d9debcf"
}

错误码

HTTP status code

错误码

错误信息

描述

400 InvalidParameter.TagValue The specified parameter is not valid. 您指定的标签值非法。
400 InvalidParameter.TagKey The specified parameter is not valid. 指定的标签键非法。
400 Duplicate.TagKey The specified tagKey is duplicate. 指定的标签值是重复的。
404 InvalidAccessKeyId.NotFound The Access Key ID provided does not exist in our records.
404 InvalidResourceId.NotFound The specified ResourceId is not found. 没有找到指定的资源Id。

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情