aws-sdk-eks 1.124.0 → 1.125.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 02ae06a9baee4cb37b6fc2400ac1dd214cac1ea48f96d56661df4b32ba0ae3c4
-  data.tar.gz: c54299ecf1988524ee260a3dbca86ef8fb31b0e934302a2eb042e02d608733dc
+  metadata.gz: 6d19db4e40a4e5b8204537c27d2ca12412b79594527d0ba650ba3a415a23ec3f
+  data.tar.gz: 6aab48422cb4626a9ae0aeff3fb9f68203ff8cd71118e82bfaa06a905a55e1fe
 SHA512:
-  metadata.gz: dd440a08b05d4cfb8a906e05ff73a879ef07d41e4da93623bf98f1e8ba058d3fbfbac76160aa52ffda24cbca72934d6f8c1bad560ccde41395ceb98cdaac498b
-  data.tar.gz: 73f1890dee53b8fb818946d2b7f6d95594c798d5a28920ad0421c616d5bbb5df336aff2b8e889b4472548f54e08fd9a1b6df0633fdac5b2d45d27e3ec5cc826b
+  metadata.gz: d8503e64fb520cc6ff7abdad381f870da6cefb4855b1495c37366ba854298a319d0d849d81fdf3749253c3e76de08b21fae06ab92f93c9e5adcf525a1a8b73a2
+  data.tar.gz: 47befc2c1bffdf1b7b788bf8fec04f01586479a4a89701cb54bdd959b069cf74a156e33002cc3b17b6c48bb966500fa90b6e222451a6171d01366190ba7f56ea

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.125.0 (2024-12-23)
+------------------
+
+* Feature - This release adds support for DescribeClusterVersions API that provides important information about Kubernetes versions along with end of support dates
+
 1.124.0 (2024-12-20)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.124.0
+1.125.0

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

@@ -2970,6 +2970,71 @@ module Aws::EKS
       req.send_request(options)
     end
 
