Network Pools APIs

APIs for managing Network Pools

Table of Contents

Create a Network Pool
Get the Network Pools
Get a Network Pool
Get a Network of a Network Pool
Rename a Network Pool
Delete a Network Pool
Add an IP Pool to a Network of a Network Pool
Delete an IP Pool from a Network of a Network Pool

1. Create a Network Pool

Used to create a Network pool in the system. The added network pool would be used during domain deployments, host commission/expansion flows.
If a network pool which is already added before is added, you will get an error with HTTP status 400.
If a malformed network pool is added (payload for network parameters, name which is already exist), you will get an error.

1.1. Prerequisites

The following data is required

Name
List of networks associated with network pool in which each network has
- Network type - It can be VSAN, VMOTION or NFS Type.
- VLAN ID - Valid Vlan id range is 0 to 4096.
- MTU - Valid MTU range is 1500 to 9216.
- Subnet - Networks of diferent types (e.g. VSAN/VMOTION/NFS) must not have overlapping subnets
- Subnet mask
- gateway - The gateway defined for the specified subnet
- List of IP address ranges - the start and end IP address of each IP Pool should be part of the subnet

1.2. Steps

Invoke the API

cURL Request

$ curl 'https://sfo-vcf01.rainpole.io/v1/network-pools' -i -X POST \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer etYWRta....' \
    -d '{
  "name" : "engineering-networkpool",
  "networks" : [ {
    "type" : "VSAN",
    "vlanId" : 3002,
    "mtu" : 9001,
    "subnet" : "192.168.8.0",
    "mask" : "255.255.252.0",
    "gateway" : "192.168.8.1",
    "ipPools" : [ {
      "start" : "192.168.8.5",
      "end" : "192.168.8.8"
    } ]
  } ]
}'

HTTP Request

POST /v1/network-pools HTTP/1.1
Content-Type: application/json
Content-Length: 304
Host: sfo-vcf01.rainpole.io
Authorization: Bearer etYWRta....

{
  "name" : "engineering-networkpool",
  "networks" : [ {
    "type" : "VSAN",
    "vlanId" : 3002,
    "mtu" : 9001,
    "subnet" : "192.168.8.0",
    "mask" : "255.255.252.0",
    "gateway" : "192.168.8.1",
    "ipPools" : [ {
      "start" : "192.168.8.5",
      "end" : "192.168.8.8"
    } ]
  } ]
}

HTTP Response

HTTP/1.1 201 Created
Location: /v1/network-pools/9ffada41-e8e4-49c7-8cbb-a36e1d505d97
Content-Type: application/json
Content-Length: 165

{
  "id" : "9ffada41-e8e4-49c7-8cbb-a36e1d505d97",
  "name" : "engineering-networkpool",
  "networks" : [ {
    "id" : "b9cfc657-0b6f-4bcb-a746-4b2817b1f319"
  } ]
}

1.3. Related APIs

[_createnetworkpool] API

2. Get the Network Pools

2.1. Prerequisites

None

2.2. Steps

Invoke the API

cURL Request

$ curl 'https://sfo-vcf01.rainpole.io/v1/network-pools' -i -X GET \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer etYWRta....'

HTTP Request

GET /v1/network-pools HTTP/1.1
Content-Type: application/json
Host: sfo-vcf01.rainpole.io
Authorization: Bearer etYWRta....

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 425

{
  "elements" : [ {
    "id" : "9c4a3df6-d5a0-4f76-a774-9c86d0b42ca8",
    "name" : "engineering-networkpool",
    "networks" : [ {
      "id" : "dbf6c049-7f44-4fdc-8961-6e35aa4b88c2"
    } ]
  }, {
    "id" : "c0275b31-e429-47ac-b9e4-bab4995439b5",
    "name" : "finance-networkpool",
    "networks" : [ {
      "id" : "95f0d979-1146-4692-9aac-72dd86d3dc84"
    } ]
  } ],
  "pageMetadata" : {
    "totalElements" : 2
  }
}

2.3. Related APIs

