aws-sdk-eks 1.39.0 → 1.40.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3a5a7ce6dd7bc21c388bbd0714cde7596ea1081af87aa1d7ff6b7c79b681620d
-  data.tar.gz: b613e224f572b20d98b35e419b4ebecd65fcfccee4cbd43cd9d10991af9a7066
+  metadata.gz: 2502b7c20f821fb7587d2d9183a9bc7d6e566be56e2dfc4051c1762119629575
+  data.tar.gz: 2a133ad4ef0d4e61e1b468482ad687c9de7be1e478efaa802e94c578937680cd
 SHA512:
-  metadata.gz: 4d64bfa6e95f6009d39853b8c10b342219a746d0729421ff88edf6fbcd28991202f65054c0f841045614e46b60c4f27bc460caee114dd63ff2f7e0f6fa262943
-  data.tar.gz: e9b7050f2d7f9df6999d26fc5aa3157a783ef6429a7083258891d4bfb33d2aa5136b9a9c20746635ca3e32128518724a9fd8dee7fb6b4a0b76bdde6d269a092c
+  metadata.gz: 05e0e71a37bab3718bdb8929da4ef865273e50c98cf311a026f03414069403c71086332fef895688f06da23f1ce51b183a88f67848c0d31388ce31075ce1f4a5
+  data.tar.gz: 33e404741bd4c50b45fb12a0e1c6819f14ab8a28408b9bd2a1ef47ae38e852b027e5c66e341ba01660e9fc563376e009605f4305d9ca73fbf1efa5bcfc5de916

data/lib/aws-sdk-eks.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-eks/customizations'
 # @service
 module Aws::EKS
 
-  GEM_VERSION = '1.39.0'
+  GEM_VERSION = '1.40.0'
 
 end

data/lib/aws-sdk-eks/client.rb

@@ -375,9 +375,9 @@ module Aws::EKS
     #
     # @option params [required, String] :role_arn
     #   The Amazon Resource Name (ARN) of the IAM role that provides
-    #   permissions for Amazon EKS to make calls to other AWS API operations
-    #   on your behalf. For more information, see [Amazon EKS Service IAM
-    #   Role][1] in the <i> <i>Amazon EKS User Guide</i> </i>.
+    #   permissions for the Kubernetes control plane to make calls to AWS API
+    #   operations on your behalf. For more information, see [Amazon EKS
+    #   Service IAM Role][1] in the <i> <i>Amazon EKS User Guide</i> </i>.
     #
     #
     #
@@ -677,17 +677,20 @@ module Aws::EKS
     # 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.
+    # 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][1].
     #
     # An Amazon EKS managed node group is an Amazon EC2 Auto Scaling group
     # and associated Amazon EC2 instances that are managed by AWS for an
     # Amazon EKS cluster. Each node group uses a version of the Amazon
     # EKS-optimized Amazon Linux 2 AMI. For more information, see [Managed
-    # Node Groups][1] in the *Amazon EKS User Guide*.
+    # Node Groups][2] in the *Amazon EKS User Guide*.
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/eks/latest/userguide/managed-node-groups.html
+    # [1]: https://docs.aws.amazon.com/eks/latest/userguide/launch-templates.html
+    # [2]: https://docs.aws.amazon.com/eks/latest/userguide/managed-node-groups.html
     #
     # @option params [required, String] :cluster_name
     #   The name of the cluster to create the node group in.
@@ -701,28 +704,68 @@ module Aws::EKS
     #
     # @option params [Integer] :disk_size
     #   The root device disk size (in GiB) for your node group instances. The
-    #   default disk size is 20 GiB.
+    #   default disk size is 20 GiB. If you specify `launchTemplate`, then
+    #   don't specify `diskSize`, or the node group deployment will fail. For
+    #   more information about using launch templates with Amazon EKS, see
+    #   [Launch template support][1] in the Amazon EKS User Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/eks/latest/userguide/launch-templates.html
     #
     # @option params [required, Array<String>] :subnets
     #   The subnets to use for the Auto Scaling group that is created for your
     #   node group. These subnets must have the tag key
     #   `kubernetes.io/cluster/CLUSTER_NAME` with a value of `shared`, where
-    #   `CLUSTER_NAME` is replaced with the name of your cluster.
+    #   `CLUSTER_NAME` is replaced with the name of your cluster. If you
+    #   specify `launchTemplate`, then don't specify [ `SubnetId` ][1] in
+    #   your launch template, or the node group deployment will fail. For more
+    #   information about using launch templates with Amazon EKS, see [Launch
+    #   template support][2] in the Amazon EKS User Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateNetworkInterface.html
+    #   [2]: https://docs.aws.amazon.com/eks/latest/userguide/launch-templates.html
     #
     # @option params [Array<String>] :instance_types
