System Administration > Configuration > Fabric > Pool Management > IP Blocks

Allocate or Release an IP Address from a Ip Subnet

Allocates or releases an IP address from the specified IP subnet. To allocate
an address, include ?action=ALLOCATE in the request and a "{}"
in the request body. When the request is successful, the response is
"allocation_id": "<ip-address>", where <ip-address> is an IP address from
the specified pool. To release an IP address (return it back to the pool),
include ?action=RELEASE in the request and "allocation_id":<ip-address> in
the request body, where <ip-address> is the address to be released. When the
request is successful, the response is NULL.

Request:

Method:
POST
URI Path(s):
/api/v1/pools/ip-subnets/<subnet-id>
Request Headers:
n/a
Query Parameters:
AllocationAction+
Request Body:
AllocationIpAddress+

Example Request:

POST https://<nsx-mgr>/api/v1/pools/ip-subnets/5a5f22a8-8293-4212-93df-99286d20e25c?action=ALLOCATE {}

Successful Response:

Response Code:
200 OK
Response Headers:
Content-type: application/json
Response Body:
AllocationIpAddress+

Example Response:

{ "allocation_id":"192.168.0.1" }

Required Permissions:

crud

Feature:

ipam_ipam

Additional Errors: