This release adds support for DescribeClusterVersions API that provides important information about Kubernetes versions along with end of support dates

Author: aws-sdk-dotnet-automation

generator/ServiceModels/eks/eks-2017-11-01.api.json

@@ -382,6 +382,20 @@
         {"shape":"ServiceUnavailableException"}
       ]
     },
+    "DescribeClusterVersions":{
+      "name":"DescribeClusterVersions",
+      "http":{
+        "method":"GET",
+        "requestUri":"/cluster-versions"
+      },
+      "input":{"shape":"DescribeClusterVersionsRequest"},
+      "output":{"shape":"DescribeClusterVersionsResponse"},
+      "errors":[
+        {"shape":"ServerException"},
+        {"shape":"InvalidParameterException"},
+        {"shape":"InvalidRequestException"}
+      ]
+    },
     "DescribeEksAnywhereSubscription":{
       "name":"DescribeEksAnywhereSubscription",
       "http":{
@@ -1381,6 +1395,32 @@
         "PENDING"
       ]
     },
+    "ClusterVersionInformation":{
+      "type":"structure",
+      "members":{
+        "clusterVersion":{"shape":"String"},
+        "clusterType":{"shape":"String"},
+        "defaultPlatformVersion":{"shape":"String"},
+        "defaultVersion":{"shape":"Boolean"},
+        "releaseDate":{"shape":"Timestamp"},
+        "endOfStandardSupportDate":{"shape":"Timestamp"},
+        "endOfExtendedSupportDate":{"shape":"Timestamp"},
+        "status":{"shape":"ClusterVersionStatus"},
+        "kubernetesPatchVersion":{"shape":"String"}
+      }
+    },
+    "ClusterVersionList":{
+      "type":"list",
+      "member":{"shape":"ClusterVersionInformation"}
+    },
+    "ClusterVersionStatus":{
+      "type":"string",
+      "enum":[
+        "unsupported",
+        "standard-support",
+        "extended-support"
+      ]
+    },
     "Compatibilities":{
       "type":"list",
       "member":{"shape":"Compatibility"}
@@ -2029,6 +2069,59 @@
         "cluster":{"shape":"Cluster"}
       }
     },
