Create a cluster

curl --request POST \
  --url https://api.astronomer.io/v1/organizations/{organizationId}/clusters \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cloudProvider": "AZURE",
  "name": "My cluster",
  "region": "us-east-1",
  "type": "DEDICATED",
  "vpcSubnetRange": "172.20.0.0/22",
  "dbInstanceType": "Small General Purpose",
  "drRegion": "us-west-2",
  "drSecondaryVpcCidr": "100.64.0.0/19",
  "drVpcSubnetRange": "172.20.0.0/22",
  "enableReplicationTimeControl": true,
  "isPrivateNetworkEgressEnabled": true,
  "k8sTags": [
    {
      "key": "key1",
      "value": "value1"
    }
  ],
  "nodePools": [
    {
      "maxNodeCount": 10,
      "name": "my-nodepool",
      "nodeInstanceType": "t3.medium",
      "isDefault": true
    }
  ],
  "providerAccount": "provider-account",
  "secondaryVpcCidr": "100.64.0.0/16",
  "workspaceIds": [
    "<string>"
  ]
}
'

import requests

url = "https://api.astronomer.io/v1/organizations/{organizationId}/clusters"

payload = {
    "cloudProvider": "AZURE",
    "name": "My cluster",
    "region": "us-east-1",
    "type": "DEDICATED",
    "vpcSubnetRange": "172.20.0.0/22",
    "dbInstanceType": "Small General Purpose",
    "drRegion": "us-west-2",
    "drSecondaryVpcCidr": "100.64.0.0/19",
    "drVpcSubnetRange": "172.20.0.0/22",
    "enableReplicationTimeControl": True,
    "isPrivateNetworkEgressEnabled": True,
    "k8sTags": [
        {
            "key": "key1",
            "value": "value1"
        }
    ],
    "nodePools": [
        {
            "maxNodeCount": 10,
            "name": "my-nodepool",
            "nodeInstanceType": "t3.medium",
            "isDefault": True
        }
    ],
    "providerAccount": "provider-account",
    "secondaryVpcCidr": "100.64.0.0/16",
    "workspaceIds": ["<string>"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    cloudProvider: 'AZURE',
    name: 'My cluster',
    region: 'us-east-1',
    type: 'DEDICATED',
    vpcSubnetRange: '172.20.0.0/22',
    dbInstanceType: 'Small General Purpose',
    drRegion: 'us-west-2',
    drSecondaryVpcCidr: '100.64.0.0/19',
    drVpcSubnetRange: '172.20.0.0/22',
    enableReplicationTimeControl: true,
    isPrivateNetworkEgressEnabled: true,
    k8sTags: [{key: 'key1', value: 'value1'}],
    nodePools: [
      {
        maxNodeCount: 10,
        name: 'my-nodepool',
        nodeInstanceType: 't3.medium',
        isDefault: true
      }
    ],
    providerAccount: 'provider-account',
    secondaryVpcCidr: '100.64.0.0/16',
    workspaceIds: ['<string>']
  })
};

fetch('https://api.astronomer.io/v1/organizations/{organizationId}/clusters', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.astronomer.io/v1/organizations/{organizationId}/clusters",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'cloudProvider' => 'AZURE',
    'name' => 'My cluster',
    'region' => 'us-east-1',
    'type' => 'DEDICATED',
    'vpcSubnetRange' => '172.20.0.0/22',
    'dbInstanceType' => 'Small General Purpose',
    'drRegion' => 'us-west-2',
    'drSecondaryVpcCidr' => '100.64.0.0/19',
    'drVpcSubnetRange' => '172.20.0.0/22',
    'enableReplicationTimeControl' => true,
    'isPrivateNetworkEgressEnabled' => true,
    'k8sTags' => [
        [
                'key' => 'key1',
                'value' => 'value1'
        ]
    ],
    'nodePools' => [
        [
                'maxNodeCount' => 10,
                'name' => 'my-nodepool',
                'nodeInstanceType' => 't3.medium',
                'isDefault' => true
        ]
    ],
    'providerAccount' => 'provider-account',
    'secondaryVpcCidr' => '100.64.0.0/16',
    'workspaceIds' => [
        '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.astronomer.io/v1/organizations/{organizationId}/clusters"

	payload := strings.NewReader("{\n  \"cloudProvider\": \"AZURE\",\n  \"name\": \"My cluster\",\n  \"region\": \"us-east-1\",\n  \"type\": \"DEDICATED\",\n  \"vpcSubnetRange\": \"172.20.0.0/22\",\n  \"dbInstanceType\": \"Small General Purpose\",\n  \"drRegion\": \"us-west-2\",\n  \"drSecondaryVpcCidr\": \"100.64.0.0/19\",\n  \"drVpcSubnetRange\": \"172.20.0.0/22\",\n  \"enableReplicationTimeControl\": true,\n  \"isPrivateNetworkEgressEnabled\": true,\n  \"k8sTags\": [\n    {\n      \"key\": \"key1\",\n      \"value\": \"value1\"\n    }\n  ],\n  \"nodePools\": [\n    {\n      \"maxNodeCount\": 10,\n      \"name\": \"my-nodepool\",\n      \"nodeInstanceType\": \"t3.medium\",\n      \"isDefault\": true\n    }\n  ],\n  \"providerAccount\": \"provider-account\",\n  \"secondaryVpcCidr\": \"100.64.0.0/16\",\n  \"workspaceIds\": [\n    \"<string>\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.astronomer.io/v1/organizations/{organizationId}/clusters")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"cloudProvider\": \"AZURE\",\n  \"name\": \"My cluster\",\n  \"region\": \"us-east-1\",\n  \"type\": \"DEDICATED\",\n  \"vpcSubnetRange\": \"172.20.0.0/22\",\n  \"dbInstanceType\": \"Small General Purpose\",\n  \"drRegion\": \"us-west-2\",\n  \"drSecondaryVpcCidr\": \"100.64.0.0/19\",\n  \"drVpcSubnetRange\": \"172.20.0.0/22\",\n  \"enableReplicationTimeControl\": true,\n  \"isPrivateNetworkEgressEnabled\": true,\n  \"k8sTags\": [\n    {\n      \"key\": \"key1\",\n      \"value\": \"value1\"\n    }\n  ],\n  \"nodePools\": [\n    {\n      \"maxNodeCount\": 10,\n      \"name\": \"my-nodepool\",\n      \"nodeInstanceType\": \"t3.medium\",\n      \"isDefault\": true\n    }\n  ],\n  \"providerAccount\": \"provider-account\",\n  \"secondaryVpcCidr\": \"100.64.0.0/16\",\n  \"workspaceIds\": [\n    \"<string>\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.astronomer.io/v1/organizations/{organizationId}/clusters")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"cloudProvider\": \"AZURE\",\n  \"name\": \"My cluster\",\n  \"region\": \"us-east-1\",\n  \"type\": \"DEDICATED\",\n  \"vpcSubnetRange\": \"172.20.0.0/22\",\n  \"dbInstanceType\": \"Small General Purpose\",\n  \"drRegion\": \"us-west-2\",\n  \"drSecondaryVpcCidr\": \"100.64.0.0/19\",\n  \"drVpcSubnetRange\": \"172.20.0.0/22\",\n  \"enableReplicationTimeControl\": true,\n  \"isPrivateNetworkEgressEnabled\": true,\n  \"k8sTags\": [\n    {\n      \"key\": \"key1\",\n      \"value\": \"value1\"\n    }\n  ],\n  \"nodePools\": [\n    {\n      \"maxNodeCount\": 10,\n      \"name\": \"my-nodepool\",\n      \"nodeInstanceType\": \"t3.medium\",\n      \"isDefault\": true\n    }\n  ],\n  \"providerAccount\": \"provider-account\",\n  \"secondaryVpcCidr\": \"100.64.0.0/16\",\n  \"workspaceIds\": [\n    \"<string>\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "cloudProvider": "AWS",
  "createdAt": "2022-11-22T04:37:12Z",
  "dbInstanceType": "db.t3.medium",
  "drRegion": "us-east-1",
  "id": "clm7k8tgw000008jz97i37y81",
  "isDrEnabled": true,
  "name": "my cluster",
  "organizationId": "clm88r8hi000008jwhzxu5crg",
  "region": "us-east-1",
  "status": "CREATED",
  "type": "DEDICATED",
  "updatedAt": "2022-11-22T04:37:12Z",
  "vpcSubnetRange": "172.20.0.0/22",
  "drPodSubnetRange": "172.21.0.0/19",
  "drSecondaryVpcCidr": "<string>",
  "drServicePeeringRange": "172.23.0.0/20",
  "drServiceSubnetRange": "172.22.0.0/22",
  "drVpcSubnetRange": "<string>",
  "enableReplicationTimeControl": true,
  "failoverInProgress": true,
  "healthStatus": {
    "value": "HEALTHY",
    "details": [
      {
        "code": "<string>",
        "description": "<string>",
        "severity": "<string>",
        "component": "<string>"
      }
    ]
  },
  "isFailedOver": true,
  "isLimited": false,
  "isPrivateNetworkEgressEnabled": true,
  "metadata": {
    "externalIPs": [
      "35.100.100.1"
    ],
    "kubeDnsIp": "10.100.100.0",
    "oidcIssuerUrl": "https://westus2.oic.prod-aks.azure.com/b84efac8-cfae-467a-b223-23b9aea1486d/3075f79e-abc2-4602-a691-28117197e83d/"
  },
  "nodePools": [
    {
      "cloudProvider": "AWS",
      "clusterId": "clm891jb6000308jrc3vjdtde",
      "createdAt": "2022-11-22T04:37:12Z",
      "id": "clm890zhe000208jr39dd0ubs",
      "isDefault": true,
      "maxNodeCount": 1,
      "name": "default",
      "nodeInstanceType": "t3.medium",
      "updatedAt": "2022-11-22T04:37:12Z",
      "supportedAstroMachines": [
        "A5",
        "A10"
      ]
    }
  ],
  "podSubnetRange": "172.21.0.0/19",
  "providerAccount": "provider-account",
  "secondaryVpcCidr": "<string>",
  "servicePeeringRange": "172.23.0.0/20",
  "serviceSubnetRange": "172.22.0.0/22",
  "tags": [
    {
      "key": "key1",
      "value": "value1"
    }
  ],
  "tenantId": "your-tenant-id",
  "workspaceIds": [
    "clm88rddl000108jwgeka2div"
  ]
}

