Querying Details of an IP Address Group
Function
This API is used to query details of an IP address group.
URI
GET /v3/{project_id}/vpc/address-groups/{address_group_id}
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
address_group_id |
Yes |
String |
IP address group ID that uniquely identifies the IP address group. |
project_id |
Yes |
String |
Project ID. For details about how to obtain a project ID, see Obtaining a Project ID. |
Request Parameter
None
Example Request
- Querying details of an IP address group
"GET https://{Endpoint}/v3/2bc7a67b35a64a79ad1d3bb8b5f61fc9/vpc/address-groups/dd18a501-fcd5-4adc-acfe-b0e2384baf08"
Response Parameter
When the status code is 200, the response parameters are as follows:
Parameter |
Type |
Description |
---|---|---|
request_id |
String |
Request ID |
address_group |
AddressGroup object |
Response body of querying an IP address group |
Parameter |
Type |
Description |
---|---|---|
id |
String |
|
name |
String |
|
description |
String |
|
ip_set |
Array of strings |
|
ip_version |
Integer |
|
created_at |
String |
|
updated_at |
String |
|
tenant_id |
String |
|
max_capacity |
Integer |
|
enterprise_project_id |
String |
|
tags |
Array of ResourceTag objects |
IP address group tags. |
status |
String |
|
status_message |
String |
|
ip_extra_set |
Array of IpExtraSetRespOption objects |
|
Parameter |
Type |
Description |
---|---|---|
key |
String |
Tag key. Each key value of a resource must be unique. Minimum length: 1 Maximum length: 128 |
value |
String |
Tag value Maximum length: 255 |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
ip |
Yes |
String |
An IP address, IP address range, or CIDR block. Both IPv4 and IPv6 are supported. |
remarks |
No |
String |
Provides supplementary information about the IP address, IP address range, or CIDR block. The value can contain up to 255 characters and cannot contain angle brackets (< or >). |
Example Response
When the status code is 200, the response parameters are as follows:
{ "address_group": { "id": "dd18a501-fcd5-4adc-acfe-b0e2384baf08", "name": "AutoTester746010.580123789", "tenant_id": "b2782e6708b8475c993e6064bc456bf8", "ip_version": 4, "ip_set": [ "192.168.5.0/24", "192.168.3.20-192.168.3.100", "192.168.3.40", "192.168.3.2" ], "ip_extra_set": [{ "ip": "192.168.5.0/24", "remarks": null }, { "ip": "192.168.3.20-192.168.3.100", "remarks": null }, { "ip": "192.168.3.40", "remarks": null }, { "ip": "192.168.3.2", "remarks": null }], "created_at": "2019-06-28T02:06:38", "updated_at": "2019-06-28T02:06:38", "description": "10.10.4.0/23", "enterprise_project_id": "0aad99bc-f5f6-4f78-8404-c598d76b0ed2", "tags": [], "max_capacity": 20, "status": "NORMAL", "status_message": "" }, "request_id": "ce6c359b-9002-41e5-a0b1-232759bd6637" }
Status Code
See Status Codes.
Error Code
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