aws-sdk-eks 1.96.0 → 1.97.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: de4faa279a6a81481d0934bd01345ed811ebde05498aa29a91223826fc668989
-  data.tar.gz: 65e82d970e8361f42e85a96e4d571073099696fdb3890c2afea6b679bc2e1e81
+  metadata.gz: 430fd0eae0a39ed5a9056e21941c29a22a661e3a8c2cc5519c47a71e9c683dcc
+  data.tar.gz: 5340c40a3e04ef849ce6734595e9e952df87f8b89885e8e7172fa41ed366c9f1
 SHA512:
-  metadata.gz: a7bb9e293c5e645c16efeb90ecbf5f20b5b3a5bc38439e346a1aa006e51a74792dea1afc94e2c70127cdcb344f6f36456c965a5439b847df2d29030fd6b72d1b
-  data.tar.gz: 1625a19ad5aeeb8af07da035de7fddde3c2161e5086fe27a0b0dbb31803eb4b84dfd77ffda7f85efb1116765767340d9bc551e59b7b260dd396dad4ec132e2b6
+  metadata.gz: f2ad2f7f59573513801649be547d92894a0322175a44b50ad782a8b412c817ccc9a77818840e4625969af5d4a226f17c10aef68df5b54b7dfa4d4619342d3e2f
+  data.tar.gz: 86441f9f3cd8afa73c3ed3b158bb38ec3387e4eef241e24549881010ec21cbc5aaca0b9da68a25881fefed3adee8273b7e0aba1627404994a4b0742dd9fe06dd

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.97.0 (2023-12-20)
+------------------
+
+* Feature - Add support for cluster insights, new EKS capability that surfaces potentially upgrade impacting issues.
+
 1.96.0 (2023-12-18)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.96.0
+1.97.0

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

@@ -629,12 +629,16 @@ module Aws::EKS
     #   than one access entry. This value can't be changed after access entry
     #   creation.
     #
-    #   [IAM best practices][1] recommend using IAM roles with temporary
-    #   credentials, rather than IAM users with long-term credentials.
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#bp-users-federation-idp
+    #   The valid principals differ depending on the type of the access entry
+    #   in the `type` field. The only valid ARN is IAM roles for the types of
+    #   access entries for nodes: ` . You can use every IAM principal type for
+    #   STANDARD access entries. You can't use the STS session principal type
+    #   with access entries because this is a temporary principal for each
+    #   session and not a permanent identity that can be assigned
+    #   permissions.</p>  IAM best practices recommend using IAM roles with
+    #   temporary credentials, rather than IAM users with long-term
+    #   credentials.
+    #   `
     #
     # @option params [Array<String>] :kubernetes_groups
     #   The value for `name` that you've specified for `kind: Group` as a
@@ -685,6 +689,9 @@ module Aws::EKS
     #   [1]: https://docs.aws.amazon.com/eks/latest/userguide/access-entries.html#creating-access-entries
     #
     # @option params [String] :type
+    #   The type of the new access entry. Valid values are `Standard`,
+    #   `FARGATE_LINUX`, `EC2_LINUX`, and `EC2_WINDOWS`.
+    #
     #   If the `principalArn` is for an IAM role that's used for self-managed
     #   Amazon EC2 nodes, specify `EC2_LINUX` or `EC2_WINDOWS`. Amazon EKS
     #   grants the necessary permissions to the node for you. If the
@@ -2835,6 +2842,63 @@ module Aws::EKS
       req.send_request(options)
     end
 
