Merge pull request #205546 from mumian/0721-linter-unused-resource

new linter rule - no unused exiting resources

Author: v-dirichards

articles/azure-resource-manager/bicep/bicep-config-linter.md

@@ -2,7 +2,7 @@
 title: Linter settings for Bicep config
 description: Describes how to customize configuration values for the Bicep linter
 ms.topic: conceptual
-ms.date: 11/18/2021
+ms.date: 07/21/2022
 ---
 
 # Add linter settings in the Bicep config file
@@ -33,6 +33,9 @@ The following example shows the rules that are available for configuration.
         "no-unnecessary-dependson": {
           "level": "warning"
         },
+        "no-unused-existing-resources": {
+          "level": "warning"
+        },
         "no-unused-params": {
           "level": "warning"
         },

articles/azure-resource-manager/bicep/linter-rule-no-unused-existing-resources.md

@@ -0,0 +1,24 @@
+---
+title: Linter rule - no unused existing resources
+description: Linter rule - no unused existing resources
+ms.topic: conceptual
+ms.date: 07/21/2022
+---
+
+# Linter rule - no unused existing resources
+
+This rule finds [existing resources](./existing-resource.md) that aren't referenced anywhere in the Bicep file.
+
+## Linter rule code
+
+Use the following value in the [Bicep configuration file](bicep-config-linter.md) to customize rule settings:
+
+`no-unused-existing-resources`
+
+## Solution
+
+To reduce confusion in your template, delete any [existing resources](./existing-resource.md) that are defined but not used. This test finds any existing resource that isn't used anywhere in the template.
+
+## Next steps
+
+For more information about the linter, see [Use Bicep linter](./linter.md).

articles/azure-resource-manager/bicep/linter.md

@@ -2,7 +2,7 @@
 title: Use Bicep linter
 description: Learn how to use Bicep linter.
 ms.topic: conceptual
-ms.date: 10/12/2021
+ms.date: 07/21/2022
 ---
 
 # Use Bicep linter
@@ -24,6 +24,7 @@ The default set of linter rules is minimal and taken from [arm-ttk test cases](.
 - [max-variables](./linter-rule-max-variables.md)
 - [no-hardcoded-env-urls](./linter-rule-no-hardcoded-environment-urls.md)
 - [no-unnecessary-dependson](./linter-rule-no-unnecessary-dependson.md)
+- [no-unused-existing-resources](./linter-rule-no-unused-existing-resources.md)
 - [no-unused-params](./linter-rule-no-unused-parameters.md)
 - [no-unused-vars](./linter-rule-no-unused-variables.md)
 - [outputs-should-not-contain-secrets](./linter-rule-outputs-should-not-contain-secrets.md)

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

@@ -368,6 +368,8 @@
         href: linter-rule-no-loc-expr-outside-params.md
       - name: No unnecessary dependsOn entries
         href: linter-rule-no-unnecessary-dependson.md
+      - name: No unused existing resources
+        href: linter-rule-no-unused-existing-resources.md
       - name: No unused parameters
         href: linter-rule-no-unused-parameters.md
       - name: No unused variables