批量删除ACL资源标签
功能介绍
为指定的ACL资源实例批量删除标签。
此接口为幂等接口:删除时,如果删除的标签不存在,默认处理成功;删除时不对标签字符集范围做校验。删除时tags结构体不能缺失,key不能为空,或者空字符串。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。
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 |
系统异常 |
错误码
请参见错误码。