Skip to content

Commit 2417f7b

Browse files
committed
updates content and error codes
1 parent e8e4f4c commit 2417f7b

File tree

3 files changed

+52
-22
lines changed

3 files changed

+52
-22
lines changed

articles/azure-resource-manager/troubleshooting/common-deployment-errors.md

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,23 @@
11
---
22
title: Troubleshoot common Azure deployment errors
3-
description: Describes common deployment errors for Azure resources that are deployed with Azure Resource Manager templates (ARM templates) or Bicep files.
3+
description: Describes common Azure deployment errors for resources that are deployed with Bicep files or Azure Resource Manager templates (ARM templates).
44
tags: top-support-issue
55
ms.topic: troubleshooting
6-
ms.date: 05/16/2022
6+
ms.date: 08/05/2022
77
ms.custom: devx-track-azurepowershell
88
---
99

1010
# Troubleshoot common Azure deployment errors
1111

12-
This article describes common Azure deployment errors, and provides information about solutions. Azure resources can be deployed with Azure Resource Manager templates (ARM templates) or Bicep files. If you can't find the error code for your deployment error, see [Find error code](find-error-code.md).
12+
This article describes common Azure deployment errors, and provides information about solutions. Azure resources can be deployed with Bicep files or Azure Resource Manager templates (ARM templates). If you can't find the error code for your deployment error, see [Find error code](find-error-code.md).
1313

1414
If your error code isn't listed, submit a GitHub issue. On the right side of the page, select **Feedback**. At the bottom of the page, under **Feedback** select **This page**. Provide your documentation feedback but **don't include confidential information** because GitHub issues are public.
1515

1616
## Error codes
1717

