new linter rule - use recent api versions

Author: mumian

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: 09/23/2022
+ms.date: 09/30/2022
 ---
 
 # Add linter settings in the Bicep config file
@@ -89,6 +89,9 @@ The following example shows the rules that are available for configuration.
         "use-protectedsettings-for-commandtoexecute-secrets": {
           "level": "warning"
         },
+        "use-recent-api-versions": {
+          "level": "warning"
+        },
         "use-resource-id-functions": {
           "level": "warning"
         },

articles/azure-resource-manager/bicep/linter-rule-use-recent-api-versions.md

@@ -0,0 +1,27 @@
+---
+title: Linter rule - use recent API versions
+description: Linter rule - use recent API versions
+ms.topic: conceptual
+ms.date: 09/30/2022
+---
+
+# Linter rule - use recent API versions
+
+This rule looks for resource API versions that are older than 730 days. It is recommended to use the most recent API versions.
+
+> [!NOTE]
+> This rule is off by default, change the level in [bicepconfig.json](./bicep-config-linter.md) to enable it.
+
+## Linter rule code
+
+Use the following value in the [Bicep configuration file](bicep-config-linter.md) to customize rule settings:
+
+`use-recent-api-versions`
+
+## Solution
+
+Use the most recent API version, or one that is no older than 730 days.
+
+## 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: 9/23/2022
+ms.date: 9/30/2022
 ---
 
 # Use Bicep linter
@@ -39,6 +39,7 @@ The default set of linter rules is minimal and taken from [arm-ttk test cases](.
 - [secure-secrets-in-params](./linter-rule-secure-secrets-in-parameters.md)
 - [simplify-interpolation](./linter-rule-simplify-interpolation.md)
 - [use-protectedsettings-for-commandtoexecute-secrets](./linter-rule-use-protectedsettings-for-commandtoexecute-secrets.md)
+- [use-recent-api-versions](./linter-rule-use-recent-api-versions.md)
 - [use-resource-id-functions](./linter-rule-use-resource-id-functions.md)
 - [use-stable-resource-identifiers](./linter-rule-use-stable-resource-identifier.md)
 - [use-stable-vm-image](./linter-rule-use-stable-vm-image.md)

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

@@ -432,6 +432,8 @@
         href: linter-rule-simplify-interpolation.md
       - name: Use explicit values for module location parameters
         href: linter-rule-explicit-values-for-loc-params.md
+      - name: use recent API versions
+        href: linter-rule-use-recent-api-versions.md
       - name: use resource ID functions
         href: linter-rule-use-resource-id-functions.md
       - name: Use stable resource identifier