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

package/lib/legacy-types/extension.tsp

@@ -12,12 +12,14 @@ using Rest;
  * @template TargetParameters The path parameters for the target resource
  * @template ExtensionParentParameters Parent parameters of the extension resource
  * @template ExtensionInstanceParameters The instance parameters of the extension resource
+ * @template ResourceName Optional. The name of the resource type at this scope in clients.
  */
 @doc("")
 interface ExtensionOperations<
   TargetParameters extends {},
   ExtensionParentParameters extends {},
-  ExtensionInstanceParameters extends {}
+  ExtensionInstanceParameters extends {},
+  ResourceName extends valueof string = string("")
 > {
   /**
    * A long-running resource CreateOrUpdate (PUT)
@@ -29,10 +31,11 @@ interface ExtensionOperations<
    * @template ErrorType Optional. The error response, if non-standard.
    * @template OperationOptions Optional. The route options for the operation.
    * @template Request Optional. The request body for the createOrUpdate operation.
+   * @template OverrideResourceName Optional. The name of the resource type at this scope in clients.
    */
   @armOperationRoute(OperationOptions)
   @doc("Create a {name}", Resource)
-  @armResourceCreateOrUpdate(Resource)
+  @legacyExtensionResourceOperation(Resource, "createOrUpdate", OverrideResourceName)
   @Azure.Core.Foundations.Private.defaultFinalStateVia(#["location", "azure-async-operation"])
   @put
   CreateOrUpdateAsync<
@@ -47,7 +50,8 @@ interface ExtensionOperations<
     OptionalRequestBody extends valueof boolean = false,
     ErrorType extends {} = ErrorResponse,
     OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false },
-    Request extends {} | void = Resource
+    Request extends {} | void = Resource,
+    OverrideResourceName extends valueof string = "${ResourceName}"
   >(
     ...TargetParameters,
     ...ExtensionInstanceParameters,
@@ -64,11 +68,12 @@ interface ExtensionOperations<
    * @template ErrorType Optional. The error response, if non-standard.
    * @template OperationOptions Optional. The route options for the operation.
    * @template Request Optional. The request body for the createOrUpdate operation.
+   * @template OverrideResourceName Optional. The name of the resource type at this scope in clients.
    */
   #suppress "@azure-tools/typespec-azure-core/no-private-usage"
   @armOperationRoute(OperationOptions)
   @doc("Create a {name}", Resource)
-  @armResourceCreateOrUpdate(Resource)
+  @legacyExtensionResourceOperation(Resource, "createOrUpdate", OverrideResourceName)
   @put
   CreateOrUpdateSync<
     Resource extends Foundations.SimpleResource,
@@ -77,7 +82,8 @@ interface ExtensionOperations<
     OptionalRequestBody extends valueof boolean = false,
     ErrorType extends {} = ErrorResponse,
     OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false },
-    Request extends {} | void = Resource
+    Request extends {} | void = Resource,
+    OverrideResourceName extends valueof string = "${ResourceName}"
   >(
     ...TargetParameters,
     ...ExtensionInstanceParameters,
@@ -95,10 +101,11 @@ interface ExtensionOperations<
    * @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.
+   * @template OverrideResourceName Optional. The name of the resource type at this scope in clients.
    */
   @armOperationRoute(OperationOptions)
   @doc("Update a {name}", Resource)
-  @armResourceUpdate(Resource)
+  @legacyExtensionResourceOperation(Resource, "update", OverrideResourceName)
   @patch(#{ implicitOptionality: false })
   CustomPatchAsync<
     Resource extends Foundations.SimpleResource,
@@ -116,7 +123,8 @@ interface ExtensionOperations<
     >,
     OptionalRequestBody extends valueof boolean = false,
     ErrorType extends {} = ErrorResponse,
-    OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false }
+    OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false },
+    OverrideResourceName extends valueof string = "${ResourceName}"
   >(
     ...TargetParameters,
     ...ExtensionInstanceParameters,
@@ -133,10 +141,11 @@ interface ExtensionOperations<
    * @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.
+   * @template OverrideResourceName Optional. The name of the resource type at this scope in clients.
    */
   @armOperationRoute(OperationOptions)
   @doc("Update a {name}", Resource)
-  @armResourceUpdate(Resource)
+  @legacyExtensionResourceOperation(Resource, "update", OverrideResourceName)
   @patch(#{ implicitOptionality: false })
   CustomPatchSync<
     Resource extends Foundations.SimpleResource,
@@ -145,7 +154,8 @@ interface ExtensionOperations<
     Response extends {} = ArmResponse<Resource>,
     OptionalRequestBody extends valueof boolean = false,
     ErrorType extends {} = ErrorResponse,
-    OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false }
+    OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false },
+    OverrideResourceName extends valueof string = "${ResourceName}"
   >(
     ...TargetParameters,
     ...ExtensionInstanceParameters,
@@ -161,13 +171,14 @@ interface ExtensionOperations<
    * @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.
+   * @template OverrideResourceName Optional. The name of the resource type at this scope in clients.
    */
   #suppress "@azure-tools/typespec-azure-core/no-response-body" "Valid"
   @armOperationRoute(OperationOptions)
   @doc("Delete a {name}", Resource)
   @delete
   @deletesResource(Resource)
-  @armResourceDelete(Resource)
+  @legacyExtensionResourceOperation(Resource, "delete", OverrideResourceName)
   DeleteWithoutOkAsync<
     Resource extends Foundations.SimpleResource,
     LroHeaders extends TypeSpec.Reflection.Model = ArmLroLocationHeader &
@@ -175,7 +186,8 @@ interface ExtensionOperations<
     Parameters extends {} = {},
     Response extends {} = ArmDeleteAcceptedLroResponse<LroHeaders> | ArmDeletedNoContentResponse,
     ErrorType extends {} = ErrorResponse,
-    OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false }
+    OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false },
+    OverrideResourceName extends valueof string = "${ResourceName}"
   >(...TargetParameters, ...ExtensionInstanceParameters, ...Parameters): Response | ErrorType;
 
   /**
@@ -185,19 +197,21 @@ interface ExtensionOperations<
    * @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.
+   * @template OverrideResourceName Optional. The name of the resource type at this scope in clients.
    */
   #suppress "@azure-tools/typespec-azure-core/no-response-body" "Valid"
   @armOperationRoute(OperationOptions)
   @doc("Delete a {name}", Resource)
   @delete
   @deletesResource(Resource)