+    # Lists available Kubernetes versions for Amazon EKS clusters.
+    #
+    # @option params [String] :cluster_type
+    #   The type of cluster to filter versions by.
+    #
+    # @option params [Integer] :max_results
+    #   Maximum number of results to return.
+    #
+    # @option params [String] :next_token
+    #   Pagination token for the next set of results.
+    #
+    # @option params [Boolean] :default_only
+    #   Filter to show only default versions.
+    #
+    # @option params [Boolean] :include_all
+    #   Include all available versions in the response.
+    #
+    # @option params [Array<String>] :cluster_versions
+    #   List of specific cluster versions to describe.
+    #
+    # @option params [String] :status
+    #   Filter versions by their current status.
+    #
+    # @return [Types::DescribeClusterVersionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeClusterVersionsResponse#next_token #next_token} => String
+    #   * {Types::DescribeClusterVersionsResponse#cluster_versions #cluster_versions} => Array&lt;Types::ClusterVersionInformation&gt;
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_cluster_versions({
+    #     cluster_type: "String",
+    #     max_results: 1,
+    #     next_token: "String",
+    #     default_only: false,
+    #     include_all: false,
+    #     cluster_versions: ["String"],
+    #     status: "unsupported", # accepts unsupported, standard-support, extended-support
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.next_token #=> String
+    #   resp.cluster_versions #=> Array
+    #   resp.cluster_versions[0].cluster_version #=> String
+    #   resp.cluster_versions[0].cluster_type #=> String
+    #   resp.cluster_versions[0].default_platform_version #=> String
+    #   resp.cluster_versions[0].default_version #=> Boolean
+    #   resp.cluster_versions[0].release_date #=> Time
+    #   resp.cluster_versions[0].end_of_standard_support_date #=> Time
+    #   resp.cluster_versions[0].end_of_extended_support_date #=> Time
+    #   resp.cluster_versions[0].status #=> String, one of "unsupported", "standard-support", "extended-support"
+    #   resp.cluster_versions[0].kubernetes_patch_version #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/DescribeClusterVersions AWS API Documentation
+    #
+    # @overload describe_cluster_versions(params = {})
+    # @param [Hash] params ({})
+    def describe_cluster_versions(params = {}, options = {})
+      req = build_request(:describe_cluster_versions, params)
+      req.send_request(options)
+    end
+
     # Returns descriptive information about a subscription.
     #
     # @option params [required, String] :id
@@ -5352,7 +5417,7 @@ module Aws::EKS
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-eks'
-      context[:gem_version] = '1.124.0'
+      context[:gem_version] = '1.125.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -70,6 +70,9 @@ module Aws::EKS
     ClusterIssueList = Shapes::ListShape.new(name: 'ClusterIssueList')
     ClusterName = Shapes::StringShape.new(name: 'ClusterName')
     ClusterStatus = Shapes::StringShape.new(name: 'ClusterStatus')
+    ClusterVersionInformation = Shapes::StructureShape.new(name: 'ClusterVersionInformation')
+    ClusterVersionList = Shapes::ListShape.new(name: 'ClusterVersionList')
+    ClusterVersionStatus = Shapes::StringShape.new(name: 'ClusterVersionStatus')
     Compatibilities = Shapes::ListShape.new(name: 'Compatibilities')
     Compatibility = Shapes::StructureShape.new(name: 'Compatibility')
     ComputeConfigRequest = Shapes::StructureShape.new(name: 'ComputeConfigRequest')
@@ -123,6 +126,9 @@ module Aws::EKS
     DescribeAddonVersionsResponse = Shapes::StructureShape.new(name: 'DescribeAddonVersionsResponse')
     DescribeClusterRequest = Shapes::StructureShape.new(name: 'DescribeClusterRequest')
     DescribeClusterResponse = Shapes::StructureShape.new(name: 'DescribeClusterResponse')
+    DescribeClusterVersionMaxResults = Shapes::IntegerShape.new(name: 'DescribeClusterVersionMaxResults')
+    DescribeClusterVersionsRequest = Shapes::StructureShape.new(name: 'DescribeClusterVersionsRequest')
+    DescribeClusterVersionsResponse = Shapes::StructureShape.new(name: 'DescribeClusterVersionsResponse')
     DescribeEksAnywhereSubscriptionRequest = Shapes::StructureShape.new(name: 'DescribeEksAnywhereSubscriptionRequest')
     DescribeEksAnywhereSubscriptionResponse = Shapes::StructureShape.new(name: 'DescribeEksAnywhereSubscriptionResponse')
     DescribeFargateProfileRequest = Shapes::StructureShape.new(name: 'DescribeFargateProfileRequest')
@@ -531,6 +537,19 @@ module Aws::EKS
 
     ClusterIssueList.member = Shapes::ShapeRef.new(shape: ClusterIssue)
 
+    ClusterVersionInformation.add_member(:cluster_version, Shapes::ShapeRef.new(shape: String, location_name: "clusterVersion"))
+    ClusterVersionInformation.add_member(:cluster_type, Shapes::ShapeRef.new(shape: String, location_name: "clusterType"))
+    ClusterVersionInformation.add_member(:default_platform_version, Shapes::ShapeRef.new(shape: String, location_name: "defaultPlatformVersion"))
+    ClusterVersionInformation.add_member(:default_version, Shapes::ShapeRef.new(shape: Boolean, location_name: "defaultVersion"))
+    ClusterVersionInformation.add_member(:release_date, Shapes::ShapeRef.new(shape: Timestamp, location_name: "releaseDate"))
+    ClusterVersionInformation.add_member(:end_of_standard_support_date, Shapes::ShapeRef.new(shape: Timestamp, location_name: "endOfStandardSupportDate"))
+    ClusterVersionInformation.add_member(:end_of_extended_support_date, Shapes::ShapeRef.new(shape: Timestamp, location_name: "endOfExtendedSupportDate"))
+    ClusterVersionInformation.add_member(:status, Shapes::ShapeRef.new(shape: ClusterVersionStatus, location_name: "status"))
+    ClusterVersionInformation.add_member(:kubernetes_patch_version, Shapes::ShapeRef.new(shape: String, location_name: "kubernetesPatchVersion"))
+    ClusterVersionInformation.struct_class = Types::ClusterVersionInformation
+
+    ClusterVersionList.member = Shapes::ShapeRef.new(shape: ClusterVersionInformation)
+
     Compatibilities.member = Shapes::ShapeRef.new(shape: Compatibility)
 
     Compatibility.add_member(:cluster_version, Shapes::ShapeRef.new(shape: String, location_name: "clusterVersion"))
@@ -781,6 +800,19 @@ module Aws::EKS
     DescribeClusterResponse.add_member(:cluster, Shapes::ShapeRef.new(shape: Cluster, location_name: "cluster"))
     DescribeClusterResponse.struct_class = Types::DescribeClusterResponse
 
+    DescribeClusterVersionsRequest.add_member(:cluster_type, Shapes::ShapeRef.new(shape: String, location: "querystring", location_name: "clusterType"))
+    DescribeClusterVersionsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: DescribeClusterVersionMaxResults, location: "querystring", location_name: "maxResults"))
+    DescribeClusterVersionsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location: "querystring", location_name: "nextToken"))
+    DescribeClusterVersionsRequest.add_member(:default_only, Shapes::ShapeRef.new(shape: BoxedBoolean, location: "querystring", location_name: "defaultOnly"))
+    DescribeClusterVersionsRequest.add_member(:include_all, Shapes::ShapeRef.new(shape: BoxedBoolean, location: "querystring", location_name: "includeAll"))
+    DescribeClusterVersionsRequest.add_member(:cluster_versions, Shapes::ShapeRef.new(shape: StringList, location: "querystring", location_name: "clusterVersions"))
+    DescribeClusterVersionsRequest.add_member(:status, Shapes::ShapeRef.new(shape: ClusterVersionStatus, location: "querystring", location_name: "status"))
+    DescribeClusterVersionsRequest.struct_class = Types::DescribeClusterVersionsRequest
+
+    DescribeClusterVersionsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "nextToken"))
+    DescribeClusterVersionsResponse.add_member(:cluster_versions, Shapes::ShapeRef.new(shape: ClusterVersionList, location_name: "clusterVersions"))
+    DescribeClusterVersionsResponse.struct_class = Types::DescribeClusterVersionsResponse
+
     DescribeEksAnywhereSubscriptionRequest.add_member(:id, Shapes::ShapeRef.new(shape: String, required: true, location: "uri", location_name: "id"))
     DescribeEksAnywhereSubscriptionRequest.struct_class = Types::DescribeEksAnywhereSubscriptionRequest
 