-    #   The instance type to use for your node group. Currently, you can
-    #   specify a single instance type for a node group. The default value for
-    #   this parameter is `t3.medium`. If you choose a GPU instance type, be
-    #   sure to specify the `AL2_x86_64_GPU` with the `amiType` parameter.
+    #   The instance type to use for your node group. You can specify a single
+    #   instance type for a node group. The default value for `instanceTypes`
+    #   is `t3.medium`. If you choose a GPU instance type, be sure to specify
+    #   `AL2_x86_64_GPU` with the `amiType` parameter. If you specify
+    #   `launchTemplate`, then don't specify `instanceTypes`, or the node
+    #   group deployment will fail. For more information about using launch
+    #   templates with Amazon EKS, see [Launch template support][1] in the
+    #   Amazon EKS User Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/eks/latest/userguide/launch-templates.html
     #
     # @option params [String] :ami_type
     #   The AMI type for your node group. GPU instance types should use the
     #   `AL2_x86_64_GPU` AMI type, which uses the Amazon EKS-optimized Linux
     #   AMI with GPU support. Non-GPU instances should use the `AL2_x86_64`
-    #   AMI type, which uses the Amazon EKS-optimized Linux AMI.
+    #   AMI type, which uses the Amazon EKS-optimized Linux AMI. If you
+    #   specify `launchTemplate`, and your launch template uses a custom AMI,
+    #   then don't specify `amiType`, or the node group deployment will fail.
+    #   For more information about using launch templates with Amazon EKS, see
+    #   [Launch template support][1] in the Amazon EKS User Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/eks/latest/userguide/launch-templates.html
     #
     # @option params [Types::RemoteAccessConfig] :remote_access
-    #   The remote access (SSH) configuration to use with your node group.
+    #   The remote access (SSH) configuration to use with your node group. If
+    #   you specify `launchTemplate`, then don't specify `remoteAccess`, or
+    #   the node group deployment will fail. For more information about using
+    #   launch templates with Amazon EKS, see [Launch template support][1] in
+    #   the Amazon EKS User Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/eks/latest/userguide/launch-templates.html
     #
     # @option params [required, String] :node_role
     #   The Amazon Resource Name (ARN) of the IAM role to associate with your
@@ -732,11 +775,17 @@ module Aws::EKS
     #   Before you can launch worker nodes and register them into a cluster,
     #   you must create an IAM role for those worker nodes to use when they
     #   are launched. For more information, see [Amazon EKS Worker Node IAM
-    #   Role][1] in the <i> <i>Amazon EKS User Guide</i> </i>.
+    #   Role][1] in the <i> <i>Amazon EKS User Guide</i> </i>. If you specify
+    #   `launchTemplate`, then don't specify [ `IamInstanceProfile` ][2] in
+    #   your launch template, or the node group deployment will fail. For more
+    #   information about using launch templates with Amazon EKS, see [Launch
+    #   template support][3] in the Amazon EKS User Guide.
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/eks/latest/userguide/worker_node_IAM_role.html
+    #   [2]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_IamInstanceProfile.html
+    #   [3]: https://docs.aws.amazon.com/eks/latest/userguide/launch-templates.html
     #
     # @option params [Hash<String,String>] :labels
     #   The Kubernetes labels to be applied to the nodes in the node group
@@ -756,21 +805,40 @@ module Aws::EKS
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
+    # @option params [Types::LaunchTemplateSpecification] :launch_template
+    #   An object representing a node group's launch template specification.
+    #   If specified, then do not specify `instanceTypes`, `diskSize`, or
+    #   `remoteAccess`. If specified, make sure that the launch template meets
+    #   the requirements in `launchTemplateSpecification`.
+    #
     # @option params [String] :version
     #   The Kubernetes version to use for your managed nodes. By default, the
     #   Kubernetes version of the cluster is used, and this is the only
-    #   accepted specified value.
+    #   accepted specified value. If you specify `launchTemplate`, and your
+    #   launch template uses a custom AMI, then don't specify `version`, or
+    #   the node group deployment will fail. For more information about using
+    #   launch templates with Amazon EKS, see [Launch template support][1] in
+    #   the Amazon EKS User Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/eks/latest/userguide/launch-templates.html
     #
     # @option params [String] :release_version
     #   The AMI version of the Amazon EKS-optimized AMI to use with your node
     #   group. By default, the latest available AMI version for the node
     #   group's current Kubernetes version is used. For more information, see
     #   [Amazon EKS-Optimized Linux AMI Versions][1] in the *Amazon EKS User
-    #   Guide*.
+    #   Guide*. If you specify `launchTemplate`, and your launch template uses
+    #   a custom AMI, then don't specify `releaseVersion`, or the node group
+    #   deployment will fail. For more information about using launch
+    #   templates with Amazon EKS, see [Launch template support][2] in the
+    #   Amazon EKS User Guide.
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/eks/latest/userguide/eks-linux-ami-versions.html
+    #   [2]: https://docs.aws.amazon.com/eks/latest/userguide/launch-templates.html
     #
     # @return [Types::CreateNodegroupResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -789,7 +857,7 @@ module Aws::EKS
     #     disk_size: 1,
     #     subnets: ["String"], # required
     #     instance_types: ["String"],
-    #     ami_type: "AL2_x86_64", # accepts AL2_x86_64, AL2_x86_64_GPU
+    #     ami_type: "AL2_x86_64", # accepts AL2_x86_64, AL2_x86_64_GPU, AL2_ARM_64
     #     remote_access: {
     #       ec2_ssh_key: "String",
     #       source_security_groups: ["String"],
