Updating Address Group Information
Function
This API is used to update address group information.
URI
PUT /v1/{project_id}/address-sets/{set_id}
Parameter | Mandatory | Type | Description |
|---|---|---|---|
project_id | Yes | String | Project ID, which can be obtained by calling an API or from the console. For details, see Obtaining a Project ID. |
set_id | Yes | String | Address group ID, which can be obtained by calling the API for querying the address group list. Find the value in data.records.set_id (The period [.] is used to separate different levels of objects). |
Parameter | Mandatory | Type | Description |
|---|---|---|---|
enterprise_project_id | No | String | Enterprise project ID, which is the ID of a project planned based on organizations. If the enterprise project function is not enabled, the value is 0. |
fw_instance_id | No | String | Firewall ID, which can be obtained by referring to Obtaining a Firewall ID. |
Request Parameters
Parameter | Mandatory | Type | Description |
|---|---|---|---|
X-Auth-Token | Yes | String | User token. It can be obtained by calling the IAM API (value of X-Subject-Token in the response header). |
Parameter | Mandatory | Type | Description |
|---|---|---|---|
name | No | String | IP address group name. |
description | No | String | Address group description. |
Response Parameters
Status code: 200
Parameter | Type | Description |
|---|---|---|
data | UpdateAddressSetResponseData object | Data returned after an address group is updated. |
Parameter | Type | Description |
|---|---|---|
id | String | Address group ID. |
name | String | IP address group name. |
Status code: 400
Parameter | Type | Description |
|---|---|---|
error_code | String | Definition Error code. Range N/A |
error_msg | String | Definition Error description. Range N/A |
Example Requests
Change the name of address group cf18f0b1-0ce7-4eb8-83b6-4b33c8448e16 in project 9d80d070b6d44942af73c9c3d38e0429 to ABCD.
https://{Endpoint}/v1/9d80d070b6d44942af73c9c3d38e0429/address-sets/cf18f0b1-0ce7-4eb8-83b6-4b33c8448e16
{
"name" : "ABCD",
"description" : ""
} Example Responses
Status code: 200
OK
{
"data" : {
"id" : "cf18f0b1-0ce7-4eb8-83b6-4b33c8448e16"
}
} Status code: 400
Bad Request
{
"error_code" : "CFW.00200005",
"error_msg" : "Object not found."
} Status Codes
Status Code | Description |
|---|---|
200 | OK |
400 | Bad Request |
401 | Unauthorized: Request error. |
403 | Forbidden: Access forbidden. |
404 | Not Found: Web page not found. |
500 | Internal Server Error |
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