[_getnetworkpools] API [_getnetworkpool] API [_getnetworksofnetworkpool] API [_getnetworkofnetworkpool] API

3. Get a Network Pool

3.1. Prerequisites

The following data is required

ID of the network pool

3.2. Steps

Invoke the API

cURL Request

$ curl 'https://sfo-vcf01.rainpole.io/v1/network-pools/4fdb60c8-71d3-4491-80eb-7eb1f4fadfff' -i -X GET \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer etYWRta....'

HTTP Request

GET /v1/network-pools/4fdb60c8-71d3-4491-80eb-7eb1f4fadfff HTTP/1.1
Content-Type: application/json
Host: sfo-vcf01.rainpole.io
Authorization: Bearer etYWRta....

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 165

{
  "id" : "4fdb60c8-71d3-4491-80eb-7eb1f4fadfff",
  "name" : "engineering-networkpool",
  "networks" : [ {
    "id" : "d323dca2-882c-4a71-b926-7fdd4299b1a2"
  } ]
}

3.3. Related APIs

[_getnetworkpools] API [_getnetworkpool] API [_getnetworksofnetworkpool] API [_getnetworkofnetworkpool] API

4. Get a Network of a Network Pool

4.1. Prerequisites

The following data is required

ID of the network

4.2. Steps

Invoke the API

cURL Request

$ curl 'https://sfo-vcf01.rainpole.io/v1/network-pools/115d11ac-1878-443f-ad69-099d97141c0a/networks/5a6d1c2f-1892-4772-9472-f688d7b8ee1b' -i -X GET \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer etYWRta....'

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 270

{
  "id" : "5a6d1c2f-1892-4772-9472-f688d7b8ee1b",
  "type" : "VSAN",
  "vlanId" : 3002,
  "mtu" : 9216,
  "subnet" : "192.168.8.0",
  "mask" : "255.255.252.0",
  "gateway" : "192.168.8.1",
  "ipPools" : [ {
    "start" : "192.168.8.5",
    "end" : "192.168.8.8"
  } ]
}

4.3. Related APIs

[_getnetworkpools] API [_getnetworkpool] API [_getnetworksofnetworkpool] API [_getnetworkofnetworkpool] API

5. Rename a Network Pool

5.1. Prerequisites

Network pool must exist.

5.2. Steps

Get the ID of the network pool. Filter the response by the network pool's current name to get the corresponding ID.

Tip : Get the Network Pools |

Create a network pool update spec. Create a JSON with the "name" field containing the desired new network pool name.

Tip : NetworkPoolUpdateSpec.

Invoke the network pool rename (update) task using the input spec and network pool ID.

Note : Running the updateNetworkPool API will ensure that the requested new name is valid. The API call will fail if the requested new name is invalid.

cURL Request

$ curl 'https://sfo-vcf01.rainpole.io/v1/network-pools/1b8cb745-1bf6-46a6-8a97-68639ec48ece' -i -X PATCH \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer etYWRta....' \
    -d '{
  "name" : "new_name"
}'

HTTP Request

PATCH /v1/network-pools/1b8cb745-1bf6-46a6-8a97-68639ec48ece HTTP/1.1
Content-Type: application/json
Content-Length: 25
Host: sfo-vcf01.rainpole.io
Authorization: Bearer etYWRta....

{
  "name" : "new_name"
}

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 165

{
  "id" : "1b8cb745-1bf6-46a6-8a97-68639ec48ece",
  "name" : "engineering-networkpool",
  "networks" : [ {
    "id" : "c0a78f40-73b9-4e41-97eb-3302d57d16b7"
  } ]
}

5.3. Related APIs

[_updatenetworkpool] API [_getnetworkpool] API [_getnetworkpools] API

6. Delete a Network Pool

Used to delete a Network pool.
Deleting a networkpool which is being used, will give an error.
Deleting a networkpool which does not exist, will give a HTTP response code 404.

6.1. Prerequisites

The following data is required

ID of the network pool

6.2. Steps

Invoke the API

Tip : Refer to: Get the Network Pools to retrieve all network pools in the system and use the ID of network pool to be deleted.