@@ -802,6 +870,11 @@ module Aws::EKS
     #       "TagKey" => "TagValue",
     #     },
     #     client_request_token: "String",
+    #     launch_template: {
+    #       name: "String",
+    #       version: "String",
+    #       id: "String",
+    #     },
     #     version: "String",
     #     release_version: "String",
     #   })
@@ -826,7 +899,7 @@ module Aws::EKS
     #   resp.nodegroup.remote_access.ec2_ssh_key #=> String
     #   resp.nodegroup.remote_access.source_security_groups #=> Array
     #   resp.nodegroup.remote_access.source_security_groups[0] #=> String
-    #   resp.nodegroup.ami_type #=> String, one of "AL2_x86_64", "AL2_x86_64_GPU"
+    #   resp.nodegroup.ami_type #=> String, one of "AL2_x86_64", "AL2_x86_64_GPU", "AL2_ARM_64"
     #   resp.nodegroup.node_role #=> String
     #   resp.nodegroup.labels #=> Hash
     #   resp.nodegroup.labels["labelKey"] #=> String
@@ -839,6 +912,9 @@ module Aws::EKS
     #   resp.nodegroup.health.issues[0].message #=> String
     #   resp.nodegroup.health.issues[0].resource_ids #=> Array
     #   resp.nodegroup.health.issues[0].resource_ids[0] #=> String
+    #   resp.nodegroup.launch_template.name #=> String
+    #   resp.nodegroup.launch_template.version #=> String
+    #   resp.nodegroup.launch_template.id #=> String
     #   resp.nodegroup.tags #=> Hash
     #   resp.nodegroup.tags["TagKey"] #=> String
     #
@@ -1033,7 +1109,7 @@ module Aws::EKS
     #   resp.nodegroup.remote_access.ec2_ssh_key #=> String
     #   resp.nodegroup.remote_access.source_security_groups #=> Array
     #   resp.nodegroup.remote_access.source_security_groups[0] #=> String
-    #   resp.nodegroup.ami_type #=> String, one of "AL2_x86_64", "AL2_x86_64_GPU"
+    #   resp.nodegroup.ami_type #=> String, one of "AL2_x86_64", "AL2_x86_64_GPU", "AL2_ARM_64"
     #   resp.nodegroup.node_role #=> String
     #   resp.nodegroup.labels #=> Hash
     #   resp.nodegroup.labels["labelKey"] #=> String
@@ -1046,6 +1122,9 @@ module Aws::EKS
     #   resp.nodegroup.health.issues[0].message #=> String
     #   resp.nodegroup.health.issues[0].resource_ids #=> Array
     #   resp.nodegroup.health.issues[0].resource_ids[0] #=> String
+    #   resp.nodegroup.launch_template.name #=> String
+    #   resp.nodegroup.launch_template.version #=> String
+    #   resp.nodegroup.launch_template.id #=> String
     #   resp.nodegroup.tags #=> Hash
     #   resp.nodegroup.tags["TagKey"] #=> String
     #
@@ -1256,7 +1335,7 @@ module Aws::EKS
     #   resp.nodegroup.remote_access.ec2_ssh_key #=> String
     #   resp.nodegroup.remote_access.source_security_groups #=> Array
     #   resp.nodegroup.remote_access.source_security_groups[0] #=> String
-    #   resp.nodegroup.ami_type #=> String, one of "AL2_x86_64", "AL2_x86_64_GPU"
+    #   resp.nodegroup.ami_type #=> String, one of "AL2_x86_64", "AL2_x86_64_GPU", "AL2_ARM_64"
     #   resp.nodegroup.node_role #=> String
     #   resp.nodegroup.labels #=> Hash
     #   resp.nodegroup.labels["labelKey"] #=> String
@@ -1269,6 +1348,9 @@ module Aws::EKS
     #   resp.nodegroup.health.issues[0].message #=> String
     #   resp.nodegroup.health.issues[0].resource_ids #=> Array
     #   resp.nodegroup.health.issues[0].resource_ids[0] #=> String
+    #   resp.nodegroup.launch_template.name #=> String
+    #   resp.nodegroup.launch_template.version #=> String
+    #   resp.nodegroup.launch_template.id #=> String
     #   resp.nodegroup.tags #=> Hash
     #   resp.nodegroup.tags["TagKey"] #=> String
     #
@@ -1949,12 +2031,20 @@ module Aws::EKS
     # Updates the Kubernetes version or AMI version of an Amazon EKS managed
     # node group.
     #
-    # 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 more information, see [Amazon
-    # EKS-Optimized Linux AMI Versions][1] in the *Amazon EKS User Guide*.
+    # 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 more information, see [Amazon EKS-Optimized Linux AMI
+    # Versions][1] in the *Amazon EKS User Guide*.
     #
     # You cannot roll back a node group to an earlier Kubernetes version or
     # AMI version.
@@ -1980,17 +2070,36 @@ module Aws::EKS
     #   The Kubernetes version to update to. If no version is specified, then
     #   the Kubernetes version of the node group does not change. You can
     #   specify the Kubernetes version of the cluster to update the node group
