Amazon Elastic Container Service for Kubernetes
API Reference (API Version 2017-11-01)

Cluster

An object representing an Amazon EKS cluster.

Contents

arn

The Amazon Resource Name (ARN) of the cluster.

Type: String

Required: No

certificateAuthority

The certificate-authority-data for your cluster.

Type: Certificate object

Required: No

clientRequestToken

Unique, case-sensitive identifier you provide to ensure the idempotency of the request.

Type: String

Required: No

createdAt

The Unix epoch time stamp in seconds for when the cluster was created.

Type: Timestamp

Required: No

endpoint

The endpoint for your Kubernetes API server.

Type: String

Required: No

name

The name of the cluster.

Type: String

Required: No

platformVersion

The platform version of your Amazon EKS cluster. For more information, see Platform Versions in the Amazon EKS User Guide .

Type: String

Required: No

resourcesVpcConfig

The VPC subnets and security groups used by the cluster control plane. Amazon EKS VPC resources have specific requirements to work properly with Kubernetes. For more information, see Cluster VPC Considerations and Cluster Security Group Considerations in the Amazon EKS User Guide.

Type: VpcConfigResponse object

Required: No

roleArn

The Amazon Resource Name (ARN) of the IAM role that provides permissions for the Kubernetes control plane to make calls to AWS API operations on your behalf.

Type: String

Required: No

status

The current status of the cluster.

Type: String

Valid Values: CREATING | ACTIVE | DELETING | FAILED

Required: No

version

The Kubernetes server version for the cluster.

Type: String

Required: No

See Also

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

On this page: