NSX-T Data Center REST API

IpAddressBlock Free Subnets

Returns the number of subnets that can be carved for a given subnet mask, from the IpAddressBlock

Request:

Method:

GET

URI Path(s):

/policy/api/v1/infra/ip-blocks/{ip-block-id}/available-subnets

Request Headers:

n/a

Query Parameters:

MaskBasedAllocationStatePathRequestParams+

MaskBasedAllocationStatePathRequestParams (schema)

Name	Description	Type	Notes
mask	The subnet mask. For IpV4, its 0 to 32. For IpV6 its 0 to 128	int

Request Body:

n/a

Successful Response:

Response Code:

200 OK

Response Headers:

Content-type: application/json

Response Body:

IpAddressBlockAvailableSubnetsCount+

IpAddressBlockAvailableSubnetsCount (schema)

Name	Description	Type	Notes
free_subnets	Number of free subnets of given size in IpAddressBlock	string

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