-    #   to the latest AMI version of the cluster's Kubernetes version.
+    #   to the latest AMI version of the cluster's Kubernetes version. If you
+    #   specify `launchTemplate`, and your launch template uses a custom AMI,
+    #   then don't specify `version`, or the node group update will fail. For
+    #   more information about using launch templates with Amazon EKS, see
+    #   [Launch template support][1] in the Amazon EKS User Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/eks/latest/userguide/launch-templates.html
     #
     # @option params [String] :release_version
     #   The AMI version of the Amazon EKS-optimized AMI to use for the update.
     #   By default, the latest available AMI version for the node group's
     #   Kubernetes version is used. For more information, see [Amazon
     #   EKS-Optimized Linux AMI Versions ][1] in the *Amazon EKS User Guide*.
+    #   If you specify `launchTemplate`, and your launch template uses a
+    #   custom AMI, then don't specify `releaseVersion`, or the node group
+    #   update will fail. For more information about using launch templates
+    #   with Amazon EKS, see [Launch template support][2] in the Amazon EKS
+    #   User Guide.
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/eks/latest/userguide/eks-linux-ami-versions.html
+    #   [2]: https://docs.aws.amazon.com/eks/latest/userguide/launch-templates.html
+    #
+    # @option params [Types::LaunchTemplateSpecification] :launch_template
+    #   An object representing a node group's launch template specification.
+    #   You can only update a node group using a launch template if the node
+    #   group was originally deployed with a launch template.
     #
     # @option params [Boolean] :force
     #   Force the update if the existing node group's pods are unable to be
@@ -2017,6 +2126,11 @@ module Aws::EKS
     #     nodegroup_name: "String", # required
     #     version: "String",
     #     release_version: "String",
+    #     launch_template: {
+    #       name: "String",
+    #       version: "String",
+    #       id: "String",
+    #     },
     #     force: false,
     #     client_request_token: "String",
     #   })
@@ -2058,7 +2172,7 @@ module Aws::EKS
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-eks'
-      context[:gem_version] = '1.39.0'
+      context[:gem_version] = '1.40.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-eks/client_api.rb

@@ -62,6 +62,7 @@ module Aws::EKS
     InvalidRequestException = Shapes::StructureShape.new(name: 'InvalidRequestException')
     Issue = Shapes::StructureShape.new(name: 'Issue')
     IssueList = Shapes::ListShape.new(name: 'IssueList')
+    LaunchTemplateSpecification = Shapes::StructureShape.new(name: 'LaunchTemplateSpecification')
     ListClustersRequest = Shapes::StructureShape.new(name: 'ListClustersRequest')
     ListClustersRequestMaxResults = Shapes::IntegerShape.new(name: 'ListClustersRequestMaxResults')
     ListClustersResponse = Shapes::StructureShape.new(name: 'ListClustersResponse')
@@ -199,6 +200,7 @@ module Aws::EKS
     CreateNodegroupRequest.add_member(:labels, Shapes::ShapeRef.new(shape: labelsMap, location_name: "labels"))
     CreateNodegroupRequest.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "tags"))
     CreateNodegroupRequest.add_member(:client_request_token, Shapes::ShapeRef.new(shape: String, location_name: "clientRequestToken", metadata: {"idempotencyToken"=>true}))
+    CreateNodegroupRequest.add_member(:launch_template, Shapes::ShapeRef.new(shape: LaunchTemplateSpecification, location_name: "launchTemplate"))
     CreateNodegroupRequest.add_member(:version, Shapes::ShapeRef.new(shape: String, location_name: "version"))
     CreateNodegroupRequest.add_member(:release_version, Shapes::ShapeRef.new(shape: String, location_name: "releaseVersion"))
     CreateNodegroupRequest.struct_class = Types::CreateNodegroupRequest
@@ -308,6 +310,11 @@ module Aws::EKS
 
     IssueList.member = Shapes::ShapeRef.new(shape: Issue)
 
+    LaunchTemplateSpecification.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "name"))
+    LaunchTemplateSpecification.add_member(:version, Shapes::ShapeRef.new(shape: String, location_name: "version"))
+    LaunchTemplateSpecification.add_member(:id, Shapes::ShapeRef.new(shape: String, location_name: "id"))
+    LaunchTemplateSpecification.struct_class = Types::LaunchTemplateSpecification
+
     ListClustersRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: ListClustersRequestMaxResults, location: "querystring", location_name: "maxResults"))
     ListClustersRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location: "querystring", location_name: "nextToken"))
     ListClustersRequest.struct_class = Types::ListClustersRequest
@@ -379,6 +386,7 @@ module Aws::EKS
     Nodegroup.add_member(:resources, Shapes::ShapeRef.new(shape: NodegroupResources, location_name: "resources"))
     Nodegroup.add_member(:disk_size, Shapes::ShapeRef.new(shape: BoxedInteger, location_name: "diskSize"))
     Nodegroup.add_member(:health, Shapes::ShapeRef.new(shape: NodegroupHealth, location_name: "health"))
+    Nodegroup.add_member(:launch_template, Shapes::ShapeRef.new(shape: LaunchTemplateSpecification, location_name: "launchTemplate"))
     Nodegroup.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "tags"))
     Nodegroup.struct_class = Types::Nodegroup
 
