TagResources_云数据库 MongoDB 版_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

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

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

流控信息

请求速率为1000/60(s)。更多流控信息,请前往配额中心查看

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
dds:TagResources
Update
Instance
acs:dds:{#regionId}:{#accountId}:dbinstance/{#dbinstanceId}

请求参数

字段名称字段详情
RegionIdstring

实例所属的地域 ID,您可以调用 DescribeDBInstanceAttribute 接口查询。

示例值:cn-hangzhou参考取值来源:
    DescribeRegions
ResourceTypestring

资源类型,取值固定为 INSTANCE

示例值:INSTANCE
ResourceGroupIdstring

资源组 ID。

示例值:rg-acfmyiu4ekp****
ResourceIdarray<string>

实例和标签信息列表。

示例值:dds-bpxxxxxxxx子级条数 <= 51
Tagarray<object>

标签信息列表。

子级条数 <= 21

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:0FDDC511-7252-4A4A-ADDA-5CB1BF63****

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
400
InvalidTagKey.Malformed
The specified parameter 'Tag.n.Key' or 'TagKey.n' is not valid.诊断
400
InvalidTagValue.Malformed
The specified parameter 'Tag.n.Value' is not valid.诊断
400
InvalidParameter.ResourceId
The specified parameter 'ResourceId.n' is not valid.诊断
400
MissParameter.TagOrResourceId
The parameter 'Tag.n'' or 'ResourceId.n' is needed.诊断
400
InvalidParameter.Scope
The specified parameter 'Scope' is not valid.诊断
400
NumberExceed.ResourceIds
The ResourceIds parameter's number is exceed.诊断
400
NumberExceed.Tags
The Tags parameter's number is exceed.诊断
400
NumberExceed.CustomTags
The Custom Tags parameter's number is exceed. Valid 20.诊断
400
Duplicate.TagKey
The specified parameter 'Tag.n.Key' is duplicated.诊断
400
InvalidParameter.ResourceType
The specified parameter 'ResourceType' is not valid.诊断
404
InvalidDbInstanceId.NotFound
Specified instance does not exist.诊断

变更历史

变更时间变更内容概要操作
2023-07-13
删除返回参数
2023-01-05
新增返回参数

相关示例

为一个或多个MongoDB实例绑定标签
2021-11-26