-  @armResourceDelete(Resource)
+  @legacyExtensionResourceOperation(Resource, "delete", OverrideResourceName)
   DeleteSync<
     Resource extends Foundations.SimpleResource,
     Parameters extends {} = {},
     Response extends {} = ArmDeletedResponse | ArmDeletedNoContentResponse,
     ErrorType extends {} = ErrorResponse,
-    OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false }
+    OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false },
+    OverrideResourceName extends valueof string = "${ResourceName}"
   >(...TargetParameters, ...ExtensionInstanceParameters, ...Parameters): Response | ErrorType;
 
   /**
@@ -207,18 +221,20 @@ interface ExtensionOperations<
    * @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.
+   * @template OverrideResourceName Optional. The name of the resource type at this scope in clients.
    */
   @armOperationRoute(OperationOptions)
   @doc("Get a {name}", Resource)
   @get
   @readsResource(Resource)
-  @armResourceRead(Resource)
+  @legacyExtensionResourceOperation(Resource, "read", OverrideResourceName)
   Read<
     Resource extends Foundations.SimpleResource,
     Parameters extends {} = {},
     Response extends {} = ArmResponse<Resource>,
     ErrorType extends {} = ErrorResponse,
-    OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false }
+    OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false },
+    OverrideResourceName extends valueof string = "${ResourceName}"
   >(...TargetParameters, ...ExtensionInstanceParameters, ...Parameters): Response | ErrorType;
 
   /**
@@ -228,16 +244,19 @@ interface ExtensionOperations<
    * @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.
+   * @template OverrideResourceName Optional. The name of the resource type at this scope in clients.
    */
   @armOperationRoute(OperationOptions)
   @doc("Check for the existence of a {name}", Resource)
