You need to enable JavaScript to run this app.
导航
UntagResources
最近更新时间:2024.12.03 17:51:42首次发布时间:2023.08.09 11:12:30

请求说明

API 名称:UntagResources 。
API 域名:open.volcengineapi.com 。
API 描述:为资源删除用户标签。

使用限制

节流限制:每秒最多提交 5 个 API 请求。

调试

URI 参数

在使用该部分 API 提交请求时必须包含以下 URI 参数。

除了 URI 参数,该 API 请求还需要包含签名参数。关于更多签名参数的信息,参见公共请求参数 。

名称类型是否必选格式说明
Action
string
[a-zA-Z]+
API 名称,如 UntagResources 。
VersionstringYYYY-MM-DDAPI 版本信息。该参数的取值是 2020-04-01 。
X-Expiresint900表示签名的有效时间,单位是秒,默认值是900。

请求参数

在使用该 API 提交请求时,请求参数中可以包含的参数如下。

参数类型是否必选参数说明示例值

ResourceType

String

资源类型。取值范围:

  • loadbalancer:负载均衡实例。

  • listener:监听器。

  • servergroup:后端服务器组。

loadbalancer

ResourceIds.NString资源的ID。参数 - N:表示资源 ID的序号,单次调用数量上限50个。多个资源 ID之间使用&分隔。ResourceIds.1=alb-273sdsdsxxxxxp8u2j****&ResourceIds.2=alb-2fe6fszjgeznk5oxruv0u****

TagKeys.N

String

待删除用户标签的标签键。具体规则如下:

  • 不能以空格开头或结尾。

  • 参数 - N:表示标签键的序号,单次调用数量上限50个。多个标签键之间使用&分隔。

TagKeys.1=k1&TagKeys.2=k2

返回参数

参数类型参数说明示例值
RequestIdString请求ID。2021062415303301022514515207C4****

示例

请求示例

GET /?Action=UntagResources&Version=2020-04-01&ResourceType=loadbalancer&ResourceIds.1=alb-r1rvlqgt58u83dvb46c1****&TagKeys.1=yxl12
Host: open.volcengineapi.com
Region: cn-beijing
ServiceName: alb

返回示例

{
    "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.

已达到单次可操作的资源的数量上限。

400InvalidResourceType.MalformedThe 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。

400InvalidTagKeys.MalformedThe specified TagKeys is malformed.指定的 TagKeys 参数格式不合法。
404InvalidResource.NotFoundThe specified Resource does not exist.指定的资源不存在。