调用TagResources为指定的ENS资源列表统一创建并绑定标签。
接口说明
绑定标签前,阿里云会校验资源已有标签数量。超过限制值后返回报错信息。当前只支持实例(虚机/祼机等)资源。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
ens:TagResources |
create |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| Tag |
array<object> |
是 |
实例所绑定的标签 |
|
|
object |
是 |
资源的标签。 |
||
| Key |
string |
是 |
资源的标签键。N 的取值范围:1~20。一旦传入该值,则不允许为空字符串。最多支持 128 个字符,不能以 aliyun 和 acs:开头,不能包含 http://或者 https://。 |
team |
| Value |
string |
是 |
资源的标签值。N 的取值范围:1~20。一旦传入该值,可以为空字符串。最多支持 128 个字符,不能以 acs:开头,不能包含 http://或者 https://。 |
Deep |
| ResourceId |
array |
是 |
资源 ID 列表。一次调用最多支持添加 50 个资源 ID。 |
|
|
string |
是 |
资源 ID。 |
i-5**** |
|
| ResourceType |
string |
是 |
资源类型。取值:instance(实例)。 |
instance |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
请求 ID。 |
C50C391C-533A-55D3-AC97-5D9333DE288F |
示例
正常返回示例
JSON格式
{
"RequestId": "C50C391C-533A-55D3-AC97-5D9333DE288F"
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | InvalidResourceId.NotFound | The specified ResourceIds are not found in our records. | 指定的资源信息不存在。 |
| 400 | ens.interface.error | Failed to call API. | 接口调用发生异常。 |
| 400 | NoPermission | Permission denied. | |
| 400 | InvalidParameter.%s | The specified field %s invalid. Please check it again. | |
| 403 | NoPermission | The operator is not permission for this operate |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。