+    # Returns details about an insight that you specify using its ID.
+    #
+    # @option params [required, String] :cluster_name
+    #   The name of the cluster to describe the insight for.
+    #
+    # @option params [required, String] :id
+    #   The identity of the insight to describe.
+    #
+    # @return [Types::DescribeInsightResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeInsightResponse#insight #insight} => Types::Insight
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_insight({
+    #     cluster_name: "String", # required
+    #     id: "String", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.insight.id #=> String
+    #   resp.insight.name #=> String
+    #   resp.insight.category #=> String, one of "UPGRADE_READINESS"
+    #   resp.insight.kubernetes_version #=> String
+    #   resp.insight.last_refresh_time #=> Time
+    #   resp.insight.last_transition_time #=> Time
+    #   resp.insight.description #=> String
+    #   resp.insight.insight_status.status #=> String, one of "PASSING", "WARNING", "ERROR", "UNKNOWN"
+    #   resp.insight.insight_status.reason #=> String
+    #   resp.insight.recommendation #=> String
+    #   resp.insight.additional_info #=> Hash
+    #   resp.insight.additional_info["String"] #=> String
+    #   resp.insight.resources #=> Array
+    #   resp.insight.resources[0].insight_status.status #=> String, one of "PASSING", "WARNING", "ERROR", "UNKNOWN"
+    #   resp.insight.resources[0].insight_status.reason #=> String
+    #   resp.insight.resources[0].kubernetes_resource_uri #=> String
+    #   resp.insight.resources[0].arn #=> String
+    #   resp.insight.category_specific_summary.deprecation_details #=> Array
+    #   resp.insight.category_specific_summary.deprecation_details[0].usage #=> String
+    #   resp.insight.category_specific_summary.deprecation_details[0].replaced_with #=> String
+    #   resp.insight.category_specific_summary.deprecation_details[0].stop_serving_version #=> String
+    #   resp.insight.category_specific_summary.deprecation_details[0].start_serving_replacement_version #=> String
+    #   resp.insight.category_specific_summary.deprecation_details[0].client_stats #=> Array
+    #   resp.insight.category_specific_summary.deprecation_details[0].client_stats[0].user_agent #=> String
+    #   resp.insight.category_specific_summary.deprecation_details[0].client_stats[0].number_of_requests_last_30_days #=> Integer
+    #   resp.insight.category_specific_summary.deprecation_details[0].client_stats[0].last_request_time #=> Time
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/DescribeInsight AWS API Documentation
+    #
+    # @overload describe_insight(params = {})
+    # @param [Hash] params ({})
+    def describe_insight(params = {}, options = {})
+      req = build_request(:describe_insight, params)
+      req.send_request(options)
+    end
+
     # Describes a managed node group.
     #
     # @option params [required, String] :cluster_name
@@ -3623,6 +3687,78 @@ module Aws::EKS
       req.send_request(options)
     end
 
+    # Returns a list of all insights checked for against the specified
+    # cluster. You can filter which insights are returned by category,
+    # associated Kubernetes version, and status.
+    #
+    # @option params [required, String] :cluster_name
+    #   The name of the Amazon EKS cluster associated with the insights.
+    #
+    # @option params [Types::InsightsFilter] :filter
+    #   The criteria to filter your list of insights for your cluster. You can
+    #   filter which insights are returned by category, associated Kubernetes
+    #   version, and status.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of identity provider configurations returned by
+    #   `ListInsights` in paginated output. When you use this parameter,
+    #   `ListInsights` returns only `maxResults` results in a single page
+    #   along with a `nextToken` response element. You can see the remaining
+    #   results of the initial request by sending another `ListInsights`
+    #   request with the returned `nextToken` value. This value can be between
+    #   1 and 100. If you don't use this parameter, `ListInsights` returns up
+    #   to 100 results and a `nextToken` value, if applicable.
+    #
+    # @option params [String] :next_token
+    #   The `nextToken` value returned from a previous paginated
+    #   `ListInsights` request. When the results of a `ListInsights` request
+    #   exceed `maxResults`, you can use this value to retrieve the next page
+    #   of results. This value is `null` when there are no more results to
+    #   return.
+    #
+    # @return [Types::ListInsightsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListInsightsResponse#insights #insights} => Array&lt;Types::InsightSummary&gt;
+    #   * {Types::ListInsightsResponse#next_token #next_token} => String
+    #
+    # 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.list_insights({
+    #     cluster_name: "String", # required
+    #     filter: {
+    #       categories: ["UPGRADE_READINESS"], # accepts UPGRADE_READINESS
+    #       kubernetes_versions: ["String"],
+    #       statuses: ["PASSING"], # accepts PASSING, WARNING, ERROR, UNKNOWN
+    #     },
+    #     max_results: 1,
+    #     next_token: "String",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.insights #=> Array
+    #   resp.insights[0].id #=> String
+    #   resp.insights[0].name #=> String
+    #   resp.insights[0].category #=> String, one of "UPGRADE_READINESS"
+    #   resp.insights[0].kubernetes_version #=> String
+    #   resp.insights[0].last_refresh_time #=> Time
+    #   resp.insights[0].last_transition_time #=> Time
+    #   resp.insights[0].description #=> String
+    #   resp.insights[0].insight_status.status #=> String, one of "PASSING", "WARNING", "ERROR", "UNKNOWN"
+    #   resp.insights[0].insight_status.reason #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/ListInsights AWS API Documentation
+    #
+    # @overload list_insights(params = {})
+    # @param [Hash] params ({})
+    def list_insights(params = {}, options = {})
+      req = build_request(:list_insights, params)
+      req.send_request(options)
+    end
+
     # Lists the managed node groups associated with the specified cluster in
     # your Amazon Web Services account in the specified Amazon Web Services
     # Region. Self-managed node groups aren't listed.
@@ -4819,7 +4955,7 @@ module Aws::EKS
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-eks'
-      context[:gem_version] = '1.96.0'
+      context[:gem_version] = '1.97.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -21,6 +21,7 @@ module Aws::EKS
     AccessPolicy = Shapes::StructureShape.new(name: 'AccessPolicy')
     AccessScope = Shapes::StructureShape.new(name: 'AccessScope')
     AccessScopeType = Shapes::StringShape.new(name: 'AccessScopeType')
+    AdditionalInfoMap = Shapes::MapShape.new(name: 'AdditionalInfoMap')
     Addon = Shapes::StructureShape.new(name: 'Addon')
     AddonHealth = Shapes::StructureShape.new(name: 'AddonHealth')
     AddonInfo = Shapes::StructureShape.new(name: 'AddonInfo')
@@ -48,8 +49,12 @@ module Aws::EKS
     BoxedInteger = Shapes::IntegerShape.new(name: 'BoxedInteger')
     Capacity = Shapes::IntegerShape.new(name: 'Capacity')
     CapacityTypes = Shapes::StringShape.new(name: 'CapacityTypes')
+    Category = Shapes::StringShape.new(name: 'Category')
+    CategoryList = Shapes::ListShape.new(name: 'CategoryList')
     Certificate = Shapes::StructureShape.new(name: 'Certificate')
     ClientException = Shapes::StructureShape.new(name: 'ClientException')
+    ClientStat = Shapes::StructureShape.new(name: 'ClientStat')
+    ClientStats = Shapes::ListShape.new(name: 'ClientStats')
     Cluster = Shapes::StructureShape.new(name: 'Cluster')
     ClusterHealth = Shapes::StructureShape.new(name: 'ClusterHealth')
     ClusterIssue = Shapes::StructureShape.new(name: 'ClusterIssue')
@@ -93,6 +98,8 @@ module Aws::EKS
     DeleteNodegroupResponse = Shapes::StructureShape.new(name: 'DeleteNodegroupResponse')
     DeletePodIdentityAssociationRequest = Shapes::StructureShape.new(name: 'DeletePodIdentityAssociationRequest')
     DeletePodIdentityAssociationResponse = Shapes::StructureShape.new(name: 'DeletePodIdentityAssociationResponse')
+    DeprecationDetail = Shapes::StructureShape.new(name: 'DeprecationDetail')
+    DeprecationDetails = Shapes::ListShape.new(name: 'DeprecationDetails')
     DeregisterClusterRequest = Shapes::StructureShape.new(name: 'DeregisterClusterRequest')
     DeregisterClusterResponse = Shapes::StructureShape.new(name: 'DeregisterClusterResponse')
     DescribeAccessEntryRequest = Shapes::StructureShape.new(name: 'DescribeAccessEntryRequest')
@@ -112,6 +119,8 @@ module Aws::EKS
     DescribeFargateProfileResponse = Shapes::StructureShape.new(name: 'DescribeFargateProfileResponse')
     DescribeIdentityProviderConfigRequest = Shapes::StructureShape.new(name: 'DescribeIdentityProviderConfigRequest')
     DescribeIdentityProviderConfigResponse = Shapes::StructureShape.new(name: 'DescribeIdentityProviderConfigResponse')
+    DescribeInsightRequest = Shapes::StructureShape.new(name: 'DescribeInsightRequest')
+    DescribeInsightResponse = Shapes::StructureShape.new(name: 'DescribeInsightResponse')
     DescribeNodegroupRequest = Shapes::StructureShape.new(name: 'DescribeNodegroupRequest')
     DescribeNodegroupResponse = Shapes::StructureShape.new(name: 'DescribeNodegroupResponse')
     DescribePodIdentityAssociationRequest = Shapes::StructureShape.new(name: 'DescribePodIdentityAssociationRequest')
@@ -146,6 +155,16 @@ module Aws::EKS
     IdentityProviderConfigResponse = Shapes::StructureShape.new(name: 'IdentityProviderConfigResponse')
     IdentityProviderConfigs = Shapes::ListShape.new(name: 'IdentityProviderConfigs')
     IncludeClustersList = Shapes::ListShape.new(name: 'IncludeClustersList')
+    Insight = Shapes::StructureShape.new(name: 'Insight')
+    InsightCategorySpecificSummary = Shapes::StructureShape.new(name: 'InsightCategorySpecificSummary')
+    InsightResourceDetail = Shapes::StructureShape.new(name: 'InsightResourceDetail')
+    InsightResourceDetails = Shapes::ListShape.new(name: 'InsightResourceDetails')
+    InsightStatus = Shapes::StructureShape.new(name: 'InsightStatus')
+    InsightStatusValue = Shapes::StringShape.new(name: 'InsightStatusValue')
+    InsightStatusValueList = Shapes::ListShape.new(name: 'InsightStatusValueList')
+    InsightSummaries = Shapes::ListShape.new(name: 'InsightSummaries')
+    InsightSummary = Shapes::StructureShape.new(name: 'InsightSummary')
+    InsightsFilter = Shapes::StructureShape.new(name: 'InsightsFilter')
     Integer = Shapes::IntegerShape.new(name: 'Integer')
     InvalidParameterException = Shapes::StructureShape.new(name: 'InvalidParameterException')
     InvalidRequestException = Shapes::StructureShape.new(name: 'InvalidRequestException')
@@ -178,6 +197,9 @@ module Aws::EKS
     ListIdentityProviderConfigsRequest = Shapes::StructureShape.new(name: 'ListIdentityProviderConfigsRequest')
     ListIdentityProviderConfigsRequestMaxResults = Shapes::IntegerShape.new(name: 'ListIdentityProviderConfigsRequestMaxResults')
     ListIdentityProviderConfigsResponse = Shapes::StructureShape.new(name: 'ListIdentityProviderConfigsResponse')
+    ListInsightsMaxResults = Shapes::IntegerShape.new(name: 'ListInsightsMaxResults')
+    ListInsightsRequest = Shapes::StructureShape.new(name: 'ListInsightsRequest')
+    ListInsightsResponse = Shapes::StructureShape.new(name: 'ListInsightsResponse')
     ListNodegroupsRequest = Shapes::StructureShape.new(name: 'ListNodegroupsRequest')
     ListNodegroupsRequestMaxResults = Shapes::IntegerShape.new(name: 'ListNodegroupsRequestMaxResults')
     ListNodegroupsResponse = Shapes::StructureShape.new(name: 'ListNodegroupsResponse')
@@ -307,6 +329,9 @@ module Aws::EKS
     AccessScope.add_member(:namespaces, Shapes::ShapeRef.new(shape: StringList, location_name: "namespaces"))
     AccessScope.struct_class = Types::AccessScope
 
+    AdditionalInfoMap.key = Shapes::ShapeRef.new(shape: String)
+    AdditionalInfoMap.value = Shapes::ShapeRef.new(shape: String)
+
     Addon.add_member(:addon_name, Shapes::ShapeRef.new(shape: String, location_name: "addonName"))
     Addon.add_member(:cluster_name, Shapes::ShapeRef.new(shape: ClusterName, location_name: "clusterName"))
     Addon.add_member(:status, Shapes::ShapeRef.new(shape: AddonStatus, location_name: "status"))
@@ -396,6 +421,8 @@ module Aws::EKS
     BadRequestException.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "message"))
     BadRequestException.struct_class = Types::BadRequestException
 
