Merge pull request #8964 from skuchipudi295/patch-1

AB#5929: Create AvailabilityZoneNotSupported TSG

Author: AmandaAZ

support/azure/azure-kubernetes/error-codes/availabilityzonenotsupported-error.md

@@ -0,0 +1,71 @@
+---
+title: Troubleshoot AvailabilityZoneNotSupported Error Code
+description: Learn how to troubleshoot the AvailabilityZoneNotSupported error when you try to create an Azure Kubernetes Service cluster in a set of zones.
+ms.date: 06/04/2025
+ms.reviewer: marcha, skuchipudi, v-weizhu
+ms.service: azure-kubernetes-service
+ms.custom: sap:Create, Upgrade, Scale and Delete operations (cluster or nodepool)
+#Customer intent: As an Azure Kubernetes Services (AKS) user, I want to troubleshoot an Azure Kubernetes Service cluster create that failed because of a AvailabilityZoneNotSupported error code so that I can create the cluster successfully.
+---
+# Troubleshoot the AvailabilityZoneNotSupported error code
+
+This article discusses how to identify and resolve the "AvailabilityZoneNotSupported" error that occurs when you try to create an Azure Kubernetes Service (AKS) cluster.
+
+## Prerequisites
+
+Access to [Azure CLI](/cli/azure/get-started-with-azure-cli).
+
+## Symptoms
+
+An AKS cluster creation fails in specified availability zones, and you receive an "AvailabilityZoneNotSupported" error with the following message:
+
+> Preflight validation check for resource(s) for container service \<resource-name> in resource group \<resource-group-name> failed. Message: The zone(s) '1' for resource '\<agentpoolName>' is not supported. The supported zones for location '\<location>' are 'A', 'B'
+
+## Cause
+
+The issue occurs because the requested SKU has restrictions in some or all zones of your subscription. To verify the restrictions, go to the [Verify SKU restrictions](#verify-sku-restrictions) section.
+
+## Solution
+
+To resolve this issue, follow the [Azure region access request process](../../general/region-access-request-process.md) to request access to the specified region or zone.
+
+## Verify SKU restrictions
+
+1. List the SKU details by running one of the following commands:
+
+    ```azurecli
+    az vm list-skus -l <location> --size <SKU> 
+    ```
+        
+    ```azurecli
+    az rest --method get \
+        --url "https://management.azure.com/subscriptions/<subscription>/providers/Microsoft.Compute/skus?%24filter=location+eq+%27<location>%27&api-version=2022-03-01"  >> availableSkus.txt
+    ```
+    
+    > [!NOTE]
+    > Replace `<subscription>`, `<SKU>`, and `<location>` accordingly.
+2. Search for the requested SKU from the command output.
+3. If you see information like the following, it indicates that the requested SKU has restrictions in some or all zones of your subscription:
+
+    ```json
+    "restrictions": [
+                    {
+                        "type": "Zone",
+                        "values": [
+                            "<zone>"
+                        ],
+                        "restrictionInfo": {
+                            "locations": [
+                                "<location>"
+                            ],
+                            "zones": [
+                                "1",
+                                "2",
+                                "3"
+                            ]
+                        },
+                        "reasonCode": "NotAvailableForSubscription"
+                    }
+                ]
+    ```
+[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]

support/azure/azure-kubernetes/toc.yml

@@ -382,6 +382,8 @@
       href: error-codes/vmextensionerror-vhdfilenotfound.md
     - name: VMExtensionError_ProvisioningTimeout error
       href: error-codes/vmextensionerror-provisioningtimeout.md
+  - name: AvailabilityZoneNotSupported error
+    href: error-codes/availabilityzonenotsupported-error.md
   - name: AksCapacityHeavyUsage error
     href: error-codes/akscapacityheavyusage-error.md
   - name: AKSOperationPreempted error