@@ -1838,6 +1870,23 @@ module Aws::EKS
         o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailableException)
       end)
 
+      api.add_operation(:describe_cluster_versions, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "DescribeClusterVersions"
+        o.http_method = "GET"
+        o.http_request_uri = "/cluster-versions"
+        o.input = Shapes::ShapeRef.new(shape: DescribeClusterVersionsRequest)
+        o.output = Shapes::ShapeRef.new(shape: DescribeClusterVersionsResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ServerException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
+      end)
+
       api.add_operation(:describe_eks_anywhere_subscription, Seahorse::Model::Operation.new.tap do |o|
         o.name = "DescribeEksAnywhereSubscription"
         o.http_method = "GET"

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

@@ -286,17 +286,14 @@ module Aws::EKS
       include Aws::Structure
     end
 
-    # The summary information about the Amazon EKS add-on compatibility for
-    # the next Kubernetes version for an insight check in the
-    # `UPGRADE_READINESS` category.
+    # Contains compatibility information for an Amazon EKS add-on.
     #
     # @!attribute [rw] name
     #   The name of the Amazon EKS add-on.
     #   @return [String]
     #
     # @!attribute [rw] compatible_versions
-    #   The list of compatible Amazon EKS add-on versions for the next
-    #   Kubernetes version.
+    #   A list of compatible add-on versions.
     #   @return [Array<String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/AddonCompatibilityDetail AWS API Documentation
@@ -1019,6 +1016,60 @@ module Aws::EKS
       include Aws::Structure
     end
 
+    # Contains details about a specific EKS cluster version.
+    #
+    # @!attribute [rw] cluster_version
+    #   The Kubernetes version for the cluster.
+    #   @return [String]
+    #
+    # @!attribute [rw] cluster_type
+    #   The type of cluster this version is for.
+    #   @return [String]
+    #
+    # @!attribute [rw] default_platform_version
+    #   Default platform version for this Kubernetes version.
+    #   @return [String]
+    #
+    # @!attribute [rw] default_version
+    #   Indicates if this is a default version.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] release_date
+    #   The release date of this cluster version.
+    #   @return [Time]
+    #
+    # @!attribute [rw] end_of_standard_support_date
+    #   Date when standard support ends for this version.
+    #   @return [Time]
+    #
+    # @!attribute [rw] end_of_extended_support_date
+    #   Date when extended support ends for this version.
+    #   @return [Time]
+    #
+    # @!attribute [rw] status
+    #   Current status of this cluster version.
+    #   @return [String]
+    #
+    # @!attribute [rw] kubernetes_patch_version
+    #   The patch version of Kubernetes for this cluster version.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/ClusterVersionInformation AWS API Documentation
+    #
+    class ClusterVersionInformation < Struct.new(
+      :cluster_version,
+      :cluster_type,
+      :default_platform_version,
+      :default_version,
+      :release_date,
+      :end_of_standard_support_date,
+      :end_of_extended_support_date,
+      :status,
+      :kubernetes_patch_version)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Compatibility information.
     #
     # @!attribute [rw] cluster_version
@@ -2692,6 +2743,65 @@ module Aws::EKS
       include Aws::Structure
     end
 
+    # @!attribute [rw] cluster_type
+    #   The type of cluster to filter versions by.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   Maximum number of results to return.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] next_token
+    #   Pagination token for the next set of results.
+    #   @return [String]
+    #
+    # @!attribute [rw] default_only
+    #   Filter to show only default versions.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] include_all
+    #   Include all available versions in the response.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] cluster_versions
+    #   List of specific cluster versions to describe.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] status
+    #   Filter versions by their current status.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/DescribeClusterVersionsRequest AWS API Documentation
+    #
+    class DescribeClusterVersionsRequest < Struct.new(
+      :cluster_type,
+      :max_results,
+      :next_token,
+      :default_only,
+      :include_all,
+      :cluster_versions,
+      :status)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] next_token
+    #   Pagination token for the next set of results.
+    #   @return [String]
+    #
+    # @!attribute [rw] cluster_versions
+    #   List of cluster version information objects.
+    #   @return [Array<Types::ClusterVersionInformation>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/DescribeClusterVersionsResponse AWS API Documentation
+    #
+    class DescribeClusterVersionsResponse < Struct.new(
+      :next_token,
+      :cluster_versions)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] id
     #   The ID of the subscription.
     #   @return [String]
