给资源打标签。当前支持实例 Instance 资源。
接口说明
单个实例最多可绑定 20 条标签。绑定标签前,阿里云会校验资源已有标签数量,超过限制值会返回报错信息。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
cr:TagResources |
create |
*Instance
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| ResourceType |
string |
是 |
资源类型。当前支持实例 Instance 资源。 枚举值:
|
Instance |
| ResourceId |
array |
是 |
资源 ID。最多支持添加 20 个资源。 |
|
|
string |
否 |
资源 ID。 |
cri-1lg7vtctpqdn**** |
|
| RegionId |
string |
是 |
地域 ID。 |
cn-hangzhou |
| Tag |
array<object> |
是 |
标签列表。 |
|
|
object |
否 |
标签列表。 |
||
| Key |
string |
否 |
资源的标签键。最多支持输入 20 个标签键。如需传入该值,则不能输入空字符串。 一个标签键最多支持 128 个字符,不能以 aliyun 和 acs:开头,不能包含 http://或者 https://。 |
test-key |
| Value |
string |
否 |
资源的标签值。最多支持输入 20 个标签值。如需传入该值,可以输入空字符串。 最多支持 128 个字符,不能以 aliyun 和 acs:开头,不能包含 http://或者 https://。 |
test-val |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
请求 ID |
E9A586D0-3977-5C28-A44D-55D3A9CD53CC |
示例
正常返回示例
JSON格式
{
"RequestId": "E9A586D0-3977-5C28-A44D-55D3A9CD53CC"
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | SystemError | A system error occurred while processing your request | 系统异常。 |
| 400 | InvalidParameter.ResourceId | The ResourceId parameter is invalid. | |
| 400 | InvalidResourceId.NotFound | The specified ResourceIds are not found in our records. | |
| 400 | NumberExceed.ResourceIds | The maximum number of ResourceIds is exceeded. | |
| 400 | InvalidParameter.RegionId | The RegionId parameter is invalid. | |
| 400 | InvalidParameter.ResourceType | The ResourceType parameter is invalid. | |
| 400 | MissingParameter.ResourceIds | You must specify ResourceId.N. | |
| 400 | MissingParameter.ResourceType | You must specify ResourceType. | |
| 400 | MissingParameter.Tags | You must specify Tags. | |
| 400 | MissingParameter.TagKey | You must specify Tag.N.Key. | |
| 400 | MissingParameter.TagValue | You must specify Tag.N.Value. | |
| 400 | InvalidParameter.TagKey | The Tag.N.Key parameter is invalid. | |
| 400 | InvalidParameter.TagValue | The Tag.N.Value parameter is invalid. | |
| 400 | NumberExceed.Tags | The maximum number of Tags is exceeded. | |
| 400 | QuotaExceed.TagsPerResource | The maximum number of tags for each resource is exceeded. | |
| 400 | Duplicate.TagKey | The Tag.N.Key contains duplicate keys. | |
| 500 | InvalidOperation.ConcurrentModification | The resource is modified concurrently. | |
| 403 | NoPermission | The operator is not permission for this operate |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。