+    CategoryList.member = Shapes::ShapeRef.new(shape: Category)
+
     Certificate.add_member(:data, Shapes::ShapeRef.new(shape: String, location_name: "data"))
     Certificate.struct_class = Types::Certificate
 
@@ -406,6 +433,13 @@ module Aws::EKS
     ClientException.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "message"))
     ClientException.struct_class = Types::ClientException
 
+    ClientStat.add_member(:user_agent, Shapes::ShapeRef.new(shape: String, location_name: "userAgent"))
+    ClientStat.add_member(:number_of_requests_last_30_days, Shapes::ShapeRef.new(shape: Integer, location_name: "numberOfRequestsLast30Days"))
+    ClientStat.add_member(:last_request_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "lastRequestTime"))
+    ClientStat.struct_class = Types::ClientStat
+
+    ClientStats.member = Shapes::ShapeRef.new(shape: ClientStat)
+
     Cluster.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "name"))
     Cluster.add_member(:arn, Shapes::ShapeRef.new(shape: String, location_name: "arn"))
     Cluster.add_member(:created_at, Shapes::ShapeRef.new(shape: Timestamp, location_name: "createdAt"))
@@ -613,6 +647,15 @@ module Aws::EKS
     DeletePodIdentityAssociationResponse.add_member(:association, Shapes::ShapeRef.new(shape: PodIdentityAssociation, location_name: "association"))
     DeletePodIdentityAssociationResponse.struct_class = Types::DeletePodIdentityAssociationResponse
 
