Skip to content

Commit 0a6e710

Browse files
committed
Updates to API breaking changes
1 parent e2a37eb commit 0a6e710

File tree

1 file changed

+9
-28
lines changed

1 file changed

+9
-28
lines changed

articles/aks/stop-api-upgrade.md

Lines changed: 9 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -43,16 +43,20 @@ After receiving the error message, you have two options:
4343
- Remove usage on your end and wait 12 hours for the current record to expire.
4444
- Bypass the validation to ignore API changes.
4545

46-
## Fail fast on minor version manual upgrades in AKS
46+
### Remove usage on API breaking changes
4747

48-
When manually updating a minor Kubernetes version, checks will be run to detect API breaking changes. If you attempt an upgrade and the checks detect usage on a deprecated API in the goal version, you can either remove usage on your end or bypass the validation to ignore API changes.
48+
Remove usage on API breaking changes using the following steps:
4949

50-
### Remove usage on API breaking changes
50+
1. Remove the deprecated API, which is listed in the error message.
51+
2. Wait 12 hours for the current record to expire.
52+
3. Retry your cluster upgrade.
53+
54+
### Bypass validation to ignore API changes
5155

52-
To remove usage on API breaking changes, update the `"properties":` block of `Microsoft.ContainerService/ManagedClusters` `PUT` operation with the following settings:
56+
To bypass validation to ignore API breaking changes, update the `"properties":` block of `Microsoft.ContainerService/ManagedClusters` `PUT` operation with the following settings:
5357

5458
> [!NOTE]
55-
> The date and time you specify for `"until"` has to be in the future. `Z` stands for timezone. The following example is in GMT.
59+
> The date and time you specify for `"until"` has to be in the future. `Z` stands for timezone. The following example is in GMT. For more information, see [Combined date and time representations](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
5660
5761
```
5862
{
@@ -69,28 +73,6 @@ To remove usage on API breaking changes, update the `"properties":` block of `Mi
6973
}
7074
```
7175

72-
After updating the properties, you must wait 12 hours for the current record to expire.
73-
74-
### Bypass validation to ignore API changes
75-
76-
To override fail fast on control plane minor version manual upgrades in AKS, use the [`az aks upgrade`][az-aks-upgrade] command with the `--ignore-api-changes` parameter.
77-
78-
```azurecli
79-
az aks upgrade --resource-group myResourceGroup --name myAKSCluster --kubernetes_version KUBERNETES_VERSION --ignore-api-changes
80-
```
81-
82-
To override *after* fail fast, use the [`az aks upgrade`][az-aks-upgrade] command.
83-
84-
```azurecli
85-
az aks upgrade --resource-group myResourceGroup --name myAKSCluster --kubernetes_version KUBERNETES_VERSION
86-
```
87-
88-
You'll receive a message prompting you to choose whether you want to proceed with the API breaking changes. This message will look similar to the following example message:
89-
90-
```azurecli
91-
We detected the following API breaking changes in your service, do you wish to proceed Y/N?
92-
```
93-
9476
## Next steps
9577

9678
In this article, you learned how to stop cluster upgrades on API breaking changes in AKS. To learn more about AKS cluster upgrades, see:
@@ -101,4 +83,3 @@ In this article, you learned how to stop cluster upgrades on API breaking change
10183
<!-- INTERNAL LINKS -->
10284
[upgrade-cluster]: upgrade-cluster.md
10385
[planned-maintenance-aks]: planned-maintenance.md
104-
[az-aks-upgrade]: /cli/azure/aks#az_aks_upgrade

0 commit comments

Comments
 (0)