TagResources_云数据库 Tair(兼容 Redis®)_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 个实例进行批量标签绑定。

该 API 对应的控制台操作请参见新建标签

流控信息

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

授权信息

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

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
kvstore:TagResources
Create
全部资源
*

请求参数

字段名称字段详情
RegionIdstring

实例所属的地域 ID。

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

资源类型,取值固定为 INSTANCE

示例值:INSTANCE枚举值:INSTANCEinstance
ResourceIdarray<string>

实例 ID。

示例值:r-bp1zxszhcgatnx****子级条数 <= 51
Tagarray<object>

实例的标签信息。

子级条数 <= 21

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:4BD4E308-A3D8-4CD1-98B3-0ADAEE38****

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
400
NumberExceed.Tags
The Tags parameter number is exceed, Valid is 20.诊断
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 number is exceed.诊断
400
NumberExceed.CustomTags
The Custom Tags parameter number is exceed. Valid is 20.诊断
400
Duplicate.TagKey
The specified parameter Tag.n.Key is duplicated.诊断
400
InvalidParameter.ResourceType
The specified parameter ResourceType is not valid.诊断
400
OperationDenied.QuotaExceed
The Tags parameter number is exceed. Valid is 20.诊断
404
InvalidDbInstanceId.NotFound
Specified instance does not exist.诊断

变更历史

暂无变更历史

相关示例

调用TagResources为一个或多个Redis实例绑定标签
2021-12-03