+    DeprecationDetail.add_member(:usage, Shapes::ShapeRef.new(shape: String, location_name: "usage"))
+    DeprecationDetail.add_member(:replaced_with, Shapes::ShapeRef.new(shape: String, location_name: "replacedWith"))
+    DeprecationDetail.add_member(:stop_serving_version, Shapes::ShapeRef.new(shape: String, location_name: "stopServingVersion"))
+    DeprecationDetail.add_member(:start_serving_replacement_version, Shapes::ShapeRef.new(shape: String, location_name: "startServingReplacementVersion"))
+    DeprecationDetail.add_member(:client_stats, Shapes::ShapeRef.new(shape: ClientStats, location_name: "clientStats"))
+    DeprecationDetail.struct_class = Types::DeprecationDetail
+
+    DeprecationDetails.member = Shapes::ShapeRef.new(shape: DeprecationDetail)
+
     DeregisterClusterRequest.add_member(:name, Shapes::ShapeRef.new(shape: String, required: true, location: "uri", location_name: "name"))
     DeregisterClusterRequest.struct_class = Types::DeregisterClusterRequest
 
@@ -681,6 +724,13 @@ module Aws::EKS
     DescribeIdentityProviderConfigResponse.add_member(:identity_provider_config, Shapes::ShapeRef.new(shape: IdentityProviderConfigResponse, location_name: "identityProviderConfig"))
     DescribeIdentityProviderConfigResponse.struct_class = Types::DescribeIdentityProviderConfigResponse
 
+    DescribeInsightRequest.add_member(:cluster_name, Shapes::ShapeRef.new(shape: String, required: true, location: "uri", location_name: "name"))
+    DescribeInsightRequest.add_member(:id, Shapes::ShapeRef.new(shape: String, required: true, location: "uri", location_name: "id"))
+    DescribeInsightRequest.struct_class = Types::DescribeInsightRequest
+
+    DescribeInsightResponse.add_member(:insight, Shapes::ShapeRef.new(shape: Insight, location_name: "insight"))
+    DescribeInsightResponse.struct_class = Types::DescribeInsightResponse
+
     DescribeNodegroupRequest.add_member(:cluster_name, Shapes::ShapeRef.new(shape: String, required: true, location: "uri", location_name: "name"))
     DescribeNodegroupRequest.add_member(:nodegroup_name, Shapes::ShapeRef.new(shape: String, required: true, location: "uri", location_name: "nodegroupName"))
     DescribeNodegroupRequest.struct_class = Types::DescribeNodegroupRequest
@@ -788,6 +838,53 @@ module Aws::EKS
 
     IncludeClustersList.member = Shapes::ShapeRef.new(shape: String)
 
