Skip to content

Commit dfee8e5

Browse files
authored
Update akscapacityerror.md
Error code has been changed to AksCapacityHeavyUsage
1 parent ce92c5e commit dfee8e5

1 file changed

Lines changed: 9 additions & 19 deletions

File tree

support/azure/azure-kubernetes/create-upgrade-delete/akscapacityerror.md

Lines changed: 9 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -10,33 +10,23 @@ ms.service: azure-kubernetes-service
1010
ms.topic: troubleshooting-problem-resolution
1111
ms.custom: sap:Create, Upgrade, Scale and Delete operations (cluster or nodepool)
1212
---
13-
# Troubleshoot the AKSCapacityError error code
13+
# Troubleshoot the AksCapacityHeavyUsage error code
1414

15-
This article discusses how to identify and resolve the `AKSCapacityError` error that might occur when you create or start a Microsoft Azure Kubernetes Service (AKS) cluster.
15+
This article discusses how to identify and resolve the `AksCapacityHeavyUsage` error that might occur when you create a Microsoft Azure Kubernetes Service (AKS) cluster.
1616

1717
## Symptoms
1818

19-
When you try to create or start an AKS cluster, you receive one of the following error messages:
19+
When you try to create an AKS cluster, you receive the following error messages:
2020

21-
> **Code:** AKSCapacityError
21+
> **Code:** AksCapacityHeavyUsage
2222
>
23-
> **Message 1:** Creating or starting a free tier cluster is unavailable at this time in region \<Region\>. To create a new cluster, we recommend using an alternate region, or create a paid tier cluster. For a list of all the Azure regions, visit <https://aka.ms/aks/regions>. For more details on this error, visit <https://aka.ms/akscapacityerror>.
24-
>
25-
> **Message 2:** Creating a new cluster or starting cluster is unavailable at this time in region \<Region>. To create a new cluster, we recommend using an alternate region. For a list of all the Azure regions, visit <https://aka.ms/aks/regions>. For more details on this error, visit <https://aka.ms/akscapacityerror>.
26-
27-
If you then try to do an operation on that cluster after it doesn't start, you receive the following error message:
28-
29-
> **"statusCode":** "InternalServerError",
30-
>
31-
> **"serviceRequestId":** null,
32-
>
33-
> **"statusMessage":** "{**\"code\":** \"KubernetesAPICallFailed\", **\"message\":** \"API call to Kubernetes API Server failed.\"}.
23+
> **Message:** AKS is experiencing heavy usage in region <Region>. We are working on adding new capacity. In the meantime, please consider creating new AKS clusters in a different region. For a list of all the Azure regions, visit https://aka.ms/aks/regions. For more details on this error, visit https://aka.ms/akscapacityheavyusage.
3424
3525
## Cause
3626

37-
You're trying to deploy a cluster in a region that has limited capacity.
27+
You're trying to create a cluster in a region that has limited capacity.
3828

39-
When you create or start an AKS cluster, Microsoft Azure allocates compute resources to your subscription. You might occasionally experience the `AKSCapacityError` error because of significant growth in demand for Azure Kubernetes Service in specific regions.
29+
When you create an AKS cluster, Microsoft Azure allocates compute resources to your subscription. You might occasionally experience the `AksCapacityHeavyUsage` error because of significant growth in demand for Azure Kubernetes Service in specific regions.
4030

4131
The `KubernetesAPICallFailed` error message indicates that the AKS cluster didn't start and doesn't have an associated control plane. Therefore, calls to the API server are failing. In this case, you have to retry the Start operation.
4232

@@ -50,11 +40,11 @@ This approach might not be feasible if you already have existing resources in th
5040

5141
### Solution 2: Try deploying a cluster that has different settings
5242

53-
The infrastructure that hosts AKS managed clusters have different allocation reservations. Therefore, AKS might have more capacity for public clusters than for private clusters. If you encounter the `AKSCapacityError` error when you try to create a private cluster, try to create a public cluster instead or vice versa.
43+
The infrastructure that hosts AKS managed clusters have different allocation reservations. Therefore, AKS might have more capacity for public clusters than for private clusters. If you encounter the `AksCapacityHeavyUsage` error when you try to create a private cluster, try to create a public cluster instead or vice versa.
5444

5545
### Solution 3: Use an Azure Enterprise subscription
5646

57-
When capacity is running low, we limit free tier AKS clusters for customers who don't have an Enterprise Agreement (EA) subscription first in order to reserve resources for real production scenarios. Make sure that you use an EA subscription to create your AKS cluster.
47+
When capacity is running low, we limit AKS cluster creates for customers who don't have an Enterprise Agreement (EA) subscription first in order to reserve resources for real production scenarios. Make sure that you use an EA subscription to create your AKS cluster.
5848

5949
### Solution 4: Retry the operation
6050

0 commit comments

Comments
 (0)