+    "DescribeClusterVersionMaxResults":{
+      "type":"integer",
+      "box":true,
+      "max":100,
+      "min":1
+    },
+    "DescribeClusterVersionsRequest":{
+      "type":"structure",
+      "members":{
+        "clusterType":{
+          "shape":"String",
+          "location":"querystring",
+          "locationName":"clusterType"
+        },
+        "maxResults":{
+          "shape":"DescribeClusterVersionMaxResults",
+          "location":"querystring",
+          "locationName":"maxResults"
+        },
+        "nextToken":{
+          "shape":"String",
+          "location":"querystring",
+          "locationName":"nextToken"
+        },
+        "defaultOnly":{
+          "shape":"BoxedBoolean",
+          "location":"querystring",
+          "locationName":"defaultOnly"
+        },
+        "includeAll":{
+          "shape":"BoxedBoolean",
+          "location":"querystring",
+          "locationName":"includeAll"
+        },
+        "clusterVersions":{
+          "shape":"StringList",
+          "location":"querystring",
+          "locationName":"clusterVersions"
+        },
+        "status":{
+          "shape":"ClusterVersionStatus",
+          "location":"querystring",
+          "locationName":"status"
+        }
+      }
+    },
+    "DescribeClusterVersionsResponse":{
+      "type":"structure",
+      "members":{
+        "nextToken":{"shape":"String"},
+        "clusterVersions":{"shape":"ClusterVersionList"}
+      }
+    },
     "DescribeEksAnywhereSubscriptionRequest":{
       "type":"structure",
       "required":["id"],

generator/ServiceModels/eks/eks-2017-11-01.docs.json

@@ -25,6 +25,7 @@
     "DescribeAddonConfiguration": "<p>Returns configuration options.</p>",
     "DescribeAddonVersions": "<p>Describes the versions for an add-on.</p> <p>Information such as the Kubernetes versions that you can use the add-on with, the <code>owner</code>, <code>publisher</code>, and the <code>type</code> of the add-on are returned.</p>",
     "DescribeCluster": "<p>Describes an Amazon EKS cluster.</p> <p>The API server endpoint and certificate authority data returned by this operation are required for <code>kubelet</code> and <code>kubectl</code> to communicate with your Kubernetes API server. For more information, see <a href=\"https://docs.aws.amazon.com/eks/latest/userguide/create-kubeconfig.html\">Creating or updating a <code>kubeconfig</code> file for an Amazon EKS cluster</a>.</p> <note> <p>The API server endpoint and certificate authority data aren't available until the cluster reaches the <code>ACTIVE</code> state.</p> </note>",
+    "DescribeClusterVersions": "<p>Lists available Kubernetes versions for Amazon EKS clusters.</p>",
     "DescribeEksAnywhereSubscription": "<p>Returns descriptive information about a subscription.</p>",
     "DescribeFargateProfile": "<p>Describes an Fargate profile.</p>",
     "DescribeIdentityProviderConfig": "<p>Describes an identity provider configuration.</p>",
@@ -126,15 +127,15 @@
       }
     },
     "AddonCompatibilityDetail": {
-      "base": "<p>The summary information about the Amazon EKS add-on compatibility for the next Kubernetes version for an insight check in the <code>UPGRADE_READINESS</code> category.</p>",
+      "base": "<p>Contains compatibility information for an Amazon EKS add-on.</p>",
       "refs": {
         "AddonCompatibilityDetails$member": null
       }
     },
     "AddonCompatibilityDetails": {
       "base": null,
       "refs": {
-        "InsightCategorySpecificSummary$addonCompatibilityDetails": "<p>A list of <code>AddonCompatibilityDetail</code> objects for Amazon EKS add-ons.</p>"
+        "InsightCategorySpecificSummary$addonCompatibilityDetails": "<p>A list of AddonCompatibilityDetail objects for Amazon EKS add-ons.</p>"
       }
     },
     "AddonHealth": {
@@ -296,6 +297,7 @@
       "refs": {
         "AddonVersionInfo$requiresConfiguration": "<p>Whether the add-on requires configuration.</p>",
         "AddonVersionInfo$requiresIamPermissions": "<p>Indicates if the Addon requires IAM Permissions to operate, such as networking permissions.</p>",
+        "ClusterVersionInformation$defaultVersion": "<p>Indicates if this is a default version.</p>",
         "Compatibility$defaultVersion": "<p>The supported default version.</p>",
         "CreateEksAnywhereSubscriptionRequest$autoRenew": "<p>A boolean indicating whether the subscription auto renews at the end of the term.</p>",
         "DeleteAddonRequest$preserve": "<p>Specifying this option preserves the add-on software on your cluster but Amazon EKS stops managing any settings for the add-on. If an IAM account is associated with the add-on, it isn't removed.</p>",
@@ -315,6 +317,8 @@
         "ComputeConfigResponse$enabled": "<p>Indicates if the compute capability is enabled on your EKS Auto Mode cluster. If the compute capability is enabled, EKS Auto Mode will create and delete EC2 Managed Instances in your Amazon Web Services account.</p>",
         "CreateAccessConfigRequest$bootstrapClusterCreatorAdminPermissions": "<p>Specifies whether or not the cluster creator IAM principal was set as a cluster admin access entry during cluster creation time. The default value is <code>true</code>.</p>",
         "CreateClusterRequest$bootstrapSelfManagedAddons": "<p>If you set this value to <code>False</code> when creating a cluster, the default networking add-ons will not be installed.</p> <p>The default networking addons include vpc-cni, coredns, and kube-proxy.</p> <p>Use this option when you plan to install third-party alternative add-ons or self-manage the default networking add-ons.</p>",
+        "DescribeClusterVersionsRequest$defaultOnly": "<p>Filter to show only default versions.</p>",
+        "DescribeClusterVersionsRequest$includeAll": "<p>Include all available versions in the response.</p>",
         "ElasticLoadBalancing$enabled": "<p>Indicates if the load balancing capability is enabled on your EKS Auto Mode cluster. If the load balancing capability is enabled, EKS Auto Mode will create and delete load balancers in your Amazon Web Services account.</p>",
         "LogSetup$enabled": "<p>If a log type is enabled, that log type exports its control plane logs to CloudWatch Logs. If a log type isn't enabled, that log type doesn't export its control plane logs. Each individual log type can be enabled or disabled independently.</p>",
         "NodeRepairConfig$enabled": "<p>Specifies whether to enable node auto repair for the node group. Node auto repair is disabled by default.</p>",
@@ -434,6 +438,25 @@
         "Cluster$status": "<p>The current status of the cluster.</p>"
       }
     },