1818
| Error code | Mitigation | More information |
1919
| ---------- | ---------- | ---------------- |
20-
| AccountNameInvalid | Follow naming restrictions for storage accounts. | [Resolve storage account name](error-storage-account-name.md) |
20+
| AccountNameInvalid | Follow naming guidelines for storage accounts. | [Resolve errors for storage account names](error-storage-account-name.md) |
2121
| AccountPropertyCannotBeSet | Check available storage account properties. | [storageAccounts](/azure/templates/microsoft.storage/storageaccounts) |
2222
| AllocationFailed | The cluster or region doesn't have resources available or can't support the requested VM size. Retry the request at a later time, or request a different VM size. | [Provisioning and allocation issues for Linux](/troubleshoot/azure/virtual-machines/troubleshoot-deployment-new-vm-linux) <br><br> [Provisioning and allocation issues for Windows](/troubleshoot/azure/virtual-machines/troubleshoot-deployment-new-vm-windows) <br><br> [Troubleshoot allocation failures](/troubleshoot/azure/virtual-machines/allocation-failure)|
2323
| AnotherOperationInProgress | Wait for concurrent operation to complete. | |
@@ -33,7 +33,7 @@ If your error code isn't listed, submit a GitHub issue. On the right side of the
3333
| DeploymentJobSizeExceeded | Simplify your template to reduce size. | [Resolve template size errors](error-job-size-exceeded.md) |
3434
| DnsRecordInUse | The DNS record name must be unique. Enter a different name. | |
3535
| ImageNotFound | Check VM image settings. | |
36-
| InaccessibleImage | Azure Container Instance deployment fails. You might need to include the image's tag with the syntax `registry/image:tag` to deploy the container. For a private registry, verify your credentials are correct. | [Find error code](find-error-code.md) |
36+
| InaccessibleImage | Azure Container Instance deployment fails. You might need to include the image's tag with the syntax `registry/image:tag` to deploy the container. For a private registry, verify your credentials are correct. | [Find error code](find-error-code.md) |
3737
| InternalServerError | Caused by a temporary problem. Retry the deployment. | |
3838
| InUseSubnetCannotBeDeleted | This error can occur when you try to update a resource, if the request process deletes and creates the resource. Make sure to specify all unchanged values. | [Update resource](/azure/architecture/guide/azure-resource-manager/advanced-templates/update-resource) |
3939
| InvalidAuthenticationTokenTenant | Get access token for the appropriate tenant. You can only get the token from the tenant that your account belongs to. | |
@@ -42,7 +42,7 @@ If your error code isn't listed, submit a GitHub issue. On the right side of the
4242
| InvalidParameter | One of the values you provided for a resource doesn't match the expected value. This error can result from many different conditions. For example, a password may be insufficient, or a blob name may be incorrect. The error message should indicate which value needs to be corrected. | [ARM template parameters](../templates/parameters.md) <br><br> [Bicep parameters](../bicep/parameters.md) |
4343
| InvalidRequestContent | The deployment values either include values that aren't recognized, or required values are missing. Confirm the values for your resource type. | [Template reference](/azure/templates/) |
4444
| InvalidRequestFormat | Enable debug logging when running the deployment, and verify the contents of the request. | [Debug logging](enable-debug-logging.md) |
45-
| InvalidResourceLocation | Provide a unique name for the storage account. | [Resolve storage account name](error-storage-account-name.md) |
45+
| InvalidResourceLocation | Provide a unique name for the storage account. | [Resolve errors for storage account names](error-storage-account-name.md) |
4646
| InvalidResourceNamespace | Check the resource namespace you specified in the **type** property. | [Template reference](/azure/templates/) |
4747
| InvalidResourceReference | The resource either doesn't yet exist or is incorrectly referenced. Check whether you need to add a dependency. Verify that your use of the **reference** function includes the required parameters for your scenario. | [Resolve dependencies](error-not-found.md) |
4848
| InvalidResourceType | Check the resource type you specified in the **type** property. | [Template reference](/azure/templates/) |
@@ -73,7 +73,8 @@ If your error code isn't listed, submit a GitHub issue. On the right side of the
7373
| ResourceNotFound | Your deployment references a resource that can't be resolved. Verify that your use of the **reference** function includes the parameters required for your scenario. | [Resolve references](error-not-found.md) |
7474
| ResourceQuotaExceeded | The deployment is trying to create resources that exceed the quota for the subscription, resource group, or region. If possible, revise your infrastructure to stay within the quotas. Otherwise, consider requesting a change to your quotas. | [Resolve quotas](error-resource-quota.md) |
7575
| SkuNotAvailable | Select SKU (such as VM size) that is available for the location you've selected. | [Resolve SKU](error-sku-not-available.md) |
76-
| StorageAccountAlreadyExists <br> StorageAccountAlreadyTaken | Provide a unique name for the storage account. | [Resolve storage account name](error-storage-account-name.md) |
76+
| StorageAccountAlreadyTaken <br> StorageAccountAlreadyExists | Provide a unique name for the storage account. | [Resolve errors for storage account names](error-storage-account-name.md) |
77+
| StorageAccountInAnotherResourceGroup | Provide a unique name for the storage account. | [Resolve errors for storage account names](error-storage-account-name.md) |
7778
| StorageAccountNotFound | Check the subscription, resource group, and name of the storage account that you're trying to use. | |
7879
| SubnetsNotInSameVnet | A virtual machine can only have one virtual network. When deploying several NICs, make sure they belong to the same virtual network. | [Windows VM multiple NICs](../../virtual-machines/windows/multiple-nics.md) <br><br> [Linux VM multiple NICs](../../virtual-machines/linux/multiple-nics.md) |
7980
| SubnetIsFull | There aren't enough available addresses in the subnet to deploy resources. You can release addresses from the subnet, use a different subnet, or create a new subnet. | [Manage subnets](../../virtual-network/virtual-network-manage-subnet.md) and [Virtual network FAQ](../../virtual-network/virtual-networks-faq.md#are-there-any-restrictions-on-using-ip-addresses-within-these-subnets) <br><br> [Private IP addresses](../../virtual-network/ip-services/private-ip-addresses.md) |

articles/azure-resource-manager/troubleshooting/error-storage-account-name.md

Lines changed: 43 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,47 +1,76 @@
11
---
2-
title: Storage account name errors
3-
description: Describes errors that can occur when specifying a storage account name in an Azure Resource Manager template (ARM template) or Bicep file.
2+
title: Resolve errors for storage account names
3+
description: Describes how to resolve errors for Azure storage account names that can occur during deployment with a Bicep file or Azure Resource Manager template (ARM template).
44
ms.topic: troubleshooting
5-
ms.date: 11/12/2021
5+
ms.date: 08/05/2022
66
---
77

88
# Resolve errors for storage account names
99

10-
This article describes naming errors that can occur when deploying a storage account with an Azure Resource Manager template (ARM template) or Bicep file.
10+
This article describes how to resolve errors for Azure storage account names that can occur during deployment with a Bicep file or Azure Resource Manager template (ARM template). Common causes for an error are a storage account name with invalid characters or a storage account that uses the same name as an existing storage account. Storage account names must be globally unique across Azure.
1111

1212
## Symptom
1313

14-
If your storage account name includes prohibited characters, like an uppercase letter or exclamation point, you receive an error:
14+
An invalid storage account name causes an error code during deployment. The following are some examples of errors for storage account names.
15+
16+
### Account name invalid
17+
18+
If your storage account name includes prohibited characters, like an uppercase letter or special character like an exclamation point.
1519

