Add arm-resource-required-operations linter rule

.chronus/changes/arm-resource-required-operations-2026-5-5-2-15-0.md

@@ -0,0 +1,8 @@
+---
+changeKind: feature
+packages:
+  - "@azure-tools/typespec-azure-resource-manager"
+  - "@azure-tools/typespec-azure-rulesets"
+---
+
+Add new `arm-resource-required-operations` linting rule that ensures every ARM resource declares the complete set of required lifecycle and list operations (singleton-aware; complements`no-resource-delete-operation`).

packages/samples/specs/resource-manager/legacy/optional-body/main.tsp

@@ -43,4 +43,5 @@ interface Widgets {
   >;
   delete is ArmResourceDeleteWithoutOkAsync<Widget>;
   list is ArmResourceListByParent<Widget>;
+  listBySubscription is ArmListBySubscription<Widget>;
 }

packages/samples/specs/resource-manager/legacy/rename-operations/main.tsp

@@ -56,4 +56,5 @@ interface Widgets {
   @Azure.ResourceManager.Legacy.renamePathParameter("widgetName", "resourceGroupName")
   delete is ArmResourceDeleteWithoutOkAsync<Widget>;
   list is ArmResourceListByParent<Widget>;
+  listBySubscription is ArmListBySubscription<Widget>;
 }

packages/samples/specs/resource-manager/legacy/static-routes/main.tsp

@@ -117,6 +117,7 @@ alias BaseParams2 = {
 };
 
 /** Subscription operations */
+#suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-required-operations" "Legacy static-routes sample uses custom operation templates not recognized by the standard required-operations check."
 @armResourceOperations(#{ allowStaticRoutes: true })
 interface EmployeeSubscriptions {
   get is EmplOps.Read<Employee>;

packages/samples/test/output/azure/resource-manager/legacy/optional-body/@azure-tools/typespec-autorest/2025-01-01-preview/openapi.json

@@ -77,6 +77,40 @@
         }
       }
     },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.OptionalBody/widgets": {
+      "get": {
+        "operationId": "Widgets_ListBySubscription",
+        "tags": [
+          "Widgets"
+        ],
+        "description": "List Widget resources by subscription ID",
+        "parameters": [
+          {
+            "$ref": "../../../../../../../../../specs/resource-manager/common-types/v5/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../../../../../specs/resource-manager/common-types/v5/types.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Azure operation completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/WidgetListResult"
+            }
+          },
+          "default": {
+            "description": "An unexpected error response.",
+            "schema": {
+              "$ref": "../../../../../../../../../specs/resource-manager/common-types/v5/types.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
     "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OptionalBody/widgets": {
       "get": {
         "operationId": "Widgets_List",

packages/samples/test/output/azure/resource-manager/legacy/rename-operations/@azure-tools/typespec-autorest/2025-01-01-preview/openapi.json

@@ -77,6 +77,40 @@
         }
       }
     },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.RenamedOperations/widgets": {
+      "get": {
+        "operationId": "Widgets_ListBySubscription",
+        "tags": [
+          "Widgets"
+        ],
+        "description": "List Widget resources by subscription ID",
+        "parameters": [
+          {
+            "$ref": "../../../../../../../../../specs/resource-manager/common-types/v5/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../../../../../specs/resource-manager/common-types/v5/types.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Azure operation completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/WidgetListResult"
+            }
+          },
+          "default": {
+            "description": "An unexpected error response.",
+            "schema": {
+              "$ref": "../../../../../../../../../specs/resource-manager/common-types/v5/types.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
     "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RenamedOperations/widgets": {
       "get": {
         "operationId": "Widgets_List",

packages/typespec-azure-resource-manager/README.md

@@ -43,6 +43,7 @@ Available ruleSets:
 | [`@azure-tools/typespec-azure-resource-manager/arm-resource-operation-response`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-resource-operation-response)                     | [RPC 008]: PUT, GET, PATCH & LIST must return the same resource schema.                                                                                                                                                                               |
 | [`@azure-tools/typespec-azure-resource-manager/arm-resource-path-segment-invalid-chars`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-resource-path-segment-invalid-chars)     | Arm resource name must contain only alphanumeric characters.                                                                                                                                                                                          |
 | [`@azure-tools/typespec-azure-resource-manager/arm-resource-provisioning-state`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-resource-provisioning-state)                     | Check for properly configured provisioningState property.                                                                                                                                                                                             |
+| [`@azure-tools/typespec-azure-resource-manager/arm-resource-required-operations`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-resource-required-operations)                   | ARM resources must define their required operations: tracked resources need the full lifecycle and list set, other resources need a read, and any resource defining createOrUpdate must also define delete.                                           |
 | [`@azure-tools/typespec-azure-resource-manager/version-progression`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/version-progression)                                             | Validate that ARM service versions all use unique dates and are declared in strictly increasing chronological order.                                                                                                                                  |
 | [`@azure-tools/typespec-azure-resource-manager/arm-custom-resource-no-key`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-custom-resource-no-key)                               | Validate that custom resource contains a key property.                                                                                                                                                                                                |
 | [`@azure-tools/typespec-azure-resource-manager/arm-custom-resource-usage-discourage`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-custom-resource-usage-discourage)           | Verify the usage of @customAzureResource decorator.                                                                                                                                                                                                   |

packages/typespec-azure-resource-manager/src/linter.ts

@@ -19,6 +19,7 @@ import { armResourceOperationsRule } from "./rules/arm-resource-operation-respon
 import { patchOperationsRule } from "./rules/arm-resource-patch.js";
 import { armResourcePathInvalidCharsRule } from "./rules/arm-resource-path-invalid-chars.js";
 import { armResourceProvisioningStateRule } from "./rules/arm-resource-provisioning-state-rule.js";
+import { armResourceRequiredOperationsRule } from "./rules/arm-resource-required-operations.js";
 import { beyondNestingRule } from "./rules/beyond-nesting-levels.js";
 import { coreOperationsRule } from "./rules/core-operations.js";
 import { envelopePropertiesRules } from "./rules/envelope-properties.js";
@@ -52,6 +53,7 @@ const rules = [
   armResourceOperationsRule,
   armResourcePathInvalidCharsRule,
   armResourceProvisioningStateRule,
+  armResourceRequiredOperationsRule,
   versionProgressionRule,
   armCustomResourceNoKey,
   armCustomResourceUsageDiscourage,