Skip to content

Commit 24ad121

Browse files
authored
Remove duplicate content in AKS error guide
1 parent 5d2013f commit 24ad121

1 file changed

Lines changed: 0 additions & 71 deletions

File tree

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

Lines changed: 0 additions & 71 deletions
Original file line numberDiff line numberDiff line change
@@ -11,19 +11,6 @@ ms.topic: troubleshooting-problem-resolution
1111
ms.custom: sap:Create, Upgrade, Scale and Delete operations (cluster or nodepool)
1212
---
1313
# Troubleshoot the AksCapacityHeavyUsage error code
14-
---
15-
title: Troubleshoot the AksCapacityHeavyUsage error code
16-
description: Discusses how to troubleshoot the AksCapacityHeavyUsage error when you create or start a Kubernetes cluster.
17-
ms.date: 05/29/2024
18-
author: axelgMS
19-
ms.author: axelg
20-
editor: v-jsitser
21-
ms.reviewer: chiragpa, anbubin, v-leedennis
22-
ms.service: azure-kubernetes-service
23-
ms.topic: troubleshooting-problem-resolution
24-
ms.custom: sap:Create, Upgrade, Scale and Delete operations (cluster or nodepool)
25-
---
26-
# Troubleshoot the AksCapacityHeavyUsage error code
2714

2815
This article discusses how to identify and resolve the `AksCapacityHeavyUsage` error that might occur when you create a Microsoft Azure Kubernetes Service (AKS) cluster.
2916

@@ -72,61 +59,3 @@ Capacity is often reclaimed when other users stop or delete their AKS clusters.
7259
- [General troubleshooting of AKS cluster creation issues](troubleshoot-aks-cluster-creation-issues.md)
7360

7461
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]
75-
76-
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.
77-
78-
## Symptoms
79-
80-
When you try to create or start an AKS cluster, you receive one of the following error messages:
81-
82-
> **Code:** AKSCapacityError
83-
>
84-
> **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>.
85-
>
86-
> **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>.
87-
88-
If you then try to do an operation on that cluster after it doesn't start, you receive the following error message:
89-
90-
> **"statusCode":** "InternalServerError",
91-
>
92-
> **"serviceRequestId":** null,
93-
>
94-
> **"statusMessage":** "{**\"code\":** \"KubernetesAPICallFailed\", **\"message\":** \"API call to Kubernetes API Server failed.\"}.
95-
96-
## Cause
97-
98-
You're trying to deploy a cluster in a region that has limited capacity.
99-
100-
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.
101-
102-
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.
103-
104-
## Resolution
105-
106-
### Solution 1: Select a different region
107-
108-
The easiest and quickest solution is to try to deploy to a different region (for example, NorthEurope instead of WestEurope or UAENorth instead of QatarCentral). To find nearby regions, visit the [Azure Geographies page](https://azure.microsoft.com/explore/global-infrastructure/geographies/#overview).
109-
110-
This approach might not be feasible if you already have existing resources in the requested region, but it's the preferred solution in a dev/test scenario.
111-
112-
### Solution 2: Try deploying a cluster that has different settings
113-
114-
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.
115-
116-
### Solution 3: Use an Azure Enterprise subscription
117-
118-
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.
119-
120-
### Solution 4: Retry the operation
121-
122-
Capacity is often reclaimed when other users stop or delete their AKS clusters. Therefore, the operation might succeed if you retry it later.
123-
124-
## More information
125-
126-
- Ensuring capacity for users is a top priority for Microsoft, and we're working around the clock to reach this goal. The increasing popularity of Azure services emphasizes the need for us to scale up our infrastructure even more rapidly. With that in mind, we're expediting expansions and improving our resource deployment process to respond to strong customer demand. We're also adding a large amount of compute infrastructure monthly.
127-
128-
We have identified several methods to improve how we load-balance under a high-resource-usage situation, and how to trigger the timely deployment of needed resources. Additionally, we're significantly increasing our capacity, and will continue to plan for strong demand across all regions. [This September 2021 Azure Blog article](https://azure.microsoft.com/blog/advancing-reliability-through-a-resilient-cloud-supply-chain/) discusses improvements that we're making toward delivering a resilient cloud supply chain.
129-
130-
- [General troubleshooting of AKS cluster creation issues](troubleshoot-aks-cluster-creation-issues.md)
131-
132-
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]

0 commit comments

Comments
 (0)