API 名称:UntagResources 。
API 域名:open.volcengineapi.com 。
API 描述:调用 UntagResources 接口,为资源删除用户标签。
节流限制:每秒最多提交 5 个 API 请求。
在使用该部分 API 提交请求时必须包含以下 URI 参数。
除了 URI 参数,该 API 请求还需要包含签名参数。关于更多签名参数的信息,参见公共请求参数 。
名称 | 类型 | 是否必选 | 格式 | 说明 |
---|---|---|---|---|
Action | string | 是 | [a-zA-Z]+ | API 名称,如 UntagResources 。 |
Version | string | 是 | YYYY-MM-DD | API 版本信息。该参数的取值是 2020-04-01 。 |
在使用该 API 提交请求时,请求参数中可以包含的参数如下。
参数 | 类型 | 是否必选 | 参数说明 | 示例值 |
---|---|---|---|---|
ResourceType | String | 是 | 资源的类型,取值为 loadbalancer。 | loadbalancer |
ResourceIds.N | String | 是 | 资源的ID。参数 - N:表示资源 ID的序号,单次调用数量上限50个。多个资源 ID之间使用&分隔。 | ResourceIds.1=alb-273sdsdsxxxxxp8u2j****&ResourceIds.2=alb-2fe6fszjgeznk5oxruv0u**** |
TagKeys.N | String | 是 | 待删除用户标签的标签键。具体规则如下:
| TagKeys.1=k1&TagKeys.2=k2 |
参数 | 类型 | 参数说明 | 示例值 |
---|---|---|---|
RequestId | String | 请求ID。 | 2021062415303301022514515207C4**** |
GET /?Action=UntagResources&ResourceType=loadbalancer&ResourceIds.1=alb-r1rvlqgt58u83dvb46c1j2fi&TagKeys.1=yxl12&Version=2020-04-01&AccountId=2100052283" -H "X-Top-Account-Id: 2100052283"
{ "ResponseMetadata":{ "RequestId":"94f928f1-0033-4ff2-b407-d91b56282967", "Action":"UntagResources", "Version":"2020-04-01" }, "Result":{ "RequestId":"94f928f1-0033-4ff2-b407-d91b56282967" } }
如果响应正文包含 Error 字段,则表示 API 请求失败。此处仅展示当前 API 的错误码,更多错误码请参见公共错误码。
HTTP Code | 错误码 | 错误信息 | 错误描述 |
---|---|---|---|
400 | LimitExceed.TagKey | You've reached the limit on the number of tag keys that you can operate at a time. | 已达到单次可操作的标签键的数量上限。 |
400 | LimitExceed.Resource | You've reached the limit on the number of resources that you can operate at a time. | 已达到单次可操作的资源的数量上限。 |
400 | InvalidResourceType.Malformed | The specified ResourceType is malformed. | 指定的 ResourceType 参数格式不合法。 |
400 | MissingParameter | The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request; for example, 'ResourceIds'. | 该请求缺少必要参数。请确保发起请求已提供全部必要参数,比如: ResourceIds。 |
400 | MissingParameter | The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request; for example, 'TagKeys'. | 该请求缺少必要参数。请确保发起请求已提供全部必要参数,比如: TagKeys。 |
400 | InvalidTagKeys.Malformed | The specified TagKeys is malformed. | 指定的 TagKeys 参数格式不合法。 |
404 | InvalidResource.NotFound | The specified Resource does not exist. | 指定的资源不存在。 |