调用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 String 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。允许传入空字符串。

返回数据

名称 类型 示例值 描述
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格式

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

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

JSON格式

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

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

错误码

HttpCode 错误码 错误信息 描述
400 NumberExceed.Tags The maximum number of Tags is exceeded. The maximum value is 20. 操作失败,Tags参数的编号超过有效值,有效值:20
400 MissingParameter The parameter - Tags should not be null 操作失败,标签键(Tag.N.Key)参数不能为空。
400 InvalidTagKey.Malformed The Tag.N.Key parameter is blank 操作失败,标签键(Tag.N.Key)参数为空。
400 InvalidTagValue.Malformed The Tag.N.Value parameter is blank 操作失败,标签键对应的标签值(Tag.N.Value)参数为空。
400 Duplicate.TagKey The Tag.N.Key contain duplicate key. 操作失败,标签键(Tag.N.Key)包含重复键。
400 OperationDenied.QuotaExceed The maximum number of Tags is exceeded. 操作失败,Tags超过限制。
400 NumberExceed.ResourceIds The maximum number of ResourceIds is exceeded. The maximum value is 50. 操作失败,ResourceIds参数的编号超过有效值,有效值:50
400 InvalidTagKey.Malformed The operator is not permission for the system tag 操作失败,没有系统标签的权限。
400 Request.NotFound The requested resource is not available. 请求的资源不可用。
400 InvalidTagValue.Malformed The Tag.N.Value parameter is invalid. Tag.N.Value参数无效。

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