Skip to content

Commit e0fe951

Browse files
Update Troubleshoot doc - 4
1 parent d5dde89 commit e0fe951

File tree

1 file changed

+0
-89
lines changed

1 file changed

+0
-89
lines changed

docs/TroubleShootingSteps.md

Lines changed: 0 additions & 89 deletions
Original file line numberDiff line numberDiff line change
@@ -77,95 +77,6 @@ Use these as quick reference guides to unblock your deployments.
7777
| **PrincipalNotFound** | | - This error occurs when the **principal ID** (Service Principal, User, or Group) specified in a role assignment or deployment does not exist in the Azure Active Directory tenant<br>- It can also happen due to **replication delays** right after creating a new principal<br>**Example causes:**<br>- The specified **Object ID** is invalid or belongs to another tenant<br>- The principal was recently created but Azure AD has not yet replicated it<br>- Attempting to assign a role to a non-existing or deleted Service Principal/User/Group<br>**How to fix:**<br>1. Verify that the **principal ID is correct** and exists in the same directory/tenant: `az ad sp show --id <object-id>`<br>2. If the principal was just created, wait a few minutes and retry<br>3. Explicitly set the principalType property (ServicePrincipal, User, or Group) in your ARM/Bicep template to avoid replication delays<br>4. If the principal does not exist, create it again before assigning roles<br>- For more details, see [Azure PrincipalType documentation](https://learn.microsoft.com/en-us/azure/role-based-access-control/troubleshooting?tabs=bicep) |
7878
| **SubscriptionDoesNotHaveServer** | | - This issue happens when you try to reference an **Azure SQL Server** (`Microsoft.Sql/servers`) that does not exist in the selected subscription<br>- It can occur if: The SQL server name is typed incorrectly; The SQL server was **deleted** but is still being referenced; You are working in the **wrong subscription context**; The server exists in a **different subscription/tenant** where you don't have access<br>**Reproduce:**<br>Run an Azure CLI command with a non-existent server name:<br>`az sql db list --server sql-doesnotexist --resource-group myResourceGroup`<br>or<br>`az sql server show --name sql-caqfrhxr4i3hyj --resource-group myResourceGroup`<br>**Resolution:**<br>- Verify the SQL Server name exists in your subscription: `az sql server list --output table`<br>- Make sure you are targeting the correct subscription:<br>`az account show`<br>`az account set --subscription <subscription-id>`<br>- If the server was deleted, either restore it (if possible) or update references to use a valid existing server |
7979

80-
---------------------------------
81-
82-
### Network & Infrastructure Configuration
83-
- Verify that the provisioning state of the existing resource is `Succeeded` by running the following command to avoid this error while deployment or restoring the resource.
84-
85-
```
86-
az resource show --ids <Resource ID> --query "properties.provisioningState"
87-
```
88-
- Sample Resource IDs format
89-
- Log Analytics Workspace Resource ID
90-
```
91-
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}
92-
```
93-
- Azure AI Foundry Project Resource ID
94-
```
95-
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{name}
96-
```
97-
- You may encounter the error `The language expression property array index '8' is out of bounds` if the resource ID is incomplete. Please ensure your resource ID is correct and contains all required information, as shown in sample resource IDs.
98-
99-
- For more information refer [Resource Not Found errors solutions](https://learn.microsoft.com/en-us/azure/azure-resource-manager/troubleshooting/error-not-found?tabs=bicep)
100-
101-
</details>
102-
103-
<details><summary><b>ParentResourceNotFound</b></summary>
104-
105-
- You can refer to the [Parent Resource Not found](https://learn.microsoft.com/en-us/azure/azure-resource-manager/troubleshooting/error-parent-resource?tabs=bicep) documentation if you encounter this error.
106-
107-
</details>
108-
109-
<details>
110-
<summary><b>PrincipalNotFound</b></summary>
111-
112-
- This error occurs when the **principal ID** (Service Principal, User, or Group) specified in a role assignment or deployment does not exist in the Azure Active Directory tenant.
113-
- It can also happen due to **replication delays** right after creating a new principal.
114-
**Example causes:**
115-
- The specified **Object ID** is invalid or belongs to another tenant.
116-
- The principal was recently created but Azure AD has not yet replicated it.
117-
- Attempting to assign a role to a non-existing or deleted Service Principal/User/Group.
118-
**How to fix:**
119-
1. Verify that the **principal ID is correct** and exists in the same directory/tenant.
120-
```bash
121-
az ad sp show --id <object-id>
122-
```
123-
2. If the principal was just created, wait a few minutes and retry.
124-
3. Explicitly set the principalType property (ServicePrincipal, User, or Group) in your ARM/Bicep template to avoid replication delays.
125-
4. If the principal does not exist, create it again before assigning roles.
126-
For more details, see [Azure PrincipalType documentation](https://learn.microsoft.com/en-us/azure/role-based-access-control/troubleshooting?tabs=bicep)
127-
</details>
128-
129-
<details>
130-
<summary><b>SubscriptionDoesNotHaveServer</b></summary>
131-
132-
- This issue happens when you try to reference an **Azure SQL Server** (`Microsoft.Sql/servers`) that does not exist in the selected subscription.
133-
- It can occur if:
134-
- The SQL server name is typed incorrectly.
135-
- The SQL server was **deleted** but is still being referenced.
136-
- You are working in the **wrong subscription context**.
137-
- The server exists in a **different subscription/tenant** where you don’t have access.
138-
139-
**Reproduce:**
140-
1. Run an Azure CLI command with a non-existent server name:
141-
```bash
142-
az sql db list --server sql-doesnotexist --resource-group myResourceGroup
143-
```
144-
145-
or
146-
147-
```bash
148-
az sql server show --name sql-caqfrhxr4i3hyj --resource-group myResourceGroup
149-
150-
```
151-
152-
Resolution:
153-
154-
Verify the SQL Server name exists in your subscription:
155-
156-
```bash
157-
az sql server list --output table
158-
```
159-
Make sure you are targeting the correct subscription:
160-
161-
```bash
162-
az account show
163-
az account set --subscription <subscription-id>
164-
```
165-
If the server was deleted, either restore it (if possible) or update references to use a valid existing server.
166-
167-
</details>
168-
16980
---------------------------------
17081

17182
### Network & Infrastructure Configuration

0 commit comments

Comments
 (0)