调用TagResources为指定的RDS实例创建并绑定标签。

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

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

调试

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

请求参数

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

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

RegionId String 是 cn-hangzhou

地域ID，可以通过接口DescribeRegions查看可用的地域ID。

ResourceType String 是 INSTANCE

资源类型定义。唯一取值：INSTANCE。

ResourceId.N RepeatList 是 rm-uf6wjk5xxxxxxx

实例ID。可以同时对N个实例绑定标签，N的取值范围：1~50。

Tag.N.Key String 是 testkey1

标签键。可以同时创建N个标签键，N的取值范围：1~20。不允许传入空字符串。

Tag.N.Value String 否 testvalue1

标签键对应的标签值。可以同时创建N个标签值，N的取值范围：1~20。允许传入空字符串。

AccessKeyId String 否 LTAIfCxxxxxxx

阿里云颁发给用户的访问服务所用的密钥ID。

返回数据

名称 类型 示例值 描述
RequestId String 224DB9F7-3100-4899-AB9C-C938BCCB43E7

请求ID。

示例

请求示例


http(s)://rds.aliyuncs.com/?Action=TagResources
&RegionId=cn-hangzhou
&ResourceType=INSTANCE
&ResourceId.1=rm-uf6wjk5xxxxxxx
&Tag.1.Key=testkey1
&Tag.1.Value=testvalue1
&<公共请求参数>

正常返回示例

XML 格式 

<TagResourcesResponse>
  <RequestId>224DB9F7-3100-4899-AB9C-C938BCCB43E7</RequestId>
</TagResourcesResponse>

JSON 格式 

{
	"RequestId":"224DB9F7-3100-4899-AB9C-C938BCCB43E7"
}

错误码

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