调用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。例如:

  • ResourceId.1表示传入第一个实例ID。
  • ResourceId.2表示传入第二个实例ID。
Tag.N.Key String 开发组

标签的键。

说明

N表示传入第几个标签的键。例如:

  • Tag.1.Key表示传入第一个标签的键。
  • Tag.2.Key表示传入第二个标签的键。
Tag.N.Value String 4.0环境

标签的值。

说明

N表示传入第几个标签的值。例如:

  • Tag.1.Value表示传入第一个标签的值。
  • Tag.2.Value表示传入第二个标签的值。

返回数据

名称 类型 示例值 描述
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****"
}

错误码

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