NSX-T Data Center REST API

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

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