为密钥或凭据绑定标签。

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

调试

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

请求参数

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

要执行的操作。取值：TagResources。
RegionId String 是 cn-hangzhou

资源所属的地域ID。

说明 您可以调用DescribeRegions查看当前阿里云账号的可用地域列表。
ResourceType String 是 key

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

  • key：密钥
  • secret：凭据
ResourceId.N String 否 key-hzz62f1cb66fa42qo****

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

输入多个资源ID时，格式为["ResourceId.1","ResourceId.2",...]。
Tag.N.Key String 否 disk-encryption

标签键。每个标签由一个键值对（Key:Value）组成，包含标签键（Key）、标签值（Value）。

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

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

说明 标签键不能以aliyun或acs:开头。
Tag.N.Value String 否 true

标签值。每个标签由一个键值对（Key:Value）组成，包含标签键（Key）、标签值（Value）。

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

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

返回数据

名称 类型 示例值 描述
RequestId String 598d0219-45cd-4477-84ad-85a52d9debcf

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

示例

请求示例

http(s)://[Endpoint]/?Action=TagResources
&RegionId=cn-hangzhou
&ResourceType=key
&ResourceId=["key-hzz62f1cb66fa42qo****"]
&Tag=[{"Key":"disk-encryption","Value":"true"}]
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<TagResourcesResponse>
    <RequestId>598d0219-45cd-4477-84ad-85a52d9debcf</RequestId>
</TagResourcesResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

HttpCode 错误码 错误信息 描述
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. 提供的 Access Key ID不存在
404 InvalidResourceId.NotFound The specified ResourceId is not found. 没有找到指定的资源Id。

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