@@ -499,6 +507,7 @@ module Aws::EKS
     UpdateNodegroupVersionRequest.add_member(:nodegroup_name, Shapes::ShapeRef.new(shape: String, required: true, location: "uri", location_name: "nodegroupName"))
     UpdateNodegroupVersionRequest.add_member(:version, Shapes::ShapeRef.new(shape: String, location_name: "version"))
     UpdateNodegroupVersionRequest.add_member(:release_version, Shapes::ShapeRef.new(shape: String, location_name: "releaseVersion"))
+    UpdateNodegroupVersionRequest.add_member(:launch_template, Shapes::ShapeRef.new(shape: LaunchTemplateSpecification, location_name: "launchTemplate"))
     UpdateNodegroupVersionRequest.add_member(:force, Shapes::ShapeRef.new(shape: Boolean, location_name: "force"))
     UpdateNodegroupVersionRequest.add_member(:client_request_token, Shapes::ShapeRef.new(shape: String, location_name: "clientRequestToken", metadata: {"idempotencyToken"=>true}))
     UpdateNodegroupVersionRequest.struct_class = Types::UpdateNodegroupVersionRequest

data/lib/aws-sdk-eks/types.rb

@@ -238,9 +238,9 @@ module Aws::EKS
     #
     # @!attribute [rw] role_arn
     #   The Amazon Resource Name (ARN) of the IAM role that provides
-    #   permissions for Amazon EKS to make calls to other AWS API operations
-    #   on your behalf. For more information, see [Amazon EKS Service IAM
-    #   Role][1] in the <i> <i>Amazon EKS User Guide</i> </i>.
+    #   permissions for the Kubernetes control plane to make calls to AWS
+    #   API operations on your behalf. For more information, see [Amazon EKS
+    #   Service IAM Role][1] in the <i> <i>Amazon EKS User Guide</i> </i>.
     #
     #
     #
@@ -439,7 +439,7 @@ module Aws::EKS
     #         disk_size: 1,
     #         subnets: ["String"], # required
     #         instance_types: ["String"],
-    #         ami_type: "AL2_x86_64", # accepts AL2_x86_64, AL2_x86_64_GPU
+    #         ami_type: "AL2_x86_64", # accepts AL2_x86_64, AL2_x86_64_GPU, AL2_ARM_64
     #         remote_access: {
     #           ec2_ssh_key: "String",
     #           source_security_groups: ["String"],
@@ -452,6 +452,11 @@ module Aws::EKS
     #           "TagKey" => "TagValue",
     #         },
     #         client_request_token: "String",
+    #         launch_template: {
+    #           name: "String",
+    #           version: "String",
+    #           id: "String",
+    #         },
     #         version: "String",
     #         release_version: "String",
     #       }
@@ -471,33 +476,73 @@ module Aws::EKS
     #
     # @!attribute [rw] disk_size
     #   The root device disk size (in GiB) for your node group instances.
-    #   The default disk size is 20 GiB.
+    #   The default disk size is 20 GiB. If you specify `launchTemplate`,
+    #   then don't specify `diskSize`, or the node group deployment will
+    #   fail. For more information about using launch templates with Amazon
+    #   EKS, see [Launch template support][1] in the Amazon EKS User Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/eks/latest/userguide/launch-templates.html
     #   @return [Integer]
     #
     # @!attribute [rw] subnets
     #   The subnets to use for the Auto Scaling group that is created for
     #   your node group. These subnets must have the tag key
     #   `kubernetes.io/cluster/CLUSTER_NAME` with a value of `shared`, where
-    #   `CLUSTER_NAME` is replaced with the name of your cluster.
+    #   `CLUSTER_NAME` is replaced with the name of your cluster. If you
+    #   specify `launchTemplate`, then don't specify [ `SubnetId` ][1] in
+    #   your launch template, or the node group deployment will fail. For
+    #   more information about using launch templates with Amazon EKS, see
+    #   [Launch template support][2] in the Amazon EKS User Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateNetworkInterface.html
+    #   [2]: https://docs.aws.amazon.com/eks/latest/userguide/launch-templates.html
     #   @return [Array<String>]
     #
     # @!attribute [rw] instance_types
-    #   The instance type to use for your node group. Currently, you can
-    #   specify a single instance type for a node group. The default value
-    #   for this parameter is `t3.medium`. If you choose a GPU instance
-    #   type, be sure to specify the `AL2_x86_64_GPU` with the `amiType`
-    #   parameter.
+    #   The instance type to use for your node group. You can specify a
+    #   single instance type for a node group. The default value for
+    #   `instanceTypes` is `t3.medium`. If you choose a GPU instance type,
+    #   be sure to specify `AL2_x86_64_GPU` with the `amiType` parameter. If
+    #   you specify `launchTemplate`, then don't specify `instanceTypes`,
+    #   or the node group deployment will fail. For more information about
+    #   using launch templates with Amazon EKS, see [Launch template
+    #   support][1] in the Amazon EKS User Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/eks/latest/userguide/launch-templates.html
     #   @return [Array<String>]
     #
     # @!attribute [rw] ami_type
     #   The AMI type for your node group. GPU instance types should use the
     #   `AL2_x86_64_GPU` AMI type, which uses the Amazon EKS-optimized Linux
     #   AMI with GPU support. Non-GPU instances should use the `AL2_x86_64`