+  @legacyExtensionResourceOperation(Resource, "checkExistence", OverrideResourceName)
   @head
   CheckExistence<
     Resource extends Foundations.SimpleResource,
     Parameters extends {} = {},
     Response extends {} = ArmResourceExistsResponse | ArmResourceNotFoundResponse,
     ErrorType extends {} = ErrorResponse,
-    OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false }
+    OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false },
+    OverrideResourceName extends valueof string = "${ResourceName}"
   > is Foundations.ArmReadOperation<
     TargetParameters & ExtensionInstanceParameters & Parameters,
     Response,
@@ -250,19 +269,21 @@ interface ExtensionOperations<
    * @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.
+   * @template OverrideResourceName Optional. The name of the resource type at this scope in clients.
    */
   @armOperationRoute(OperationOptions)
   @doc("List a {name}", Resource)
   @get
   @list
   @listsResource(Resource)
-  @armResourceList(Resource)
+  @legacyExtensionResourceOperation(Resource, "list", OverrideResourceName)
   List<
     Resource extends Foundations.SimpleResource,
     Parameters extends {} = {},
     Response extends {} = ArmResponse<ResourceListResult<Resource>>,
     ErrorType extends {} = ErrorResponse,
-    OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false }
+    OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false },
+    OverrideResourceName extends valueof string = "${ResourceName}"
   >(...TargetParameters, ...ExtensionParentParameters, ...Parameters): Response | ErrorType;
 
   /**
@@ -272,18 +293,20 @@ interface ExtensionOperations<
    * @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.
+   * @template OverrideResourceName Optional. The name of the resource type at this scope in clients.
    */
   @armOperationRoute(OperationOptions)
   @doc("List a {name}", Resource)
   @get
   @listsResource(Resource)
-  @armResourceList(Resource)
+  @legacyExtensionResourceOperation(Resource, "list", OverrideResourceName)
   ListSinglePage<
     Resource extends Foundations.SimpleResource,
     Parameters extends {} = {},
     Response extends {} = ArmResponse<ResourceListResult<Resource>>,
     ErrorType extends {} = ErrorResponse,
-    OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false }
+    OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false },
+    OverrideResourceName extends valueof string = "${ResourceName}"
   >(...TargetParameters, ...ExtensionParentParameters, ...Parameters): Response | ErrorType;
 
   /**
@@ -295,10 +318,11 @@ interface ExtensionOperations<
    * @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.
+   * @template OverrideResourceName Optional. The name of the resource type at this scope in clients.
    */
   @doc("")
   @armOperationRoute(OperationOptions)
-  @armResourceAction(Resource)
+  @legacyExtensionResourceOperation(Resource, "action", OverrideResourceName)
   @Private.enforceConstraint(Resource, Foundations.Resource)
   @post
   @returnsDoc("Azure operation completed successfully.")
@@ -309,7 +333,8 @@ interface ExtensionOperations<
     Parameters extends {} = {},
     OptionalRequestBody extends valueof boolean = false,
     ErrorType extends {} = ErrorResponse,
