Updated on 2024-08-01 GMT+08:00

Delete a Tag from a Network ACL

Function

This API is used to delete a tag from a specified network ACL. This is an idempotent API. The tag key cannot be left blank or be an empty string. If the key of the tag to be deleted does not exist, 404 will be returned.

URI

DELETE /v3/{project_id}/firewalls/{firewall_id}/tags/{tag_key}

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

tag_key

Yes

String

Tag key

Request Parameters

None

Response Parameters

Status code: 400

Table 2 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 3 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 4 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 5 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 6 Response body parameters

Parameter

Type

Description

request_id

String

Request ID

error_msg

String

Error message

error_code

String

Error code

Example Requests

Delete a tag from a network ACL.

DELETE https://{Endpoint}/v3/{project_id}/firewalls/{firewall_id}/tags/{tag_key}

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.