Skip to content

Lists information about the specified virtual cluster

Description

Lists information about the specified virtual cluster. Virtual cluster is a managed entity on Amazon EMR on EKS. You can create, update, 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.

Usage

emrcontainers_list_virtual_clusters(containerProviderId,
  containerProviderType, createdAfter, createdBefore, states, maxResults,
  nextToken, eksAccessEntryIntegrated)

Arguments

  • containerProviderId

    The container provider ID of the virtual cluster.

  • containerProviderType

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

  • createdAfter

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

  • createdBefore

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

  • states

    The states of the requested virtual clusters.

  • maxResults

    The maximum number of virtual clusters that can be listed.

  • nextToken

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

  • eksAccessEntryIntegrated

    Optional Boolean that specifies whether the operation should return the virtual clusters that have the access entry integration enabled or disabled. If not specified, the operation returns all applicable virtual clusters.

Value

A list with the following syntax:

list(
  virtualClusters = list(
    list(
      id = "string",
      name = "string",
      arn = "string",
      state = "RUNNING"|"TERMINATING"|"TERMINATED"|"ARRESTED",
      containerProvider = list(
        type = "EKS",
        id = "string",
        info = list(
          eksInfo = list(
            namespace = "string",
            nodeLabel = "string"
          )
        )
      ),
      createdAt = as.POSIXct(
        "2015-01-01"
      ),
      tags = list(
        "string"
      ),
      securityConfigurationId = "string",
      sessionEnabled = TRUE|FALSE,
      schedulerConfiguration = list(
        maxInQueueJobRuns = 123,
        maxConcurrentJobRuns = 123
      ),
      schedulerStatus = list(
        currentInQueueJobRuns = 123,
        currentConcurrentJobRuns = 123
      )
    )
  ),
  nextToken = "string"
)

Request syntax

svc$list_virtual_clusters(
  containerProviderId = "string",
  containerProviderType = "EKS",
  createdAfter = as.POSIXct(
    "2015-01-01"
  ),
  createdBefore = as.POSIXct(
    "2015-01-01"
  ),
  states = list(
    "RUNNING"|"TERMINATING"|"TERMINATED"|"ARRESTED"
  ),
  maxResults = 123,
  nextToken = "string",
  eksAccessEntryIntegrated = TRUE|FALSE
)