+    Insight.add_member(:id, Shapes::ShapeRef.new(shape: String, location_name: "id"))
+    Insight.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "name"))
+    Insight.add_member(:category, Shapes::ShapeRef.new(shape: Category, location_name: "category"))
+    Insight.add_member(:kubernetes_version, Shapes::ShapeRef.new(shape: String, location_name: "kubernetesVersion"))
+    Insight.add_member(:last_refresh_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "lastRefreshTime"))
+    Insight.add_member(:last_transition_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "lastTransitionTime"))
+    Insight.add_member(:description, Shapes::ShapeRef.new(shape: String, location_name: "description"))
+    Insight.add_member(:insight_status, Shapes::ShapeRef.new(shape: InsightStatus, location_name: "insightStatus"))
+    Insight.add_member(:recommendation, Shapes::ShapeRef.new(shape: String, location_name: "recommendation"))
+    Insight.add_member(:additional_info, Shapes::ShapeRef.new(shape: AdditionalInfoMap, location_name: "additionalInfo"))
+    Insight.add_member(:resources, Shapes::ShapeRef.new(shape: InsightResourceDetails, location_name: "resources"))
+    Insight.add_member(:category_specific_summary, Shapes::ShapeRef.new(shape: InsightCategorySpecificSummary, location_name: "categorySpecificSummary"))
+    Insight.struct_class = Types::Insight
+
+    InsightCategorySpecificSummary.add_member(:deprecation_details, Shapes::ShapeRef.new(shape: DeprecationDetails, location_name: "deprecationDetails"))
+    InsightCategorySpecificSummary.struct_class = Types::InsightCategorySpecificSummary
+
+    InsightResourceDetail.add_member(:insight_status, Shapes::ShapeRef.new(shape: InsightStatus, location_name: "insightStatus"))
+    InsightResourceDetail.add_member(:kubernetes_resource_uri, Shapes::ShapeRef.new(shape: String, location_name: "kubernetesResourceUri"))
+    InsightResourceDetail.add_member(:arn, Shapes::ShapeRef.new(shape: String, location_name: "arn"))
+    InsightResourceDetail.struct_class = Types::InsightResourceDetail
+
+    InsightResourceDetails.member = Shapes::ShapeRef.new(shape: InsightResourceDetail)
+
+    InsightStatus.add_member(:status, Shapes::ShapeRef.new(shape: InsightStatusValue, location_name: "status"))
+    InsightStatus.add_member(:reason, Shapes::ShapeRef.new(shape: String, location_name: "reason"))
+    InsightStatus.struct_class = Types::InsightStatus
+
+    InsightStatusValueList.member = Shapes::ShapeRef.new(shape: InsightStatusValue)
+
+    InsightSummaries.member = Shapes::ShapeRef.new(shape: InsightSummary)
+
+    InsightSummary.add_member(:id, Shapes::ShapeRef.new(shape: String, location_name: "id"))
+    InsightSummary.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "name"))
+    InsightSummary.add_member(:category, Shapes::ShapeRef.new(shape: Category, location_name: "category"))
+    InsightSummary.add_member(:kubernetes_version, Shapes::ShapeRef.new(shape: String, location_name: "kubernetesVersion"))
+    InsightSummary.add_member(:last_refresh_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "lastRefreshTime"))
+    InsightSummary.add_member(:last_transition_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "lastTransitionTime"))
+    InsightSummary.add_member(:description, Shapes::ShapeRef.new(shape: String, location_name: "description"))
+    InsightSummary.add_member(:insight_status, Shapes::ShapeRef.new(shape: InsightStatus, location_name: "insightStatus"))
+    InsightSummary.struct_class = Types::InsightSummary
+
+    InsightsFilter.add_member(:categories, Shapes::ShapeRef.new(shape: CategoryList, location_name: "categories"))
+    InsightsFilter.add_member(:kubernetes_versions, Shapes::ShapeRef.new(shape: StringList, location_name: "kubernetesVersions"))
+    InsightsFilter.add_member(:statuses, Shapes::ShapeRef.new(shape: InsightStatusValueList, location_name: "statuses"))
+    InsightsFilter.struct_class = Types::InsightsFilter
+
     InvalidParameterException.add_member(:cluster_name, Shapes::ShapeRef.new(shape: String, location_name: "clusterName"))
     InvalidParameterException.add_member(:nodegroup_name, Shapes::ShapeRef.new(shape: String, location_name: "nodegroupName"))
     InvalidParameterException.add_member(:fargate_profile_name, Shapes::ShapeRef.new(shape: String, location_name: "fargateProfileName"))
@@ -899,6 +996,16 @@ module Aws::EKS
     ListIdentityProviderConfigsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "nextToken"))
     ListIdentityProviderConfigsResponse.struct_class = Types::ListIdentityProviderConfigsResponse
 
+    ListInsightsRequest.add_member(:cluster_name, Shapes::ShapeRef.new(shape: String, required: true, location: "uri", location_name: "name"))
+    ListInsightsRequest.add_member(:filter, Shapes::ShapeRef.new(shape: InsightsFilter, location_name: "filter"))
+    ListInsightsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: ListInsightsMaxResults, location_name: "maxResults"))
+    ListInsightsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "nextToken"))
+    ListInsightsRequest.struct_class = Types::ListInsightsRequest
+
+    ListInsightsResponse.add_member(:insights, Shapes::ShapeRef.new(shape: InsightSummaries, location_name: "insights"))
+    ListInsightsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "nextToken"))
+    ListInsightsResponse.struct_class = Types::ListInsightsResponse
+
     ListNodegroupsRequest.add_member(:cluster_name, Shapes::ShapeRef.new(shape: String, required: true, location: "uri", location_name: "name"))
     ListNodegroupsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: ListNodegroupsRequestMaxResults, location: "querystring", location_name: "maxResults"))
     ListNodegroupsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location: "querystring", location_name: "nextToken"))
