TagResources - 给资源打标签

给资源打标签。当前支持实例 Instance 资源。

接口说明

单个实例最多可绑定 20 条标签。绑定标签前,阿里云会校验资源已有标签数量,超过限制值会返回报错信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
cr:TagResources
*Instance
acs:cr:{#regionId}:{#accountId}:instance/{#InstanceId}

请求参数

名称类型必填描述示例值
ResourceTypestring

资源类型。当前支持实例 Instance 资源。

Instance
ResourceIdarray

资源 ID。最多支持添加 20 个资源。

string

资源 ID。

cri-1lg7vtctpqdn****
RegionIdstring

地域 ID。

cn-hangzhou
Tagarray<object>

标签列表。

object

标签列表。

Keystring

资源的标签键。最多支持输入 20 个标签键。如需传入该值,则不能输入空字符串。

一个标签键最多支持 128 个字符,不能以 aliyun 和 acs:开头,不能包含 http://或者 https://。

test-key
Valuestring

资源的标签值。最多支持输入 20 个标签值。如需传入该值,可以输入空字符串。

最多支持 128 个字符,不能以 aliyun 和 acs:开头,不能包含 http://或者 https://。

test-val

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

请求 ID

E9A586D0-3977-5C28-A44D-55D3A9CD53CC

示例

正常返回示例

JSON格式

{
  "RequestId": "E9A586D0-3977-5C28-A44D-55D3A9CD53CC"
}

错误码

HTTP status code错误码错误信息描述
400SystemErrorA system error occurred while processing your request系统异常。
400InvalidParameter.ResourceIdThe ResourceId parameter is invalid.-
400InvalidResourceId.NotFoundThe specified ResourceIds are not found in our records.-
400NumberExceed.ResourceIdsThe maximum number of ResourceIds is exceeded.-
400InvalidParameter.RegionIdThe RegionId parameter is invalid.-
400InvalidParameter.ResourceTypeThe ResourceType parameter is invalid.-
400MissingParameter.ResourceIdsYou must specify ResourceId.N.-
400MissingParameter.ResourceTypeYou must specify ResourceType.-
400MissingParameter.TagsYou must specify Tags.-
400MissingParameter.TagKeyYou must specify Tag.N.Key.-
400MissingParameter.TagValueYou must specify Tag.N.Value.-
400InvalidParameter.TagKeyThe Tag.N.Key parameter is invalid.-
400InvalidParameter.TagValueThe Tag.N.Value parameter is invalid.-
400NumberExceed.TagsThe maximum number of Tags is exceeded.-
400QuotaExceed.TagsPerResourceThe maximum number of tags for each resource is exceeded.-
400Duplicate.TagKeyThe Tag.N.Key contains duplicate keys.-
403NoPermissionThe operator is not permission for this operate-
500InvalidOperation.ConcurrentModificationThe resource is modified concurrently.-

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

变更历史

变更时间变更内容概要操作
2024-04-01OpenAPI 错误码发生变更查看变更详情