调用TagResources接口为一个或多个云数据库MongoDB实例绑定标签。
在实例数量较多的情况下,您可以创建多个标签,为实例绑定不同的标签对其进行分类,后续可通过标签筛选实例。
- 标签由一对键(key)值(value)组成,键在同账号同地域下唯一,值无此限制。
- 若设置的标签不存在,则自动创建该标签并绑定到目标实例。
- 若实例已经绑定了有相同键的标签,则会覆盖绑定。
- 每个实例最多可以绑定20个标签。
- 每次调用最多可以对50个实例执行批量标签绑定。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | TagResources |
系统规定参数。取值:TagResources。 |
| RegionId | String | 是 | cn-hangzhou |
实例所属的地域ID,您可以调用DescribeDBInstanceAttribute接口查询。 |
| ResourceType | String | 是 | INSTANCE |
资源类型,取值固定为INSTANCE。 |
| ResourceGroupId | String | 否 | rg-acfmyiu4ekp**** |
资源组ID。 |
| ResourceId.N | String | 是 | dds-bp1fa5efaa93**** |
实例ID。 说明
表示传入第几个实例ID。例如:
|
| Tag.N.Key | String | 是 | 开发组 |
标签的键。 说明
N表示传入第几个标签的键。例如:
|
| Tag.N.Value | String | 是 | 4.0环境 |
标签的值。 说明
N表示传入第几个标签的值。例如:
|
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | 0FDDC511-7252-4A4A-ADDA-5CB1BF63**** |
请求ID。 |
示例
请求示例
http(s)://mongodb.aliyuncs.com/?Action=TagResources
&RegionId=cn-hangzhou
&ResourceType=INSTANCE
&ResourceGroupId=rg-acfmyiu4ekp****
&ResourceId=["dds-bp1fa5efaa93****"]
&Tag=[{"Key":"开发组","Value":"4.0环境"}]
&公共请求参数
正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<TagResourcesResponse>
<RequestId>0FDDC511-7252-4A4A-ADDA-5CB1BF63****</RequestId>
</TagResourcesResponse>
JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "0FDDC511-7252-4A4A-ADDA-5CB1BF63****"
}
错误码
访问错误中心查看更多错误码。