1620
```Output
1721
Code=AccountNameInvalid
1822
Message=S!torageckrexph7isnoc is not a valid storage account name. Storage account name must be
1923
between 3 and 24 characters in length and use numbers and lower-case letters only.
2024
```
2125

22-
For storage accounts, you must provide a resource name that's unique across Azure. If you don't provide a unique name, you receive an error:
26+
### Invalid resource location
27+
28+
If you try to deploy a new storage account with the same name and in the same resource group, but use a different location as an existing storage account in your Azure subscription. The error indicates the storage account already exists and can't be created in the new location. Select a different name to create the new storage account.
2329

2430
```Output
25-
Code=StorageAccountAlreadyTaken
26-
Message=The storage account named mystorage is already taken.
31+
Code=InvalidResourceLocation
32+
Message=The resource 'storageckrexph7isnoc' already exists in location 'westus'
33+
in resource group 'demostorage'. A resource with the same name cannot be created in location 'eastus'.
34+
Please select a new resource name.
35+
```
36+
37+
### Storage account in another resource group
38+
39+
If you try to deploy a new storage account with the same name and location as an existing storage account but in a different resource group in your subscription.
40+
41+
```Output
42+
Code=StorageAccountInAnotherResourceGroup
43+
Message=The account storageckrexph7isnoc is already in another resource group in this subscription.
2744
```
2845

29-
If you deploy a storage account with the same name as an existing storage account in your subscription, but in a different location, you receive an error. The error indicates the storage account already exists in a different location. Either delete the existing storage account or use the same location as the existing storage account.
46+
### Storage account already taken
47+
48+
If you try to deploy a new storage account with the same name as a storage account that already exists in Azure. The existing storage account name might be in your subscription or tenant, or anywhere across Azure. Storage account names must be globally unique across Azure.
49+
50+
```Output
51+
Code=StorageAccountAlreadyTaken
52+
Message=The storage account named storageckrexph7isnoc is already taken.
53+
```
3054

3155
## Cause
3256

33-
Storage account names must be between 3 and 24 characters in length and only use numbers and lowercase letters. No uppercase letters or special characters. The name must be unique.
57+
Common reasons for an error are because the storage account name uses invalid characters or is a duplicate name. Storage account names must meet the following criteria:
58+
59+
- Length between 3 and 24 characters with only lowercase letters and numbers.
60+
- Must be globally unique across Azure. Storage account names can't be duplicated in Azure.
3461

3562
## Solution
3663

37-
You can create a unique name by concatenating your naming convention with the result of the `uniqueString` function.
64+
You can create a unique name by concatenating a prefix or suffix with a value from the `uniqueString` function.
65+
66+
The following examples specify a prefix with the string `storage` that's concatenated with the value from `uniqueString`.
3867

3968
# [Bicep](#tab/bicep)
4069

4170
Bicep uses [string interpolation](../bicep/bicep-functions-string.md#concat) with [uniqueString](../bicep/bicep-functions-string.md#uniquestring).
4271

4372
```bicep
44-
resource storageAccount 'Microsoft.Storage/storageAccounts@2021-04-01' = {
73+
resource storageAccount 'Microsoft.Storage/storageAccounts@2021-09-01' = {
4574
name: 'storage${uniqueString(resourceGroup().id)}'
4675
```
4776

@@ -58,7 +87,7 @@ ARM templates use [concat](../templates/template-functions-string.md#concat) wit
5887

5988
Make sure your storage account name doesn't exceed 24 characters. The `uniqueString` function returns 13 characters. If you want to concatenate a prefix or suffix, provide a value that's 11 characters or less.
6089

61-
The following examples use a parameter that creates a prefix with a maximum of 11 characters.
90+
The following examples use a parameter named `storageNamePrefix` that creates a prefix with a maximum of 11 characters.
6291

6392
# [Bicep](#tab/bicep)
6493

@@ -85,7 +114,7 @@ param storageNamePrefix string = 'storage'
85114

86115
---
87116

88-
You then concatenate the parameter value with the `uniqueString` value to create a storage account name.
117+
You then concatenate the `storageNamePrefix` parameter's value with the `uniqueString` value to create a storage account name.
89118

90119
# [Bicep](#tab/bicep)
91120

articles/azure-resource-manager/troubleshooting/toc.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@
2222
items:
2323
- name: Common deployment errors
2424
href: common-deployment-errors.md
25-
- name: Account name invalid
25+
- name: Storage account name invalid
2626
href: error-storage-account-name.md
2727
- name: Deployment quota exceeded
2828
href: deployment-quota-exceeded.md

0 commit comments

Comments
 (0)