最近更新时间：2024.02.29 14:48:22
首次发布时间：2023.08.09 11:12:30
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. | 指定的资源不存在。 |