Avisi cloud logo
Clusters

Create cluster inside an environment.

POST
/api/v1/orgs/{organisationSlug}/clusters/{environmentSlug}

Request Body

application/jsonRequired

name
Required
string

descriptionstring

cloudAccountIdentity
Required
string

Format: "uuid"

region
Required
string

version
Required
string

updateChannelstring

enableNATGatewayboolean

enableNetworkEncryptionboolean

enablePodSecurityStandards
Deprecated
boolean

podSecurityStandardsProfilestring

Value in: "privileged" | "baseline" | "restricted"

enableMultiAvailabilityZonesboolean

enableAutoUpgradeboolean

enableHAboolean

enableHighAvailabilityboolean

cnistring

Value in: "custom" | "cilium" | "calico"

serviceSubnetobject

clusterPodSubnetobject

nodePools
Required
array<object>

ipWhitelistarray<object>

addonsobject

maintenanceScheduleIdentitystring

Format: "uuid"

clusterAutoscalerSettingsobject

Path Parameters

organisationSlug
Required
string

environmentSlug
Required
string

curl -X POST "http://localhost:8090/api/v1/orgs/string/clusters/string" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "description": "string",
    "cloudAccountIdentity": "763d6cbd-4c53-4613-bba9-cb8f34de18a7",
    "region": "string",
    "version": "string",
    "updateChannel": "string",
    "enableNATGateway": true,
    "enableNetworkEncryption": true,
    "enablePodSecurityStandards": true,
    "podSecurityStandardsProfile": "privileged",
    "enableMultiAvailabilityZones": true,
    "enableAutoUpgrade": true,
    "enableHA": true,
    "enableHighAvailability": true,
    "cni": "custom",
    "serviceSubnet": {
      "ipRange": "string"
    },
    "clusterPodSubnet": {
      "ipRange": "string"
    },
    "nodePools": [
      {
        "name": "string",
        "nodeSize": "string",
        "autoScaling": true,
        "enableNodeAutoReplacement": true,
        "enableNodeReboots": true,
        "upgradeStrategy": "REPLACE",
        "minSize": 0,
        "maxSize": 0,
        "availabilityZone": "string",
        "annotations": {
          "property1": "string",
          "property2": "string"
        },
        "labels": {
          "property1": "string",
          "property2": "string"
        },
        "taints": [
          {
            "key": "string",
            "value": "string",
            "effect": "string"
          }
        ]
      }
    ],
    "ipWhitelist": [
      {
        "cidr": {
          "ipRange": "string"
        },
        "description": "string"
      }
    ],
    "addons": {
      "property1": {
        "enabled": true,
        "customValues": {
          "property1": "string",
          "property2": "string"
        }
      },
      "property2": {
        "enabled": true,
        "customValues": {
          "property1": "string",
          "property2": "string"
        }
      }
    },
    "maintenanceScheduleIdentity": "e083de3d-c54f-4906-804d-30ef2bc37b6f",
    "clusterAutoscalerSettings": {
      "property1": "string",
      "property2": "string"
    }
  }'

Request was successfully processed. The response body contains the requested data.

{
  "name": "string",
  "identity": "10a80a7a-1a32-4a74-b592-aa2a4ef691c5",
  "environmentIdentity": "bb451031-60ba-4fcd-9556-56368eb5c985",
  "maintenanceSchedule": {
    "identity": "10a80a7a-1a32-4a74-b592-aa2a4ef691c5",
    "name": "string",
    "clusterCount": 0,
    "windows": [
      {
        "day": "MONDAY",
        "startTime": "string",
        "duration": 0
      }
    ]
  },
  "environmentSlug": {
    "slugValue": "string"
  },
  "customerIdentity": "e7596901-a2e3-4b7e-9dd1-f11d0f6765a7",
  "customerSlug": {
    "slugValue": "string"
  },
  "poolID": 0,
  "poolName": "string",
  "slug": {
    "slugValue": "string"
  },
  "description": "string",
  "cloudProvider": "string",
  "region": "string",
  "version": "string",
  "updateChannel": {
    "name": "string",
    "available": true,
    "kubernetesClusterVersion": "string"
  },
  "autoUpgrade": true,
  "highlyAvailable": true,
  "enableNetworkEncryption": true,
  "podSecurityStandardsProfile": "privileged",
  "cni": "custom",
  "enableMultiAvailabilityZones": true,
  "enableNATGateway": true,
  "serviceSubnet": "string",
  "clusterPodSubnet": "string",
  "status": "new",
  "desiredStatus": "starting",
  "provisionStatus": "UNKNOWN",
  "createdAt": "2019-08-24T14:15:22Z",
  "modifiedAt": "2019-08-24T14:15:22Z",
  "deletedAt": "2019-08-24T14:15:22Z",
  "memory": 0,
  "cpu": 0,
  "ipWhitelist": [
    {
      "cidr": "string",
      "description": "string"
    }
  ],
  "ameOIDC": true,
  "deleteProtection": true,
  "addons": {
    "property1": {
      "enabled": true,
      "customValues": {
        "property1": "string",
        "property2": "string"
      }
    },
    "property2": {
      "enabled": true,
      "customValues": {
        "property1": "string",
        "property2": "string"
      }
    }
  },
  "observabilityTenant": {
    "id": 0,
    "identity": "10a80a7a-1a32-4a74-b592-aa2a4ef691c5",
    "customer": "string",
    "name": "string",
    "slug": "string",
    "available": true,
    "ipWhiteList": "string",
    "createdAt": "2019-08-24T14:15:22Z",
    "modifiedAt": "2019-08-24T14:15:22Z",
    "deletedAt": "2019-08-24T14:15:22Z",
    "cluster": {
      "id": 0,
      "identity": "10a80a7a-1a32-4a74-b592-aa2a4ef691c5",
      "name": "string",
      "slug": "string",
      "environmentSlug": "string",
      "version": "string",
      "deletedAt": "2019-08-24T14:15:22Z"
    },
    "environment": {
      "id": 0,
      "name": "string",
      "slug": "string"
    }
  },
  "environmentPrometheusRules": true,
  "cloudAccount": {
    "identity": "10a80a7a-1a32-4a74-b592-aa2a4ef691c5",
    "displayName": "string",
    "primaryCloudCredentials": {
      "identity": "10a80a7a-1a32-4a74-b592-aa2a4ef691c5",
      "displayName": "string",
      "isPrimary": true
    }
  },
  "cloudCredentials": {
    "identity": "10a80a7a-1a32-4a74-b592-aa2a4ef691c5",
    "displayName": "string",
    "isPrimary": true
  },
  "actualState": {
    "status": "string",
    "version": "string",
    "collectedAt": "2019-08-24T14:15:22Z"
  },
  "clusterAutoscalerSettings": {
    "property1": "string",
    "property2": "string"
  }
}