-    #   AMI type, which uses the Amazon EKS-optimized Linux AMI.
+    #   AMI type, which uses the Amazon EKS-optimized Linux AMI. If you
+    #   specify `launchTemplate`, and your launch template uses a custom
+    #   AMI, then don't specify `amiType`, or the node group deployment
+    #   will fail. For more information about using launch templates with
+    #   Amazon EKS, see [Launch template support][1] in the Amazon EKS User
+    #   Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/eks/latest/userguide/launch-templates.html
     #   @return [String]
     #
     # @!attribute [rw] remote_access
     #   The remote access (SSH) configuration to use with your node group.
+    #   If you specify `launchTemplate`, then don't specify `remoteAccess`,
+    #   or the node group deployment will fail. For more information about
+    #   using launch templates with Amazon EKS, see [Launch template
+    #   support][1] in the Amazon EKS User Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/eks/latest/userguide/launch-templates.html
     #   @return [Types::RemoteAccessConfig]
     #
     # @!attribute [rw] node_role
@@ -508,11 +553,18 @@ module Aws::EKS
     #   policies. Before you can launch worker nodes and register them into
     #   a cluster, you must create an IAM role for those worker nodes to use
     #   when they are launched. For more information, see [Amazon EKS Worker
-    #   Node IAM Role][1] in the <i> <i>Amazon EKS User Guide</i> </i>.
+    #   Node IAM Role][1] in the <i> <i>Amazon EKS User Guide</i> </i>. If
+    #   you specify `launchTemplate`, then don't specify [
+    #   `IamInstanceProfile` ][2] in your launch template, or the node group
+    #   deployment will fail. For more information about using launch
+    #   templates with Amazon EKS, see [Launch template support][3] in the
+    #   Amazon EKS User Guide.
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/eks/latest/userguide/worker_node_IAM_role.html
+    #   [2]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_IamInstanceProfile.html
+    #   [3]: https://docs.aws.amazon.com/eks/latest/userguide/launch-templates.html
     #   @return [String]
     #
     # @!attribute [rw] labels
@@ -536,10 +588,26 @@ module Aws::EKS
     #   not need to pass this option.
     #   @return [String]
     #
+    # @!attribute [rw] launch_template
+    #   An object representing a node group's launch template
+    #   specification. If specified, then do not specify `instanceTypes`,
+    #   `diskSize`, or `remoteAccess`. If specified, make sure that the
+    #   launch template meets the requirements in
+    #   `launchTemplateSpecification`.
+    #   @return [Types::LaunchTemplateSpecification]
+    #
     # @!attribute [rw] version
     #   The Kubernetes version to use for your managed nodes. By default,
     #   the Kubernetes version of the cluster is used, and this is the only
-    #   accepted specified value.
+    #   accepted specified value. If you specify `launchTemplate`, and your
+    #   launch template uses a custom AMI, then don't specify `version`, or
+    #   the node group deployment will fail. For more information about
+    #   using launch templates with Amazon EKS, see [Launch template
+    #   support][1] in the Amazon EKS User Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/eks/latest/userguide/launch-templates.html
     #   @return [String]
     #
     # @!attribute [rw] release_version
@@ -547,11 +615,16 @@ module Aws::EKS
     #   node group. By default, the latest available AMI version for the
     #   node group's current Kubernetes version is used. For more
     #   information, see [Amazon EKS-Optimized Linux AMI Versions][1] in the
-    #   *Amazon EKS User Guide*.
+    #   *Amazon EKS User Guide*. If you specify `launchTemplate`, and your
+    #   launch template uses a custom AMI, then don't specify
+    #   `releaseVersion`, or the node group deployment will fail. For more
+    #   information about using launch templates with Amazon EKS, see
+    #   [Launch template support][2] in the Amazon EKS User Guide.
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/eks/latest/userguide/eks-linux-ami-versions.html
+    #   [2]: https://docs.aws.amazon.com/eks/latest/userguide/launch-templates.html
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/CreateNodegroupRequest AWS API Documentation
@@ -569,6 +642,7 @@ module Aws::EKS
       :labels,
       :tags,
       :client_request_token,
+      :launch_template,
       :version,
       :release_version)
       SENSITIVE = []
@@ -1117,6 +1191,14 @@ module Aws::EKS
     #     version that Amazon EKS created. You may be able to revert to the
     #     version that Amazon EKS created to recover.
     #
+    #   * **Ec2SubnetInvalidConfiguration**\: One or more Amazon EC2 subnets
+    #     specified for a node group do not automatically assign public IP
+    #     addresses to instances launched into it. If you want your
+    #     instances to be assigned a public IP address, then you need to
+    #     enable the `auto-assign public IP address` setting for the subnet.
+    #     See [Modifying the public IPv4 addressing attribute for your
+    #     subnet][1] in the Amazon VPC User Guide.
+    #
     #   * **IamInstanceProfileNotFound**\: We couldn't find the IAM
     #     instance profile for your managed node group. You may be able to
     #     recreate an instance profile with the same settings to recover.
