调用TagResources为一个或多个Redis实例绑定标签。

在实例数量较多的情况下，您可以创建多个标签，为实例绑定不同的标签对其进行分类，之后通过标签进行实例筛选。

  • 标签由一对键（key）值（value）组成，键在同账号同地域下唯一，值无此限制。
  • 若设置的标签不存在，则自动创建该标签并绑定到目标实例。
  • 若实例已经绑定了有相同键的标签，则进行覆盖绑定。
  • 每个实例最多可以绑定20个标签。
  • 每次调用最多设置50个实例进行批量标签绑定。

该API对应的控制台操作请参见新建标签。

调试

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

请求参数

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

系统规定参数。取值：TagResources。

RegionId String 是 cn-hangzhou

实例所属的地域ID。
ResourceType String 是 INSTANCE

资源类型，取值固定为INSTANCE。

ResourceId.N String 是 r-bp1zxszhcgatnx****

实例ID，支持设置多个。

说明 N表示传入第几个实例ID。例如ResourceId.1表示传入第一个实例ID；ResourceId.2表示传入第二个实例ID。
Tag.N.Key String 是 demokey

标签的键。

说明
  • N表示传入第几个标签的键。例如Tag.1.Key表示传入第一个标签的键；Tag.2.Key表示传入第二个标签的键。
  • 如果标签的键不存在，则自动创建。
Tag.N.Value String 是 demovalue

标签的值。

说明 N表示传入第几个标签的值。例如Tag.1.Value表示传入第一个标签的值；Tag.2.Value表示传入第二个标签的值。

返回数据

名称 类型 示例值 描述
RequestId String 4BD4E308-A3D8-4CD1-98B3-0ADAEE38****

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=TagResources
&RegionId=cn-hangzhou
&ResourceId.1=r-bp1zxszhcgatnx****
&ResourceId.2=r-bp1zxszhcgatnx****
&ResourceType=INSTANCE
&Tag.1.Key=demokey1
&Tag.1.Value=demovalue1
&Tag.2.Key=demokey2
&Tag.2.Value=demovalue2
&<公共请求参数>

正常返回示例

XML格式 

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

<TagResourcesResponse>
    <RequestId>4BD4E308-A3D8-4CD1-98B3-0ADAEE38****</RequestId>
</TagResourcesResponse>

JSON格式 

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

{
  "RequestId" : "4BD4E308-A3D8-4CD1-98B3-0ADAEE38****"
}

错误码

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