批量删除ACL资源标签
功能介绍
为指定的ACL资源实例批量删除标签。
此接口为幂等接口:删除时,如果删除的标签不存在,默认处理成功;删除时不对标签字符集范围做校验。删除时tags结构体不能缺失,key不能为空,或者空字符串。
URI
POST /v3/{project_id}/firewalls/{firewall_id}/tags/delete
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
firewall_id |
是 |
String |
功能说明:ACL唯一标识 取值范围:合法UUID 约束:ID对应的ACL必须存在 |
|
project_id |
是 |
String |
项目ID |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
tags |
是 |
Array of DeleteResourceTagRequestBody objects |
标签列表 |
响应参数
状态码:400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
request_id |
String |
请求ID。 |
|
error_msg |
String |
错误消息。 |
|
error_code |
String |
错误码。 |
状态码:401
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
request_id |
String |
请求ID。 |
|
error_msg |
String |
错误消息。 |
|
error_code |
String |
错误码。 |
状态码:403
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
request_id |
String |
请求ID。 |
|
error_msg |
String |
错误消息。 |
|
error_code |
String |
错误码。 |
状态码:404
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
request_id |
String |
请求ID。 |
|
error_msg |
String |
错误消息。 |
|
error_code |
String |
错误码。 |
状态码:500
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
request_id |
String |
请求ID。 |
|
error_msg |
String |
错误消息。 |
|
error_code |
String |
错误码。 |
请求示例
批量删除网络ACL标签,标签key为keyxxx,value为value1。
POST https://{Endpoint}/v3/{project_id}/firewalls/{firewall_id}/tags/delete
{
"tags" : [ {
"key" : "keyxxx",
"value" : "value1"
} ]
}
响应示例
无
状态码
|
状态码 |
描述 |
|---|---|
|
204 |
请求正常返回 |
|
400 |
参数非法 |
|
401 |
鉴权失败 |
|
403 |
权限不足 |
|
404 |
资源未找到 |
|
500 |
系统异常 |
错误码
请参见错误码。