View a markdown version of this page

EksConfiguration - Amazon Batch
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

EksConfiguration

Configuration for the Amazon EKS cluster that supports the Amazon Batch compute environment. The cluster must exist before the compute environment can be created.

Contents

eksClusterArn

The Amazon Resource Name (ARN) of the Amazon EKS cluster. An example is arn:aws:eks:us-east-1:123456789012:cluster/ClusterForBatch .

Type: String

Required: Yes

kubernetesNamespace

The namespace of the Amazon EKS cluster. Amazon Batch manages pods in this namespace. The value can't left empty or null. It must be fewer than 64 characters long, can't be set to default, can't start with "kube-," and must match this regular expression: ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$. For more information, see Namespaces in the Kubernetes documentation.

Type: String

Required: Yes

accessEntry

The Amazon Batch-managed Amazon EKS access entry for the compute environment. Set desiredState to declare whether Amazon Batch manages an access entry on the cluster. In a DescribeComputeEnvironments response, desiredState is the value that Amazon Batch recorded for the compute environment and status is the observed state of the access entry on the cluster. To change the access entry on an existing compute environment, use EksConfigurationUpdate.accessEntry.

Whether the entry is provisioned on the cluster depends on the cluster's authenticationMode and the desiredState recorded for each Amazon Batch compute environment targeting the cluster. For more information, see Amazon EKS access entry authentication in the Amazon Batch User Guide.

If you don't specify this field, Amazon Batch doesn't record a desiredState for the compute environment and DescribeComputeEnvironments doesn't return one. For the purpose of provisioning the access entry, Amazon Batch behaves as it does for INHERIT_FROM_CLUSTER.

Type: EksAccessEntry object

Required: No

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: