Policy >
Networking
>
IP Management
>
IP Address Pools
>
IP Blocks
Get an IpAddressBlock usage
Get IpAddressBlock usage with given Id.
Request:
Method:
GET
URI Path(s):
/policy/api/v1/infra/ip-blocks/{ip-block-id}/usage
/policy/api/v1/orgs/{org-id}/projects/{project-id}/infra/ip-blocks/{ip-block-id}/usage
Request Headers:
n/a
Query Parameters:
n/a
Request Body:
n/a
Example Request:
GET https://<policy-mgr>/policy/api/v1/infra/ip-blocks/Finance-block/usage
Successful Response:
Response Code:
200 OK
Response Headers:
Content-type: application/json
Response Body:
IpAddressBlockUsage
+
IpAddressBlockUsage
(
schema
)
Name
Description
Type
Notes
available_ip_ranges
Available IP ranges in an IpAddressBlock
This represents available ip ranges of an IpAddressBlock.
array of string
Readonly
used_ip_ranges
Used IP ranges in an IpAddressBlock
This represents used ip ranges of an IpAddressBlock.
array of string
Readonly
Example Response:
{ "used_ip_ranges": [ "192.168.0.0-192.168.0.63", "192.168.0.64-192.168.0.79", "192.168.0.96-192.168.0.127" ], "available_ip_ranges": [ "192.168.0.80-92.168.0.95", "192.168.0.128-192.168.0.255" ] }
Required Permissions:
read
Feature:
policy_ipam
Additional Errors:
301 Moved Permanently
307 Temporary Redirect
400 Bad Request
403 Forbidden
409 Conflict
412 Precondition Failed
500 Internal Server Error
503 Service Unavailable