Merge pull request #295045 from mumian/0220-bcp-135

Add BCP135

Author: v-dirichards

articles/azure-resource-manager/bicep/bicep-core-diagnostics.md

@@ -138,8 +138,8 @@ If you need more information about a particular diagnostic code, select the **Fe
 | <a id='BCP130' />BCP130 | Error | Decorators aren't allowed here. |
 | <a id='BCP132' />[BCP132](./diagnostics/bcp132.md) | Error | Expected a declaration after the decorator. |
 | <a id='BCP133' />BCP133 | Error | The unicode escape sequence isn't valid. Valid unicode escape sequences range from \\u{0} to \\u{10FFFF}. |
-| <a id='BCP134' />BCP134 | Warning | Scope {ToQuotedString(LanguageConstants.GetResourceScopeDescriptions(suppliedScope))} isn't valid for this module. Permitted scopes: {ToQuotedString(LanguageConstants.GetResourceScopeDescriptions(supportedScopes))}. |
-| <a id='BCP135' />BCP135 | Warning | Scope {ToQuotedString(LanguageConstants.GetResourceScopeDescriptions(suppliedScope))} isn't valid for this resource type. Permitted scopes: {ToQuotedString(LanguageConstants.GetResourceScopeDescriptions(supportedScopes))}. |
+| <a id='BCP134' />BCP134 | Error | Scope \<scope-name> isn't valid for this module. Permitted scopes: \<scope-name>. |
+| <a id='BCP135' />[BCP135](./diagnostics/bcp135.md) | Error | Scope \<scope-name> isn't valid for this resource type. Permitted scopes: \<scope-name>. |
 | <a id='BCP136' />BCP136 | Error | Expected a loop item variable identifier at this location. |
 | <a id='BCP137' />BCP137 | Error | Loop expected an expression of type "{LanguageConstants.Array}" but the provided value is of type "{actualType}". |
 | <a id='BCP138' />BCP138 | Error | For-expressions aren't supported in this context. For-expressions may be used as values of resource, module, variable, and output declarations, or values of resource and module properties. |

articles/azure-resource-manager/bicep/diagnostics/bcp135.md

@@ -0,0 +1,60 @@
+---
+title: BCP135
+description: Scope <scope-name> isn't valid for this resource type. Permitted scopes <scope-name>.
+ms.topic: reference
+ms.custom: devx-track-bicep
+ms.date: 02/20/2025
+---
+
+# Bicep diagnostic code - BCP135
+
+In Bicep, scopes determine the hierarchical level at which resources are deployed within Azure. ARM provides four deployment scopes—resource group, management group, subscription, and tenant. Resources must be deployed within the allowed scopes. For more information, see [Deployment scope](../deploy-to-resource-group.md#deployment-scopes).
+
+## Description
+
+Scope \<scope-name> isn't valid for this resource type. Permitted scopes: \<scope-name>.
+
+## Level
+
+Error
+
+## Solutions
+
+Deploy resources to the permitted scopes.
+
+## Examples
+
+The following example raises the diagnostic because `storageAccounts` can't be deployed at the management group scope.
+
+```bicep
+targetScope = 'managementGroup'
+
+resource storageAccount 'Microsoft.Storage/storageAccounts@2023-05-01' = {
+  name: 'demostorage0220'
+  location: 'eastus'
+  sku: {
+    name:  'Standard_LRS'
+  }
+  kind:  'StorageV2'
+}
+```
+
+You can fix the diagnostic by setting the `targetScope` to `resourceGroup`.  
+
+```bicep
+targetScope = 'resourceGroup'
+
+resource storageAccount 'Microsoft.Storage/storageAccounts@2023-05-01' = {
+  name: 'demostorage0220'
+  location: 'eastus'
+  sku: {
+    name:  'Standard_LRS'
+  }
+  kind:  'StorageV2'
+}
+
+```
+
+## Next steps
+
+For more information about Bicep diagnostics, see [Bicep core diagnostics](../bicep-core-diagnostics.md).

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

@@ -681,6 +681,8 @@
       href: diagnostics/bcp129.md
     - name: BCP132
       href: diagnostics/bcp132.md
+    - name: BCP135
+      href: diagnostics/bcp135.md
     - name: BCP139
       href: diagnostics/bcp139.md
     - name: BCP147