Cluster

Update a cluster

POST
Update a cluster in the Organization.

Path parameters

organizationIdstringRequired
The ID of the Organization to which the cluster belongs.
clusterIdstringRequired
The cluster's ID

Request

This endpoint expects a union.
Dedicated
OR
Hybrid

Response

This endpoint returns an object
cloudProvider
enum
The name of the cluster's cloud provider.
Allowed values: AWSAZUREGCP
createdAt
datetime

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

dbInstanceType
string
The type of database instance that is used for the cluster.
id
string
The cluster's ID.
name
string
The cluster's name.
organizationId
string
The ID of the Organization that the cluster belongs to.
region
string
The region in which the cluster is created.
status
enum
The status of the cluster.
Allowed values: CREATINGCREATEDCREATE_FAILEDUPDATE_FAILEDUPDATING
type
enum
The type of the cluster.
Allowed values: DEDICATEDHYBRID
updatedAt
datetime

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

vpcSubnetRange
string
The VPC subnet range.
isLimited
booleanOptional
Whether the cluster is limited.
metadata
objectOptional
nodePools
list of objectsOptional
The list of node pools that are created in the cluster.
podSubnetRange
stringOptional
The subnet range for Pods. For GCP clusters only.
providerAccount
stringOptional
The provider account ID. For GCP clusters only.
servicePeeringRange
stringOptional
The service peering range. For GCP clusters only.
serviceSubnetRange
stringOptional
The service subnet range. For GCP clusters only.
tags
list of objectsOptional
The Kubernetes tags in the cluster. For AWS Hybrid clusters only.
tenantId
stringOptional
The tenant ID. For Azure clusters only.
workspaceIds
list of stringsOptional
The list of Workspaces that are authorized to the cluster.
POST
1curl -X POST https://api.astronomer.io/platform/v1beta1/organizations/:organizationId/clusters/:clusterId \
2 -H "Authorization: Bearer <token>" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "clusterType": "DEDICATED",
6 "k8sTags": [
7 {}
8 ],
9 "name": "string"
10}'
Response
1{
2 "cloudProvider": "AWS",
3 "createdAt": "2023-01-01T00:00:00Z",
4 "dbInstanceType": "string",
5 "id": "string",
6 "name": "string",
7 "organizationId": "string",
8 "region": "string",
9 "status": "CREATING",
10 "type": "DEDICATED",
11 "updatedAt": "2023-01-01T00:00:00Z",
12 "vpcSubnetRange": "string",
13 "isLimited": true,
14 "metadata": {
15 "externalIPs": [
16 "string"
17 ],
18 "oidcIssuerUrl": "string"
19 },
20 "nodePools": [
21 {
22 "cloudProvider": "AWS",
23 "clusterId": "string",
24 "createdAt": "2023-01-01T00:00:00Z",
25 "id": "string",
26 "isDefault": true,
27 "maxNodeCount": 0,
28 "name": "string",
29 "nodeInstanceType": "string",
30 "updatedAt": "2023-01-01T00:00:00Z",
31 "supportedAstroMachines": [
32 "string"
33 ]
34 }
35 ],
36 "podSubnetRange": "string",
37 "providerAccount": "string",
38 "servicePeeringRange": "string",
39 "serviceSubnetRange": "string",
40 "tags": [
41 {
42 "key": "string",
43 "value": "string"
44 }
45 ],
46 "tenantId": "string",
47 "workspaceIds": [
48 "string"
49 ]
50}