listClusters
Retrieve a list of existing clusters.
Request syntax
GET /v3/clusters { "clusterStatus": "string", "nextToken": "string", "region": "string" }
Request body
- clusterStatus
-
Filter by cluster status. The default is all clusters.
Type: string
Valid values:
CREATE_IN_PROGRESS | CREATE_FAILED | CREATE_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | UPDATE_IN_PROGRESS | UPDATE_COMPLETE | UPDATE_FAILEDRequired: no
- nextToken
-
A token that's used for paginated requests.
Type: string
Required: No
- region
-
The Amazon Web Services Region of the clusters.
Type: string
Required: No
Response syntax
{ "nextToken": "string", "clusters": [ { "clusterName": "string", "region": "string", "version": "string", "cloudformationStackArn": "string", "cloudformationStackStatus": "CREATE_IN_PROGRESS", "clusterStatus": "CREATE_IN_PROGRESS", "scheduler": { "type": "string", "metadata": { "name": "string", "version": "string" } } } ] }
Response body
- clusters
-
- cloudformationStackArn
-
The Amazon Resource Name (ARN) of the main CloudFormation stack.
Type: string
- cloudformationStackStatus
-
The CloudFormation stack status.
Type: string
Valid values:
CREATE_IN_PROGRESS | CREATE_FAILED | CREATE_COMPLETE | ROLLBACK_IN_PROGRESS | ROLLBACK_FAILED | ROLLBACK_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE | UPDATE_IN_PROGRESS | UPDATE_COMPLETE_CLEANUP_IN_PROGRESS | UPDATE_COMPLETE | UPDATE_ROLLBACK_IN_PROGRESS | UPDATE_ROLLBACK_FAILED | UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS | UPDATE_ROLLBACK_COMPLETE - clusterName
-
The name of the cluster.
Type: string
- clusterStatus
-
The cluster status.
Type: string
Valid values:
CREATE_IN_PROGRESS | CREATE_FAILED | CREATE_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE | UPDATE_IN_PROGRESS | UPDATE_COMPLETE | UPDATE_FAILED - scheduler
-
- metadata
-
The scheduler metadata.
- name
-
The name of the scheduler.
Type: string
- version
-
The scheduler version.
Type: string
- type
-
The type of scheduler.
Type: string
- region
-
The Amazon Web Services Region that the cluster is created in.
Type: string
- version
-
The Amazon ParallelCluster version that's used to create the cluster.
Type: string
- nextToken
-
A token that's used for paginated requests.
Type: string