/* * Copyright 2018-2023 Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with * the License. A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR * CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions * and limitations under the License. */ package com.amazonaws.services.eks; import javax.annotation.Generated; import com.amazonaws.services.eks.model.*; /** * Interface for accessing Amazon EKS asynchronously. Each asynchronous method will return a Java Future object * representing the asynchronous operation; overloads which accept an {@code AsyncHandler} can be used to receive * notification when an asynchronous operation completes. *
* Note: Do not directly implement this interface, new methods are added to it regularly. Extend from * {@link com.amazonaws.services.eks.AbstractAmazonEKSAsync} instead. *
**
* Amazon Elastic Kubernetes Service (Amazon EKS) is a managed service that makes it easy for you to run Kubernetes on * Amazon Web Services without needing to stand up or maintain your own Kubernetes control plane. Kubernetes is an * open-source system for automating the deployment, scaling, and management of containerized applications. *
** Amazon EKS runs up-to-date versions of the open-source Kubernetes software, so you can use all the existing plugins * and tooling from the Kubernetes community. Applications running on Amazon EKS are fully compatible with applications * running on any standard Kubernetes environment, whether running in on-premises data centers or public clouds. This * means that you can easily migrate any standard Kubernetes application to Amazon EKS without any code modification * required. *
*/ @Generated("com.amazonaws:aws-java-sdk-code-generator") public interface AmazonEKSAsync extends AmazonEKS { /** ** Associate encryption configuration to an existing cluster. *
** You can use this API to enable encryption on existing clusters which do not have encryption already enabled. This * allows you to implement a defense-in-depth security strategy without migrating applications to new Amazon EKS * clusters. *
* * @param associateEncryptionConfigRequest * @return A Java Future containing the result of the AssociateEncryptionConfig operation returned by the service. * @sample AmazonEKSAsync.AssociateEncryptionConfig * @see AWS * API Documentation */ java.util.concurrent.Future* Associate encryption configuration to an existing cluster. *
** You can use this API to enable encryption on existing clusters which do not have encryption already enabled. This * allows you to implement a defense-in-depth security strategy without migrating applications to new Amazon EKS * clusters. *
* * @param associateEncryptionConfigRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the AssociateEncryptionConfig operation returned by the service. * @sample AmazonEKSAsyncHandler.AssociateEncryptionConfig * @see AWS * API Documentation */ java.util.concurrent.Future* Associate an identity provider configuration to a cluster. *
*
* If you want to authenticate identities using an identity provider, you can create an identity provider
* configuration and associate it to your cluster. After configuring authentication to your cluster you can create
* Kubernetes roles
and clusterroles
to assign permissions to the roles, and then bind the
* roles to the identities using Kubernetes rolebindings
and clusterrolebindings
. For more
* information see Using RBAC
* Authorization in the Kubernetes documentation.
*
* Associate an identity provider configuration to a cluster. *
*
* If you want to authenticate identities using an identity provider, you can create an identity provider
* configuration and associate it to your cluster. After configuring authentication to your cluster you can create
* Kubernetes roles
and clusterroles
to assign permissions to the roles, and then bind the
* roles to the identities using Kubernetes rolebindings
and clusterrolebindings
. For more
* information see Using RBAC
* Authorization in the Kubernetes documentation.
*
* Creates an Amazon EKS add-on. *
** Amazon EKS add-ons help to automate the provisioning and lifecycle management of common operational software for * Amazon EKS clusters. For more information, see Amazon EKS add-ons in the Amazon * EKS User Guide. *
* * @param createAddonRequest * @return A Java Future containing the result of the CreateAddon operation returned by the service. * @sample AmazonEKSAsync.CreateAddon * @see AWS API * Documentation */ java.util.concurrent.Future* Creates an Amazon EKS add-on. *
** Amazon EKS add-ons help to automate the provisioning and lifecycle management of common operational software for * Amazon EKS clusters. For more information, see Amazon EKS add-ons in the Amazon * EKS User Guide. *
* * @param createAddonRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the CreateAddon operation returned by the service. * @sample AmazonEKSAsyncHandler.CreateAddon * @see AWS API * Documentation */ java.util.concurrent.Future* Creates an Amazon EKS control plane. *
*
* The Amazon EKS control plane consists of control plane instances that run the Kubernetes software, such as
* etcd
and the API server. The control plane runs in an account managed by Amazon Web Services, and
* the Kubernetes API is exposed by the Amazon EKS API server endpoint. Each Amazon EKS cluster control plane is
* single tenant and unique. It runs on its own set of Amazon EC2 instances.
*
* The cluster control plane is provisioned across multiple Availability Zones and fronted by an Elastic Load
* Balancing Network Load Balancer. Amazon EKS also provisions elastic network interfaces in your VPC subnets to
* provide connectivity from the control plane instances to the nodes (for example, to support
* kubectl exec
, logs
, and proxy
data flows).
*
* Amazon EKS nodes run in your Amazon Web Services account and connect to your cluster's control plane over the * Kubernetes API server endpoint and a certificate file that is created for your cluster. *
** In most cases, it takes several minutes to create a cluster. After you create an Amazon EKS cluster, you must * configure your Kubernetes tooling to communicate with the API server and launch nodes into your cluster. For more * information, see Managing Cluster * Authentication and Launching * Amazon EKS nodes in the Amazon EKS User Guide. *
* * @param createClusterRequest * @return A Java Future containing the result of the CreateCluster operation returned by the service. * @sample AmazonEKSAsync.CreateCluster * @see AWS API * Documentation */ java.util.concurrent.Future* Creates an Amazon EKS control plane. *
*
* The Amazon EKS control plane consists of control plane instances that run the Kubernetes software, such as
* etcd
and the API server. The control plane runs in an account managed by Amazon Web Services, and
* the Kubernetes API is exposed by the Amazon EKS API server endpoint. Each Amazon EKS cluster control plane is
* single tenant and unique. It runs on its own set of Amazon EC2 instances.
*
* The cluster control plane is provisioned across multiple Availability Zones and fronted by an Elastic Load
* Balancing Network Load Balancer. Amazon EKS also provisions elastic network interfaces in your VPC subnets to
* provide connectivity from the control plane instances to the nodes (for example, to support
* kubectl exec
, logs
, and proxy
data flows).
*
* Amazon EKS nodes run in your Amazon Web Services account and connect to your cluster's control plane over the * Kubernetes API server endpoint and a certificate file that is created for your cluster. *
** In most cases, it takes several minutes to create a cluster. After you create an Amazon EKS cluster, you must * configure your Kubernetes tooling to communicate with the API server and launch nodes into your cluster. For more * information, see Managing Cluster * Authentication and Launching * Amazon EKS nodes in the Amazon EKS User Guide. *
* * @param createClusterRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the CreateCluster operation returned by the service. * @sample AmazonEKSAsyncHandler.CreateCluster * @see AWS API * Documentation */ java.util.concurrent.Future* Creates an Fargate profile for your Amazon EKS cluster. You must have at least one Fargate profile in a cluster * to be able to run pods on Fargate. *
** The Fargate profile allows an administrator to declare which pods run on Fargate and specify which pods run on * which Fargate profile. This declaration is done through the profile’s selectors. Each profile can have up to five * selectors that contain a namespace and labels. A namespace is required for every selector. The label field * consists of multiple optional key-value pairs. Pods that match the selectors are scheduled on Fargate. If a * to-be-scheduled pod matches any of the selectors in the Fargate profile, then that pod is run on Fargate. *
*
* When you create a Fargate profile, you must specify a pod execution role to use with the pods that are scheduled
* with the profile. This role is added to the cluster's Kubernetes Role Based Access Control (RBAC) for
* authorization so that the kubelet
that is running on the Fargate infrastructure can register with
* your Amazon EKS cluster so that it can appear in your cluster as a node. The pod execution role also provides IAM
* permissions to the Fargate infrastructure to allow read access to Amazon ECR image repositories. For more
* information, see Pod Execution
* Role in the Amazon EKS User Guide.
*
* Fargate profiles are immutable. However, you can create a new updated profile to replace an existing profile and * then delete the original after the updated profile has finished creating. *
*
* If any Fargate profiles in a cluster are in the DELETING
status, you must wait for that Fargate
* profile to finish deleting before you can create any other profiles in that cluster.
*
* For more information, see Fargate * Profile in the Amazon EKS User Guide. *
* * @param createFargateProfileRequest * @return A Java Future containing the result of the CreateFargateProfile operation returned by the service. * @sample AmazonEKSAsync.CreateFargateProfile * @see AWS API * Documentation */ java.util.concurrent.Future* Creates an Fargate profile for your Amazon EKS cluster. You must have at least one Fargate profile in a cluster * to be able to run pods on Fargate. *
** The Fargate profile allows an administrator to declare which pods run on Fargate and specify which pods run on * which Fargate profile. This declaration is done through the profile’s selectors. Each profile can have up to five * selectors that contain a namespace and labels. A namespace is required for every selector. The label field * consists of multiple optional key-value pairs. Pods that match the selectors are scheduled on Fargate. If a * to-be-scheduled pod matches any of the selectors in the Fargate profile, then that pod is run on Fargate. *
*
* When you create a Fargate profile, you must specify a pod execution role to use with the pods that are scheduled
* with the profile. This role is added to the cluster's Kubernetes Role Based Access Control (RBAC) for
* authorization so that the kubelet
that is running on the Fargate infrastructure can register with
* your Amazon EKS cluster so that it can appear in your cluster as a node. The pod execution role also provides IAM
* permissions to the Fargate infrastructure to allow read access to Amazon ECR image repositories. For more
* information, see Pod Execution
* Role in the Amazon EKS User Guide.
*
* Fargate profiles are immutable. However, you can create a new updated profile to replace an existing profile and * then delete the original after the updated profile has finished creating. *
*
* If any Fargate profiles in a cluster are in the DELETING
status, you must wait for that Fargate
* profile to finish deleting before you can create any other profiles in that cluster.
*
* For more information, see Fargate * Profile in the Amazon EKS User Guide. *
* * @param createFargateProfileRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the CreateFargateProfile operation returned by the service. * @sample AmazonEKSAsyncHandler.CreateFargateProfile * @see AWS API * Documentation */ java.util.concurrent.Future* Creates a managed node group for an Amazon EKS cluster. You can only create a node group for your cluster that is * equal to the current Kubernetes version for the cluster. All node groups are created with the latest AMI release * version for the respective minor Kubernetes version of the cluster, unless you deploy a custom AMI using a launch * template. For more information about using launch templates, see Launch template support. *
** An Amazon EKS managed node group is an Amazon EC2 Auto Scaling group and associated Amazon EC2 instances that are * managed by Amazon Web Services for an Amazon EKS cluster. For more information, see Managed node groups in the * Amazon EKS User Guide. *
** Windows AMI types are only supported for commercial Regions that support Windows Amazon EKS. *
** Creates a managed node group for an Amazon EKS cluster. You can only create a node group for your cluster that is * equal to the current Kubernetes version for the cluster. All node groups are created with the latest AMI release * version for the respective minor Kubernetes version of the cluster, unless you deploy a custom AMI using a launch * template. For more information about using launch templates, see Launch template support. *
** An Amazon EKS managed node group is an Amazon EC2 Auto Scaling group and associated Amazon EC2 instances that are * managed by Amazon Web Services for an Amazon EKS cluster. For more information, see Managed node groups in the * Amazon EKS User Guide. *
** Windows AMI types are only supported for commercial Regions that support Windows Amazon EKS. *
** Delete an Amazon EKS add-on. *
** When you remove the add-on, it will also be deleted from the cluster. You can always manually start an add-on on * the cluster using the Kubernetes API. *
* * @param deleteAddonRequest * @return A Java Future containing the result of the DeleteAddon operation returned by the service. * @sample AmazonEKSAsync.DeleteAddon * @see AWS API * Documentation */ java.util.concurrent.Future* Delete an Amazon EKS add-on. *
** When you remove the add-on, it will also be deleted from the cluster. You can always manually start an add-on on * the cluster using the Kubernetes API. *
* * @param deleteAddonRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DeleteAddon operation returned by the service. * @sample AmazonEKSAsyncHandler.DeleteAddon * @see AWS API * Documentation */ java.util.concurrent.Future* Deletes the Amazon EKS cluster control plane. *
** If you have active services in your cluster that are associated with a load balancer, you must delete those * services before deleting the cluster so that the load balancers are deleted properly. Otherwise, you can have * orphaned resources in your VPC that prevent you from being able to delete the VPC. For more information, see Deleting a Cluster in the * Amazon EKS User Guide. *
** If you have managed node groups or Fargate profiles attached to the cluster, you must delete them first. For more * information, see DeleteNodegroup and DeleteFargateProfile. *
* * @param deleteClusterRequest * @return A Java Future containing the result of the DeleteCluster operation returned by the service. * @sample AmazonEKSAsync.DeleteCluster * @see AWS API * Documentation */ java.util.concurrent.Future* Deletes the Amazon EKS cluster control plane. *
** If you have active services in your cluster that are associated with a load balancer, you must delete those * services before deleting the cluster so that the load balancers are deleted properly. Otherwise, you can have * orphaned resources in your VPC that prevent you from being able to delete the VPC. For more information, see Deleting a Cluster in the * Amazon EKS User Guide. *
** If you have managed node groups or Fargate profiles attached to the cluster, you must delete them first. For more * information, see DeleteNodegroup and DeleteFargateProfile. *
* * @param deleteClusterRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DeleteCluster operation returned by the service. * @sample AmazonEKSAsyncHandler.DeleteCluster * @see AWS API * Documentation */ java.util.concurrent.Future* Deletes an Fargate profile. *
** When you delete a Fargate profile, any pods running on Fargate that were created with the profile are deleted. If * those pods match another Fargate profile, then they are scheduled on Fargate with that profile. If they no longer * match any Fargate profiles, then they are not scheduled on Fargate and they may remain in a pending state. *
*
* Only one Fargate profile in a cluster can be in the DELETING
status at a time. You must wait for a
* Fargate profile to finish deleting before you can delete any other profiles in that cluster.
*
* Deletes an Fargate profile. *
** When you delete a Fargate profile, any pods running on Fargate that were created with the profile are deleted. If * those pods match another Fargate profile, then they are scheduled on Fargate with that profile. If they no longer * match any Fargate profiles, then they are not scheduled on Fargate and they may remain in a pending state. *
*
* Only one Fargate profile in a cluster can be in the DELETING
status at a time. You must wait for a
* Fargate profile to finish deleting before you can delete any other profiles in that cluster.
*
* Deletes an Amazon EKS node group for a cluster. *
* * @param deleteNodegroupRequest * @return A Java Future containing the result of the DeleteNodegroup operation returned by the service. * @sample AmazonEKSAsync.DeleteNodegroup * @see AWS API * Documentation */ java.util.concurrent.Future* Deletes an Amazon EKS node group for a cluster. *
* * @param deleteNodegroupRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DeleteNodegroup operation returned by the service. * @sample AmazonEKSAsyncHandler.DeleteNodegroup * @see AWS API * Documentation */ java.util.concurrent.Future* Deregisters a connected cluster to remove it from the Amazon EKS control plane. *
* * @param deregisterClusterRequest * @return A Java Future containing the result of the DeregisterCluster operation returned by the service. * @sample AmazonEKSAsync.DeregisterCluster * @see AWS API * Documentation */ java.util.concurrent.Future* Deregisters a connected cluster to remove it from the Amazon EKS control plane. *
* * @param deregisterClusterRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DeregisterCluster operation returned by the service. * @sample AmazonEKSAsyncHandler.DeregisterCluster * @see AWS API * Documentation */ java.util.concurrent.Future* Describes an Amazon EKS add-on. *
* * @param describeAddonRequest * @return A Java Future containing the result of the DescribeAddon operation returned by the service. * @sample AmazonEKSAsync.DescribeAddon * @see AWS API * Documentation */ java.util.concurrent.Future* Describes an Amazon EKS add-on. *
* * @param describeAddonRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeAddon operation returned by the service. * @sample AmazonEKSAsyncHandler.DescribeAddon * @see AWS API * Documentation */ java.util.concurrent.Future* Returns configuration options. *
* * @param describeAddonConfigurationRequest * @return A Java Future containing the result of the DescribeAddonConfiguration operation returned by the service. * @sample AmazonEKSAsync.DescribeAddonConfiguration * @see AWS * API Documentation */ java.util.concurrent.Future* Returns configuration options. *
* * @param describeAddonConfigurationRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeAddonConfiguration operation returned by the service. * @sample AmazonEKSAsyncHandler.DescribeAddonConfiguration * @see AWS * API Documentation */ java.util.concurrent.Future
* Describes the versions for an add-on. Information such as the Kubernetes versions that you can use the add-on
* with, the owner
, publisher
, and the type
of the add-on are returned.
*
* Describes the versions for an add-on. Information such as the Kubernetes versions that you can use the add-on
* with, the owner
, publisher
, and the type
of the add-on are returned.
*
* Returns descriptive information about an Amazon EKS cluster. *
*
* The API server endpoint and certificate authority data returned by this operation are required for
* kubelet
and kubectl
to communicate with your Kubernetes API server. For more
* information, see Create a
* kubeconfig for Amazon EKS.
*
* The API server endpoint and certificate authority data aren't available until the cluster reaches the
* ACTIVE
state.
*
* Returns descriptive information about an Amazon EKS cluster. *
*
* The API server endpoint and certificate authority data returned by this operation are required for
* kubelet
and kubectl
to communicate with your Kubernetes API server. For more
* information, see Create a
* kubeconfig for Amazon EKS.
*
* The API server endpoint and certificate authority data aren't available until the cluster reaches the
* ACTIVE
state.
*
* Returns descriptive information about an Fargate profile. *
* * @param describeFargateProfileRequest * @return A Java Future containing the result of the DescribeFargateProfile operation returned by the service. * @sample AmazonEKSAsync.DescribeFargateProfile * @see AWS API * Documentation */ java.util.concurrent.Future* Returns descriptive information about an Fargate profile. *
* * @param describeFargateProfileRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeFargateProfile operation returned by the service. * @sample AmazonEKSAsyncHandler.DescribeFargateProfile * @see AWS API * Documentation */ java.util.concurrent.Future* Returns descriptive information about an identity provider configuration. *
* * @param describeIdentityProviderConfigRequest * @return A Java Future containing the result of the DescribeIdentityProviderConfig operation returned by the * service. * @sample AmazonEKSAsync.DescribeIdentityProviderConfig * @see AWS API Documentation */ java.util.concurrent.Future* Returns descriptive information about an identity provider configuration. *
* * @param describeIdentityProviderConfigRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeIdentityProviderConfig operation returned by the * service. * @sample AmazonEKSAsyncHandler.DescribeIdentityProviderConfig * @see AWS API Documentation */ java.util.concurrent.Future* Returns descriptive information about an Amazon EKS node group. *
* * @param describeNodegroupRequest * @return A Java Future containing the result of the DescribeNodegroup operation returned by the service. * @sample AmazonEKSAsync.DescribeNodegroup * @see AWS API * Documentation */ java.util.concurrent.Future* Returns descriptive information about an Amazon EKS node group. *
* * @param describeNodegroupRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeNodegroup operation returned by the service. * @sample AmazonEKSAsyncHandler.DescribeNodegroup * @see AWS API * Documentation */ java.util.concurrent.Future* Returns descriptive information about an update against your Amazon EKS cluster or associated managed node group * or Amazon EKS add-on. *
*
* When the status of the update is Succeeded
, the update is complete. If an update fails, the status
* is Failed
, and an error detail explains the reason for the failure.
*
* Returns descriptive information about an update against your Amazon EKS cluster or associated managed node group * or Amazon EKS add-on. *
*
* When the status of the update is Succeeded
, the update is complete. If an update fails, the status
* is Failed
, and an error detail explains the reason for the failure.
*
* Disassociates an identity provider configuration from a cluster. If you disassociate an identity provider from * your cluster, users included in the provider can no longer access the cluster. However, you can still access the * cluster with Amazon Web Services IAM users. *
* * @param disassociateIdentityProviderConfigRequest * @return A Java Future containing the result of the DisassociateIdentityProviderConfig operation returned by the * service. * @sample AmazonEKSAsync.DisassociateIdentityProviderConfig * @see AWS API Documentation */ java.util.concurrent.Future* Disassociates an identity provider configuration from a cluster. If you disassociate an identity provider from * your cluster, users included in the provider can no longer access the cluster. However, you can still access the * cluster with Amazon Web Services IAM users. *
* * @param disassociateIdentityProviderConfigRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DisassociateIdentityProviderConfig operation returned by the * service. * @sample AmazonEKSAsyncHandler.DisassociateIdentityProviderConfig * @see AWS API Documentation */ java.util.concurrent.Future* Lists the available add-ons. *
* * @param listAddonsRequest * @return A Java Future containing the result of the ListAddons operation returned by the service. * @sample AmazonEKSAsync.ListAddons * @see AWS API * Documentation */ java.util.concurrent.Future* Lists the available add-ons. *
* * @param listAddonsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListAddons operation returned by the service. * @sample AmazonEKSAsyncHandler.ListAddons * @see AWS API * Documentation */ java.util.concurrent.Future* Lists the Amazon EKS clusters in your Amazon Web Services account in the specified Region. *
* * @param listClustersRequest * @return A Java Future containing the result of the ListClusters operation returned by the service. * @sample AmazonEKSAsync.ListClusters * @see AWS API * Documentation */ java.util.concurrent.Future* Lists the Amazon EKS clusters in your Amazon Web Services account in the specified Region. *
* * @param listClustersRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListClusters operation returned by the service. * @sample AmazonEKSAsyncHandler.ListClusters * @see AWS API * Documentation */ java.util.concurrent.Future* Lists the Fargate profiles associated with the specified cluster in your Amazon Web Services account in the * specified Region. *
* * @param listFargateProfilesRequest * @return A Java Future containing the result of the ListFargateProfiles operation returned by the service. * @sample AmazonEKSAsync.ListFargateProfiles * @see AWS API * Documentation */ java.util.concurrent.Future* Lists the Fargate profiles associated with the specified cluster in your Amazon Web Services account in the * specified Region. *
* * @param listFargateProfilesRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListFargateProfiles operation returned by the service. * @sample AmazonEKSAsyncHandler.ListFargateProfiles * @see AWS API * Documentation */ java.util.concurrent.Future* A list of identity provider configurations. *
* * @param listIdentityProviderConfigsRequest * @return A Java Future containing the result of the ListIdentityProviderConfigs operation returned by the service. * @sample AmazonEKSAsync.ListIdentityProviderConfigs * @see AWS API Documentation */ java.util.concurrent.Future* A list of identity provider configurations. *
* * @param listIdentityProviderConfigsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListIdentityProviderConfigs operation returned by the service. * @sample AmazonEKSAsyncHandler.ListIdentityProviderConfigs * @see AWS API Documentation */ java.util.concurrent.Future* Lists the Amazon EKS managed node groups associated with the specified cluster in your Amazon Web Services * account in the specified Region. Self-managed node groups are not listed. *
* * @param listNodegroupsRequest * @return A Java Future containing the result of the ListNodegroups operation returned by the service. * @sample AmazonEKSAsync.ListNodegroups * @see AWS API * Documentation */ java.util.concurrent.Future* Lists the Amazon EKS managed node groups associated with the specified cluster in your Amazon Web Services * account in the specified Region. Self-managed node groups are not listed. *
* * @param listNodegroupsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListNodegroups operation returned by the service. * @sample AmazonEKSAsyncHandler.ListNodegroups * @see AWS API * Documentation */ java.util.concurrent.Future* List the tags for an Amazon EKS resource. *
* * @param listTagsForResourceRequest * @return A Java Future containing the result of the ListTagsForResource operation returned by the service. * @sample AmazonEKSAsync.ListTagsForResource * @see AWS API * Documentation */ java.util.concurrent.Future* List the tags for an Amazon EKS resource. *
* * @param listTagsForResourceRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListTagsForResource operation returned by the service. * @sample AmazonEKSAsyncHandler.ListTagsForResource * @see AWS API * Documentation */ java.util.concurrent.Future* Lists the updates associated with an Amazon EKS cluster or managed node group in your Amazon Web Services * account, in the specified Region. *
* * @param listUpdatesRequest * @return A Java Future containing the result of the ListUpdates operation returned by the service. * @sample AmazonEKSAsync.ListUpdates * @see AWS API * Documentation */ java.util.concurrent.Future* Lists the updates associated with an Amazon EKS cluster or managed node group in your Amazon Web Services * account, in the specified Region. *
* * @param listUpdatesRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListUpdates operation returned by the service. * @sample AmazonEKSAsyncHandler.ListUpdates * @see AWS API * Documentation */ java.util.concurrent.Future* Connects a Kubernetes cluster to the Amazon EKS control plane. *
** Any Kubernetes cluster can be connected to the Amazon EKS control plane to view current information about the * cluster and its nodes. *
*
* Cluster connection requires two steps. First, send a RegisterClusterRequest
to add it to
* the Amazon EKS control plane.
*
* Second, a Manifest containing the activationID
and activationCode
must be applied to the
* Kubernetes cluster through it's native provider to provide visibility.
*
* After the Manifest is updated and applied, then the connected cluster is visible to the Amazon EKS control plane. * If the Manifest is not applied within three days, then the connected cluster will no longer be visible and must * be deregistered. See DeregisterCluster. *
* * @param registerClusterRequest * @return A Java Future containing the result of the RegisterCluster operation returned by the service. * @sample AmazonEKSAsync.RegisterCluster * @see AWS API * Documentation */ java.util.concurrent.Future* Connects a Kubernetes cluster to the Amazon EKS control plane. *
** Any Kubernetes cluster can be connected to the Amazon EKS control plane to view current information about the * cluster and its nodes. *
*
* Cluster connection requires two steps. First, send a RegisterClusterRequest
to add it to
* the Amazon EKS control plane.
*
* Second, a Manifest containing the activationID
and activationCode
must be applied to the
* Kubernetes cluster through it's native provider to provide visibility.
*
* After the Manifest is updated and applied, then the connected cluster is visible to the Amazon EKS control plane. * If the Manifest is not applied within three days, then the connected cluster will no longer be visible and must * be deregistered. See DeregisterCluster. *
* * @param registerClusterRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the RegisterCluster operation returned by the service. * @sample AmazonEKSAsyncHandler.RegisterCluster * @see AWS API * Documentation */ java.util.concurrent.Future
* Associates the specified tags to a resource with the specified resourceArn
. If existing tags on a
* resource are not specified in the request parameters, they are not changed. When a resource is deleted, the tags
* associated with that resource are deleted as well. Tags that you create for Amazon EKS resources do not propagate
* to any other resources associated with the cluster. For example, if you tag a cluster with this operation, that
* tag does not automatically propagate to the subnets and nodes associated with the cluster.
*
* Associates the specified tags to a resource with the specified resourceArn
. If existing tags on a
* resource are not specified in the request parameters, they are not changed. When a resource is deleted, the tags
* associated with that resource are deleted as well. Tags that you create for Amazon EKS resources do not propagate
* to any other resources associated with the cluster. For example, if you tag a cluster with this operation, that
* tag does not automatically propagate to the subnets and nodes associated with the cluster.
*
* Deletes specified tags from a resource. *
* * @param untagResourceRequest * @return A Java Future containing the result of the UntagResource operation returned by the service. * @sample AmazonEKSAsync.UntagResource * @see AWS API * Documentation */ java.util.concurrent.Future* Deletes specified tags from a resource. *
* * @param untagResourceRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the UntagResource operation returned by the service. * @sample AmazonEKSAsyncHandler.UntagResource * @see AWS API * Documentation */ java.util.concurrent.Future* Updates an Amazon EKS add-on. *
* * @param updateAddonRequest * @return A Java Future containing the result of the UpdateAddon operation returned by the service. * @sample AmazonEKSAsync.UpdateAddon * @see AWS API * Documentation */ java.util.concurrent.Future* Updates an Amazon EKS add-on. *
* * @param updateAddonRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the UpdateAddon operation returned by the service. * @sample AmazonEKSAsyncHandler.UpdateAddon * @see AWS API * Documentation */ java.util.concurrent.Future* Updates an Amazon EKS cluster configuration. Your cluster continues to function during the update. The response * output includes an update ID that you can use to track the status of your cluster update with the * DescribeUpdate API operation. *
** You can use this API operation to enable or disable exporting the Kubernetes control plane logs for your cluster * to CloudWatch Logs. By default, cluster control plane logs aren't exported to CloudWatch Logs. For more * information, see Amazon EKS * Cluster Control Plane Logs in the Amazon EKS User Guide . *
** CloudWatch Logs ingestion, archive storage, and data scanning rates apply to exported control plane logs. For * more information, see CloudWatch Pricing. *
** You can also use this API operation to enable or disable public and private access to your cluster's Kubernetes * API server endpoint. By default, public access is enabled, and private access is disabled. For more information, * see Amazon EKS cluster endpoint * access control in the Amazon EKS User Guide . *
** You can't update the subnets or security group IDs for an existing cluster. *
*
* Cluster updates are asynchronous, and they should finish within a few minutes. During an update, the cluster
* status moves to UPDATING
(this status transition is eventually consistent). When the update is
* complete (either Failed
or Successful
), the cluster status moves to Active
* .
*
* Updates an Amazon EKS cluster configuration. Your cluster continues to function during the update. The response * output includes an update ID that you can use to track the status of your cluster update with the * DescribeUpdate API operation. *
** You can use this API operation to enable or disable exporting the Kubernetes control plane logs for your cluster * to CloudWatch Logs. By default, cluster control plane logs aren't exported to CloudWatch Logs. For more * information, see Amazon EKS * Cluster Control Plane Logs in the Amazon EKS User Guide . *
** CloudWatch Logs ingestion, archive storage, and data scanning rates apply to exported control plane logs. For * more information, see CloudWatch Pricing. *
** You can also use this API operation to enable or disable public and private access to your cluster's Kubernetes * API server endpoint. By default, public access is enabled, and private access is disabled. For more information, * see Amazon EKS cluster endpoint * access control in the Amazon EKS User Guide . *
** You can't update the subnets or security group IDs for an existing cluster. *
*
* Cluster updates are asynchronous, and they should finish within a few minutes. During an update, the cluster
* status moves to UPDATING
(this status transition is eventually consistent). When the update is
* complete (either Failed
or Successful
), the cluster status moves to Active
* .
*
* Updates an Amazon EKS cluster to the specified Kubernetes version. Your cluster continues to function during the * update. The response output includes an update ID that you can use to track the status of your cluster update * with the DescribeUpdate API operation. *
*
* Cluster updates are asynchronous, and they should finish within a few minutes. During an update, the cluster
* status moves to UPDATING
(this status transition is eventually consistent). When the update is
* complete (either Failed
or Successful
), the cluster status moves to Active
* .
*
* If your cluster has managed node groups attached to it, all of your node groups’ Kubernetes versions must match * the cluster’s Kubernetes version in order to update the cluster to a new Kubernetes version. *
* * @param updateClusterVersionRequest * @return A Java Future containing the result of the UpdateClusterVersion operation returned by the service. * @sample AmazonEKSAsync.UpdateClusterVersion * @see AWS API * Documentation */ java.util.concurrent.Future* Updates an Amazon EKS cluster to the specified Kubernetes version. Your cluster continues to function during the * update. The response output includes an update ID that you can use to track the status of your cluster update * with the DescribeUpdate API operation. *
*
* Cluster updates are asynchronous, and they should finish within a few minutes. During an update, the cluster
* status moves to UPDATING
(this status transition is eventually consistent). When the update is
* complete (either Failed
or Successful
), the cluster status moves to Active
* .
*
* If your cluster has managed node groups attached to it, all of your node groups’ Kubernetes versions must match * the cluster’s Kubernetes version in order to update the cluster to a new Kubernetes version. *
* * @param updateClusterVersionRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the UpdateClusterVersion operation returned by the service. * @sample AmazonEKSAsyncHandler.UpdateClusterVersion * @see AWS API * Documentation */ java.util.concurrent.Future* Updates an Amazon EKS managed node group configuration. Your node group continues to function during the update. * The response output includes an update ID that you can use to track the status of your node group update with the * DescribeUpdate API operation. Currently you can update the Kubernetes labels for a node group or the * scaling configuration. *
* * @param updateNodegroupConfigRequest * @return A Java Future containing the result of the UpdateNodegroupConfig operation returned by the service. * @sample AmazonEKSAsync.UpdateNodegroupConfig * @see AWS API * Documentation */ java.util.concurrent.Future* Updates an Amazon EKS managed node group configuration. Your node group continues to function during the update. * The response output includes an update ID that you can use to track the status of your node group update with the * DescribeUpdate API operation. Currently you can update the Kubernetes labels for a node group or the * scaling configuration. *
* * @param updateNodegroupConfigRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the UpdateNodegroupConfig operation returned by the service. * @sample AmazonEKSAsyncHandler.UpdateNodegroupConfig * @see AWS API * Documentation */ java.util.concurrent.Future* Updates the Kubernetes version or AMI version of an Amazon EKS managed node group. *
** You can update a node group using a launch template only if the node group was originally deployed with a launch * template. If you need to update a custom AMI in a node group that was deployed with a launch template, then * update your custom AMI, specify the new ID in a new version of the launch template, and then update the node * group to the new version of the launch template. *
** If you update without a launch template, then you can update to the latest available AMI version of a node * group's current Kubernetes version by not specifying a Kubernetes version in the request. You can update to the * latest AMI version of your cluster's current Kubernetes version by specifying your cluster's Kubernetes version * in the request. For information about Linux versions, see Amazon EKS optimized Amazon * Linux AMI versions in the Amazon EKS User Guide. For information about Windows versions, see Amazon EKS optimized * Windows AMI versions in the Amazon EKS User Guide. *
** You cannot roll back a node group to an earlier Kubernetes version or AMI version. *
*
* When a node in a managed node group is terminated due to a scaling action or update, the pods in that node are
* drained first. Amazon EKS attempts to drain the nodes gracefully and will fail if it is unable to do so. You can
* force
the update if Amazon EKS is unable to drain the nodes as a result of a pod disruption budget
* issue.
*
* Updates the Kubernetes version or AMI version of an Amazon EKS managed node group. *
** You can update a node group using a launch template only if the node group was originally deployed with a launch * template. If you need to update a custom AMI in a node group that was deployed with a launch template, then * update your custom AMI, specify the new ID in a new version of the launch template, and then update the node * group to the new version of the launch template. *
** If you update without a launch template, then you can update to the latest available AMI version of a node * group's current Kubernetes version by not specifying a Kubernetes version in the request. You can update to the * latest AMI version of your cluster's current Kubernetes version by specifying your cluster's Kubernetes version * in the request. For information about Linux versions, see Amazon EKS optimized Amazon * Linux AMI versions in the Amazon EKS User Guide. For information about Windows versions, see Amazon EKS optimized * Windows AMI versions in the Amazon EKS User Guide. *
** You cannot roll back a node group to an earlier Kubernetes version or AMI version. *
*
* When a node in a managed node group is terminated due to a scaling action or update, the pods in that node are
* drained first. Amazon EKS attempts to drain the nodes gracefully and will fail if it is unable to do so. You can
* force
the update if Amazon EKS is unable to drain the nodes as a result of a pod disruption budget
* issue.
*