为密钥或凭据绑定标签。
支持一次为多个密钥或者多个凭据绑定多个标签。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | TagResources | 要执行的操作。取值:TagResources。 |
RegionId | String | 是 | cn-hangzhou | 资源所属的地域ID。 说明 您可以调用DescribeRegions查看当前阿里云账号的可用地域列表。 |
ResourceType | String | 是 | key | 要绑定标签的资源类型。取值:
|
ResourceId.N | String | 否 | key-hzz62f1cb66fa42qo**** | 要绑定标签的资源ID列表,最多可以输入50个资源ID。 输入多个资源ID时,格式为 |
Tag.N.Key | String | 否 | disk-encryption | 标签键。每个标签由一个键值对(Key:Value)组成,包含标签键(Key)、标签值(Value)。 最多可以输入20个标签。输入多个标签时,格式为 每个标签键最多支持128个字符,可以包含英文大小写字母、数字、正斜线(/)、反斜线(\)、下划线(_)、短划线(-)、半角句号(.)、加号(+)、等于号(=)、半角冒号(:)、字符at(@)。 说明 标签键不能以aliyun或acs:开头。 |
Tag.N.Value | String | 否 | true | 标签值。每个标签由一个键值对(Key:Value)组成,包含标签键(Key)、标签值(Value)。 最多可以输入20个标签。输入多个标签时,格式为 每个标签值最多支持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。 |
访问错误中心查看更多错误码。