调用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参数无效。 |
访问错误中心查看更多错误码。