Creates an IP pool defintion for the sepcified private gateway

POST 
https://api.spectrocloud.com/v1/overlords/vsphere/:uid/pools

Creates an IP pool defintion for the sepcified private gateway

Request

Path Parameters

uid stringrequired

Header Parameters

ProjectUid string

Scope the request to the specified project uid

application/json

Body

metadata

object

ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.

annotations

object

Annotations are system generated key value metadata for the resource. As an input certain annotations like description can be set.

property name*string

creationTimestampdate-time

Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.

deletionTimestampdate-time

Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.

labels

object

Labels are key value data to organize and categorize resources. Providing spectro__tag as value for a label is considered as a kubernetes compliant tag

property name*string

lastModifiedTimestampdate-time

Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.

namestring

Name of the resource.

uidstring

UID is the unique identifier generated for the resource. This is not an input field for any request.

spec

object

pool

object

required

Pool defines IP ranges or with CIDR for available IPs Gateway, Prefix and Nameserver if provided, will overwrite values in IPPool

endstring

End is the last IP address that can be rendered. It is used as a validation that the rendered IP is in bound.

gatewaystring

Gateway is the gateway ip address

nameserver

object

Nameserver define search domains and nameserver addresses

addressesstring[]

searchstring[]

prefixint32

Prefix is the mask of the network as integer (max 128)

startstring

Start is the first ip address that can be rendered

subnetstring

Subnet is used to validate that the rendered IP is in bounds. eg: 192.168.0.0/24 If Start value is not given, start value is derived from the subnet ip incremented by 1 (start value is 192.168.0.1 for subnet 192.168.0.0/24)

restrictToSingleClusterboolean

if true, restricts this IP pool to be used by single cluster at any time

Responses

201

Created successfully

Response Headers

• AuditUid

  string

  Audit uid for the request

application/json

Schema

Schema

uidstringrequired

Example (from schema)

{
  "uid": "string"
}

• curl
• python
• go
• nodejs
• java

• CURL

curl -L -X POST 'https://api.spectrocloud.com/v1/overlords/vsphere/:uid/pools' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'ApiKey: <API_KEY_VALUE>' \
--data-raw '{
  "metadata": {
    "annotations": {},
    "creationTimestamp": "2024-04-16T17:48:59.826Z",
    "deletionTimestamp": "2024-04-16T17:48:59.826Z",
    "labels": {},
    "lastModifiedTimestamp": "2024-04-16T17:48:59.826Z",
    "name": "string",
    "uid": "string"
  },
  "spec": {
    "pool": {
      "end": "string",
      "gateway": "string",
      "nameserver": {
        "addresses": [
          "string"
        ],
        "search": [
          "string"
        ]
      },
      "prefix": 0,
      "start": "string",
      "subnet": "string"
    },
    "restrictToSingleCluster": true
  }
}'

Request Collapse all

Base URL

https://api.spectrocloud.com

Auth

Security Scheme

ApiKeyAuthorization

ApiKey

Parameters

uid — pathrequired

ProjectUid — header

Body

{
  "metadata": {
    "annotations": {},
    "creationTimestamp": "2024-04-16T17:48:59.826Z",
    "deletionTimestamp": "2024-04-16T17:48:59.826Z",
    "labels": {},
    "lastModifiedTimestamp": "2024-04-16T17:48:59.826Z",
    "name": "string",
    "uid": "string"
  },
  "spec": {
    "pool": {
      "end": "string",
      "gateway": "string",
      "nameserver": {
        "addresses": [
          "string"
        ],
        "search": [
          "string"
        ]
      },
      "prefix": 0,
      "start": "string",
      "subnet": "string"
    },
    "restrictToSingleCluster": true
  }
}