create_virtual_cluster

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