cURL Request

$ curl 'https://sfo-vcf01.rainpole.io/v1/network-pools/b820434f-cd20-4c34-94f1-146c7378ba2d' -i -X DELETE \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer etYWRta....'

HTTP Request

DELETE /v1/network-pools/b820434f-cd20-4c34-94f1-146c7378ba2d HTTP/1.1
Content-Type: application/json
Host: sfo-vcf01.rainpole.io
Authorization: Bearer etYWRta....

HTTP Response

HTTP/1.1 204 No Content

6.3. Related APIs

[_deletenetworkpool] API [_getnetworkpools] API [_getnetworkpool] API

7. Add an IP Pool to a Network of a Network Pool

7.1. Prerequisites

The following data is required

ID of the network pool

Tip : Refer to: Get the Network Pools |

ID of the network.

Tip : Refer to: Get a Network of a Network Pool |

The start and end IP addresses for the IP pool

7.2. Steps

Invoke the API

cURL Request

$ curl 'https://sfo-vcf01.rainpole.io/v1/network-pools/96f1a8f7-9009-4f9f-b3b7-f744b37bff99/networks/f2fd37f9-4825-4b96-88c0-5fac223015c8/ip-pools' -i -X POST \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer etYWRta....' \
    -d '{
  "start" : "192.168.8.5",
  "end" : "192.168.8.8"
}'

HTTP Request

POST /v1/network-pools/96f1a8f7-9009-4f9f-b3b7-f744b37bff99/networks/f2fd37f9-4825-4b96-88c0-5fac223015c8/ip-pools HTTP/1.1
Content-Type: application/json
Content-Length: 54
Host: sfo-vcf01.rainpole.io
Authorization: Bearer etYWRta....

{
  "start" : "192.168.8.5",
  "end" : "192.168.8.8"
}

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 270

{
  "id" : "f00ede7d-d70e-4ec0-b1b0-dcded778decf",
  "type" : "VSAN",
  "vlanId" : 3002,
  "mtu" : 9216,
  "subnet" : "192.168.8.0",
  "mask" : "255.255.252.0",
  "gateway" : "192.168.8.1",
  "ipPools" : [ {
    "start" : "192.168.8.5",
    "end" : "192.168.8.8"
  } ]
}

7.3. Related APIs

[_addippooltonetworkofnetworkpool] API [_getnetworkpools] API [_getnetworkpool] API [_getnetworksofnetworkpool] API [_getnetworkofnetworkpool] API

8. Delete an IP Pool from a Network of a Network Pool

8.1. Prerequisites

The following data is required

ID of the IP pool

8.2. Steps

Invoke the API

cURL Request

$ curl 'https://sfo-vcf01.rainpole.io/v1/network-pools/cab0a6d6-5569-4acc-928a-bbf198520474/networks/a0150599-5e43-432c-be4b-3aa7423482f2/ip-pools' -i -X DELETE \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer etYWRta....' \
    -d '{
  "start" : "192.168.8.5",
  "end" : "192.168.8.8"
}'

HTTP Request

DELETE /v1/network-pools/cab0a6d6-5569-4acc-928a-bbf198520474/networks/a0150599-5e43-432c-be4b-3aa7423482f2/ip-pools HTTP/1.1
Content-Type: application/json
Content-Length: 54
Host: sfo-vcf01.rainpole.io
Authorization: Bearer etYWRta....

{
  "start" : "192.168.8.5",
  "end" : "192.168.8.8"
}

HTTP Response

HTTP/1.1 204 No Content

8.3. Related APIs

[_deleteippoolfromnetworkofnetworkpool] API [_getnetworkpools] API [_getnetworkpool] API [_getnetworksofnetworkpool] API [_getnetworkofnetworkpool] API
Last updated 2025-03-21 15:13:04 +0530

Operations

GET

Get Network Pool

Get the list of all Network Pools

POST

Create Network Pool

Create a Network Pool

POST

Add Ip Pool To Network Of Network Pool

Add an IP Pool to a Network of a Network Pool

DELETE

Delete Ip Pool From Network Of Network Pool