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
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
Parameter |
Type |
Description |
---|---|---|
tags |
Array of ResourceTag objects |
Tags |
request_id |
String |
Request ID |
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
Parameter |
Type |
Description |
---|---|---|
request_id |
String |
Request ID |
error_msg |
String |
Error message |
error_code |
String |
Error code |
Status code: 401
Parameter |
Type |
Description |
---|---|---|
request_id |
String |
Request ID |
error_msg |
String |
Error message |
error_code |
String |
Error code |
Status code: 403
Parameter |
Type |
Description |
---|---|---|
request_id |
String |
Request ID |
error_msg |
String |
Error message |
error_code |
String |
Error code |
Status code: 404
Parameter |
Type |
Description |
---|---|---|
request_id |
String |
Request ID |
error_msg |
String |
Error message |
error_code |
String |
Error code |
Status code: 500
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.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot