@azure-tools/typespec-azure-resource-manager 0.58.0-dev.3 → 0.58.0-dev.5

package/lib/Legacy/decorator.tsp

@@ -2,6 +2,16 @@ using Reflection;
 
 namespace Azure.ResourceManager.Legacy;
 
+/**
+ * Route options for an operation
+ */
+model ArmOperationOptions {
+  /** Should a static route be used */
+  useStaticRoute?: boolean;
+
+  /** The status route for operations to use */
+  route?: string;
+}
 /**
  * This decorator is used on resources that do not satisfy the definition of a resource
  * but need to be identified as such.
@@ -13,3 +23,11 @@ extern dec customAzureResource(target: Model);
  * @param jsonRef - External reference(e.g. "../../common.json#/definitions/Foo")
  */
 extern dec externalTypeRef(entity: Model | ModelProperty, jsonRef: valueof string);
+
+/**
+ * Signifies that an operation is an Azure Resource Manager operation
+ * and optionally associates the operation with a route template.
+ * @param target The operation to associate the model with
+ * @param route Optional route to associate with the operation
+ */
+extern dec armOperationRoute(target: Operation, route?: valueof ArmOperationOptions);

package/lib/Legacy/extension.tsp

@@ -27,8 +27,9 @@ interface ExtensionOperations<
    * @template Response Optional. The success response(s) for the PUT operation
    * @template OptionalRequestBody Optional. Indicates whether the request body is optional
    * @template ErrorType Optional. The error response, if non-standard.
+   * @template OperationOptions Optional. The route options for the operation.
    */
-  @autoRoute
+  @armOperationRoute(OperationOptions)
   @doc("Create a {name}", Resource)
   @armResourceCreateOrUpdate(Resource)
   @Azure.Core.Foundations.Private.defaultFinalStateVia(#["location", "azure-async-operation"])
@@ -43,7 +44,8 @@ interface ExtensionOperations<
       LroHeaders
     >,
     OptionalRequestBody extends valueof boolean = false,
-    ErrorType extends {} = ErrorResponse
+    ErrorType extends {} = ErrorResponse,
+    OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false }
   >(
     ...TargetParameters,
     ...ExtensionInstanceParameters,
@@ -58,9 +60,10 @@ interface ExtensionOperations<
    * @template Response Optional. The success response(s) for the PUT operation
    * @template OptionalRequestBody Optional. Indicates whether the request body is optional
    * @template ErrorType Optional. The error response, if non-standard.
+   * @template OperationOptions Optional. The route options for the operation.
    */
   #suppress "@azure-tools/typespec-azure-core/no-private-usage"
-  @autoRoute
+  @armOperationRoute(OperationOptions)
   @doc("Create a {name}", Resource)
   @armResourceCreateOrUpdate(Resource)
   @put
@@ -69,7 +72,8 @@ interface ExtensionOperations<
     Parameters extends {} = {},
     Response extends {} = ArmResourceUpdatedResponse<Resource> | ArmResourceCreatedSyncResponse<Resource>,
     OptionalRequestBody extends valueof boolean = false,
-    ErrorType extends {} = ErrorResponse
+    ErrorType extends {} = ErrorResponse,
+    OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false }
   >(
     ...TargetParameters,
     ...ExtensionInstanceParameters,
@@ -86,8 +90,9 @@ interface ExtensionOperations<
    * @template Response Optional. The success response(s) for the PATCH operation
    * @template OptionalRequestBody Optional. Indicates whether the request body is optional
    * @template ErrorType Optional. The error response, if non-standard.
+   * @template OperationOptions Optional. The route options for the operation.
    */
-  @autoRoute
+  @armOperationRoute(OperationOptions)
   @doc("Update a {name}", Resource)
   @armResourceUpdate(Resource)
   @patch(#{ implicitOptionality: false })
@@ -106,7 +111,8 @@ interface ExtensionOperations<
       LroHeaders
     >,
     OptionalRequestBody extends valueof boolean = false,
-    ErrorType extends {} = ErrorResponse
+    ErrorType extends {} = ErrorResponse,
+    OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false }
   >(
     ...TargetParameters,
     ...ExtensionInstanceParameters,
@@ -122,8 +128,9 @@ interface ExtensionOperations<
    * @template Response Optional. The success response(s) for the PATCH operation
    * @template OptionalRequestBody Optional. Indicates whether the request body is optional
    * @template ErrorType Optional. The error response, if non-standard.
+   * @template OperationOptions Optional. The route options for the operation.
    */
-  @autoRoute
+  @armOperationRoute(OperationOptions)
   @doc("Update a {name}", Resource)
   @armResourceUpdate(Resource)
   @patch(#{ implicitOptionality: false })
@@ -133,7 +140,8 @@ interface ExtensionOperations<
     Parameters extends {} = {},
     Response extends {} = ArmResponse<Resource>,
     OptionalRequestBody extends valueof boolean = false,
-    ErrorType extends {} = ErrorResponse
+    ErrorType extends {} = ErrorResponse,
+    OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false }
   >(
     ...TargetParameters,
     ...ExtensionInstanceParameters,
@@ -148,9 +156,10 @@ interface ExtensionOperations<
    * @template Parameters Optional. Additional parameters after the path parameters
    * @template Response Optional. The success response(s) for the delete operation
    * @template ErrorType Optional. The error response, if non-standard.
+   * @template OperationOptions Optional. The route options for the operation.
    */
   #suppress "@azure-tools/typespec-azure-core/no-response-body" "Valid"
-  @autoRoute
+  @armOperationRoute(OperationOptions)
   @doc("Delete a {name}", Resource)
   @delete
   @deletesResource(Resource)
@@ -161,7 +170,8 @@ interface ExtensionOperations<
       Azure.Core.Foundations.RetryAfterHeader,
     Parameters extends {} = {},
     Response extends {} = ArmDeleteAcceptedLroResponse<LroHeaders> | ArmDeletedNoContentResponse,
-    ErrorType extends {} = ErrorResponse
+    ErrorType extends {} = ErrorResponse,
+    OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false }
   >(...TargetParameters, ...ExtensionInstanceParameters, ...Parameters): Response | ErrorType;
 
   /**
@@ -170,9 +180,10 @@ interface ExtensionOperations<
    * @template Parameters Optional. Additional parameters after the path parameters
    * @template Response Optional. The success response(s) for the delete operation
    * @template ErrorType Optional. The error response, if non-standard.
+   * @template OperationOptions Optional. The route options for the operation.
    */
   #suppress "@azure-tools/typespec-azure-core/no-response-body" "Valid"
-  @autoRoute
+  @armOperationRoute(OperationOptions)
   @doc("Delete a {name}", Resource)
   @delete
   @deletesResource(Resource)
@@ -181,7 +192,8 @@ interface ExtensionOperations<
     Resource extends Foundations.SimpleResource,
     Parameters extends {} = {},
     Response extends {} = ArmDeletedResponse | ArmDeletedNoContentResponse,
-    ErrorType extends {} = ErrorResponse
+    ErrorType extends {} = ErrorResponse,
+    OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false }
   >(...TargetParameters, ...ExtensionInstanceParameters, ...Parameters): Response | ErrorType;
 
   /**
@@ -190,8 +202,9 @@ interface ExtensionOperations<
    * @template Parameters Optional. Additional parameters after the path parameters
    * @template Response Optional. The success response for a get operation.
    * @template ErrorType Optional. The error response, if non-standard.
+   * @template OperationOptions Optional. The route options for the operation.
    */
-  @autoRoute
+  @armOperationRoute(OperationOptions)
   @doc("Get a {name}", Resource)
   @get
   @readsResource(Resource)
@@ -200,24 +213,27 @@ interface ExtensionOperations<
     Resource extends Foundations.SimpleResource,
     Parameters extends {} = {},
     Response extends {} = ArmResponse<Resource>,
-    ErrorType extends {} = ErrorResponse
+    ErrorType extends {} = ErrorResponse,
+    OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false }
   >(...TargetParameters, ...ExtensionInstanceParameters, ...Parameters): Response | ErrorType;
 
   /**
    * Check a resource's existence via HEAD operation
-   * * @template Resource The resource being checked
+   * @template Resource The resource being checked
    * @template Parameters Optional. Additional parameters after the path parameters
    * @template Response Optional. The success response for a head operation (by default NoContent or NotFound response).
    * @template ErrorType Optional. The error response, if non-standard.
+   * @template OperationOptions Optional. The route options for the operation.
    */
-  @autoRoute
+  @armOperationRoute(OperationOptions)
   @doc("Check for the existence of a {name}", Resource)
   @head
   CheckExistence<
     Resource extends Foundations.SimpleResource,
     Parameters extends {} = {},
     Response extends {} = ArmResourceExistsResponse | ArmResourceNotFoundResponse,
-    ErrorType extends {} = ErrorResponse
+    ErrorType extends {} = ErrorResponse,
+    OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false }
   > is Foundations.ArmReadOperation<
     TargetParameters & ExtensionInstanceParameters & Parameters,
     Response,
@@ -229,8 +245,9 @@ interface ExtensionOperations<
    * @template Parameters Optional. Additional parameters after the path parameters
    * @template Response Optional. The response returned by the list
    * @template ErrorType Optional. The error response, if non-standard.
+   * @template OperationOptions Optional. The route options for the operation.
    */
-  @autoRoute
+  @armOperationRoute(OperationOptions)
   @doc("List a {name}", Resource)
   @get
   @listsResource(Resource)
@@ -239,7 +256,8 @@ interface ExtensionOperations<
     Resource extends Foundations.SimpleResource,
     Parameters extends {} = {},
     Response extends {} = ArmResponse<ResourceListResult<Resource>>,
-    ErrorType extends {} = ErrorResponse
+    ErrorType extends {} = ErrorResponse,
+    OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false }
   >(...TargetParameters, ...ExtensionParentParameters, ...Parameters): Response | ErrorType;
 
   /**
@@ -250,9 +268,10 @@ interface ExtensionOperations<
    * @template Parameters Optional. Additional parameters after the path parameters
    * @template OptionalRequestBody Optional. Indicates whether the request body is optional
    * @template ErrorType Optional. The error response, if non-standard.
+   * @template OperationOptions Optional. The route options for the operation.
    */
   @doc("")
-  @autoRoute
+  @armOperationRoute(OperationOptions)
   @armResourceAction(Resource)
   @Private.enforceConstraint(Resource, Foundations.Resource)
   @post
@@ -263,7 +282,8 @@ interface ExtensionOperations<
     Response extends TypeSpec.Reflection.Model | void,
     Parameters extends {} = {},
     OptionalRequestBody extends valueof boolean = false,
