EMRContainers / Client / create_virtual_cluster

create_virtual_cluster

EMRContainers.Client.create_virtual_cluster(**kwargs)

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(
    name='string',
    containerProvider={
        'type': 'EKS',
        'id': 'string',
        'info': {
            'eksInfo': {
                'namespace': 'string'
            }
        }
    },
    clientToken='string',
    tags={
        'string': 'string'
    }
)

Parameters:

• name (string) –

  [REQUIRED]

  The specified name of the virtual cluster.

• containerProvider (dict) –

  [REQUIRED]

  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.

    Note

    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) –

  [REQUIRED]

  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:

dict

Returns:

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.

Exceptions

• EMRContainers.Client.exceptions.ValidationException

• EMRContainers.Client.exceptions.ResourceNotFoundException

• EMRContainers.Client.exceptions.InternalServerException