+    "ClusterVersionInformation": {
+      "base": "<p>Contains details about a specific EKS cluster version.</p>",
+      "refs": {
+        "ClusterVersionList$member": null
+      }
+    },
+    "ClusterVersionList": {
+      "base": null,
+      "refs": {
+        "DescribeClusterVersionsResponse$clusterVersions": "<p>List of cluster version information objects.</p>"
+      }
+    },
+    "ClusterVersionStatus": {
+      "base": null,
+      "refs": {
+        "ClusterVersionInformation$status": "<p>Current status of this cluster version.</p>",
+        "DescribeClusterVersionsRequest$status": "<p>Filter versions by their current status.</p>"
+      }
+    },
     "Compatibilities": {
       "base": null,
       "refs": {
@@ -713,6 +736,22 @@
       "refs": {
       }
     },
+    "DescribeClusterVersionMaxResults": {
+      "base": null,
+      "refs": {
+        "DescribeClusterVersionsRequest$maxResults": "<p>Maximum number of results to return.</p>"
+      }
+    },
+    "DescribeClusterVersionsRequest": {
+      "base": null,
+      "refs": {
+      }
+    },
+    "DescribeClusterVersionsResponse": {
+      "base": null,
+      "refs": {
+      }
+    },
     "DescribeEksAnywhereSubscriptionRequest": {
       "base": null,
       "refs": {
@@ -1648,6 +1687,10 @@
         "Cluster$platformVersion": "<p>The platform version of your Amazon EKS cluster. For more information about clusters deployed on the Amazon Web Services Cloud, see <a href=\"https://docs.aws.amazon.com/eks/latest/userguide/platform-versions.html\">Platform versions</a> in the <i> <i>Amazon EKS User Guide</i> </i>. For more information about local clusters deployed on an Outpost, see <a href=\"https://docs.aws.amazon.com/eks/latest/userguide/eks-outposts-platform-versions.html\">Amazon EKS local cluster platform versions</a> in the <i> <i>Amazon EKS User Guide</i> </i>.</p>",
         "Cluster$id": "<p>The ID of your local Amazon EKS cluster on an Amazon Web Services Outpost. This property isn't available for an Amazon EKS cluster on the Amazon Web Services cloud.</p>",
         "ClusterIssue$message": "<p>A description of the issue.</p>",
+        "ClusterVersionInformation$clusterVersion": "<p>The Kubernetes version for the cluster.</p>",
+        "ClusterVersionInformation$clusterType": "<p>The type of cluster this version is for.</p>",
+        "ClusterVersionInformation$defaultPlatformVersion": "<p>Default platform version for this Kubernetes version.</p>",
+        "ClusterVersionInformation$kubernetesPatchVersion": "<p>The patch version of Kubernetes for this cluster version.</p>",
         "Compatibility$clusterVersion": "<p>The supported Kubernetes version of the cluster.</p>",
         "ComputeConfigRequest$nodeRoleArn": "<p>The ARN of the IAM Role EKS will assign to EC2 Managed Instances in your EKS Auto Mode cluster. This value cannot be changed after the compute capability of EKS Auto Mode is enabled. For more information, see the IAM Reference in the EKS User Guide.</p>",
         "ComputeConfigResponse$nodeRoleArn": "<p>The ARN of the IAM Role EKS will assign to EC2 Managed Instances in your EKS Auto Mode cluster.</p>",
@@ -1715,6 +1758,9 @@
         "DescribeAddonVersionsRequest$addonName": "<p>The name of the add-on. The name must match one of the names returned by <a href=\"https://docs.aws.amazon.com/eks/latest/APIReference/API_ListAddons.html\"> <code>ListAddons</code> </a>.</p>",
         "DescribeAddonVersionsResponse$nextToken": "<p>The <code>nextToken</code> value to include in a future <code>DescribeAddonVersions</code> request. When the results of a <code>DescribeAddonVersions</code> request exceed <code>maxResults</code>, you can use this value to retrieve the next page of results. This value is <code>null</code> when there are no more results to return.</p> <note> <p>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.</p> </note>",
         "DescribeClusterRequest$name": "<p>The name of your cluster.</p>",
+        "DescribeClusterVersionsRequest$clusterType": "<p>The type of cluster to filter versions by.</p>",
+        "DescribeClusterVersionsRequest$nextToken": "<p>Pagination token for the next set of results.</p>",
+        "DescribeClusterVersionsResponse$nextToken": "<p>Pagination token for the next set of results.</p>",
         "DescribeEksAnywhereSubscriptionRequest$id": "<p>The ID of the subscription.</p>",
         "DescribeFargateProfileRequest$clusterName": "<p>The name of your cluster.</p>",
         "DescribeFargateProfileRequest$fargateProfileName": "<p>The name of the Fargate profile to describe.</p>",
@@ -1932,7 +1978,7 @@
         "AccessEntry$kubernetesGroups": "<p>A <code>name</code> that you've specified in a Kubernetes <code>RoleBinding</code> or <code>ClusterRoleBinding</code> object so that Kubernetes authorizes the <code>principalARN</code> access to cluster objects.</p>",
         "AccessScope$namespaces": "<p>A Kubernetes <code>namespace</code> that an access policy is scoped to. A value is required if you specified <code>namespace</code> for <code>Type</code>.</p>",
         "Addon$podIdentityAssociations": "<p>An array of Pod Identity Assocations owned by the Addon. Each EKS Pod Identity association maps a role to a service account in a namespace in the cluster.</p> <p>For more information, see <a href=\"https://docs.aws.amazon.com/eks/latest/userguide/add-ons-iam.html\">Attach an IAM Role to an Amazon EKS add-on using Pod Identity</a> in the EKS User Guide.</p>",
-        "AddonCompatibilityDetail$compatibleVersions": "<p>The list of compatible Amazon EKS add-on versions for the next Kubernetes version.</p>",
+        "AddonCompatibilityDetail$compatibleVersions": "<p>A list of compatible add-on versions.</p>",
         "AddonIssue$resourceIds": "<p>The resource IDs of the issue.</p>",
         "AddonPodIdentityConfiguration$recommendedManagedPolicies": "<p>A suggested IAM Policy for the addon.</p>",
         "AddonVersionInfo$architecture": "<p>The architectures that the version supports.</p>",
@@ -1948,6 +1994,7 @@
         "DescribeAddonVersionsRequest$types": "<p>The type of the add-on. For valid <code>types</code>, don't specify a value for this property.</p>",
         "DescribeAddonVersionsRequest$publishers": "<p>The publisher of the add-on. For valid <code>publishers</code>, don't specify a value for this property.</p>",
         "DescribeAddonVersionsRequest$owners": "<p>The owner of the add-on. For valid <code>owners</code>, don't specify a value for this property.</p>",
+        "DescribeClusterVersionsRequest$clusterVersions": "<p>List of specific cluster versions to describe.</p>",
         "EksAnywhereSubscription$licenseArns": "<p>Amazon Web Services License Manager ARN associated with the subscription.</p>",
         "EncryptionConfig$resources": "<p>Specifies the resources to be encrypted. The only supported value is <code>secrets</code>.</p>",
         "ErrorDetail$resourceIds": "<p>An optional field that contains the resource IDs associated with the error.</p>",
@@ -2062,6 +2109,9 @@
         "AssociatedAccessPolicy$modifiedAt": "<p>The Unix epoch timestamp for the last modification to the object.</p>",
         "ClientStat$lastRequestTime": "<p>The timestamp of the last request seen from the Kubernetes client.</p>",
         "Cluster$createdAt": "<p>The Unix epoch timestamp at object creation.</p>",
+        "ClusterVersionInformation$releaseDate": "<p>The release date of this cluster version.</p>",
+        "ClusterVersionInformation$endOfStandardSupportDate": "<p>Date when standard support ends for this version.</p>",
+        "ClusterVersionInformation$endOfExtendedSupportDate": "<p>Date when extended support ends for this version.</p>",
         "ConnectorConfigResponse$activationExpiry": "<p>The expiration time of the connected cluster. The cluster's YAML file must be applied through the native provider.</p>",
         "EksAnywhereSubscription$createdAt": "<p>The Unix timestamp in seconds for when the subscription was created.</p>",
         "EksAnywhereSubscription$effectiveDate": "<p>The Unix timestamp in seconds for when the subscription is effective.</p>",