-    ErrorType extends {} = ErrorResponse
+    ErrorType extends {} = ErrorResponse,
+    OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false }
   >(
     ...TargetParameters,
     ...ExtensionInstanceParameters,
@@ -284,10 +304,11 @@ interface ExtensionOperations<
    * @template Parameters Optional. Additional parameters after the path parameters
    * @template OptionalRequestBody Optional. Indicates whether the request body is optional
    * @template ErrorType Optional. The error response, if non-standard.
+   * @template OperationOptions Optional. The route options for the operation.
    */
   #suppress "@azure-tools/typespec-azure-core/no-response-body" "ARM"
   @doc("")
-  @autoRoute
+  @armOperationRoute(OperationOptions)
   @armResourceAction(Resource)
   @Private.enforceConstraint(Resource, Foundations.Resource)
   @post
@@ -308,7 +329,8 @@ interface ExtensionOperations<
       LroHeaders
     > | Result,
     OptionalRequestBody extends valueof boolean = false,
-    ErrorType extends {} = ErrorResponse
+    ErrorType extends {} = ErrorResponse,
+    OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false }
   >(
     ...TargetParameters,
     ...ExtensionInstanceParameters,

package/lib/Legacy/operations.tsp

@@ -15,11 +15,26 @@ using Rest;
  * @template ResourceTypeParameter The path parameter for the resource name
  * @template ErrorType Optional. The type of error models used in operations created form this template
  */
-@doc("")
 interface LegacyOperations<
   ParentParameters extends {},
   ResourceTypeParameter extends {},
   ErrorType extends {} = ErrorResponse
+> extends RoutedOperations<ParentParameters, ResourceTypeParameter, ErrorType> {}
+
+/**
+ * An operation template used to build resource operations in which the same resource type
+ * is accessible at multiple, fixed resource paths. Can be used with static routes.
+ * @template ParentParameters The path parameters for the resource parent
+ * @template ResourceTypeParameter The path parameter for the resource name
+ * @template ErrorType Optional. The type of error models used in operations created form this template
+ * @template ResourceRoute Optional. The resource route to use for operations in the interface.
+ */
+@doc("")
+interface RoutedOperations<
+  ParentParameters extends {},
+  ResourceTypeParameter extends {},
+  ErrorType extends {} = ErrorResponse,
+  ResourceRoute extends valueof ArmOperationOptions = #{ useStaticRoute: false }
 > {
   /**
    * A long-running resource CreateOrUpdate (PUT)
@@ -28,9 +43,11 @@ interface LegacyOperations<
    * @template Parameters Optional. Additional parameters after the path parameters
    * @template Response Optional. The success response(s) for the PUT operation
    * @template OptionalRequestBody Optional. Indicates whether the request body is optional
+   * @template OverrideErrorType Optional. The error response, if non-standard.
+   * @template OverrideRouteOptions Optional. The route options for the operation.
    */
-  @autoRoute
   @doc("Create a {name}", Resource)
+  @armOperationRoute(OverrideRouteOptions)
   @armResourceCreateOrUpdate(Resource)
   @Private.armUpdateProviderNamespace
   @Azure.Core.Foundations.Private.defaultFinalStateVia(#["location", "azure-async-operation"])
@@ -44,13 +61,15 @@ interface LegacyOperations<
       Resource,
       LroHeaders
     >,
-    OptionalRequestBody extends valueof boolean = false
+    OptionalRequestBody extends valueof boolean = false,
+    OverrideErrorType extends {} = ErrorType,
+    OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute
   >(
     ...ParentParameters,
     ...ResourceTypeParameter,
     ...Parameters,
     @doc("Resource create parameters.") @armBodyRoot(OptionalRequestBody) resource: Resource,
-  ): Response | ErrorType;
+  ): Response | OverrideErrorType;
 
   /**
    * A synchronous resource CreateOrUpdate (PUT)
@@ -58,9 +77,11 @@ interface LegacyOperations<
    * @template Parameters Optional. Additional parameters after the path parameters
    * @template Response Optional. The success response(s) for the PUT operation
    * @template OptionalRequestBody Optional. Indicates whether the request body is optional
+   * @template OverrideErrorType Optional. The error response, if non-standard.
+   * @template OverrideRouteOptions Optional. The route options for the operation.
    */
   #suppress "@azure-tools/typespec-azure-core/no-private-usage"
-  @autoRoute
+  @armOperationRoute(OverrideRouteOptions)
   @doc("Create a {name}", Resource)
   @armResourceCreateOrUpdate(Resource)
   @Private.armUpdateProviderNamespace
@@ -69,13 +90,15 @@ interface LegacyOperations<
     Resource extends Foundations.SimpleResource,
     Parameters extends {} = {},
     Response extends {} = ArmResourceUpdatedResponse<Resource> | ArmResourceCreatedSyncResponse<Resource>,
-    OptionalRequestBody extends valueof boolean = false
+    OptionalRequestBody extends valueof boolean = false,
+    OverrideErrorType extends {} = ErrorType,
+    OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute
   >(
     ...ParentParameters,
     ...ResourceTypeParameter,
     ...Parameters,
     @doc("Resource create parameters.") @armBodyRoot(OptionalRequestBody) resource: Resource,
-  ): Response | ErrorType;
+  ): Response | OverrideErrorType;
 
   /**
    * A long-running resource Update (PATCH)
@@ -85,9 +108,11 @@ interface LegacyOperations<
    * @template Parameters Optional. Additional parameters after the path parameters
    * @template Response Optional. The success response(s) for the PATCH operation
    * @template OptionalRequestBody Optional. Indicates whether the request body is optional
+   * @template OverrideErrorType Optional. The error response, if non-standard.
+   * @template OverrideRouteOptions Optional. The route options for the operation.
    */
-  @autoRoute
   @doc("Update a {name}", Resource)
+  @armOperationRoute(OverrideRouteOptions)
   @armResourceUpdate(Resource)
   @Private.armUpdateProviderNamespace
   @patch(#{ implicitOptionality: false })
@@ -105,13 +130,15 @@ interface LegacyOperations<
       "Resource update request accepted.",
       LroHeaders
     >,
-    OptionalRequestBody extends valueof boolean = false
+    OptionalRequestBody extends valueof boolean = false,
+    OverrideErrorType extends {} = ErrorType,
+    OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute
   >(
     ...ParentParameters,
     ...ResourceTypeParameter,
     ...Parameters,
     @doc("Resource create parameters.") @armBodyRoot(OptionalRequestBody) properties: PatchModel,
-  ): Response | ErrorType;
+  ): Response | OverrideErrorType;
 
   /**
    * A synchronous resource Update (PATCH)
@@ -120,9 +147,11 @@ interface LegacyOperations<
    * @template Parameters Optional. Additional parameters after the path parameters
    * @template Response Optional. The success response(s) for the PATCH operation
    * @template OptionalRequestBody Optional. Indicates whether the request body is optional
+   * @template OverrideErrorType Optional. The error response, if non-standard.
+   * @template OverrideRouteOptions Optional. The route options for the operation.
    */
-  @autoRoute
   @doc("Update a {name}", Resource)
+  @armOperationRoute(OverrideRouteOptions)
   @armResourceUpdate(Resource)
   @Private.armUpdateProviderNamespace
   @patch(#{ implicitOptionality: false })
@@ -131,13 +160,15 @@ interface LegacyOperations<
     PatchModel extends {} = Azure.ResourceManager.Foundations.TagsUpdateModel<Resource>,
     Parameters extends {} = {},
     Response extends {} = ArmResponse<Resource>,
-    OptionalRequestBody extends valueof boolean = false
+    OptionalRequestBody extends valueof boolean = false,
+    OverrideErrorType extends {} = ErrorType,
+    OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute
   >(
     ...ParentParameters,
     ...ResourceTypeParameter,
     ...Parameters,
     @doc("Resource create parameters.") @armBodyRoot(OptionalRequestBody) properties: PatchModel,
-  ): Response | ErrorType;
+  ): Response | OverrideErrorType;
 
   /**
    * Delete a resource asynchronously
@@ -145,10 +176,12 @@ interface LegacyOperations<
    * @template LroHeaders The lro headers for the operation
    * @template Parameters Optional. Additional parameters after the path parameters
    * @template Response Optional. The success response(s) for the delete operation
+   * @template OverrideErrorType Optional. The error response, if non-standard.
+   * @template OverrideRouteOptions Optional. The route options for the operation.
    */
   #suppress "@azure-tools/typespec-azure-core/no-response-body" "Valid"
-  @autoRoute
   @doc("Delete a {name}", Resource)
+  @armOperationRoute(OverrideRouteOptions)
   @delete
   @deletesResource(Resource)
   @Private.armUpdateProviderNamespace
@@ -158,18 +191,22 @@ interface LegacyOperations<
     LroHeaders extends TypeSpec.Reflection.Model = ArmLroLocationHeader &
       Azure.Core.Foundations.RetryAfterHeader,
     Parameters extends {} = {},
-    Response extends {} = ArmDeleteAcceptedLroResponse<LroHeaders> | ArmDeletedNoContentResponse
-  >(...ParentParameters, ...ResourceTypeParameter, ...Parameters): Response | ErrorType;
+    Response extends {} = ArmDeleteAcceptedLroResponse<LroHeaders> | ArmDeletedNoContentResponse,
+    OverrideErrorType extends {} = ErrorType,
+    OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute
+  >(...ParentParameters, ...ResourceTypeParameter, ...Parameters): Response | OverrideErrorType;
 
   /**
    * Delete a resource synchronously
    * @template Resource The resource being deleted
    * @template Parameters Optional. Additional parameters after the path parameters
    * @template Response Optional. The success response(s) for the delete operation
+   * @template OverrideErrorType Optional. The error response, if non-standard.
+   * @template OverrideRouteOptions Optional. The route options for the operation.
    */
   #suppress "@azure-tools/typespec-azure-core/no-response-body" "Valid"
-  @autoRoute
   @doc("Delete a {name}", Resource)
+  @armOperationRoute(OverrideRouteOptions)
   @delete
   @deletesResource(Resource)
   @armResourceDelete(Resource)
@@ -177,17 +214,21 @@ interface LegacyOperations<
   DeleteSync<
     Resource extends Foundations.SimpleResource,
     Parameters extends {} = {},
-    Response extends {} = ArmDeletedResponse | ArmDeletedNoContentResponse
-  >(...ParentParameters, ...ResourceTypeParameter, ...Parameters): Response | ErrorType;
+    Response extends {} = ArmDeletedResponse | ArmDeletedNoContentResponse,
+    OverrideErrorType extends {} = ErrorType,
+    OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute
+  >(...ParentParameters, ...ResourceTypeParameter, ...Parameters): Response | OverrideErrorType;
 
   /**
    * @dev Get a resource
    * @template Resource The resource being read
    * @template Parameters Optional. Additional parameters after the path parameters
    * @template Response Optional. The success response for a get operation.
+   * @template OverrideErrorType Optional. The error response, if non-standard.
+   * @template OverrideRouteOptions Optional. The route options for the operation.
    */
-  @autoRoute
   @doc("Get a {name}", Resource)
+  @armOperationRoute(OverrideRouteOptions)
   @get
   @readsResource(Resource)
   @armResourceRead(Resource)
@@ -195,27 +236,33 @@ interface LegacyOperations<
   Read<
     Resource extends Foundations.SimpleResource,
     Parameters extends {} = {},
-    Response extends {} = ArmResponse<Resource>
-  >(...ParentParameters, ...ResourceTypeParameter, ...Parameters): Response | ErrorType;
+    Response extends {} = ArmResponse<Resource>,
+    OverrideErrorType extends {} = ErrorType,
+    OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute
+  >(...ParentParameters, ...ResourceTypeParameter, ...Parameters): Response | OverrideErrorType;
 
   /**
    * Check a resource's existence via HEAD operation
    * @template Resource The resource being checked
    * @template Parameters Optional. Additional parameters after the path parameters
    * @template Response Optional. The success response for a head operation (by default NoContent or NotFound response).
+   * @template OverrideErrorType Optional. The error response, if non-standard.
+   * @template OverrideRouteOptions Optional. The route options for the operation.
    */
-  @autoRoute
+  @armOperationRoute(OverrideRouteOptions)
   @doc("Check for the existence of a {name}", Resource)
   @Private.armUpdateProviderNamespace
   @head
   CheckExistence<
     Resource extends Foundations.SimpleResource,
     Parameters extends {} = {},
-    Response extends {} = ArmResourceExistsResponse | ArmResourceNotFoundResponse
+    Response extends {} = ArmResourceExistsResponse | ArmResourceNotFoundResponse,
+    OverrideErrorType extends {} = ErrorType,
+    OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute
   > is Foundations.ArmReadOperation<
     ParentParameters & ResourceTypeParameter & Parameters,
     Response,
-    ErrorType
+    OverrideErrorType
   >;
 
   /**
@@ -223,18 +270,22 @@ interface LegacyOperations<
    * @template Resource The resource being listed
    * @template Parameters Optional. Additional parameters after the path parameters
    * @template Response Optional. The response returned by the list
+   * @template OverrideErrorType Optional. The error response, if non-standard.
+   * @template OverrideRouteOptions Optional. The route options for the operation.
    */
-  @autoRoute
   @doc("List a {name}", Resource)
   @get
   @listsResource(Resource)
   @segmentOf(Resource)
+  @armOperationRoute(OverrideRouteOptions)
   @armResourceList(Resource)
   @Private.armUpdateProviderNamespace
   List<
     Resource extends Foundations.SimpleResource,
     Parameters extends {} = {},
-    Response extends {} = ArmResponse<ResourceListResult<Resource>>
+    Response extends {} = ArmResponse<ResourceListResult<Resource>>,
+    OverrideErrorType extends {} = ErrorType,
+    OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute
   >(...ParentParameters, ...Parameters): Response | ErrorType;
 
   /**
@@ -244,10 +295,12 @@ interface LegacyOperations<
    * @template Response The response model for the action
    * @template Parameters Optional. Additional parameters after the path parameters
    * @template OptionalRequestBody Optional. Indicates whether the request body is optional
+   * @template OverrideErrorType Optional. The error response, if non-standard.
+   * @template OverrideRouteOptions Optional. The route options for the operation.
    */
   @doc("")
-  @autoRoute
   @armResourceAction(Resource)
+  @armOperationRoute(OverrideRouteOptions)
   @Private.enforceConstraint(Resource, Foundations.Resource)
   @post
   @Private.armUpdateProviderNamespace
@@ -257,7 +310,9 @@ interface LegacyOperations<
     Request extends TypeSpec.Reflection.Model | void,
     Response extends TypeSpec.Reflection.Model | void,
     Parameters extends {} = {},
-    OptionalRequestBody extends valueof boolean = false
+    OptionalRequestBody extends valueof boolean = false,
+    OverrideErrorType extends {} = ErrorType,
+    OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute
   >(
     ...ParentParameters,
     ...ResourceTypeParameter,
@@ -266,7 +321,7 @@ interface LegacyOperations<
     @doc("The content of the action request")
     @armBodyRoot(OptionalRequestBody)
     body: Request,
-  ): Response | ErrorType;
+  ): Response | OverrideErrorType;
 
   /**
    * A long-running resource action.
@@ -277,11 +332,13 @@ interface LegacyOperations<
    * @template Response The union of successful responses for the action
    * @template Parameters Optional. Additional parameters after the path parameters
    * @template OptionalRequestBody Optional. Indicates whether the request body is optional
+   * @template OverrideErrorType Optional. The error response, if non-standard.
+   * @template OverrideRouteOptions Optional. The route options for the operation.
    */
   #suppress "@azure-tools/typespec-azure-core/no-response-body" "ARM"
   @doc("")
