调用TagResources接口,为资源添加用户标签。
下表中,Tags.N.a类型参数中的“N”表示标签信息的序号,需按照数字顺序从1开始填写,取值范围为1~50。多个标签之间使用&分隔。每个标签键对应一个标签值。
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | TagResources | 要执行的操作,取值为TagResources。 |
Version | String | 是 | 2020-04-01 | API版本信息,当前版本为2020-04-01。 |
ResourceType | String | 是 | transitrouter | 资源的类型,取值如下:
|
ResourceIds.N | String | 是 | ResourceIds.1=tr-273sdsdsxxxxxp8u2j****&ResourceIds.2=tr-2fe6fszjgeznk5oxruv0u**** | 资源的ID。
说明
|
Tags.N.Key | String | 是 | Tags.1.Key=k1&Tags.2.Key=k2 | 用户标签的标签键。
说明
|
Tags.N.Value | String | 否 | Tags.1.Value=v1&Tags.2.Value=v2 | 用户标签的标签值。
说明 如果传入该参数,则必须先传入 |
本接口无特有的返回参数。更多信息请见返回结构。
GET /?Action=TagResources&Version=2020-04-01&ResourceType=transitrouter&ResourceIds.1=tr-273sdsdsxxxxxp8u2j****&ResourceIds.2=tr-2fe6fszjgeznk5oxruv0u****&Tags.1.Key=k1&Tags.2.Key=k2&Tags.1.Value=v1&Tags.2.Value=v2 HTTP/1.1 Host: open.volcengineapi.com ServiceName: transitrouter Region: cn-guangzhou
{ "ResponseMetadata": { "RequestId": "2021062415303301022514515207C4****", "Action": "TagResources", "Version": "2020-04-01", "Service": "transitrouter", "Region": "cn-guangzhou" }, "Result": { "RequestId": "2021062415303301022514515207C4****" } }
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidResourceType.Malformed | The specified parameter resource type is invalid. | 资源类型不合法。 |
400 | InvalidTag.Disorder | The specified index order of tag is malformed. | 指定标签的索引顺序参数格式不合法。 |
400 | InvalidTagKey.Malformed | The specified parameter tag key is invalid. | 标签键不合法。 |
400 | InvalidTagValue.Malformed | The specified parameter tag value is invalid. | 标签值不合法。 |
400 | LimitExceeded.Resource | You've reached the limit on the number of resources that you can operate at a time. | 已达到单次可操作资源数量的上限。 |
400 | LimitExceeded.Tags | You've reached the limit on the number of tags that you can operate at a time. | 已达到单次可操作标签数量的上限。 |
400 | QuotaExceeded.ResourceSystemTags | You've reached the limit on the number of system tags that you can create. | 已达到单个资源可创建系统标签的数量的配额上限。 |
400 | QuotaExceeded.ResourceTags | You've reached the limit on the number of resource tags that you can create. | 已达到单个资源可创建用户标签的数量的配额上限。 |
404 | InvalidResource.NotFound | The specified resource does not exist. | 指定的资源不存在。 |