TagResources_云存储网关_API文档-阿里云OpenAPI开发者门户

接口说明

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

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

流控信息

当前云产品API请求速率暂未透出。

授权信息

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

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

hcs-sgw:TagResources	Update	全部资源 *	无	无

请求参数

字段名称	字段详情
RegionIdstring	地域 ID，可以通过接口 DescribeRegions 查看可用的地域 ID。示例值:cn-hangzhou参考取值来源: DescribeRegions
ResourceRegionIdstring	资源地域 ID。示例值:cn-hangzhou
ResourceTypestring	资源类型定义。唯一取值：GATEWAY。示例值:GATEWAY
Tagarray<object>	标签信息。子级条数 <= 21
ResourceIdarray<string>	网关 ID 列表。可以同时对 N 个实例绑定标签，N 的取值范围为 1~50。子级条数 <= 51

返回参数

字段名称	字段详情
RequestIdstring	请求 ID。示例值:224DB9F7-3100-4899-AB9C-C938BCCB43E7

返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

400	MissingParameter.ResourceIds	The parameter - ResourceIds.N should not be null.	诊断
400	MissingParameter.Tags	The parameter - Tags should not be null.	诊断
400	Missing.TagKey	The Tag.N.Key parameter is blank.	诊断
400	InvalidParameter.TagKey	The Tag.N.Key parameter is invalid.	诊断
400	InvalidParameter.TagValue	The Tag.N.Value parameter is invalid.	诊断
400	InvalidParameter.ResourceType	The ResourceType parameter is invalid.	诊断
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	诊断
400	MissingParameter.TagOrResourceId	The specified Tags and ResourcesIds are not allow to both empty.	诊断
400	NumberExceed.ResourceIds	The ResourceIds parameter's number is exceed , Valid : 50	诊断
400	NumberExceed.Tags	The Tags parameter's number is exceed , Valid : 20	诊断
400	QuotaExceed.TagsPerResource	The tags per resource number is exceed, Valid: 20	诊断
403	PermissionDenied.Scope	The specified operator not have permission to set Scope value.	诊断
403	PermissionDenied.TagOwnerUid	The specified operator not have permission to set TagOwnerUid value.	诊断
403	PermissionDenied.TagOwnerBid	The specified operator not have permission to set TagOwnerBid value.	诊断
403	NoPermissionKey.Operator	These keys are not permission for this operator.	诊断
403	NoPermissionKey.Scope	These keys are not permission for this scope.	诊断
403	NoPermissionKey.Category	These keys are not permission for this category.	诊断
403	NoPermission.SystemTag	The operator is not permission for the system tag.	诊断
403	NoPermission.Operator	The operator is not permission for this operate.	诊断
404	InvalidResourceType.NotFound	The ResourceType provided does not exist in our records.	诊断
404	InvalidResourceId.NotFound	The specified ResourceId is not found in our records.	诊断

变更历史

暂无变更历史

TagResources_云存储网关_API文档

接口说明

流控信息

授权信息

请求参数

返回参数

返回示例

错误码

变更历史

相关示例