-  @autoRoute
   @armResourceAction(Resource)
+  @armOperationRoute(OverrideRouteOptions)
   @Private.enforceConstraint(Resource, Foundations.Resource)
   @Private.armUpdateProviderNamespace
   @post
@@ -301,7 +358,9 @@ interface LegacyOperations<
       "Resource operation accepted.",
       LroHeaders
     > | Result,
-    OptionalRequestBody extends valueof boolean = false
+    OptionalRequestBody extends valueof boolean = false,
+    OverrideErrorType extends {} = ErrorType,
+    OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute
   >(
     ...ParentParameters,
     ...ResourceTypeParameter,
@@ -310,7 +369,7 @@ interface LegacyOperations<
     @doc("The content of the action request")
     @armBodyRoot(OptionalRequestBody)
     body: Request,
-  ): Response | ErrorType;
+  ): Response | OverrideErrorType;
 }
 /**
  * @dev DEPRECATED: Use ProviderParameter instead. Get the provider namespace key-value pair

package/lib/decorators.tsp

@@ -152,16 +152,48 @@ extern dec armResourceList(target: Operation, resourceType: Model);
 
 /**
  * This decorator is used to identify interfaces containing resource operations.
- * When applied, it marks the interface with the `@autoRoute` decorator so that
+ * By default, it marks the interface with the `@autoRoute` decorator so that
  * all of its contained operations will have their routes generated
  * automatically.
  *
- * It also adds a `@tag` decorator bearing the name of the interface so that all
+ * The decorator also adds a `@tag` decorator bearing the name of the interface so that all
  * of the operations will be grouped based on the interface name in generated
  * clients.
- * @param _ DEPRECATED
+ *
+ * The optional `resourceOperationOptions` parameter provides additional options.
+ * `allowStaticRoutes` turns off autoRout for the interface, so individual operations can
+ * choose static (`@route`) or automatic (`@autoRoute`) routing.
+ *
+ * `resourceType: Model` specifies the resource type for the operations in the interface
+ *
+ * `omitTags: true`: turns off the default tagging of operations in the interface, so that individual operations must be
+ * individually tagged
+ *
+ *
+ * @param resourceOperationOptions Options for routing the operations in the interface and associating them with a specific resource
  */
