Skip to content

Commit 594fab9

Browse files
committed
Moved the relevant CREATE related TSGs into the error code section
1 parent 665a0c4 commit 594fab9

16 files changed

+992
-0
lines changed
Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
---
2+
title: AKSOperationPreempted error when performing a new operation
3+
description: Helps resolve the AKSOperationPreempted or AKSOperationPreemptedByDelete error when you perform a new operation on an Azure Kubernetes Service (AKS) cluster.
4+
ms.date: 10/28/2024
5+
ms.reviewer: rissing, chiragpa, erbookbi, jopalhei, dorinalecu, v-leedennis, v-weizhu
6+
ms.service: azure-kubernetes-service
7+
#Customer intent: As an Azure Kubernetes user, I want to troubleshoot the OperationPreempted error code so that I can successfully perform a new operation an Azure Kubernetes Service (AKS) cluster.
8+
ms.custom: sap:Create, Upgrade, Scale and Delete operations (cluster or nodepool)
9+
---
10+
# AKSOperationPreempted or AKSOperationPreemptedByDelete error when performing a new operation
11+
12+
This article discusses how to identify and resolve the `AKSOperationPreempted` or `AKSOperationPreemptedByDelete` error that might occur when you try to perform a new operation but it has been preempted by another operation on a Microsoft Azure Kubernetes Service (AKS) cluster.
13+
14+
## Symptoms
15+
16+
When you try to perform a new operation on an AKS cluster, you receive one of the following error messages:
17+
18+
- > Code: "AKSOperationPreempted"
19+
>
20+
> Message: "This operation has been preempted by another operation with ID \<operation ID\>"
21+
22+
This message indicates that the operation has been preempted by another operation, and the GUID for the new operation is given in the error message.
23+
24+
- > Code: "AKSOperationPreemptedByDelete"
25+
>
26+
> Message: "This operation has been preempted by Deleting operation."
27+
28+
This message indicates that the operation has been preempted by a delete operation.
29+
30+
## Cause
31+
32+
This error usually occurs when an in-progress operation is interrupted by a subsequent operation that was issued before the in-progress operation is finished. The error will indicate the subsequent operation, which can be a delete or any other operation.
33+
34+
## Solution
35+
36+
To resolve this issue, use one of the following methods. Once there are no operations running, you can try to run your operation again.
37+
38+
- Wait for the previous operation to complete.
39+
40+
You can check the status of the operation using the ID given in the error message with the follwing command:
41+
42+
```azurecli-interactive
43+
az aks operation show \
44+
--resource-group myResourceGroup \
45+
--name myCluster \
46+
--operation-id "<operation-id>"
47+
```
48+
49+
- Run an `abort` command to stop the previous operation.
50+
51+
For more information about how to abort an operation, see [Terminate a long running operation on an Azure Kubernetes Service (AKS) cluster](/azure/aks/manage-abort-operations).
52+
53+
## More information
54+
55+
[General troubleshooting of AKS cluster creation issues](troubleshoot-aks-cluster-creation-issues.md)
56+
57+
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]
Lines changed: 82 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,82 @@
1+
---
2+
title: Troubleshoot the InvalidParameter error
3+
description: Learn how to troubleshoot the InvalidParameter error when you try to create and deploy an Azure Kubernetes Service (AKS) cluster.
4+
ms.date: 11/19/2024
5+
editor: v-gsitser
6+
ms.reviewer: rissing, chiragpa, erbookbi, jaewonpark, v-leedennis
7+
ms.service: azure-kubernetes-service
8+
#Customer intent: As an Azure Kubernetes user, I want to troubleshoot the InvalidParameter error so that I can successfully create and deploy an AKS cluster.
9+
ms.custom: sap:Create, Upgrade, Scale and Delete operations (cluster or nodepool)
10+
---
11+
# Troubleshoot the InvalidParameter error
12+
13+
This article discusses how to identify and resolve the `InvalidParameter` error that occurs when you try to create and deploy a Microsoft Azure Kubernetes Service (AKS) cluster.
14+
15+
## Prerequisites
16+
17+
- [Azure CLI](/cli/azure/install-azure-cli), version 2.0.81 or a later version. If Azure CLI is already installed, you can find the version number by running `az --version`.
18+
19+
## Symptoms
20+
21+
When you create an AKS cluster, the provided configurations are usually validated before the cluster is created. However, on rare occasions, a parameter passes validation before the AKS cluster is created but causes errors when the resources for the cluster are created. Errors that are related to invalid parameters might resemble the following examples:
22+
23+
- Scenario: The selected VM size is not available
24+
25+
```
26+
Code="InvalidParameter"
27+
28+
Message="**The requested VM size Standard_D4s_v3 is not available in the current region. The sizes available in the current region are: ExtraSmall_Internal, Small_Internal, Medium_Internal, Large_Internal, ExtraLarge_Internal, Standard_DC2as_v5, Standard_DC4as_v5, Standard_DC8as_v5, Standard_DC16as_v5, Standard_DC32as_v5, Standard_DC48as_v5, Standard_DC64as_v5, Standard_DC96as_v5, Standard_DC2ads_v5, Standard_DC4ads_v5, Standard_DC8ads_v5, Standard_DC16ads_v5, Standard_DC32ads_v5, Standard_DC48ads_v5, Standard_DC64ads_v5, Standard_DC96ads_v5, Standard_EC2as_v5, Standard_EC4as_v5, Standard_EC8as_v5, Standard_EC16as_v5, Standard_EC20as_v5, Standard_EC32as_v5, Standard_EC48as_v5, Standard_EC64as_v5, Standard_EC96as_v5, Standard_EC96ias_v5, Standard_EC2ads_v5, Standard_EC4ads_v5, Standard_EC8ads_v5, Standard_EC16ads_v5, Standard_EC20ads_v5, Standard_EC32ads_v5, Standard_EC48ads_v5, Standard_EC64ads_v5, Standard_EC96ads_v5, Standard_EC96iads_v5.\r\nFind out more on the available VM sizes in each region at <https://aka.ms/azureregions>."
29+
30+
Target="vmSize"
31+
```
32+
- Scenario: Cluster names are unavailable or conflict with Azure reserved values
33+
34+
- Example 1
35+
36+
```
37+
Code="InvalidParameter"
38+
39+
Message="The value of parameter name is invalid. Error details: "omsagent-aks-dev-microsoft" managed cluster name is invalid because 'MICROSOFT' and 'WINDOWS' can't be used as either a whole word or a substring in the name.. Please see https://aka.ms/aks-naming-rules for more details."
40+
```
41+
42+
- Example 2
43+
44+
```
45+
Message="The value of parameter name is invalid. Error details: "login" managed cluster name is invalid because 'LOGIN' and 'XBOX' can't be used at the start of a resource name, but can be used later in the name.. Please see https://aka.ms/aks-naming-rules for more details."
46+
```
47+
48+
- Example 3
49+
50+
```
51+
Message=" The value of parameter name is invalid. Error details: "azure" managed cluster name is invalid because it is reserved.. Please see https://aka.ms/aks-naming-rules for more details.
52+
Target: name"
53+
```
54+
## Cause
55+
56+
This issue occurs because one of the following conditions is true:
57+
58+
- The Azure Virtual Machine SKU isn't available in the selected region.
59+
- The service principal is invalid.
60+
- A virtual network, subnet, or route table is invalid.
61+
- An Azure CLI parameter is invalid.
62+
- The value of parameter name is unavailable or reserved by Azure.
63+
64+
There might also be other reasons that your cluster creation attempt failed.
65+
66+
## Solution
67+
68+
In the following table, follow the link for the appropriate troubleshooting step.
69+
70+
| Troubleshooting step | Reference link |
71+
| -------------------- | -------------- |
72+
| Check whether the SKU is available | [Resolve errors for SKU not available](/azure/azure-resource-manager/troubleshooting/error-sku-not-available) |
73+
| Verify that the service principal is valid | [Service principals together with AKS](/azure/aks/kubernetes-service-principal) |
74+
| Verify that any commands that were used to create the cluster are valid | [az aks](/cli/azure/aks#az-aks-create) (Azure CLI reference) |
75+
| Verify that any custom network resources that were used to create the cluster are valid | [Configure Azure CNI networking in AKS](/azure/aks/configure-azure-cni) and [Customize cluster egress with a user-defined route](/azure/aks/egress-outboundtype) |
76+
| Avoid using unavailable or Azure-reserved values for names | [Refer to the error messages provided](#symptoms)
77+
78+
## More information
79+
80+
- [General troubleshooting of AKS cluster creation issues](troubleshoot-aks-cluster-creation-issues.md)
81+
82+
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]
Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
---
2+
title: Troubleshoot the InvalidResourceReference error code
3+
description: Learn how to troubleshoot the InvalidResourceReference errors when you try to create and deploy an Azure Kubernetes Service (AKS) cluster or update an AKS cluster.
4+
ms.date: 01/11/2024
5+
editor: v-jsitser
6+
ms.reviewer: rissing, chiragpa, erbookbi, v-leedennis, v-weizhu
7+
ms.service: azure-kubernetes-service
8+
#Customer intent: As an Azure Kubernetes user, I want to troubleshoot the InvalidResourceReference error code so that I can successfully create and deploy an Azure Kubernetes Service (AKS) cluster.
9+
ms.custom: sap:Create, Upgrade, Scale and Delete operations (cluster or nodepool)
10+
---
11+
# Troubleshoot the InvalidResourceReference error code
12+
13+
This article discusses how to identify and resolve the `InvalidResourceReference` errors that may occur when you try to create and deploy a Microsoft Azure Kubernetes Service (AKS) cluster or update an AKS cluster.
14+
15+
## Symptom 1
16+
17+
When you try to create an AKS cluster, you receive the following error message:
18+
19+
> Code="InvalidResourceReference"
20+
>
21+
> Message="Resource
22+
> **/subscriptions/*\<subscription-id-guid>*/resourceGroups/MyResourceGroup/providers/Microsoft.Network/virtualNetworks/vnet-otcom/subnets/Subnet-AKS**
23+
> referenced by resource
24+
> **/subscriptions/*\<subscription-id-guid>*/resourceGroups/MC_MyResourceGroup_MyCluster-AKS_JAPANEAST/providers/Microsoft.Compute/virtualMachineScaleSets/aks-nodepool-vmss**
25+
> was not found. Please make sure that the referenced resource exists, and that both resources are in the same region."
26+
>
27+
> Details=[]
28+
29+
### Cause 1
30+
31+
Here are the possible causes of this issue:
32+
33+
- A mismatch exists between resources in different regions.
34+
35+
The example in [Symptom 1](#symptom-1) shows that the virtual network and the virtual machine scale set aren't in the same region. Because the resources are in different regions, it's impossible to create the scale set instance.
36+
37+
- The referenced resource has been manually modified or deleted.
38+
39+
### Solution 1
40+
41+
If a mismatch exists between resources in different regions, review the resources to make sure that they're in the same region. In this example, either modify the region where the AKS cluster is being built, or create a new virtual network in the same region.
42+
43+
If the referenced resource has been manually modified or deleted, it might be difficult to resolve this issue because it's unsupported to manually modify the underlying IaaS resources in the *MC_* resource group. A possible solution might be to recreate the deleted resource, reassociate it with the VMSS, and then trigger an update on the AKS cluster. However, as this is an unsupported scenario, the success of this solution can't be guaranteed.
44+
45+
## Symptom 2
46+
47+
When you try to update an AKS cluster, you receive the following error message:
48+
49+
> Code="InvalidResourceReference"
50+
> Message="Resource
51+
> /subscriptions/*\<subscription-id-guid>*/resourceGroups/MC_MyResourceGroup/providers/Microsoft.Network/loadBalancers/kubernetes/frontendIPConfigurations/<frontendIP_ID> referenced by resource /subscriptions/*\<subscription-id-guid>*/resourceGroups/MC_MyResourceGroup/providers/Microsoft.Network/loadBalancers/kubernetes/**loadBalancingRules/<frontend_IP_rule> was not found.** Please make sure that the referenced resource exists, and that both resources are in the same region."
52+
> Message="Resource
53+
>
54+
> Details=[]
55+
56+
### Cause 2
57+
58+
This issue might occur if the default outbound rule "aksOutboundRule" on the load balancer is manually modified. This unexpected modification typically occurs when the outbound IP is updated if you update the cluster without the `load-balancer-outbound-ips` parameter.
59+
60+
### Solution 2
61+
62+
Rerun the `az aks update` command with the `load-balancer-outbound-ips` parameter to update your cluster. Use the resource ID of the public IP as the parameter value. For more information, see [Update the cluster with your own outbound public IP](/azure/aks/load-balancer-standard#update-the-cluster-with-your-own-outbound-public-ip).
63+
64+
## More information
65+
66+
[General troubleshooting of AKS cluster creation issues](troubleshoot-aks-cluster-creation-issues.md)
67+
68+
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]
Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
---
2+
title: Troubleshoot the LinkedAuthorizationFailed error code
3+
description: Learn how to troubleshoot the LinkedAuthorizationFailed error when you try to create and deploy an Azure Kubernetes Service (AKS) cluster.
4+
ms.date: 08/28/2024
5+
editor: v-jsitser
6+
ms.reviewer: rissing, chiragpa, erbookbi, v-leedennis
7+
ms.service: azure-kubernetes-service
8+
#Customer intent: As an Azure Kubernetes user, I want to troubleshoot the LinkedAuthorizationFailed error code so that I can successfully create and deploy an Azure Kubernetes Service (AKS) cluster.
9+
ms.custom: sap:Create, Upgrade, Scale and Delete operations (cluster or nodepool)
10+
---
11+
# Troubleshoot the LinkedAuthorizationFailed error code
12+
13+
This article discusses how to identify and resolve the `LinkedAuthorizationFailed` error that occurs when you try to create and deploy a Microsoft Azure Kubernetes Service (AKS) cluster.
14+
15+
## Symptoms
16+
17+
When you try to create an AKS cluster, you receive the following error message:
18+
19+
> Reconcile VNet failed.
20+
>
21+
> Details: VNetReconciler retry failed:
22+
>
23+
> Category: ClientError; SubCode: LinkedAuthorizationFailed;
24+
>
25+
> Dependency: Microsoft.Network/virtualNetworks; OrginalError: Code="LinkedAuthorizationFailed"
26+
>
27+
> Message="**The client '12345678-1234-1234-1234-123456789098' with object id '123456789-1234-1234-1234-1234567890987' has permission to perform action 'Microsoft.Network/virtualNetworks/write' on scope '/subscriptions/*\<subscription-id-guid>*/resourceGroups/MC_MyRG_westeurope/providers/Microsoft.Network/virtualNetworks/aks-vnet'; however, it does not have permission to perform action 'Microsoft.Network/ddosProtectionPlans/join/action' on the linked scope(s) '/subscriptions/*\<subscription-id-guid>*/resourcegroups/ddos-protection-plan-rg/providers/microsoft.network/ddosprotectionplans/upmddosprotectionplan'** or the linked scope(s) are invalid.";
28+
>
29+
> AKSTeam: Networking, Retriable: false.
30+
31+
## Cause
32+
33+
A service principal doesn't have permission to use a resource that's required for cluster creation.
34+
35+
## Solution
36+
37+
Grant the service principal permissions to use the resource that's mentioned in the error message. The example output in the "Symptoms" section provides the following information.
38+
39+
| Item | Value |
40+
| ---- | ----- |
41+
| Service principal | 12345678-1234-1234-1234-123456789098 |
42+
| Resource | /subscriptions/*\<subscription-id-guid>*/resourcegroups/ddos-protection-plan-rg/providers/microsoft.network/ddosprotectionplans/upmddosprotectionplan |
43+
| Operation | Microsoft.Network/ddosProtectionPlans/join/action |
44+
45+
For more information about how to grant permissions to the service principal, see [Assign Azure roles using the Azure portal](/azure/role-based-access-control/role-assignments-portal).
46+
47+
## More information
48+
49+
- [General troubleshooting of AKS cluster creation issues](troubleshoot-aks-cluster-creation-issues.md)
50+
51+
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]
Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
---
2+
title: Troubleshoot the MissingSubscriptionRegistration error code
3+
description: Learn how to troubleshoot the MissingSubscriptionRegistration error when you try to create and deploy an Azure Kubernetes Service (AKS) cluster.
4+
ms.date: 09/16/2024
5+
editor: v-jsitser
6+
ms.reviewer: rissing, chiragpa, erbookbi, v-leedennis
7+
ms.service: azure-kubernetes-service
8+
#Customer intent: As an Azure Kubernetes user, I want to troubleshoot the MissingSubscriptionRegistration error code so that I can successfully create and deploy an Azure Kubernetes Service (AKS) cluster.
9+
ms.custom: sap:Create, Upgrade, Scale and Delete operations (cluster or nodepool)
10+
---
11+
# Troubleshoot the MissingSubscriptionRegistration error code
12+
13+
This article discusses how to identify and resolve the `MissingSubscriptionRegistration` error that occurs when you try to create and deploy a Microsoft Azure Kubernetes Service (AKS) cluster.
14+
15+
## Symptoms
16+
17+
When you try to deploy an AKS cluster, you receive the following error message:
18+
19+
> Code="MissingSubscriptionRegistration"
20+
>
21+
> Message="**The subscription is not registered to use namespace 'Microsoft.OperationsManagement'.** See <https://aka.ms/rps-not-found> for how to register subscriptions."
22+
>
23+
> Details=[{
24+
>
25+
> "code": "MissingSubscriptionRegistration",
26+
>
27+
> "message": "The subscription is not registered to use namespace 'Microsoft.OperationsManagement'. See <https://aka.ms/rps-not-found> for how to register subscriptions.",
28+
>
29+
> "target": "Microsoft.OperationsManagement"
30+
>
31+
> }]
32+
33+
## Cause
34+
35+
You receive this error message for one of the following reasons:
36+
37+
- The required resource provider isn't registered for your subscription.
38+
39+
- The API version isn't supported for the resource type.
40+
41+
- The location isn't supported for the resource type.
42+
43+
## Solution
44+
45+
To resolve this issue, follow the instructions in the "Solution" section of [Resolve errors for resource provider registration](/azure/azure-resource-manager/troubleshooting/error-register-resource-provider?tabs=azure-portal#solution). Replace the existing namespace with the namespace that's shown in the error message. In the example in the "Symptoms" section, the namespace is `Microsoft.OperationsManagement`.
46+
47+
## More information
48+
49+
- [General troubleshooting of AKS cluster creation issues](troubleshoot-aks-cluster-creation-issues.md)
50+
51+
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]

0 commit comments

Comments
 (0)