Deleting Tags from a Network ACL in Batches

Function

This API is used to delete tags from a specified network ACL in batches. This is an idempotent API. If some tags to be deleted do not exist, the deletion is considered to be successful by default. The character set of the tags will not be checked. When you delete tags, the tag structure cannot be missing, and the key cannot be left blank or be an empty string.

URI

POST /v3/{project_id}/firewalls/{firewall_id}/tags/delete

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
firewall_id	Yes	String	The unique ID of a network ACL. The value is a string in UUID format. The network ACL with a given ID must exist.
project_id	Yes	String	Project ID

Request Parameters

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
tags	No	Array of DeleteResourceTagRequestBody objects	Tags

**Table 3** DeleteResourceTagRequestBody
Parameter	Mandatory	Type	Description
key	Yes	String	Tag key. The key of the same resource must be unique. Minimum: 1 Maximum: 128
value	No	String	Tag key Maximum: 255

Response Parameters

Status code: 400

**Table 4** Response body parameters
Parameter	Type	Description
request_id	String	Request ID
error_msg	String	Error message
error_code	String	Error code

Status code: 401

**Table 5** Response body parameters
Parameter	Type	Description
request_id	String	Request ID
error_msg	String	Error message
error_code	String	Error code

Status code: 403

**Table 6** Response body parameters
Parameter	Type	Description
request_id	String	Request ID
error_msg	String	Error message
error_code	String	Error code

Status code: 404

**Table 7** Response body parameters
Parameter	Type	Description
request_id	String	Request ID
error_msg	String	Error message
error_code	String	Error code

Status code: 500

**Table 8** Response body parameters
Parameter	Type	Description
request_id	String	Request ID
error_msg	String	Error message
error_code	String	Error code

Example Requests

Delete tags from a network ACL in batches. The key of the tag is keyxxx, and the value is value1.

POST https://{Endpoint}/v3/{project_id}/firewalls/{firewall_id}/tags/delete

{
  "tags" : [ {
    "key" : "keyxxx",
    "value" : "value1"
  } ]
}

Example Responses

None

Status Codes

Status Code	Description
204	Normal request response
400	Invalid parameter
401	Authentication failure
403	Insufficient permissions
404	Not found
500	System exception

Error Codes

See Error Codes.

Parent topic: Network ACL Tag Management

Previous topic: Adding Tags to a Network ACL in Batches

Next topic: Querying Tags of Network ACLs in a Project

Feedback

Was this page helpful?

Helpful Not helpful

Provide feedback

Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.

The system is busy. Please try again later.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel

For any further questions, feel free to contact us through the chatbot.

Chatbot