GA alias minor version (#18038)

zjpjack · matthchr · web-flow · commit 3a99cda3cb48 · 2022-03-04T21:55:44.000+08:00
* GA alias minor version

* polish more details on kubernetesVersion and currentKubernetesVersion

* Update specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/managedClusters.json

minor revision

Co-authored-by: Matthew Christopher &lt;matthchr@microsoft.com&gt;

Co-authored-by: Matthew Christopher &lt;matthchr@microsoft.com&gt;
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_DisableRunCommand.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_DisableRunCommand.json
@@ -84,6 +84,7 @@
           "provisioningState": "Succeeded",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
@@ -179,6 +180,7 @@
           "provisioningState": "Creating",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_DualStackNetworking.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_DualStackNetworking.json
@@ -102,6 +102,7 @@
           "provisioningState": "Succeeded",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.22.1",
+          "currentKubernetesVersion": "1.22.1",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
@@ -220,6 +221,7 @@
           "provisioningState": "Creating",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.22.1",
+          "currentKubernetesVersion": "1.22.1",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_EnableEncryptionAtHost.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_EnableEncryptionAtHost.json
@@ -82,6 +82,7 @@
           "provisioningState": "Succeeded",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
@@ -174,6 +175,7 @@
           "provisioningState": "Creating",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_EnableUltraSSD.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_EnableUltraSSD.json
@@ -82,6 +82,7 @@
           "provisioningState": "Succeeded",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
@@ -174,6 +175,7 @@
           "provisioningState": "Creating",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_EnabledFIPS.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_EnabledFIPS.json
@@ -82,6 +82,7 @@
           "provisioningState": "Succeeded",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
@@ -174,6 +175,7 @@
           "provisioningState": "Creating",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_GPUMIG.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_GPUMIG.json
@@ -91,6 +91,7 @@
           "provisioningState": "Succeeded",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
@@ -192,6 +193,7 @@
           "provisioningState": "Creating",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_HTTPProxy.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_HTTPProxy.json
@@ -90,6 +90,7 @@
           "provisioningState": "Succeeded",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
@@ -190,6 +191,7 @@
           "provisioningState": "Creating",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_ManagedNATGateway.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_ManagedNATGateway.json
@@ -81,6 +81,7 @@
           "provisioningState": "Succeeded",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
@@ -162,6 +163,7 @@
           "provisioningState": "Creating",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_NodePublicIPPrefix.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_NodePublicIPPrefix.json
@@ -82,6 +82,7 @@
           "provisioningState": "Succeeded",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
@@ -174,6 +175,7 @@
           "provisioningState": "Creating",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_OSSKU.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_OSSKU.json
@@ -91,6 +91,7 @@
           "provisioningState": "Succeeded",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
@@ -192,6 +193,7 @@
           "provisioningState": "Creating",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_PPG.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_PPG.json
@@ -82,6 +82,7 @@
           "provisioningState": "Succeeded",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
@@ -174,6 +175,7 @@
           "provisioningState": "Creating",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_PodIdentity.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_PodIdentity.json
@@ -85,6 +85,7 @@
           "provisioningState": "Succeeded",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
@@ -180,6 +181,7 @@
           "provisioningState": "Creating",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_PrivateClusterFQDNSubdomain.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_PrivateClusterFQDNSubdomain.json
@@ -85,6 +85,7 @@
           "provisioningState": "Succeeded",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "fqdnSubdomain": "domain1",
           "agentPoolProfiles": [
             {
@@ -180,6 +181,7 @@
           "provisioningState": "Creating",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "fqdnSubdomain": "domain1",
           "agentPoolProfiles": [
             {
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_PrivateClusterPublicFQDN.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_PrivateClusterPublicFQDN.json
@@ -85,6 +85,7 @@
           "provisioningState": "Succeeded",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
@@ -182,6 +183,7 @@
           "provisioningState": "Creating",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_SecurityProfile.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_SecurityProfile.json
@@ -71,6 +71,7 @@
           "provisioningState": "Succeeded",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
@@ -164,6 +165,7 @@
           "provisioningState": "Creating",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_Snapshot.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_Snapshot.json
@@ -85,6 +85,7 @@
           "provisioningState": "Succeeded",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
@@ -180,6 +181,7 @@
           "provisioningState": "Creating",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_Update.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_Update.json
@@ -98,6 +98,7 @@
           "provisioningState": "Succeeded",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
@@ -209,6 +210,7 @@
           "provisioningState": "Creating",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_UpdateWindowsGmsa.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_UpdateWindowsGmsa.json
@@ -95,6 +95,7 @@
           "provisioningState": "Succeeded",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
@@ -203,6 +204,7 @@
           "provisioningState": "Creating",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_UpdateWithAHUB.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_UpdateWithAHUB.json
@@ -93,6 +93,7 @@
           "provisioningState": "Succeeded",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
@@ -199,6 +200,7 @@
           "provisioningState": "Creating",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_UpdateWithEnableAzureRBAC.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_UpdateWithEnableAzureRBAC.json
@@ -90,6 +90,7 @@
           "provisioningState": "Succeeded",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
@@ -192,6 +193,7 @@
           "provisioningState": "Creating",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_UserAssignedNATGateway.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersCreate_UserAssignedNATGateway.json
@@ -76,6 +76,7 @@
           "provisioningState": "Succeeded",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
@@ -143,6 +144,7 @@
           "provisioningState": "Creating",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "agentPoolProfiles": [
             {
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersGet.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersGet.json
@@ -20,6 +20,7 @@
           "provisioningState": "Succeeded",
           "maxAgentPools": 1,
           "kubernetesVersion": "1.9.6",
+          "currentKubernetesVersion": "1.9.6",
           "dnsPrefix": "dnsprefix1",
           "fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
           "azurePortalFQDN": "dnsprefix1-abcd1234.portal.hcp.eastus.azmk8s.io",
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersList.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersList.json
@@ -19,6 +19,7 @@
             "properties": {
               "provisioningState": "Succeeded",
               "kubernetesVersion": "1.9.6",
+              "currentKubernetesVersion": "1.9.6",
               "maxAgentPools": 1,
               "dnsPrefix": "dnsprefix1",
               "fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersListByResourceGroup.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/examples/ManagedClustersListByResourceGroup.json
@@ -20,6 +20,7 @@
             "properties": {
               "provisioningState": "Succeeded",
               "kubernetesVersion": "1.9.6",
+              "currentKubernetesVersion": "1.9.6",
               "maxAgentPools": 1,
               "dnsPrefix": "dnsprefix1",
               "fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/managedClusters.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2022-02-01/managedClusters.json
@@ -3683,7 +3683,12 @@
         "kubernetesVersion": {
           "type": "string",
           "title": "The version of Kubernetes the Managed Cluster is running.",
-          "description": "When you upgrade a supported AKS cluster, Kubernetes minor versions cannot be skipped. All upgrades must be performed sequentially by major version number. For example, upgrades between 1.14.x -> 1.15.x or 1.15.x -> 1.16.x are allowed, however 1.14.x -> 1.16.x is not allowed. See [upgrading an AKS cluster](https://docs.microsoft.com/azure/aks/upgrade-cluster) for more details."
+          "description": "Both full Kubernetes version (e.g. 1.20.13) and Kubernetes version only containing major and minor versions (e.g. 1.20) are supported. When you upgrade a supported AKS cluster, Kubernetes minor versions cannot be skipped. All upgrades must be performed sequentially by major version number. For example, upgrades between 1.14.x -> 1.15.x or 1.15.x -> 1.16.x are allowed, however 1.14.x -> 1.16.x is not allowed. See [upgrading an AKS cluster](https://docs.microsoft.com/azure/aks/upgrade-cluster) for more details."
+        },
+        "currentKubernetesVersion": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The version of Kubernetes the Managed Cluster is running. If a specific Kubernetes version is specified in kubernetesVersion, currentKubernetesVersion is the same as kubernetesVersion. For example, kubernetesVersion: 1.20.13, currentKubernetesVersion: 1.20.13. If only major and minor versions are used in kubernetesVersion, then currentKubernetesVersion will be the latest GA patch version picked by the service. For example, kubernetesVersion: 1.20, currentKubernetesVersion: 1.20.13."
         },
         "dnsPrefix": {
           "type": "string",
