Skip to content

Commit beef623

Browse files
author
AWS
committed
Amazon Elastic Kubernetes Service Update: This release adds support for DescribeClusterVersions API that provides important information about Kubernetes versions along with end of support dates
1 parent 8c7c62a commit beef623

File tree

3 files changed

+150
-3
lines changed

3 files changed

+150
-3
lines changed
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
{
2+
"type": "feature",
3+
"category": "Amazon Elastic Kubernetes Service",
4+
"contributor": "",
5+
"description": "This release adds support for DescribeClusterVersions API that provides important information about Kubernetes versions along with end of support dates"
6+
}

services/eks/src/main/resources/codegen-resources/paginators-1.json

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,12 @@
66
"output_token": "nextToken",
77
"result_key": "addons"
88
},
9+
"DescribeClusterVersions": {
10+
"input_token": "nextToken",
11+
"limit_key": "maxResults",
12+
"output_token": "nextToken",
13+
"result_key": "clusterVersions"
14+
},
915
"ListAccessEntries": {
1016
"input_token": "nextToken",
1117
"limit_key": "maxResults",

services/eks/src/main/resources/codegen-resources/service-2.json

Lines changed: 138 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -405,6 +405,21 @@
405405
],
406406
"documentation":"<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>"
407407
},
408+
"DescribeClusterVersions":{
409+
"name":"DescribeClusterVersions",
410+
"http":{
411+
"method":"GET",
412+
"requestUri":"/cluster-versions"
413+
},
414+
"input":{"shape":"DescribeClusterVersionsRequest"},
415+
"output":{"shape":"DescribeClusterVersionsResponse"},
416+
"errors":[
417+
{"shape":"ServerException"},
418+
{"shape":"InvalidParameterException"},
419+
{"shape":"InvalidRequestException"}
420+
],
421+
"documentation":"<p>Lists available Kubernetes versions for Amazon EKS clusters.</p>"
422+
},
408423
"DescribeEksAnywhereSubscription":{
409424
"name":"DescribeEksAnywhereSubscription",
410425
"http":{
@@ -1154,10 +1169,10 @@
11541169
},
11551170
"compatibleVersions":{
11561171
"shape":"StringList",
1157-
"documentation":"<p>The list of compatible Amazon EKS add-on versions for the next Kubernetes version.</p>"
1172+
"documentation":"<p>A list of compatible add-on versions.</p>"
11581173
}
11591174
},
1160-
"documentation":"<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>"
1175+
"documentation":"<p>Contains compatibility information for an Amazon EKS add-on.</p>"
11611176
},
11621177
"AddonCompatibilityDetails":{
11631178
"type":"list",
@@ -1790,6 +1805,60 @@
17901805
"PENDING"
17911806
]
17921807
},
1808+
"ClusterVersionInformation":{
1809+
"type":"structure",
1810+
"members":{
1811+
"clusterVersion":{
1812+
"shape":"String",
1813+
"documentation":"<p>The Kubernetes version for the cluster.</p>"
1814+
},
1815+
"clusterType":{
1816+
"shape":"String",
1817+
"documentation":"<p>The type of cluster this version is for.</p>"
1818+
},
1819+
"defaultPlatformVersion":{
1820+
"shape":"String",
1821+
"documentation":"<p>Default platform version for this Kubernetes version.</p>"
1822+
},
1823+
"defaultVersion":{
1824+
"shape":"Boolean",
1825+
"documentation":"<p>Indicates if this is a default version.</p>"
1826+
},
1827+
"releaseDate":{
1828+
"shape":"Timestamp",
1829+
"documentation":"<p>The release date of this cluster version.</p>"
1830+
},
1831+
"endOfStandardSupportDate":{
1832+
"shape":"Timestamp",
1833+
"documentation":"<p>Date when standard support ends for this version.</p>"
1834+
},
1835+
"endOfExtendedSupportDate":{
1836+
"shape":"Timestamp",
1837+
"documentation":"<p>Date when extended support ends for this version.</p>"
1838+
},
1839+
"status":{
1840+
"shape":"ClusterVersionStatus",
1841+
"documentation":"<p>Current status of this cluster version.</p>"
1842+
},
1843+
"kubernetesPatchVersion":{
1844+
"shape":"String",
1845+
"documentation":"<p>The patch version of Kubernetes for this cluster version.</p>"
1846+
}
1847+
},
1848+
"documentation":"<p>Contains details about a specific EKS cluster version.</p>"
1849+
},
1850+
"ClusterVersionList":{
1851+
"type":"list",
1852+
"member":{"shape":"ClusterVersionInformation"}
1853+
},
1854+
"ClusterVersionStatus":{
1855+
"type":"string",
1856+
"enum":[
1857+
"unsupported",
1858+
"standard-support",
1859+
"extended-support"
1860+
]
1861+
},
17931862
"Compatibilities":{
17941863
"type":"list",
17951864
"member":{"shape":"Compatibility"}
@@ -2796,6 +2865,72 @@
27962865
}
27972866
}
27982867
},
2868+
"DescribeClusterVersionMaxResults":{
2869+
"type":"integer",
2870+
"box":true,
2871+
"max":100,
2872+
"min":1
2873+
},
2874+
"DescribeClusterVersionsRequest":{
2875+
"type":"structure",
2876+
"members":{
2877+
"clusterType":{
2878+
"shape":"String",
2879+
"documentation":"<p>The type of cluster to filter versions by.</p>",
2880+
"location":"querystring",
2881+
"locationName":"clusterType"
2882+
},
2883+
"maxResults":{
2884+
"shape":"DescribeClusterVersionMaxResults",
2885+
"documentation":"<p>Maximum number of results to return.</p>",
2886+
"location":"querystring",
2887+
"locationName":"maxResults"
2888+
},
2889+
"nextToken":{
2890+
"shape":"String",
2891+
"documentation":"<p>Pagination token for the next set of results.</p>",
2892+
"location":"querystring",
2893+
"locationName":"nextToken"
2894+
},
2895+
"defaultOnly":{
2896+
"shape":"BoxedBoolean",
2897+
"documentation":"<p>Filter to show only default versions.</p>",
2898+
"location":"querystring",
2899+
"locationName":"defaultOnly"
2900+
},
2901+
"includeAll":{
2902+
"shape":"BoxedBoolean",
2903+
"documentation":"<p>Include all available versions in the response.</p>",
2904+
"location":"querystring",
2905+
"locationName":"includeAll"
2906+
},
2907+
"clusterVersions":{
2908+
"shape":"StringList",
2909+
"documentation":"<p>List of specific cluster versions to describe.</p>",
2910+
"location":"querystring",
2911+
"locationName":"clusterVersions"
2912+
},
2913+
"status":{
2914+
"shape":"ClusterVersionStatus",
2915+
"documentation":"<p>Filter versions by their current status.</p>",
2916+
"location":"querystring",
2917+
"locationName":"status"
2918+
}
2919+
}
2920+
},
2921+
"DescribeClusterVersionsResponse":{
2922+
"type":"structure",
2923+
"members":{
2924+
"nextToken":{
2925+
"shape":"String",
2926+
"documentation":"<p>Pagination token for the next set of results.</p>"
2927+
},
2928+
"clusterVersions":{
2929+
"shape":"ClusterVersionList",
2930+
"documentation":"<p>List of cluster version information objects.</p>"
2931+
}
2932+
}
2933+
},
27992934
"DescribeEksAnywhereSubscriptionRequest":{
28002935
"type":"structure",
28012936
"required":["id"],
@@ -3480,7 +3615,7 @@
34803615
},
34813616
"addonCompatibilityDetails":{
34823617
"shape":"AddonCompatibilityDetails",
3483-
"documentation":"<p>A list of <code>AddonCompatibilityDetail</code> objects for Amazon EKS add-ons.</p>"
3618+
"documentation":"<p>A list of AddonCompatibilityDetail objects for Amazon EKS add-ons.</p>"
34843619
}
34853620
},
34863621
"documentation":"<p>Summary information that relates to the category of the insight. Currently only returned with certain insights having category <code>UPGRADE_READINESS</code>.</p>"

0 commit comments

Comments
 (0)