@@ -1130,7 +1212,7 @@ module Aws::EKS
     #
     #   * **NodeCreationFailure**\: Your launched instances are unable to
     #     register with your Amazon EKS cluster. Common causes of this
-    #     failure are insufficient [worker node IAM role][1] permissions or
+    #     failure are insufficient [worker node IAM role][2] permissions or
     #     lack of outbound internet access for the nodes.
     #
     #   * **InstanceLimitExceeded**\: Your AWS account is unable to launch
@@ -1149,7 +1231,8 @@ module Aws::EKS
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/eks/latest/userguide/worker_node_IAM_role.html
+    #   [1]: https://docs.aws.amazon.com/vpc/latest/userguide/vpc-ip-addressing.html#subnet-public-ip
+    #   [2]: https://docs.aws.amazon.com/eks/latest/userguide/worker_node_IAM_role.html
     #   @return [String]
     #
     # @!attribute [rw] message
@@ -1170,6 +1253,60 @@ module Aws::EKS
       include Aws::Structure
     end
 
+    # An object representing a node group launch template specification. The
+    # launch template cannot include [ `SubnetId` ][1], [
+    # `IamInstanceProfile` ][2], [ `RequestSpotInstances` ][3], [
+    # `HibernationOptions` ][4], or [ `TerminateInstances` ][5], or the node
+    # group deployment or update will fail. For more information about
+    # launch templates, see [ `CreateLaunchTemplate` ][6] in the Amazon EC2
+    # API Reference. For more information about using launch templates with
+    # Amazon EKS, see [Launch template support][7] in the Amazon EKS User
+    # Guide.
+    #
+    # Specify either `name` or `id`, but not both.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateNetworkInterface.html
+    # [2]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_IamInstanceProfile.html
+    # [3]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RequestSpotInstances.html
+    # [4]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_HibernationOptionsRequest.html
+    # [5]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_TerminateInstances.html
+    # [6]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateLaunchTemplate.html
+    # [7]: https://docs.aws.amazon.com/eks/latest/userguide/launch-templates.html
+    #
+    # @note When making an API call, you may pass LaunchTemplateSpecification
+    #   data as a hash:
+    #
+    #       {
+    #         name: "String",
+    #         version: "String",
+    #         id: "String",
+    #       }
+    #
+    # @!attribute [rw] name
+    #   The name of the launch template.
+    #   @return [String]
+    #
+    # @!attribute [rw] version
+    #   The version of the launch template to use. If no version is
+    #   specified, then the template's default version is used.
+    #   @return [String]
+    #
+    # @!attribute [rw] id
+    #   The ID of the launch template.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/LaunchTemplateSpecification AWS API Documentation
+    #
+    class LaunchTemplateSpecification < Struct.new(
+      :name,
+      :version,
+      :id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass ListClustersRequest
     #   data as a hash:
     #
@@ -1541,13 +1678,11 @@ module Aws::EKS
     #   @return [String]
     #
     # @!attribute [rw] release_version
-    #   The AMI version of the managed node group. For more information, see
-    #   [Amazon EKS-Optimized Linux AMI Versions ][1] in the *Amazon EKS
-    #   User Guide*.
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/eks/latest/userguide/eks-linux-ami-versions.html
+    #   If the node group was deployed using a launch template with a custom
+    #   AMI, then this is the AMI ID that was specified in the launch
+    #   template. For node groups that weren't deployed using a launch
+    #   template, this is the version of the Amazon EKS-optimized AMI that
+    #   the node group was deployed with.
     #   @return [String]
     #
     # @!attribute [rw] created_at
@@ -1570,42 +1705,36 @@ module Aws::EKS
     #   @return [Types::NodegroupScalingConfig]
     #
     # @!attribute [rw] instance_types
-    #   The instance types associated with your node group.
+    #   If the node group wasn't deployed with a launch template, then this
+    #   is the instance type that is associated with the node group. If the
+    #   node group was deployed with a launch template, then `instanceTypes`
+    #   is `null`.
     #   @return [Array<String>]
     #
     # @!attribute [rw] subnets
-    #   The subnets allowed for the Auto Scaling group that is associated
-    #   with your node group. These subnets must have the following tag:
-    #   `kubernetes.io/cluster/CLUSTER_NAME`, where `CLUSTER_NAME` is
-    #   replaced with the name of your cluster.
+    #   The subnets that were specified for the Auto Scaling group that is
+    #   associated with your node group.
     #   @return [Array<String>]
     #
     # @!attribute [rw] remote_access
-    #   The remote access (SSH) configuration that is associated with the
-    #   node group.
+    #   If the node group wasn't deployed with a launch template, then this
+    #   is the remote access configuration that is associated with the node
+    #   group. If the node group was deployed with a launch template, then
+    #   `remoteAccess` is `null`.
     #   @return [Types::RemoteAccessConfig]
     #
     # @!attribute [rw] ami_type
-    #   The AMI type associated with your node group. GPU instance types
-    #   should use the `AL2_x86_64_GPU` AMI type, which uses the Amazon
-    #   EKS-optimized Linux AMI with GPU support. Non-GPU instances should
-    #   use the `AL2_x86_64` AMI type, which uses the Amazon EKS-optimized
-    #   Linux AMI.
+    #   If the node group was deployed using a launch template with a custom
+    #   AMI, then this is `CUSTOM`. For node groups that weren't deployed
+    #   using a launch template, this is the AMI type that was specified in
+    #   the node group configuration.
     #   @return [String]
     #
     # @!attribute [rw] node_role
     #   The IAM role associated with your node group. The Amazon EKS worker
     #   node `kubelet` daemon makes calls to AWS APIs on your behalf. Worker
     #   nodes receive permissions for these API calls through an IAM
-    #   instance profile and associated policies. Before you can launch
-    #   worker nodes and register them into a cluster, you must create an
-    #   IAM role for those worker nodes to use when they are launched. For
-    #   more information, see [Amazon EKS Worker Node IAM Role][1] in the
-    #   <i> <i>Amazon EKS User Guide</i> </i>.
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/eks/latest/userguide/worker_node_IAM_role.html
+    #   instance profile and associated policies.
     #   @return [String]
     #
     # @!attribute [rw] labels
@@ -1624,8 +1753,9 @@ module Aws::EKS
     #   @return [Types::NodegroupResources]
     #
     # @!attribute [rw] disk_size
-    #   The root device disk size (in GiB) for your node group instances.
-    #   The default disk size is 20 GiB.
+    #   If the node group wasn't deployed with a launch template, then this
+    #   is the disk size in the node group configuration. If the node group
+    #   was deployed with a launch template, then `diskSize` is `null`.
     #   @return [Integer]
     #
     # @!attribute [rw] health
@@ -1633,6 +1763,11 @@ module Aws::EKS
     #   node group's health, they are listed here.
     #   @return [Types::NodegroupHealth]
     #
+    # @!attribute [rw] launch_template
+    #   If a launch template was used to create the node group, then this is
+    #   the launch template that was used.
+    #   @return [Types::LaunchTemplateSpecification]
+    #
     # @!attribute [rw] tags
     #   The metadata applied to the node group to assist with categorization
     #   and organization. Each tag consists of a key and an optional value,
@@ -1662,6 +1797,7 @@ module Aws::EKS
       :resources,
       :disk_size,
       :health,
+      :launch_template,
       :tags)
       SENSITIVE = []
       include Aws::Structure
