v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-141912377.1 KB

Lists information about the specified virtual cluster. Virtual cluster is a managed entity on Amazon EMR on EKS. You can create, describe, list and delete virtual clusters. They do not consume any additional resource in your system. A single virtual cluster maps to a single Kubernetes namespace. Given this relationship, you can model virtual clusters the same way you model Kubernetes namespaces to meet your requirements.

get/virtualclusters

Query parameters

containerProviderIdstring

The container provider ID of the virtual cluster.

containerProviderType'EKS'

The container provider type of the virtual cluster. Amazon EKS is the only supported type as of now.

createdAfterstring date-time

The date and time after which the virtual clusters are created.

createdBeforestring date-time

The date and time before which the virtual clusters are created.

statesVirtualClusterState[]

The states of the requested virtual clusters.

maxResultsinteger

The maximum number of virtual clusters that can be listed.

nextTokenstring

The token for the next set of virtual clusters to return.

Response

Success

nextTokenstring

This output displays the token for the next set of virtual clusters.