-    OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false }
+    OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false },
+    OverrideResourceName extends valueof string = "${ResourceName}"
   >(
     ...TargetParameters,
     ...ExtensionInstanceParameters,
@@ -331,11 +356,12 @@ interface ExtensionOperations<
    * @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.
+   * @template OverrideResourceName Optional. The name of the resource type at this scope in clients.
    */
   #suppress "@azure-tools/typespec-azure-core/no-response-body" "ARM"
   @doc("")
   @armOperationRoute(OperationOptions)
-  @armResourceAction(Resource)
+  @legacyExtensionResourceOperation(Resource, "action", OverrideResourceName)
   @Private.enforceConstraint(Resource, Foundations.Resource)
   @post
   @returnsDoc("Azure operation completed successfully.")
@@ -356,7 +382,8 @@ interface ExtensionOperations<
     > | Result,
     OptionalRequestBody extends valueof boolean = false,
     ErrorType extends {} = ErrorResponse,
-    OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false }
+    OperationOptions extends valueof ArmOperationOptions = #{ useStaticRoute: false },
+    OverrideResourceName extends valueof string = "${ResourceName}"
   >(
     ...TargetParameters,
     ...ExtensionInstanceParameters,

package/lib/legacy-types/operations.tsp

@@ -14,12 +14,20 @@ using Rest;
  * @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 ResourceName Optional. The name of the resource type described in this template
  */
 interface LegacyOperations<
   ParentParameters extends {},
   ResourceTypeParameter extends {},
-  ErrorType extends {} = ErrorResponse
-> extends RoutedOperations<ParentParameters, ResourceTypeParameter, ErrorType> {}
+  ErrorType extends {} = ErrorResponse,
+  ResourceName extends valueof string = string("")
+>
+  extends RoutedOperations<
+      ParentParameters,
+      ResourceTypeParameter,
+      ErrorType,
+      RoutedResourceName = ResourceName
+    > {}
 
 /**
  * An operation template used to build resource operations in which the same resource type
@@ -28,13 +36,15 @@ interface LegacyOperations<
  * @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.
+ * @template RoutedResourceName Optional. The name of the resource type described in this template
  */
 @doc("")
 interface RoutedOperations<
   ParentParameters extends {},
   ResourceTypeParameter extends {},
   ErrorType extends {} = ErrorResponse,
-  ResourceRoute extends valueof ArmOperationOptions = #{ useStaticRoute: false }
+  ResourceRoute extends valueof ArmOperationOptions = #{ useStaticRoute: false },
+  RoutedResourceName extends valueof string = string("")
 > {
   /**
    * A long-running resource CreateOrUpdate (PUT)
@@ -46,10 +56,11 @@ interface RoutedOperations<
    * @template OverrideErrorType Optional. The error response, if non-standard.
    * @template OverrideRouteOptions Optional. The route options for the operation.
    * @template Request Optional. The request body for the createOrUpdate operation.
+   * @template OverrideResourceName Optional. The name of the resource type being acted upon.
    */
   @doc("Create a {name}", Resource)
   @armOperationRoute(OverrideRouteOptions)
-  @armResourceCreateOrUpdate(Resource)
+  @legacyResourceOperation(Resource, "createOrUpdate", OverrideResourceName)
   @Private.armUpdateProviderNamespace
   @Azure.Core.Foundations.Private.defaultFinalStateVia(#["location", "azure-async-operation"])
   @put
@@ -65,7 +76,8 @@ interface RoutedOperations<
     OptionalRequestBody extends valueof boolean = false,
     OverrideErrorType extends {} = ErrorType,
     OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute,
-    Request extends {} | void = Resource
+    Request extends {} | void = Resource,
+    OverrideResourceName extends valueof string = "${RoutedResourceName}"
   >(
     ...ParentParameters,
     ...ResourceTypeParameter,
@@ -82,11 +94,12 @@ interface RoutedOperations<
    * @template OverrideErrorType Optional. The error response, if non-standard.
    * @template OverrideRouteOptions Optional. The route options for the operation.
    * @template Request Optional. The request body for the createOrUpdate operation.
+   * @template OverrideResourceName Optional. The name of the resource type being acted upon.
    */
   #suppress "@azure-tools/typespec-azure-core/no-private-usage"
   @armOperationRoute(OverrideRouteOptions)
   @doc("Create a {name}", Resource)
-  @armResourceCreateOrUpdate(Resource)
+  @legacyResourceOperation(Resource, "createOrUpdate", OverrideResourceName)
   @Private.armUpdateProviderNamespace
   @put
   CreateOrUpdateSync<
@@ -96,7 +109,8 @@ interface RoutedOperations<
     OptionalRequestBody extends valueof boolean = false,
     OverrideErrorType extends {} = ErrorType,
     OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute,
-    Request extends {} | void = Resource
+    Request extends {} | void = Resource,
+    OverrideResourceName extends valueof string = "${RoutedResourceName}"
   >(
     ...ParentParameters,
     ...ResourceTypeParameter,
@@ -114,10 +128,11 @@ interface RoutedOperations<
    * @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.
+   * @template OverrideResourceName Optional. The name of the resource type being acted upon.
    */
   @doc("Update a {name}", Resource)
   @armOperationRoute(OverrideRouteOptions)
-  @armResourceUpdate(Resource)
+  @legacyResourceOperation(Resource, "update", OverrideResourceName)
   @Private.armUpdateProviderNamespace
   @patch(#{ implicitOptionality: false })
   CustomPatchAsync<
@@ -136,7 +151,8 @@ interface RoutedOperations<
     >,
     OptionalRequestBody extends valueof boolean = false,
     OverrideErrorType extends {} = ErrorType,
-    OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute
+    OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute,
+    OverrideResourceName extends valueof string = "${RoutedResourceName}"
   >(
     ...ParentParameters,
     ...ResourceTypeParameter,
@@ -153,10 +169,11 @@ interface RoutedOperations<
    * @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.
+   * @template OverrideResourceName Optional. The name of the resource type being acted upon.
    */
   @doc("Update a {name}", Resource)
   @armOperationRoute(OverrideRouteOptions)
-  @armResourceUpdate(Resource)
+  @legacyResourceOperation(Resource, "update", OverrideResourceName)
   @Private.armUpdateProviderNamespace
   @patch(#{ implicitOptionality: false })
   CustomPatchSync<
@@ -166,7 +183,8 @@ interface RoutedOperations<
     Response extends {} = ArmResponse<Resource>,
     OptionalRequestBody extends valueof boolean = false,
     OverrideErrorType extends {} = ErrorType,
-    OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute
+    OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute,
+    OverrideResourceName extends valueof string = "${RoutedResourceName}"
   >(
     ...ParentParameters,
     ...ResourceTypeParameter,
@@ -182,6 +200,7 @@ interface RoutedOperations<
    * @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.
+   * @template OverrideResourceName Optional. The name of the resource type being acted upon.
    */
   #suppress "@azure-tools/typespec-azure-core/no-response-body" "Valid"
   @doc("Delete a {name}", Resource)
@@ -189,7 +208,7 @@ interface RoutedOperations<
   @delete
   @deletesResource(Resource)
   @Private.armUpdateProviderNamespace
-  @armResourceDelete(Resource)
+  @legacyResourceOperation(Resource, "delete", OverrideResourceName)
   DeleteWithoutOkAsync<
     Resource extends Foundations.SimpleResource,
     LroHeaders extends TypeSpec.Reflection.Model = ArmLroLocationHeader &
@@ -197,7 +216,8 @@ interface RoutedOperations<
     Parameters extends {} = {},
     Response extends {} = ArmDeleteAcceptedLroResponse<LroHeaders> | ArmDeletedNoContentResponse,
     OverrideErrorType extends {} = ErrorType,
-    OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute
+    OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute,
+    OverrideResourceName extends valueof string = "${RoutedResourceName}"
   >(...ParentParameters, ...ResourceTypeParameter, ...Parameters): Response | OverrideErrorType;
 
   /**
@@ -207,20 +227,22 @@ interface RoutedOperations<
    * @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.
+   * @template OverrideResourceName Optional. The name of the resource type being acted upon.
    */
   #suppress "@azure-tools/typespec-azure-core/no-response-body" "Valid"
   @doc("Delete a {name}", Resource)
   @armOperationRoute(OverrideRouteOptions)
   @delete
   @deletesResource(Resource)
-  @armResourceDelete(Resource)
+  @legacyResourceOperation(Resource, "delete", OverrideResourceName)
   @Private.armUpdateProviderNamespace
   DeleteSync<
     Resource extends Foundations.SimpleResource,
     Parameters extends {} = {},
     Response extends {} = ArmDeletedResponse | ArmDeletedNoContentResponse,
     OverrideErrorType extends {} = ErrorType,
-    OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute
+    OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute,
+    OverrideResourceName extends valueof string = "${RoutedResourceName}"
   >(...ParentParameters, ...ResourceTypeParameter, ...Parameters): Response | OverrideErrorType;
 
   /**
@@ -230,19 +252,21 @@ interface RoutedOperations<
    * @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.
+   * @template OverrideResourceName Optional. The name of the resource type being acted upon.
    */
   @doc("Get a {name}", Resource)
   @armOperationRoute(OverrideRouteOptions)
   @get
   @readsResource(Resource)
-  @armResourceRead(Resource)
+  @legacyResourceOperation(Resource, "read", OverrideResourceName)
   @Private.armUpdateProviderNamespace
   Read<
     Resource extends Foundations.SimpleResource,
     Parameters extends {} = {},
     Response extends {} = ArmResponse<Resource>,
     OverrideErrorType extends {} = ErrorType,
-    OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute
+    OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute,
+    OverrideResourceName extends valueof string = "${RoutedResourceName}"
   >(...ParentParameters, ...ResourceTypeParameter, ...Parameters): Response | OverrideErrorType;
 
   /**
@@ -252,8 +276,10 @@ interface RoutedOperations<
    * @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.
+   * @template OverrideResourceName Optional. The name of the resource type being acted upon.
    */
   @armOperationRoute(OverrideRouteOptions)
+  @legacyResourceOperation(Resource, "checkExistence", OverrideResourceName)
   @doc("Check for the existence of a {name}", Resource)
   @Private.armUpdateProviderNamespace
   @head
@@ -262,7 +288,8 @@ interface RoutedOperations<
     Parameters extends {} = {},
     Response extends {} = ArmResourceExistsResponse | ArmResourceNotFoundResponse,
     OverrideErrorType extends {} = ErrorType,
-    OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute
+    OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute,
+    OverrideResourceName extends valueof string = "${RoutedResourceName}"
   > is Foundations.ArmReadOperation<
     ParentParameters & ResourceTypeParameter & Parameters,
     Response,
@@ -276,6 +303,7 @@ interface RoutedOperations<
    * @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.
+   * @template OverrideResourceName Optional. The name of the resource type being acted upon.
    */
   @segmentOf(ResourceTypeParameter)
   @doc("List a {name}", Resource)
@@ -283,14 +311,15 @@ interface RoutedOperations<
   @list
   @listsResource(Resource)
   @armOperationRoute(OverrideRouteOptions)
-  @armResourceList(Resource)
+  @legacyResourceOperation(Resource, "list", OverrideResourceName)
   @Private.armUpdateProviderNamespace
   List<
     Resource extends Foundations.SimpleResource,
     Parameters extends {} = {},
     Response extends {} = ArmResponse<ResourceListResult<Resource>>,
     OverrideErrorType extends {} = ErrorType,
-    OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute
+    OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute,
+    OverrideResourceName extends valueof string = "${RoutedResourceName}"
   >(...ParentParameters, ...Parameters): Response | OverrideErrorType;
 
   /**
@@ -300,20 +329,22 @@ interface RoutedOperations<
    * @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.
+   * @template OverrideResourceName Optional. The name of the resource type being acted upon.
    */
   @segmentOf(ResourceTypeParameter)
   @doc("List a {name}", Resource)
   @get
   @listsResource(Resource)
   @armOperationRoute(OverrideRouteOptions)
-  @armResourceList(Resource)
+  @legacyResourceOperation(Resource, "list", OverrideResourceName)
   @Private.armUpdateProviderNamespace
   ListSinglePage<
     Resource extends Foundations.SimpleResource,
     Parameters extends {} = {},
     Response extends {} = ArmResponse<ResourceListResult<Resource>>,
     OverrideErrorType extends {} = ErrorType,
-    OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute
+    OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute,
+    OverrideResourceName extends valueof string = "${RoutedResourceName}"
   >(...ParentParameters, ...Parameters): Response | OverrideErrorType;
 
   /**
@@ -325,9 +356,10 @@ interface RoutedOperations<
    * @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.
+   * @template OverrideResourceName Optional. The name of the resource type being acted upon.
    */
   @doc("")
-  @armResourceAction(Resource)
+  @legacyResourceOperation(Resource, "action", OverrideResourceName)
   @armOperationRoute(OverrideRouteOptions)
   @Private.enforceConstraint(Resource, Foundations.Resource)
   @post
@@ -340,7 +372,8 @@ interface RoutedOperations<
     Parameters extends {} = {},
     OptionalRequestBody extends valueof boolean = false,
     OverrideErrorType extends {} = ErrorType,
-    OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute
+    OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute,
+    OverrideResourceName extends valueof string = "${RoutedResourceName}"
   >(
     ...ParentParameters,
     ...ResourceTypeParameter,
@@ -362,10 +395,11 @@ interface RoutedOperations<
    * @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.
+   * @template OverrideResourceName Optional. The name of the resource type being acted upon.
    */
   #suppress "@azure-tools/typespec-azure-core/no-response-body" "ARM"
   @doc("")
-  @armResourceAction(Resource)
+  @legacyResourceOperation(Resource, "action", OverrideResourceName)
   @armOperationRoute(OverrideRouteOptions)
   @Private.enforceConstraint(Resource, Foundations.Resource)
   @Private.armUpdateProviderNamespace
@@ -388,7 +422,8 @@ interface RoutedOperations<
     > | Result,
     OptionalRequestBody extends valueof boolean = false,
     OverrideErrorType extends {} = ErrorType,
-    OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute
+    OverrideRouteOptions extends valueof ArmOperationOptions = ResourceRoute,
+    OverrideResourceName extends valueof string = "${RoutedResourceName}"
   >(
     ...ParentParameters,
     ...ResourceTypeParameter,

package/lib/legacy-types/resource.tsp

@@ -91,6 +91,28 @@ model ExtendedLocationOptional {
 @Http.Private.includeInapplicableMetadataInPayload(false)
 model ResourceWithPathParameter {}
 
+/**
+ * Model representing the  `kind` envelope property only for use with a polymorphic resource..
+ * Spread this model into a resource model if the resource support ARM `kind`.
+ * @template Type The type of the kind property. Default is string. However you can pass a union with string values.
+ *
+ * @example
+ *
+ * ```typespec
+ * model Foo is TrackedResource<FooProperties> {
+ *   // Only have standard Succeeded, Failed, Cancelled states
+ *   ...PolymorphicResourceKindProperty;
+ * }
+ * ```
+ */
+@doc("The resource kind property envelope.")
+model PolymorphicResourceKindProperty<Type extends string = string> {
+  @doc("Metadata used by portal/tooling/etc to render different UX experiences for resources of the same type; e.g. ApiApps are a kind of Microsoft.Web/sites type.  If supported, the resource provider must validate and persist this value.")
+  @pattern("^[-\\w\\._,\\(\\\\\\)]+$")
+  @visibility(Lifecycle.Read, Lifecycle.Create)
+  kind: Type;
+}
+
 /**
  * Discriminated tracked resource types can be created by instantiating this type, with 'kind' as the discriminator property.
  *
@@ -116,7 +138,7 @@ model DiscriminatedTrackedResource<
   KindType extends string = string,
   Description extends valueof string = "Polymorphic Tracked resource types can be created by instantiating this type, with 'kind' as the discriminator."
 > extends Foundations.TrackedResource {
-  ...ResourceKindProperty<KindType>;
+  ...PolymorphicResourceKindProperty<KindType>;
 }
 
 /**
@@ -144,7 +166,7 @@ model DiscriminatedProxyResource<
   KindType extends string = string,
   Description extends valueof string = "Polymorphic proxy resource types can be created by instantiating this type, using 'kind' as the discriminator property."
 > extends Foundations.ProxyResource {
-  ...ResourceKindProperty<KindType>;
+  ...PolymorphicResourceKindProperty<KindType>;
 }
 
 /**
@@ -173,5 +195,5 @@ model DiscriminatedExtensionResource<
   KindType extends string = string,
   Description extends valueof string = "Polymorphic extension resource types can be created by aliasing this type using a specific property type."
 > extends Foundations.ExtensionResource {
-  ...ResourceKindProperty<KindType>;
+  ...PolymorphicResourceKindProperty<KindType>;
 }