Adding a Tag to a Network ACL
Function
This API is used to add a tag to a specific network ACL. This is an idempotent API. If the new tag has the same key as an existing tag, the tag will be created and overwrite the existing one.
URI
POST /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
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
tag |
Yes |
ResourceTag object |
Request body for adding tags to a network ACL |
Response Parameters
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
Add a tag to a network ACL. Set the tag key to key4 and tag value to value4.
POST https://{Endpoint}/v3/{project_id}/firewalls/{firewall_id}/tags { "tag" : { "key" : "key4", "value" : "value4" } }
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.
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