调用 CreateTags 接口为一个或多个资源添加用户标签。
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateTags | 要执行的操作,取值:CreateTags。 |
Version | String | 是 | 2020-04-01 | API的版本,取值:2020-04-01。 |
ClientToken | String | 否 | 333456899ff**** | 保证请求幂等性。由客户端自动生成一个参数值,确保不同请求间该参数值唯一,避免当调用API超时或服务器内部错误时,客户端多次重试导致重复性操作。 |
ResourceIds.N | Array of String | 是 | ResourceIds.1=i-l8u0p77yseabkpak****&ResourceIds.2=i-l8u0p7xyseabkbak**** | 资源ID。
|
ResourceType | String | 是 | instance | 资源类型,取值:
|
Tags.N.Key | Array of String | 是 | Tags.1.Key=k1 | 为资源添加的用户标签的标签键。
|
Tags.N.Value | Array of String | 否 | Tags.1.Value=v1 | 为资源添加的用户标签的标签值。
|
下表仅列出本接口特有的返回参数。更多信息请参见返回结构。
说明
仅当请求参数输入不合法时提示下文中的接口错误码。若请求参数输入无误,将不会提示接口错误码,且接口的返回状态码将为200,但这并不代表对所有资源的操作均已成功,单个资源的操作结果请参见如下返回参数中的信息。
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
OperationDetails | Array of Object | -- | 操作详情。 |
GET /?Action=CreateTags&Version=2020-04-01&ResourceType=instance&ResourceIds.1=i-l8u0p77yseabkpak****&ResourceIds.2=i-l8u0p7xyseabkbak****&Tags.1.Key=k1&Tags.1.Value=v1 HTTP/1.1 Host: open.volcengineapi.com Region: cn-beijing ServiceName: ecs
{ "ResponseMetadata": { "RequestId": "2021062415303301022514515207C4****", "Action": "CreateTags", "Version": "2020-04-01", "Service": "ecs", "Region": "cn-beijing" }, "Result": { "OperationDetails": [ { "Error": null, "ResourceId": "i-l8u0p77yseabkpak****" }, { "Error": { "Code": "InvalidResourceId.NotFound", "Message": "The specified ResourceId does not exist." }, "ResourceId": "i-l8u0p7xyseabkbak****" } ] } }
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
状态码 | 错误码 | 说明 |
---|---|---|
400 | IdempotentParameterMismatch | 幂等参数不一致。 |
400 | InvalidClientToken.Malformed | 指定的ClientToken不合法。 |
400 | InvalidTagKey.Malformed | 指定的标签的键不合法。 |
400 | InvalidTagValue.Malformed | 指定的标签的值不合法。 |
400 | LimitExceeded.MaximumResourceIds | 指定的资源ID数量超过限制。 |
400 | LimitExceeded.MaximumTags | 指定的标签数量超过最大限制。 |
400 | QuotaExceeded.MaximumTags | 已达到单个资源可创建标签上限。 |
404 | InvalidResourceId.NotFound | 指定资源不存在。 |
404 | InvalidResourceType.NotFound | 指定的资源类型不存在。 |
404 | InvalidTag.NotFound | 指定的键值不存在。 |
409 | InvalidTagKey.Conflict | 指定的标签键已存在。 |
412 | IdempotentProcessing | 先前的幂等请求仍在处理中,请稍后重试。 |
500 | InternalError | 内部错误,请重试。如果多次尝试失败,请提交工单。 |