@@ -1703,7 +1839,9 @@ module Aws::EKS
     end
 
     # An object representing the scaling configuration details for the Auto
-    # Scaling group that is associated with your node group.
+    # Scaling group that is associated with your node group. If you specify
+    # a value for any property, then you must specify values for all of the
+    # properties.
     #
     # @note When making an API call, you may pass NodegroupScalingConfig
     #   data as a hash:
@@ -2336,6 +2474,11 @@ module Aws::EKS
     #         nodegroup_name: "String", # required
     #         version: "String",
     #         release_version: "String",
+    #         launch_template: {
+    #           name: "String",
+    #           version: "String",
+    #           id: "String",
+    #         },
     #         force: false,
     #         client_request_token: "String",
     #       }
@@ -2354,7 +2497,15 @@ module Aws::EKS
     #   then the Kubernetes version of the node group does not change. You
     #   can specify the Kubernetes version of the cluster to update the node
     #   group to the latest AMI version of the cluster's Kubernetes
-    #   version.
+    #   version. If you specify `launchTemplate`, and your launch template
+    #   uses a custom AMI, then don't specify `version`, or the node group
+    #   update will fail. For more information about using launch templates
+    #   with Amazon EKS, see [Launch template support][1] in the Amazon EKS
+    #   User Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/eks/latest/userguide/launch-templates.html
     #   @return [String]
     #
     # @!attribute [rw] release_version
@@ -2362,13 +2513,25 @@ module Aws::EKS
     #   update. By default, the latest available AMI version for the node
     #   group's Kubernetes version is used. For more information, see
     #   [Amazon EKS-Optimized Linux AMI Versions ][1] in the *Amazon EKS
-    #   User Guide*.
+    #   User Guide*. If you specify `launchTemplate`, and your launch
+    #   template uses a custom AMI, then don't specify `releaseVersion`, or
+    #   the node group update will fail. For more information about using
+    #   launch templates with Amazon EKS, see [Launch template support][2]
+    #   in the Amazon EKS User Guide.
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/eks/latest/userguide/eks-linux-ami-versions.html
+    #   [2]: https://docs.aws.amazon.com/eks/latest/userguide/launch-templates.html
     #   @return [String]
     #
+    # @!attribute [rw] launch_template
+    #   An object representing a node group's launch template
+    #   specification. You can only update a node group using a launch
+    #   template if the node group was originally deployed with a launch
+    #   template.
+    #   @return [Types::LaunchTemplateSpecification]
+    #
     # @!attribute [rw] force
     #   Force the update if the existing node group's pods are unable to be
     #   drained due to a pod disruption budget issue. If an update fails
@@ -2392,6 +2555,7 @@ module Aws::EKS
       :nodegroup_name,
       :version,
       :release_version,
+      :launch_template,
       :force,
       :client_request_token)
       SENSITIVE = []

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-eks
 version: !ruby/object:Gem::Version
-  version: 1.39.0
+  version: 1.40.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-06-23 00:00:00.000000000 Z
+date: 2020-08-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core