@@ -1623,6 +1730,18 @@ module Aws::EKS
         o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailableException)
       end)
 
+      api.add_operation(:describe_insight, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "DescribeInsight"
+        o.http_method = "GET"
+        o.http_request_uri = "/clusters/{name}/insights/{id}"
+        o.input = Shapes::ShapeRef.new(shape: DescribeInsightRequest)
+        o.output = Shapes::ShapeRef.new(shape: DescribeInsightResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ServerException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+      end)
+
       api.add_operation(:describe_nodegroup, Seahorse::Model::Operation.new.tap do |o|
         o.name = "DescribeNodegroup"
         o.http_method = "GET"
@@ -1827,6 +1946,24 @@ module Aws::EKS
         )
       end)
 
+      api.add_operation(:list_insights, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ListInsights"
+        o.http_method = "POST"
+        o.http_request_uri = "/clusters/{name}/insights"
+        o.input = Shapes::ShapeRef.new(shape: ListInsightsRequest)
+        o.output = Shapes::ShapeRef.new(shape: ListInsightsResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ServerException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
+      end)
+
       api.add_operation(:list_nodegroups, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ListNodegroups"
         o.http_method = "GET"

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

@@ -376,6 +376,20 @@ module Aws::EKS
       end
     end
 
+    class DescribeInsight
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::EKS::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
     class DescribeNodegroup
       def self.build(context)
         unless context.config.regional_endpoint
@@ -558,6 +572,20 @@ module Aws::EKS
       end
     end
 
+    class ListInsights
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::EKS::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
     class ListNodegroups
       def self.build(context)
         unless context.config.regional_endpoint

data/lib/aws-sdk-eks/plugins/endpoints.rb

@@ -109,6 +109,8 @@ module Aws::EKS
             Aws::EKS::Endpoints::DescribeFargateProfile.build(context)
           when :describe_identity_provider_config
             Aws::EKS::Endpoints::DescribeIdentityProviderConfig.build(context)
+          when :describe_insight
+            Aws::EKS::Endpoints::DescribeInsight.build(context)
           when :describe_nodegroup
             Aws::EKS::Endpoints::DescribeNodegroup.build(context)
           when :describe_pod_identity_association
@@ -135,6 +137,8 @@ module Aws::EKS
             Aws::EKS::Endpoints::ListFargateProfiles.build(context)
           when :list_identity_provider_configs
             Aws::EKS::Endpoints::ListIdentityProviderConfigs.build(context)
+          when :list_insights
+            Aws::EKS::Endpoints::ListInsights.build(context)
           when :list_nodegroups
             Aws::EKS::Endpoints::ListNodegroups.build(context)
           when :list_pod_identity_associations

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

@@ -652,6 +652,32 @@ module Aws::EKS
       include Aws::Structure
     end
 
+    # Details about clients using the deprecated resources.
+    #
+    # @!attribute [rw] user_agent
+    #   The user agent of the Kubernetes client using the deprecated
+    #   resource.
+    #   @return [String]
+    #
+    # @!attribute [rw] number_of_requests_last_30_days
+    #   The number of requests from the Kubernetes client seen over the last
+    #   30 days.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] last_request_time
+    #   The timestamp of the last request seen from the Kubernetes client.
+    #   @return [Time]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/ClientStat AWS API Documentation
+    #
+    class ClientStat < Struct.new(
+      :user_agent,
+      :number_of_requests_last_30_days,
+      :last_request_time)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # An object representing an Amazon EKS cluster.
     #
     # @!attribute [rw] name
@@ -999,12 +1025,16 @@ module Aws::EKS
     #   more than one access entry. This value can't be changed after
     #   access entry creation.
     #
-    #   [IAM best practices][1] recommend using IAM roles with temporary
-    #   credentials, rather than IAM users with long-term credentials.
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#bp-users-federation-idp
+    #   The valid principals differ depending on the type of the access
+    #   entry in the `type` field. The only valid ARN is IAM roles for the
+    #   types of access entries for nodes: ` . You can use every IAM
+    #   principal type for STANDARD access entries. You can't use the STS
+    #   session principal type with access entries because this is a
+    #   temporary principal for each session and not a permanent identity
+    #   that can be assigned permissions.</p>  IAM best practices recommend
+    #   using IAM roles with temporary credentials, rather than IAM users
+    #   with long-term credentials.
+    #   `
     #   @return [String]
     #
     # @!attribute [rw] kubernetes_groups
@@ -1062,6 +1092,9 @@ module Aws::EKS
     #   @return [String]
     #
     # @!attribute [rw] type
+    #   The type of the new access entry. Valid values are `Standard`,
+    #   `FARGATE_LINUX`, `EC2_LINUX`, and `EC2_WINDOWS`.
+    #
     #   If the `principalArn` is for an IAM role that's used for
     #   self-managed Amazon EC2 nodes, specify `EC2_LINUX` or `EC2_WINDOWS`.
     #   Amazon EKS grants the necessary permissions to the node for you. If
@@ -2035,6 +2068,43 @@ module Aws::EKS
       include Aws::Structure
     end
 
+    # The summary information about deprecated resource usage for an insight
+    # check in the `UPGRADE_READINESS` category.
+    #
+    # @!attribute [rw] usage
+    #   The deprecated version of the resource.
+    #   @return [String]
+    #
+    # @!attribute [rw] replaced_with
+    #   The newer version of the resource to migrate to if applicable.
+    #   @return [String]
+    #
+    # @!attribute [rw] stop_serving_version
+    #   The version of the software where the deprecated resource version
+    #   will stop being served.
+    #   @return [String]
+    #
+    # @!attribute [rw] start_serving_replacement_version
+    #   The version of the software where the newer resource version became
+    #   available to migrate to if applicable.
+    #   @return [String]
+    #
+    # @!attribute [rw] client_stats
+    #   Details about Kubernetes clients using the deprecated resources.
+    #   @return [Array<Types::ClientStat>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/DeprecationDetail AWS API Documentation
+    #
+    class DeprecationDetail < Struct.new(
+      :usage,
+      :replaced_with,
+      :stop_serving_version,
+      :start_serving_replacement_version,
+      :client_stats)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] name
     #   The name of the connected cluster to deregister.
     #   @return [String]
@@ -2379,6 +2449,35 @@ module Aws::EKS
       include Aws::Structure
     end
 
+    # @!attribute [rw] cluster_name
+    #   The name of the cluster to describe the insight for.
+    #   @return [String]
+    #
+    # @!attribute [rw] id
+    #   The identity of the insight to describe.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/DescribeInsightRequest AWS API Documentation
+    #
+    class DescribeInsightRequest < Struct.new(
+      :cluster_name,
+      :id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] insight
+    #   The full description of the insight.
+    #   @return [Types::Insight]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/DescribeInsightResponse AWS API Documentation
+    #
+    class DescribeInsightResponse < Struct.new(
+      :insight)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] cluster_name
     #   The name of your cluster.
     #   @return [String]
