TagResources - 绑定标签-密钥管理服务(KMS)-阿里云帮助中心

为密钥或凭据绑定标签。

接口说明

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。

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

变更历史

变更时间	变更内容概要	操作
2023-05-30	OpenAPI 错误码发生变更	查看变更详情