-extern dec armResourceOperations(target: Interface, _?: unknown);
+extern dec armResourceOperations(
+  target: Interface,
+  resourceOperationOptions?: (valueof ResourceOperationOptions) | unknown
+);
+
+/** Interface-level operation options */
+model ResourceOperationOptions {
+  /**
+   * The resource type for the operations in the interface
+   */
+  resourceType?: Model;
+
+  /**
+   * If true, turns off autoRoute for the interface, so individual operations can choose static (`@route`) or automatic (`@autoRoute`) routing.
+   */
+  allowStaticRoutes?: boolean;
+
+  /**
+   * If true, turns off the default tagging of operations in the interface, so that individual operations must be individually tagged
+   */
+  omitTags?: boolean;
+}
 
 /**
  * This decorator is used either on a namespace or a version enum value to indicate
@@ -189,7 +221,7 @@ extern dec armVirtualResource(target: Model, provider?: valueof string);
  */
 extern dec resourceBaseType(
   target: Model,
-  baseType: "Tenant" | "Subscription" | "ResourceGroup" | "Location" | "Extension"
+  baseTypeIt: "Tenant" | "Subscription" | "ResourceGroup" | "Location" | "Extension"
 );
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure-tools/typespec-azure-resource-manager",
-  "version": "0.58.0-dev.3",
+  "version": "0.58.0-dev.5",
   "author": "Microsoft Corporation",
   "description": "TypeSpec Azure Resource Manager library",
   "homepage": "https://azure.github.io/typespec-azure",