@@ -2862,6 +2961,222 @@ module Aws::EKS
       include Aws::Structure
     end
 
+    # A check that provides recommendations to remedy potential
+    # upgrade-impacting issues.
+    #
+    # @!attribute [rw] id
+    #   The ID of the insight.
+    #   @return [String]
+    #
+    # @!attribute [rw] name
+    #   The name of the insight.
+    #   @return [String]
+    #
+    # @!attribute [rw] category
+    #   The category of the insight.
+    #   @return [String]
+    #
+    # @!attribute [rw] kubernetes_version
+    #   The Kubernetes minor version associated with an insight if
+    #   applicable.
+    #   @return [String]
+    #
+    # @!attribute [rw] last_refresh_time
+    #   The time Amazon EKS last successfully completed a refresh of this
+    #   insight check on the cluster.
+    #   @return [Time]
+    #
+    # @!attribute [rw] last_transition_time
+    #   The time the status of the insight last changed.
+    #   @return [Time]
+    #
+    # @!attribute [rw] description
+    #   The description of the insight which includes alert criteria,
+    #   remediation recommendation, and additional resources (contains
+    #   Markdown).
+    #   @return [String]
+    #
+    # @!attribute [rw] insight_status
+    #   An object containing more detail on the status of the insight
+    #   resource.
+    #   @return [Types::InsightStatus]
+    #
+    # @!attribute [rw] recommendation
+    #   A summary of how to remediate the finding of this insight if
+    #   applicable.
+    #   @return [String]
+    #
+    # @!attribute [rw] additional_info
+    #   Links to sources that provide additional context on the insight.
+    #   @return [Hash<String,String>]
+    #
+    # @!attribute [rw] resources
+    #   The details about each resource listed in the insight check result.
+    #   @return [Array<Types::InsightResourceDetail>]
+    #
+    # @!attribute [rw] category_specific_summary
+    #   Summary information that relates to the category of the insight.
+    #   Currently only returned with certain insights having category
+    #   `UPGRADE_READINESS`.
+    #   @return [Types::InsightCategorySpecificSummary]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/Insight AWS API Documentation
+    #
+    class Insight < Struct.new(
+      :id,
+      :name,
+      :category,
+      :kubernetes_version,
+      :last_refresh_time,
+      :last_transition_time,
+      :description,
+      :insight_status,
+      :recommendation,
+      :additional_info,
+      :resources,
+      :category_specific_summary)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Summary information that relates to the category of the insight.
+    # Currently only returned with certain insights having category
+    # `UPGRADE_READINESS`.
+    #
+    # @!attribute [rw] deprecation_details
+    #   The summary information about deprecated resource usage for an
+    #   insight check in the `UPGRADE_READINESS` category.
+    #   @return [Array<Types::DeprecationDetail>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/InsightCategorySpecificSummary AWS API Documentation
+    #
+    class InsightCategorySpecificSummary < Struct.new(
+      :deprecation_details)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Returns information about the resource being evaluated.
+    #
+    # @!attribute [rw] insight_status
+    #   An object containing more detail on the status of the insight
+    #   resource.
+    #   @return [Types::InsightStatus]
+    #
+    # @!attribute [rw] kubernetes_resource_uri
+    #   The Kubernetes resource URI if applicable.
+    #   @return [String]
+    #
+    # @!attribute [rw] arn
+    #   The Amazon Resource Name (ARN) if applicable.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/InsightResourceDetail AWS API Documentation
+    #
+    class InsightResourceDetail < Struct.new(
+      :insight_status,
+      :kubernetes_resource_uri,
+      :arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The status of the insight.
+    #
+    # @!attribute [rw] status
+    #   The status of the resource.
+    #   @return [String]
+    #
+    # @!attribute [rw] reason
+    #   Explanation on the reasoning for the status of the resource.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/InsightStatus AWS API Documentation
+    #
+    class InsightStatus < Struct.new(
+      :status,
+      :reason)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The summarized description of the insight.
+    #
+    # @!attribute [rw] id
+    #   The ID of the insight.
+    #   @return [String]
+    #
+    # @!attribute [rw] name
+    #   The name of the insight.
+    #   @return [String]
+    #
+    # @!attribute [rw] category
+    #   The category of the insight.
+    #   @return [String]
+    #
+    # @!attribute [rw] kubernetes_version
+    #   The Kubernetes minor version associated with an insight if
+    #   applicable.
+    #   @return [String]
+    #
+    # @!attribute [rw] last_refresh_time
+    #   The time Amazon EKS last successfully completed a refresh of this
+    #   insight check on the cluster.
+    #   @return [Time]
+    #
+    # @!attribute [rw] last_transition_time
+    #   The time the status of the insight last changed.
+    #   @return [Time]
+    #
+    # @!attribute [rw] description
+    #   The description of the insight which includes alert criteria,
+    #   remediation recommendation, and additional resources (contains
+    #   Markdown).
+    #   @return [String]
+    #
+    # @!attribute [rw] insight_status
+    #   An object containing more detail on the status of the insight.
+    #   @return [Types::InsightStatus]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/InsightSummary AWS API Documentation
+    #
+    class InsightSummary < Struct.new(
+      :id,
+      :name,
+      :category,
+      :kubernetes_version,
+      :last_refresh_time,
+      :last_transition_time,
+      :description,
+      :insight_status)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The criteria to use for the insights.
+    #
+    # @!attribute [rw] categories
+    #   The categories to use to filter insights.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] kubernetes_versions
+    #   The Kubernetes versions to use to filter the insights.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] statuses
+    #   The statuses to use to filter the insights.
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/InsightsFilter AWS API Documentation
+    #
+    class InsightsFilter < Struct.new(
+      :categories,
+      :kubernetes_versions,
+      :statuses)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The specified parameter is invalid. Review the available parameters
     # for the API request.
     #
@@ -3710,6 +4025,12 @@ module Aws::EKS
     #   `ListIdentityProviderConfigsResponse` request exceed `maxResults`,
     #   you can use this value to retrieve the next page of results. This
     #   value is `null` when there are no more results to return.
+    #
+    #   <note markdown="1"> This token should be treated as an opaque identifier that is used
+    #   only to retrieve the next items in a list and not for other
+    #   programmatic purposes.
+    #
+    #    </note>
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/ListIdentityProviderConfigsResponse AWS API Documentation
@@ -3721,6 +4042,66 @@ module Aws::EKS
       include Aws::Structure
     end
 
+    # @!attribute [rw] cluster_name
+    #   The name of the Amazon EKS cluster associated with the insights.
+    #   @return [String]
+    #
+    # @!attribute [rw] filter
+    #   The criteria to filter your list of insights for your cluster. You
+    #   can filter which insights are returned by category, associated
+    #   Kubernetes version, and status.
+    #   @return [Types::InsightsFilter]
+    #
+    # @!attribute [rw] max_results
+    #   The maximum number of identity provider configurations returned by
+    #   `ListInsights` in paginated output. When you use this parameter,
+    #   `ListInsights` returns only `maxResults` results in a single page
+    #   along with a `nextToken` response element. You can see the remaining
+    #   results of the initial request by sending another `ListInsights`
+    #   request with the returned `nextToken` value. This value can be
+    #   between 1 and 100. If you don't use this parameter, `ListInsights`
+    #   returns up to 100 results and a `nextToken` value, if applicable.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] next_token
+    #   The `nextToken` value returned from a previous paginated
+    #   `ListInsights` request. When the results of a `ListInsights` request
+    #   exceed `maxResults`, you can use this value to retrieve the next
+    #   page of results. This value is `null` when there are no more results
+    #   to return.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/ListInsightsRequest AWS API Documentation
+    #
+    class ListInsightsRequest < Struct.new(
+      :cluster_name,
+      :filter,
+      :max_results,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] insights
+    #   The returned list of insights.
+    #   @return [Array<Types::InsightSummary>]
+    #
+    # @!attribute [rw] next_token
+    #   The `nextToken` value to include in a future `ListInsights` request.
+    #   When the results of a `ListInsights` request exceed `maxResults`,
+    #   you can use this value to retrieve the next page of results. This
+    #   value is `null` when there are no more results to return.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/ListInsightsResponse AWS API Documentation
+    #
+    class ListInsightsResponse < Struct.new(
+      :insights,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] cluster_name
     #   The name of your cluster.
     #   @return [String]

data/lib/aws-sdk-eks.rb

@@ -53,6 +53,6 @@ require_relative 'aws-sdk-eks/customizations'
 # @!group service
 module Aws::EKS
 
-  GEM_VERSION = '1.96.0'
+  GEM_VERSION = '1.97.0'
 
 end

metadata

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