Querying Tags of Network ACLs

Function

This API is used to query tags of a specific network ACL.

URI

GET /v3/{project_id}/firewalls/{firewall_id}/tags

**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

None

Response Parameters

Status code: 200

**Table 2** Response body parameters
Parameter	Type	Description
tags	Array of ResourceTag objects	Tags
request_id	String	Request ID

**Table 3** ResourceTag
Parameter	Type	Description
key	String	Tag key Tag keys must be unique for each resource. Maximum length: 128 Minimum: 1 Maximum: 128
value	String	Tag value Maximum length: 255 Maximum: 255

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

Query tags of a network ACL.

GET https://{Endpoint}/v3/{project_id}/firewalls/{firewall_id}/tags

Example Responses

Status code: 200

Normal response to the GET operation

{
  "request_id" : "95cedc2b-4b3d-4e5c-af29-74576daf5513",
  "tags" : [ {
    "key" : "key5",
    "value" : "value5"
  }, {
    "key" : "key1",
    "value" : "value1"
  } ]
}