@@ -3440,7 +3550,7 @@ module Aws::EKS
     #   @return [Array<Types::DeprecationDetail>]
     #
     # @!attribute [rw] addon_compatibility_details
-    #   A list of `AddonCompatibilityDetail` objects for Amazon EKS add-ons.
+    #   A list of AddonCompatibilityDetail objects for Amazon EKS add-ons.
     #   @return [Array<Types::AddonCompatibilityDetail>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/InsightCategorySpecificSummary AWS API Documentation

data/lib/aws-sdk-eks.rb

@@ -55,7 +55,7 @@ module Aws::EKS
   autoload :EndpointProvider, 'aws-sdk-eks/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-eks/endpoints'
 
-  GEM_VERSION = '1.124.0'
+  GEM_VERSION = '1.125.0'
 
 end
 

data/sig/client.rbs

@@ -511,6 +511,23 @@ module Aws
                             ) -> _DescribeClusterResponseSuccess
                           | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _DescribeClusterResponseSuccess
 
+      interface _DescribeClusterVersionsResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::DescribeClusterVersionsResponse]
+        def next_token: () -> ::String
+        def cluster_versions: () -> ::Array[Types::ClusterVersionInformation]
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/EKS/Client.html#describe_cluster_versions-instance_method
+      def describe_cluster_versions: (
+                                       ?cluster_type: ::String,
+                                       ?max_results: ::Integer,
+                                       ?next_token: ::String,
+                                       ?default_only: bool,
+                                       ?include_all: bool,
+                                       ?cluster_versions: Array[::String],
+                                       ?status: ("unsupported" | "standard-support" | "extended-support")
+                                     ) -> _DescribeClusterVersionsResponseSuccess
+                                   | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _DescribeClusterVersionsResponseSuccess
+
       interface _DescribeEksAnywhereSubscriptionResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::DescribeEksAnywhereSubscriptionResponse]
         def subscription: () -> Types::EksAnywhereSubscription

data/sig/types.rbs

@@ -240,6 +240,19 @@ module Aws::EKS
       SENSITIVE: []
     end
 
+    class ClusterVersionInformation
+      attr_accessor cluster_version: ::String
+      attr_accessor cluster_type: ::String
+      attr_accessor default_platform_version: ::String
+      attr_accessor default_version: bool
+      attr_accessor release_date: ::Time
+      attr_accessor end_of_standard_support_date: ::Time
+      attr_accessor end_of_extended_support_date: ::Time
+      attr_accessor status: ("unsupported" | "standard-support" | "extended-support")
+      attr_accessor kubernetes_patch_version: ::String
+      SENSITIVE: []
+    end
+
     class Compatibility
       attr_accessor cluster_version: ::String
       attr_accessor platform_versions: ::Array[::String]
@@ -583,6 +596,23 @@ module Aws::EKS
       SENSITIVE: []
     end
 
+    class DescribeClusterVersionsRequest
+      attr_accessor cluster_type: ::String
+      attr_accessor max_results: ::Integer
+      attr_accessor next_token: ::String
+      attr_accessor default_only: bool
+      attr_accessor include_all: bool
+      attr_accessor cluster_versions: ::Array[::String]
+      attr_accessor status: ("unsupported" | "standard-support" | "extended-support")
+      SENSITIVE: []
+    end
+
+    class DescribeClusterVersionsResponse
+      attr_accessor next_token: ::String
+      attr_accessor cluster_versions: ::Array[Types::ClusterVersionInformation]
+      SENSITIVE: []
+    end
+
     class DescribeEksAnywhereSubscriptionRequest
       attr_accessor id: ::String
       SENSITIVE: []

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-eks
 version: !ruby/object:Gem::Version
-  version: 1.124.0
+  version: 1.125.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-12-20 00:00:00.000000000 Z
+date: 2024-12-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core