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. Minimum: 1 Maximum: 128
value	String	Tag value. 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"
  } ]
}

Status Codes

Status Code	Description
200	Normal response to the GET operation
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

Предыдущая статья

Delete a Tag from a Network ACL

Следующая статья

Adding Tags to a Network ACL in Batches

Была ли эта статья полезна?

Поддержка Юридические документы