{
  "message": "<string>",
  "requestId": "<string>",
  "statusCode": 500,
  "fieldErrors": [
    {
      "code": "<string>",
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "message": "<string>",
  "requestId": "<string>",
  "statusCode": 500,
  "fieldErrors": [
    {
      "code": "<string>",
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "message": "<string>",
  "requestId": "<string>",
  "statusCode": 500,
  "fieldErrors": [
    {
      "code": "<string>",
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "message": "<string>",
  "requestId": "<string>",
  "statusCode": 500,
  "fieldErrors": [
    {
      "code": "<string>",
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "message": "<string>",
  "requestId": "<string>",
  "statusCode": 500,
  "fieldErrors": [
    {
      "code": "<string>",
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "message": "<string>",
  "requestId": "<string>",
  "statusCode": 500,
  "fieldErrors": [
    {
      "code": "<string>",
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

POST

organizations

{organizationId}

clusters

Create a cluster

curl --request POST \
  --url https://api.astronomer.io/v1/organizations/{organizationId}/clusters \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cloudProvider": "AZURE",
  "name": "My cluster",
  "region": "us-east-1",
  "type": "DEDICATED",
  "vpcSubnetRange": "172.20.0.0/22",
  "dbInstanceType": "Small General Purpose",
  "drRegion": "us-west-2",
  "drSecondaryVpcCidr": "100.64.0.0/19",
  "drVpcSubnetRange": "172.20.0.0/22",
  "enableReplicationTimeControl": true,
  "isPrivateNetworkEgressEnabled": true,
  "k8sTags": [
    {
      "key": "key1",
      "value": "value1"
    }
  ],
  "nodePools": [
    {
      "maxNodeCount": 10,
      "name": "my-nodepool",
      "nodeInstanceType": "t3.medium",
      "isDefault": true
    }
  ],
  "providerAccount": "provider-account",
  "secondaryVpcCidr": "100.64.0.0/16",
  "workspaceIds": [
    "<string>"
  ]
}
'

import requests

url = "https://api.astronomer.io/v1/organizations/{organizationId}/clusters"

payload = {
    "cloudProvider": "AZURE",
    "name": "My cluster",
    "region": "us-east-1",
    "type": "DEDICATED",
    "vpcSubnetRange": "172.20.0.0/22",
    "dbInstanceType": "Small General Purpose",
    "drRegion": "us-west-2",
    "drSecondaryVpcCidr": "100.64.0.0/19",
    "drVpcSubnetRange": "172.20.0.0/22",
    "enableReplicationTimeControl": True,
    "isPrivateNetworkEgressEnabled": True,
    "k8sTags": [
        {
            "key": "key1",
            "value": "value1"
        }
    ],
    "nodePools": [
        {
            "maxNodeCount": 10,
            "name": "my-nodepool",
            "nodeInstanceType": "t3.medium",
            "isDefault": True
        }
    ],
    "providerAccount": "provider-account",
    "secondaryVpcCidr": "100.64.0.0/16",
    "workspaceIds": ["<string>"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    cloudProvider: 'AZURE',
    name: 'My cluster',
    region: 'us-east-1',
    type: 'DEDICATED',
    vpcSubnetRange: '172.20.0.0/22',
    dbInstanceType: 'Small General Purpose',
    drRegion: 'us-west-2',
    drSecondaryVpcCidr: '100.64.0.0/19',
    drVpcSubnetRange: '172.20.0.0/22',
    enableReplicationTimeControl: true,
    isPrivateNetworkEgressEnabled: true,
    k8sTags: [{key: 'key1', value: 'value1'}],
    nodePools: [
      {
        maxNodeCount: 10,
        name: 'my-nodepool',
        nodeInstanceType: 't3.medium',
        isDefault: true
      }
    ],
    providerAccount: 'provider-account',
    secondaryVpcCidr: '100.64.0.0/16',
    workspaceIds: ['<string>']
  })
};

fetch('https://api.astronomer.io/v1/organizations/{organizationId}/clusters', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.astronomer.io/v1/organizations/{organizationId}/clusters",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'cloudProvider' => 'AZURE',
    'name' => 'My cluster',
    'region' => 'us-east-1',
    'type' => 'DEDICATED',
    'vpcSubnetRange' => '172.20.0.0/22',
    'dbInstanceType' => 'Small General Purpose',
    'drRegion' => 'us-west-2',
    'drSecondaryVpcCidr' => '100.64.0.0/19',
    'drVpcSubnetRange' => '172.20.0.0/22',
    'enableReplicationTimeControl' => true,
    'isPrivateNetworkEgressEnabled' => true,
    'k8sTags' => [
        [
                'key' => 'key1',
                'value' => 'value1'
        ]
    ],
    'nodePools' => [
        [
                'maxNodeCount' => 10,
                'name' => 'my-nodepool',
                'nodeInstanceType' => 't3.medium',
                'isDefault' => true
        ]
    ],
    'providerAccount' => 'provider-account',
    'secondaryVpcCidr' => '100.64.0.0/16',
    'workspaceIds' => [
        '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.astronomer.io/v1/organizations/{organizationId}/clusters"

	payload := strings.NewReader("{\n  \"cloudProvider\": \"AZURE\",\n  \"name\": \"My cluster\",\n  \"region\": \"us-east-1\",\n  \"type\": \"DEDICATED\",\n  \"vpcSubnetRange\": \"172.20.0.0/22\",\n  \"dbInstanceType\": \"Small General Purpose\",\n  \"drRegion\": \"us-west-2\",\n  \"drSecondaryVpcCidr\": \"100.64.0.0/19\",\n  \"drVpcSubnetRange\": \"172.20.0.0/22\",\n  \"enableReplicationTimeControl\": true,\n  \"isPrivateNetworkEgressEnabled\": true,\n  \"k8sTags\": [\n    {\n      \"key\": \"key1\",\n      \"value\": \"value1\"\n    }\n  ],\n  \"nodePools\": [\n    {\n      \"maxNodeCount\": 10,\n      \"name\": \"my-nodepool\",\n      \"nodeInstanceType\": \"t3.medium\",\n      \"isDefault\": true\n    }\n  ],\n  \"providerAccount\": \"provider-account\",\n  \"secondaryVpcCidr\": \"100.64.0.0/16\",\n  \"workspaceIds\": [\n    \"<string>\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.astronomer.io/v1/organizations/{organizationId}/clusters")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"cloudProvider\": \"AZURE\",\n  \"name\": \"My cluster\",\n  \"region\": \"us-east-1\",\n  \"type\": \"DEDICATED\",\n  \"vpcSubnetRange\": \"172.20.0.0/22\",\n  \"dbInstanceType\": \"Small General Purpose\",\n  \"drRegion\": \"us-west-2\",\n  \"drSecondaryVpcCidr\": \"100.64.0.0/19\",\n  \"drVpcSubnetRange\": \"172.20.0.0/22\",\n  \"enableReplicationTimeControl\": true,\n  \"isPrivateNetworkEgressEnabled\": true,\n  \"k8sTags\": [\n    {\n      \"key\": \"key1\",\n      \"value\": \"value1\"\n    }\n  ],\n  \"nodePools\": [\n    {\n      \"maxNodeCount\": 10,\n      \"name\": \"my-nodepool\",\n      \"nodeInstanceType\": \"t3.medium\",\n      \"isDefault\": true\n    }\n  ],\n  \"providerAccount\": \"provider-account\",\n  \"secondaryVpcCidr\": \"100.64.0.0/16\",\n  \"workspaceIds\": [\n    \"<string>\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.astronomer.io/v1/organizations/{organizationId}/clusters")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"cloudProvider\": \"AZURE\",\n  \"name\": \"My cluster\",\n  \"region\": \"us-east-1\",\n  \"type\": \"DEDICATED\",\n  \"vpcSubnetRange\": \"172.20.0.0/22\",\n  \"dbInstanceType\": \"Small General Purpose\",\n  \"drRegion\": \"us-west-2\",\n  \"drSecondaryVpcCidr\": \"100.64.0.0/19\",\n  \"drVpcSubnetRange\": \"172.20.0.0/22\",\n  \"enableReplicationTimeControl\": true,\n  \"isPrivateNetworkEgressEnabled\": true,\n  \"k8sTags\": [\n    {\n      \"key\": \"key1\",\n      \"value\": \"value1\"\n    }\n  ],\n  \"nodePools\": [\n    {\n      \"maxNodeCount\": 10,\n      \"name\": \"my-nodepool\",\n      \"nodeInstanceType\": \"t3.medium\",\n      \"isDefault\": true\n    }\n  ],\n  \"providerAccount\": \"provider-account\",\n  \"secondaryVpcCidr\": \"100.64.0.0/16\",\n  \"workspaceIds\": [\n    \"<string>\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "cloudProvider": "AWS",
  "createdAt": "2022-11-22T04:37:12Z",
  "dbInstanceType": "db.t3.medium",
  "drRegion": "us-east-1",
  "id": "clm7k8tgw000008jz97i37y81",
  "isDrEnabled": true,
  "name": "my cluster",
  "organizationId": "clm88r8hi000008jwhzxu5crg",
  "region": "us-east-1",
  "status": "CREATED",
  "type": "DEDICATED",
  "updatedAt": "2022-11-22T04:37:12Z",
  "vpcSubnetRange": "172.20.0.0/22",
  "drPodSubnetRange": "172.21.0.0/19",
  "drSecondaryVpcCidr": "<string>",
  "drServicePeeringRange": "172.23.0.0/20",
  "drServiceSubnetRange": "172.22.0.0/22",
  "drVpcSubnetRange": "<string>",
  "enableReplicationTimeControl": true,
  "failoverInProgress": true,
  "healthStatus": {
    "value": "HEALTHY",
    "details": [
      {
        "code": "<string>",
        "description": "<string>",
        "severity": "<string>",
        "component": "<string>"
      }
    ]
  },
  "isFailedOver": true,
  "isLimited": false,
  "isPrivateNetworkEgressEnabled": true,
  "metadata": {
    "externalIPs": [
      "35.100.100.1"
    ],
    "kubeDnsIp": "10.100.100.0",
    "oidcIssuerUrl": "https://westus2.oic.prod-aks.azure.com/b84efac8-cfae-467a-b223-23b9aea1486d/3075f79e-abc2-4602-a691-28117197e83d/"
  },
  "nodePools": [
    {
      "cloudProvider": "AWS",
      "clusterId": "clm891jb6000308jrc3vjdtde",
      "createdAt": "2022-11-22T04:37:12Z",
      "id": "clm890zhe000208jr39dd0ubs",
      "isDefault": true,
      "maxNodeCount": 1,
      "name": "default",
      "nodeInstanceType": "t3.medium",
      "updatedAt": "2022-11-22T04:37:12Z",
      "supportedAstroMachines": [
        "A5",
        "A10"
      ]
    }
  ],
  "podSubnetRange": "172.21.0.0/19",
  "providerAccount": "provider-account",
  "secondaryVpcCidr": "<string>",
  "servicePeeringRange": "172.23.0.0/20",
  "serviceSubnetRange": "172.22.0.0/22",
  "tags": [
    {
      "key": "key1",
      "value": "value1"
    }
  ],
  "tenantId": "your-tenant-id",
  "workspaceIds": [
    "clm88rddl000108jwgeka2div"
  ]
}

{
  "message": "<string>",
  "requestId": "<string>",
  "statusCode": 500,
  "fieldErrors": [
    {
      "code": "<string>",
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "message": "<string>",
  "requestId": "<string>",
  "statusCode": 500,
  "fieldErrors": [
    {
      "code": "<string>",
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "message": "<string>",
  "requestId": "<string>",
  "statusCode": 500,
  "fieldErrors": [
    {
      "code": "<string>",
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "message": "<string>",
  "requestId": "<string>",
  "statusCode": 500,
  "fieldErrors": [
    {
      "code": "<string>",
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "message": "<string>",
  "requestId": "<string>",
  "statusCode": 500,
  "fieldErrors": [
    {
      "code": "<string>",
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "message": "<string>",
  "requestId": "<string>",
  "statusCode": 500,
  "fieldErrors": [
    {
      "code": "<string>",
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

organizationId

string

required

The ID of the Organization to create the cluster in.

Body

application/json

The request body for creating a cluster

Option 1
Option 2
Option 3

cloudProvider

enum<string>

required

The cluster's cloud provider.

Available options:

AWS,

AZURE,

GCP

Example:

"AZURE"

name

string

required

The cluster's name.

Example:

"My cluster"

region

string

required

The cluster's region.

Example:

"us-east-1"

type

enum<string>

required

The cluster's type.

Available options:

DEDICATED,

HYBRID

Example:

"DEDICATED"

vpcSubnetRange

string

required

The VPC subnet range.

Example:

"172.20.0.0/22"

dbInstanceType

string

The type of database instance that is used for the cluster. Required for Hybrid clusters.

Example:

"Small General Purpose"

drRegion

string

The secondary region for Disaster Recovery.

Example:

"us-west-2"

drSecondaryVpcCidr

string

The secondary CIDR for the DR region. Defaults to the primary secondary CIDR if not specified. For AWS clusters only.

Example:

"100.64.0.0/19"

drVpcSubnetRange

string

The VPC subnet range for the DR region. Defaults to the primary VPC subnet range if not specified.

Example:

"172.20.0.0/22"

enableReplicationTimeControl

boolean

Whether Bucket Storage Replication Time Control should be enabled for DR on task logs.

isPrivateNetworkEgressEnabled

boolean

When true, enables Private Network Egress mode, which disables public Internet connectivity from the cluster's Deployments and metrics exports. For AWS clusters only.

k8sTags

object[]

The Kubernetes tags in the cluster.

Show child attributes

nodePools

object[]

The list of node pools to create in the cluster.

Show child attributes

providerAccount

string

The provider account ID. Required for Hybrid clusters.

Example:

"provider-account"

secondaryVpcCidr

string

The secondary VPC CIDR for pods. For AWS clusters only.

Example:

"100.64.0.0/16"

workspaceIds

string[]

The list of Workspaces that are authorized to the cluster.

Response

cloudProvider

enum<string>

required

The name of the cluster's cloud provider.

Available options:

AWS,

AZURE,

GCP

Example:

"AWS"

createdAt

string<date-time>

required

The time when the cluster was created in UTC. formatted as YYYY-MM-DDTHH:MM:SSZ.

Example:

"2022-11-22T04:37:12Z"

dbInstanceType

string

required

The type of database instance that is used for the cluster.

Example:

"db.t3.medium"

drRegion

string

required

The secondary region for Disaster Recovery for the cluster.

Example:

"us-east-1"

string

required

The cluster's ID.

Example:

"clm7k8tgw000008jz97i37y81"

isDrEnabled

boolean

required

Whether Disaster Recovery is enabled on the cluster

name

string

required

The cluster's name.

Example:

"my cluster"

organizationId

string

required

The ID of the Organization that the cluster belongs to.

Example:

"clm88r8hi000008jwhzxu5crg"

region

string

required

The region in which the cluster is created.

Example:

"us-east-1"

status

enum<string>

required

The status of the cluster.

Available options:

CREATING,

CREATED,

CREATE_FAILED,

UPDATE_FAILED,

UPDATING,

ACCESS_DENIED,

UPGRADE_PENDING,

FAILING_OVER,

FAILOVER_FAILED

Example:

"CREATED"

type

enum<string>

required

The type of the cluster.

Available options:

DEDICATED,

HYBRID

Example:

"DEDICATED"

updatedAt

string<date-time>

required

The time when the cluster was last updated in UTC. formatted as YYYY-MM-DDTHH:MM:SSZ.

Example:

"2022-11-22T04:37:12Z"

vpcSubnetRange

string

required

The VPC subnet range.

Example:

"172.20.0.0/22"

drPodSubnetRange

string

The disaster recovery subnet range for Pods. For GCP clusters only.

Example:

"172.21.0.0/19"

drSecondaryVpcCidr

string

The secondary CIDR for the DR region. For AWS clusters only.

drServicePeeringRange

string

The disaster recovery service peering range. For GCP clusters only.

Example:

"172.23.0.0/20"

drServiceSubnetRange

string

The disaster recovery service subnet range. For GCP clusters only.

Example:

"172.22.0.0/22"

drVpcSubnetRange

string

The VPC subnet range for the DR region.

enableReplicationTimeControl

boolean

Whether Bucket Storage Replication Time Control is enabled for DR.

failoverInProgress

boolean

Whether a failover is currently in progress.

healthStatus

object

Show child attributes

isFailedOver

boolean

Whether the cluster is currently failed over to the DR region.

isLimited

boolean

Whether the cluster is limited.

Example:

false

isPrivateNetworkEgressEnabled

boolean

Whether Private Network Egress mode is enabled, which disables public Internet connectivity from the cluster's Deployments and metrics exports. For AWS clusters only.

metadata

object

Show child attributes

nodePools

object[]

The list of node pools that are created in the cluster.

Show child attributes

podSubnetRange

string

The subnet range for Pods. For GCP clusters only.

Example:

"172.21.0.0/19"

providerAccount

string

The provider account ID. For GCP clusters only.

Example:

"provider-account"

secondaryVpcCidr

string

The secondary VPC CIDR. For AWS clusters only.

servicePeeringRange

string

The service peering range. For GCP clusters only.

Example:

"172.23.0.0/20"

serviceSubnetRange

string

The service subnet range. For GCP clusters only.

Example:

"172.22.0.0/22"

Astro API v1

API Reference

Create a cluster

Authorizations

Path Parameters

Body

Response