TagResources
调用TagResources为一个或多个Redis实例绑定标签。
在实例数量较多的情况下,您可以创建多个标签,为实例绑定不同的标签对其进行分类,之后通过标签进行实例筛选。
- 标签由一对键(key)值(value)组成,键在同账号同地域下唯一,值无此限制。
- 若设置的标签不存在,则自动创建该标签并绑定到目标实例。
- 若实例已经绑定了有相同键的标签,则进行覆盖绑定。
- 每个实例最多可以绑定20个标签。
- 每次调用最多设置50个实例进行批量标签绑定。
该API对应的控制台操作请参见新建标签。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
RegionId | String | 是 | cn-hangzhou |
地域ID,可调用DescribeRegions查询。 |
ResourceId.N | RepeatList | 是 | r-hp3xxxxxxxxxxxxx |
实例ID,可以设置多个。 说明 设置方法请参见请求示例。
|
ResourceType | String | 是 | INSTANCE |
资源类型,唯一值:INSTANCE。 |
Action | String | 否 | TagResources |
系统规定参数,取值:TagResources。 |
AccessKeyId | String | 否 | Lxxxxxxxxxxxxxxw |
阿里云颁发给用户的访问服务所用的密钥ID。 |
Tag.N.Key | String | 否 | demokey |
标签N的键。 说明 设置方法请参见请求示例。
|
Tag.N.Value | String | 否 | demovalue |
标签N的值。 说明 设置方法请参见请求示例。
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 4BD4E308-A3D8-4CD1-98B3-0ADAEE38B01B |
请求ID。 |
示例
请求示例
https://r-kvstore.aliyuncs.com/
?Action=TagResources
&RegionId=cn-huhehaote
&ResourceId.1=r-hp1xxxxxxxxxxxxx
&ResourceId.2=r-hp2xxxxxxxxxxxxx
&ResourceType=INSTANCE
&Tag.1.Key=demokey1
&Tag.1.Value=demovalue1
&Tag.2.Key=demokey2
&Tag.2.Value=demovalue2
&<公共请求参数>
正常返回示例
XML
格式
<TagResourcesResponse>
<RequestId>4BD4E308-A3D8-4CD1-98B3-0ADAEE38B01B</RequestId>
</TagResourcesResponse>
JSON
格式
{
"RequestId":"4BD4E308-A3D8-4CD1-98B3-0ADAEE38B01B"
}
错误码
访问错误中心查看更多错误码。
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论