EMRContainers / Client / create_virtual_cluster



Creates a 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.

See also: AWS API Documentation

Request Syntax

response = client.create_virtual_cluster(
        'type': 'EKS',
        'id': 'string',
        'info': {
            'eksInfo': {
                'namespace': 'string'
        'string': 'string'
  • name (string) –


    The specified name of the virtual cluster.

  • containerProvider (dict) –


    The container provider of the virtual cluster.

    • type (string) – [REQUIRED]

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

    • id (string) – [REQUIRED]

      The ID of the container cluster.

    • info (dict) –

      The information about the container cluster.


      This is a Tagged Union structure. Only one of the following top level keys can be set: eksInfo.

      • eksInfo (dict) –

        The information about the Amazon EKS cluster.

        • namespace (string) –

          The namespaces of the Amazon EKS cluster.

  • clientToken (string) –


    The client token of the virtual cluster.

    This field is autopopulated if not provided.

  • tags (dict) –

    The tags assigned to the virtual cluster.

    • (string) –

      • (string) –

Return type:



Response Syntax

    'id': 'string',
    'name': 'string',
    'arn': 'string'

Response Structure

  • (dict) –

    • id (string) –

      This output contains the virtual cluster ID.

    • name (string) –

      This output contains the name of the virtual cluster.

    • arn (string) –

      This output contains the ARN of virtual cluster.


  • EMRContainers.Client.exceptions.ValidationException

  • EMRContainers.Client.exceptions.ResourceNotFoundException

  • EMRContainers.Client.exceptions.InternalServerException

  • EMRContainers.Client.exceptions.EKSRequestThrottledException