@azure-tools/typespec-azure-resource-manager 0.39.0-dev.0 → 0.39.0-dev.1

package/README.md

@@ -82,7 +82,7 @@ Available ruleSets:
 #### `@armCommonTypesVersion`
 
 This decorator is used either on a namespace or a version enum value to indicate
-the version of the ARM common-types to use for refs in emitted Swagger files.
+the version of the Azure Resource Manager common-types to use for refs in emitted Swagger files.
 
 ```typespec
 @Azure.ResourceManager.armCommonTypesVersion(version: valueof string | EnumMember)
@@ -100,7 +100,7 @@ the version of the ARM common-types to use for refs in emitted Swagger files.
 
 #### `@armLibraryNamespace`
 
-`@armLibraryNamespace` designates a namespace as containign ARM Provider information.
+`@armLibraryNamespace` designates a namespace as containign Azure Resource Manager Provider information.
 
 ```typespec
 @Azure.ResourceManager.armLibraryNamespace
@@ -123,7 +123,7 @@ namespace Microsoft.Contoso;
 
 #### `@armProviderNamespace`
 
-`@armProviderNamespace` sets the ARM provider name. It will default to use the
+`@armProviderNamespace` sets the Azure Resource Manager provider name. It will default to use the
 Namespace element value unless an override value is specified.
 
 ```typespec
@@ -155,7 +155,7 @@ namespace Microsoft.ContosoService;
 #### `@armProviderNameValue`
 
 `@armResourceType` sets the value fo the decorated string
-property to the type of the ARM resource.
+property to the type of the Azure Resource Manager resource.
 
 ```typespec
 @Azure.ResourceManager.armProviderNameValue
@@ -328,13 +328,13 @@ clients.
 
 #### `@extensionResource`
 
-`@extensionResource` marks an ARM resource model as an Extension resource.
+`@extensionResource` marks an Azure Resource Manager resource model as an Extension resource.
 Extension resource extends other resource types. URL path is appended
 to another segment {scope} which refers to another Resource URL.
 
 `{resourceUri}/providers/Microsoft.Contoso/accessPermissions`
 
-See more details on [different ARM resource type here.](https://azure.github.io/typespec-azure/docs/howtos/ARM/resource-type)
+See more details on [different Azure Resource Manager resource type here.](https://azure.github.io/typespec-azure/docs/howtos/ARM/resource-type)
 
 ```typespec
 @Azure.ResourceManager.extensionResource
@@ -350,12 +350,12 @@ None
 
 #### `@locationResource`
 
-`@locationResource` marks an ARM resource model as a location based resource.
+`@locationResource` marks an Azure Resource Manager resource model as a location based resource.
 
 Location based resources have REST API paths like
 `/subscriptions/{subscriptionId}/locations/{location}/providers/Microsoft.Contoso/employees`
 
-See more details on [different ARM resource type here.](https://azure.github.io/typespec-azure/docs/howtos/ARM/resource-type)
+See more details on [different Azure Resource Manager resource type here.](https://azure.github.io/typespec-azure/docs/howtos/ARM/resource-type)
 
 ```typespec
 @Azure.ResourceManager.locationResource
@@ -371,13 +371,13 @@ None
 
 #### `@resourceGroupResource`
 
-`@resourceGroupResource` marks an ARM resource model as a resource group level resource.
-This is the default option for ARM resources. It is provided for symmetry and clarity, and
+`@resourceGroupResource` marks an Azure Resource Manager resource model as a resource group level resource.
+This is the default option for Azure Resource Manager resources. It is provided for symmetry and clarity, and
 you typically do not need to specify it.
 
 `/subscription/{id}/resourcegroups/{rg}/providers/Microsoft.Contoso/employees`
 
-See more details on [different ARM resource type here.](https://azure.github.io/typespec-azure/docs/howtos/ARM/resource-type)
+See more details on [different Azure Resource Manager resource type here.](https://azure.github.io/typespec-azure/docs/howtos/ARM/resource-type)
 
 ```typespec
 @Azure.ResourceManager.resourceGroupResource
@@ -393,12 +393,12 @@ None
 
 #### `@singleton`
 
-`@singleton` marks an ARM resource model as a singleton resource.
+`@singleton` marks an Azure Resource Manager resource model as a singleton resource.
 
 Singleton resources only have a single instance with a fixed key name.
 `.../providers/Microsoft.Contoso/monthlyReports/default`
 
-See more details on [different ARM resource type here.](https://azure.github.io/typespec-azure/docs/howtos/ARM/resource-type)
+See more details on [different Azure Resource Manager resource type here.](https://azure.github.io/typespec-azure/docs/howtos/ARM/resource-type)
 
 ```typespec
 @Azure.ResourceManager.singleton(keyValue?: valueof string | default)
@@ -416,12 +416,12 @@ See more details on [different ARM resource type here.](https://azure.github.io/
 
 #### `@subscriptionResource`
 
-`@subscriptionResource` marks an ARM resource model as a subscription resource.
+`@subscriptionResource` marks an Azure Resource Manager resource model as a subscription resource.
 
 Subscription resources have REST API paths like:
 `/subscription/{id}/providers/Microsoft.Contoso/employees`
 
-See more details on [different ARM resource type here.](https://azure.github.io/typespec-azure/docs/howtos/ARM/resource-type)
+See more details on [different Azure Resource Manager resource type here.](https://azure.github.io/typespec-azure/docs/howtos/ARM/resource-type)
 
 ```typespec
 @Azure.ResourceManager.subscriptionResource
@@ -437,12 +437,12 @@ None
 
 #### `@tenantResource`
 
-`@tenantResource` marks an ARM resource model as a Tenant resource/Root resource/Top-Level resource.
+`@tenantResource` marks an Azure Resource Manager resource model as a Tenant resource/Root resource/Top-Level resource.
 
 Tenant resources have REST API paths like:
 `/provider/Microsoft.Contoso/FooResources`
 
-See more details on [different ARM resource type here.](https://azure.github.io/typespec-azure/docs/howtos/ARM/resource-type)
+See more details on [different Azure Resource Manager resource type here.](https://azure.github.io/typespec-azure/docs/howtos/ARM/resource-type)
 
 ```typespec
 @Azure.ResourceManager.tenantResource
@@ -458,8 +458,8 @@ None
 
 #### `@useLibraryNamespace`
 
-Declare the ARM library namespaces used in this provider.
-This allows sharing ARM resource types across specifications
+Declare the Azure Resource Manager library namespaces used in this provider.
+This allows sharing Azure Resource Manager resource types across specifications
 
 ```typespec
 @Azure.ResourceManager.useLibraryNamespace(...namespaces: Namespace[])
@@ -471,6 +471,6 @@ This allows sharing ARM resource types across specifications
 
 ##### Parameters
 
-| Name       | Type                | Description                                           |
-| ---------- | ------------------- | ----------------------------------------------------- |
-| namespaces | `model Namespace[]` | The namespaces of arm libraries used in this provider |
+| Name       | Type                | Description                                                              |
+| ---------- | ------------------- | ------------------------------------------------------------------------ |
+| namespaces | `model Namespace[]` | The namespaces of Azure Resource Manager libraries used in this provider |

package/lib/arm.foundations.tsp

@@ -17,9 +17,9 @@ A list of REST API operations supported by an Azure Resource Provider. It contai
 model OperationListResult is Azure.Core.Page<Operation>;
 
 /**
- * Base model that defines common properties for all ARM resources.
+ * Base model that defines common properties for all Azure Resource Manager resources.
  */
-@doc("Common properties for all ARM resources.")
+@doc("Common properties for all Azure Resource Manager resources.")
 model ArmResource extends ArmResourceBase {
   @doc("Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}")
   @visibility("read")
@@ -295,11 +295,11 @@ model ErrorAdditionalInfo {
 }
 
 /**
- * Standard type definition for ARM Tags property.
+ * Standard type definition for Azure Resource Manager Tags property.
  *
  * It is included in the TrackedResource template definition.
  */
-@doc("The ARM Resource tags.")
+@doc("The Azure Resource Manager Resource tags.")
 model ArmTagsProperty {
   @doc("Resource tags.")
   tags?: Record<string>;
@@ -636,7 +636,7 @@ model Operation {
   name?: string;
 
   @doc("""
-  Whether the operation applies to data-plane. This is "true" for data-plane operations and "false" for ARM/control-plane operations.
+  Whether the operation applies to data-plane. This is "true" for data-plane operations and "false" for Azure Resource Manager/control-plane operations.
   """)
   @visibility("read")
   isDataAction?: boolean;
@@ -751,3 +751,47 @@ op checkNameAvailability<
   @body
   body: Request,
 ): Response | ErrorResponse;
+
+/**
+ * @dev The base template for Azure Resource Manager Operations.
+ * @param Parameters The parameter object for the operation.
+ * @param Response The response or union of responses for success.
+ * @param ErrorResponse The error response.
+ */
+op ArmReadOperation<Parameters extends {}, Response extends {}, ErrorResponse extends {}>(
+  ...Parameters,
+): Response | ErrorResponse;
+
+/**
+ * @dev The base temlate for Azure Resource Manager PUT Operations.
+ * @param HttpParameters The parameter object for the operation.
+ * @param BodyParameter The body parameter
+ * @param Response The response or union of responses for success.
+ * @param ErrorResponse The error response.
+ */
+op ArmCreateOperation<
+  HttpParameters extends {},
+  BodyParameter extends {},
+  Response extends {},
+  ErrorResponse extends {}
+>(
+  ...HttpParameters,
+  @doc("Resource create parameters.") @body resource: BodyParameter,
+): Response | ErrorResponse;
+
+/**
+ * @dev The base temlate for Azure Resource Manager PATCH Operations.
+ * @param HttpParameters The parameter object for the operation.
+ * @param BodyParameter The body parameter
+ * @param Response The response or union of responses for success.
+ * @param ErrorResponse The error response.
+ */
+op ArmUpdateOperation<
+  HttpParameters extends {},
+  BodyParameter extends {},
+  Response extends {},
+  ErrorResponse extends {}
+>(
+  ...HttpParameters,
+  @doc("The resource properties to be updated.") @body properties: BodyParameter,
+): Response | ErrorResponse;

package/lib/common-types.tsp

@@ -5,14 +5,14 @@ using TypeSpec.Versioning;
 namespace Azure.ResourceManager.CommonTypes;
 
 @Private.armCommonTypesVersions
-@doc("The ARM common-types versions.")
+@doc("The Azure Resource Manager common-types versions.")
 enum Versions {
-  @doc("The ARM v3 common types.")
+  @doc("The Azure Resource Manager v3 common types.")
   v3,
 
-  @doc("The ARM v4 common types.")
+  @doc("The Azure Resource Manager v4 common types.")
   v4,
 
-  @doc("The ARM v5 common types.")
+  @doc("The Azure Resource Manager v5 common types.")
   v5,
 }

package/lib/decorators.tsp

@@ -3,7 +3,7 @@ using TypeSpec.Reflection;
 namespace Azure.ResourceManager;
 
 /**
- * `@armProviderNamespace` sets the ARM provider name. It will default to use the
+ * `@armProviderNamespace` sets the Azure Resource Manager provider name. It will default to use the
  * Namespace element value unless an override value is specified.
  *
  * @example
@@ -25,14 +25,14 @@ namespace Azure.ResourceManager;
 extern dec armProviderNamespace(target: Namespace, providerNamespace?: valueof string);
 
 /**
- * Declare the ARM library namespaces used in this provider.
- * This allows sharing ARM resource types across specifications
- * @param namespaces The namespaces of arm libraries used in this provider
+ * Declare the Azure Resource Manager library namespaces used in this provider.
+ * This allows sharing Azure Resource Manager resource types across specifications
+ * @param namespaces The namespaces of Azure Resource Manager libraries used in this provider
  */
 extern dec useLibraryNamespace(target: Namespace, ...namespaces: Namespace[]);
 
 /**
- * `@armLibraryNamespace` designates a namespace as containign ARM Provider information.
+ * `@armLibraryNamespace` designates a namespace as containign Azure Resource Manager Provider information.
  *
  * @example
  *
@@ -45,72 +45,72 @@ extern dec useLibraryNamespace(target: Namespace, ...namespaces: Namespace[]);
 extern dec armLibraryNamespace(target: Namespace);
 
 /**
- * `@singleton` marks an ARM resource model as a singleton resource.
+ * `@singleton` marks an Azure Resource Manager resource model as a singleton resource.
  *
  * Singleton resources only have a single instance with a fixed key name.
  *  `.../providers/Microsoft.Contoso/monthlyReports/default`
  *
- * See more details on [different ARM resource type here.](https://azure.github.io/typespec-azure/docs/howtos/ARM/resource-type)
+ * See more details on [different Azure Resource Manager resource type here.](https://azure.github.io/typespec-azure/docs/howtos/ARM/resource-type)
  *
  * @param keyValue The name of the singleton resource. Default name is "default".
  */
 extern dec singleton(target: Model, keyValue?: valueof string | "default");
 
 /**
- * `@tenantResource` marks an ARM resource model as a Tenant resource/Root resource/Top-Level resource.
+ * `@tenantResource` marks an Azure Resource Manager resource model as a Tenant resource/Root resource/Top-Level resource.
  *
  * Tenant resources have REST API paths like:
  *   `/provider/Microsoft.Contoso/FooResources`
  *
- * See more details on [different ARM resource type here.](https://azure.github.io/typespec-azure/docs/howtos/ARM/resource-type)
+ * See more details on [different Azure Resource Manager resource type here.](https://azure.github.io/typespec-azure/docs/howtos/ARM/resource-type)
  */
 extern dec tenantResource(target: Model);
 
 /**
- * `@subscriptionResource` marks an ARM resource model as a subscription resource.
+ * `@subscriptionResource` marks an Azure Resource Manager resource model as a subscription resource.
  *
  * Subscription resources have REST API paths like:
  *  `/subscription/{id}/providers/Microsoft.Contoso/employees`
  *
- * See more details on [different ARM resource type here.](https://azure.github.io/typespec-azure/docs/howtos/ARM/resource-type)
+ * See more details on [different Azure Resource Manager resource type here.](https://azure.github.io/typespec-azure/docs/howtos/ARM/resource-type)
  */
 extern dec subscriptionResource(target: Model);
 
 /**
- * `@locationResource` marks an ARM resource model as a location based resource.
+ * `@locationResource` marks an Azure Resource Manager resource model as a location based resource.
  *
  * Location based resources have REST API paths like
  *   `/subscriptions/{subscriptionId}/locations/{location}/providers/Microsoft.Contoso/employees`
  *
- * See more details on [different ARM resource type here.](https://azure.github.io/typespec-azure/docs/howtos/ARM/resource-type)
+ * See more details on [different Azure Resource Manager resource type here.](https://azure.github.io/typespec-azure/docs/howtos/ARM/resource-type)
  */
 extern dec locationResource(target: Model);
 
 /**
- * `@resourceGroupResource` marks an ARM resource model as a resource group level resource.
- * This is the default option for ARM resources. It is provided for symmetry and clarity, and
+ * `@resourceGroupResource` marks an Azure Resource Manager resource model as a resource group level resource.
+ * This is the default option for Azure Resource Manager resources. It is provided for symmetry and clarity, and
  * you typically do not need to specify it.
  *
  *   `/subscription/{id}/resourcegroups/{rg}/providers/Microsoft.Contoso/employees`
  *
- * See more details on [different ARM resource type here.](https://azure.github.io/typespec-azure/docs/howtos/ARM/resource-type)
+ * See more details on [different Azure Resource Manager resource type here.](https://azure.github.io/typespec-azure/docs/howtos/ARM/resource-type)
  */
 extern dec resourceGroupResource(target: Model);
 
 /**
- * `@extensionResource` marks an ARM resource model as an Extension resource.
+ * `@extensionResource` marks an Azure Resource Manager resource model as an Extension resource.
  * Extension resource extends other resource types. URL path is appended
  * to another segment {scope} which refers to another Resource URL.
  *
  *   `{resourceUri}/providers/Microsoft.Contoso/accessPermissions`
  *
- * See more details on [different ARM resource type here.](https://azure.github.io/typespec-azure/docs/howtos/ARM/resource-type)
+ * See more details on [different Azure Resource Manager resource type here.](https://azure.github.io/typespec-azure/docs/howtos/ARM/resource-type)
  */
 extern dec extensionResource(target: Model);
 
 /**
  * `@armResourceType` sets the value fo the decorated string
- * property to the type of the ARM resource.
+ * property to the type of the Azure Resource Manager resource.
  * @param resource The resource to get the type of
  */
 extern dec armProviderNameValue(target: Operation | Model);
@@ -178,7 +178,7 @@ extern dec armResourceOperations(target: Interface, _?: unknown);
 
 /**
  * This decorator is used either on a namespace or a version enum value to indicate
- * the version of the ARM common-types to use for refs in emitted Swagger files.
+ * the version of the Azure Resource Manager common-types to use for refs in emitted Swagger files.
  *
  * @param version The Azure.ResourceManager.CommonTypes.Versions for the desired common-types version or an equivalent string value.
  */

package/lib/interfaces.tsp

@@ -8,9 +8,9 @@ using Azure.ResourceManager.Private;
 namespace Azure.ResourceManager;
 
 /**
- * This is the interface that implements the standard ARM operation that returns
+ * This is the interface that implements the standard Azure Resource Manager operation that returns
  * all supported RP operations. You should have exactly one declaration for each
- * ARM service. It implements
+ * Azure Resource Manager service. It implements
  *   GET "/providers/Microsoft.ContosoProviderHub/operations"
  */
 interface Operations {
@@ -201,7 +201,7 @@ interface ResourceCreateSync<
    * @template Resource The ArmResource to create or update.
    * @template BaseParameters The http parameters that are part of the request
    */
-  createOrUpdate is ArmResourceCreateOrUpdateSync<Resource, BaseParameters>;
+  createOrUpdate is ArmResourceCreateOrReplaceSync<Resource, BaseParameters>;
 }
 
 /**

package/lib/models.tsp

@@ -10,7 +10,7 @@ namespace Azure.ResourceManager;
 /**
  * Concrete tracked resource types can be created by aliasing this type using a specific property type.
  *
- * See more details on [different ARM resource type here.](https://azure.github.io/typespec-azure/docs/howtos/ARM/resource-type)
+ * See more details on [different Azure Resource Manager resource type here.](https://azure.github.io/typespec-azure/docs/howtos/ARM/resource-type)
  * @template Properties A model containing the provider-specific properties for this resource
  */
 @doc("Concrete tracked resource types can be created by aliasing this type using a specific property type.")
@@ -26,7 +26,7 @@ model TrackedResource<Properties extends {}> extends TrackedResourceBase {
 /**
  * Concrete proxy resource types can be created by aliasing this type using a specific property type.
  *
- * See more details on [different ARM resource type here.](https://azure.github.io/typespec-azure/docs/howtos/ARM/resource-type)
+ * See more details on [different Azure Resource Manager resource type here.](https://azure.github.io/typespec-azure/docs/howtos/ARM/resource-type)
  * @template Properties A model containing the provider-specific properties for this resource
  */
 @doc("Concrete proxy resource types can be created by aliasing this type using a specific property type.")
@@ -42,7 +42,7 @@ model ProxyResource<Properties extends {}> extends ProxyResourceBase {
 /**
  * Concrete extension resource types can be created by aliasing this type using a specific property type.
  *
- * See more details on [different ARM resource type here.](https://azure.github.io/typespec-azure/docs/howtos/ARM/resource-type)
+ * See more details on [different Azure Resource Manager resource type here.](https://azure.github.io/typespec-azure/docs/howtos/ARM/resource-type)
  * @template Properties A model containing the provider-specific properties for this resource
  */
 @extensionResource
@@ -86,10 +86,10 @@ model ProviderNamespace<Resource extends {}> {
 }
 //#endregion
 
-//#region Common ARM type definitions
+//#region Common Azure Resource Manager type definitions
 
 /**
- * A type definition that refers the id to an ARM resource.
+ * A type definition that refers the id to an Azure Resource Manager resource.
  *
  * Sample usage:
  *   otherArmId: ResourceIdentifier;
@@ -97,7 +97,7 @@ model ProviderNamespace<Resource extends {}> {
  *   vmIds: ResourceIdentifier<[{type:"\\Microsoft.Compute\\vm", scopes["*"]}]>
  * @template AllowedResourceTypes An array of allowed resource types for the resource reference
  */
-@doc("A type definition that refers the id to an ARM resource.")
+@doc("A type definition that refers the id to an Azure Resource Manager resource.")
 @format("arm-id")
 @OpenAPI.extension(
   "x-ms-arm-id-details",
@@ -109,10 +109,10 @@ scalar ResourceIdentifier<AllowedResourceTypes extends ResourceIdentifierAllowed
   extends string;
 
 /**
- * Used in ResourceIdentifier definition to represent a particular type of ARM resource, enabling constraints based on resource type.
+ * Used in ResourceIdentifier definition to represent a particular type of Azure Resource Manager resource, enabling constraints based on resource type.
  * See [link](https://github.com/Azure/autorest/tree/main/docs/extensions#schema)
  */
-@doc("Optional definition represents a particular type of ARM resource which can be referred to by a ResourceIdentifier.")
+@doc("Optional definition represents a particular type of Azure Resource Manager resource which can be referred to by a ResourceIdentifier.")
 model ResourceIdentifierAllowedResource {
   @doc("The type of resource that is being referred to. For example Microsoft.Network/virtualNetworks or Microsoft.Network/virtualNetworks/subnets. See Example Types for more examples.")
   type: string;
@@ -173,7 +173,7 @@ model DefaultProvisioningStateProperty {
 }
 
 /**
- * Standard ARM definition of ManagedServiceIdentity
+ * Standard Azure Resource Manager definition of ManagedServiceIdentity
  */
 @doc("The managed service identities envelope.")
 model ManagedServiceIdentity {
@@ -182,7 +182,7 @@ model ManagedServiceIdentity {
 }
 
 /**
- * Standard ARM definition of ManagedServiceIdentity for services
+ * Standard Azure Resource Manager definition of ManagedServiceIdentity for services
  * that only support system-defined identities
  */
 @doc("Managed identity for services that are constrained to system-assigned managed identities.")

package/lib/operations.tsp

@@ -11,6 +11,9 @@ namespace Azure.ResourceManager;
 /**
  * A resource list operation, at the subscription scope
  * @template Resource the resource being patched
+ * @template Parameters Optional. Additional parameters after the path parameters
+ * @template Response Optional. The success response for the list operation
+ * @template Error Optional. The error response, if non-standard.
  */
 @autoRoute
 @doc("List {name} resources by subscription ID", Resource)
@@ -18,9 +21,12 @@ namespace Azure.ResourceManager;
 @segmentOf(Resource)
 @armResourceList(Resource)
 @get
-op ArmListBySubscription<Resource extends ArmResource>(
-  ...SubscriptionScope<Resource>,
-): ArmResponse<ResourceListResult<Resource>> | ErrorResponse;
+op ArmListBySubscription<
+  Resource extends ArmResource,
+  Parameters extends {} = {},
+  Response extends {} = ArmResponse<ResourceListResult<Resource>>,
+  Error extends {} = ErrorResponse
+> is ArmReadOperation<SubscriptionScope<Resource> & Parameters, Response, Error>;
 
 /**
  * A resource list operation, at the scope of the resource's parent
@@ -28,6 +34,9 @@ op ArmListBySubscription<Resource extends ArmResource>(
  * @template BaseParameters Optional. Allows overriding the operation parameters
  * @template ParentName Optional. The name of the parent resource
  * @template ParentFriendlyName Optional. The friendly name of the parent resource
+ * @template Parameters Optional. Additional parameters after the path parameters
+ * @template Response Optional. The success response for the list operation
+ * @template Error Optional. The error response, if non-standard.
  */
 @get
 @autoRoute
@@ -39,15 +48,23 @@ op ArmResourceListByParent<
   Resource extends ArmResource,
   BaseParameters = DefaultBaseParameters<Resource>,
   ParentName extends valueof string = "",
-  ParentFriendlyName extends valueof string = ""
->(
-  ...ResourceParentParameters<Resource, BaseParameters>,
-): ArmResponse<ResourceListResult<Resource>> | ErrorResponse;
+  ParentFriendlyName extends valueof string = "",
+  Parameters extends {} = {},
+  Response extends {} = ArmResponse<ResourceListResult<Resource>>,
+  Error extends {} = ErrorResponse
+> is ArmReadOperation<
+  ResourceParentParameters<Resource, BaseParameters> & Parameters,
+  Response,
+  ErrorResponse
+>;
 
 /**
  * A resource list operation, with scope determined by BaseParameters
  * @template Resource the resource being patched
  * @template BaseParameters Optional. Allows overriding the operation parameters
+ * @template Parameters Optional. Additional parameters after the path parameters
+ * @template Response Optional. The success response for the list operation
+ * @template Error Optional. The error response, if non-standard.
  */
 @get
 @autoRoute
@@ -57,15 +74,23 @@ op ArmResourceListByParent<
 @armResourceList(Resource)
 op ArmResourceListAtScope<
   Resource extends ArmResource,
-  BaseParameters = DefaultBaseParameters<Resource>
->(
-  ...ResourceParentParameters<Resource, BaseParameters>,
-): ArmResponse<ResourceListResult<Resource>> | ErrorResponse;
+  BaseParameters = DefaultBaseParameters<Resource>,
+  Parameters extends {} = {},
+  Response extends {} = ArmResponse<ResourceListResult<Resource>>,
+  Error extends {} = ErrorResponse
+> is ArmReadOperation<
+  ResourceParentParameters<Resource, BaseParameters> & Parameters,
+  Response,
+  ErrorResponse
+>;
 
 /**
  * A resource GET operation
  * @template Resource the resource being patched
  * @template BaseParameters Optional. Allows overriding the operation parameters
+ * @template Parameters Optional. Additional parameters after the path parameters
+ * @template Response Optional. The success response for the read operation
+ * @template Error Optional. The error response, if non-standard.
  */
 @autoRoute
 @doc("Get a {name}", Resource)
@@ -73,14 +98,24 @@ op ArmResourceListAtScope<
 @armResourceRead(Resource)
 op ArmResourceRead<
   Resource extends ArmResourceBase,
-  BaseParameters = DefaultBaseParameters<Resource>
->(...ResourceInstanceParameters<Resource, BaseParameters>): ArmResponse<Resource> | ErrorResponse;
+  BaseParameters = DefaultBaseParameters<Resource>,
+  Parameters extends {} = {},
+  Response extends {} = ArmResponse<Resource>,
+  Error extends {} = ErrorResponse
+> is ArmReadOperation<
+  ResourceInstanceParameters<Resource, BaseParameters> & Parameters,
+  Response,
+  ErrorResponse
+>;
 
 /**
  * A long-running resource CreateOrUpdate (PUT)
  * @template Resource the resource being patched
  * @template BaseParameters Optional. Allows overriding the operation parameters
  * @template LroHeaders Optional.  Allows overriding the lro headers returned on resource create
+ * @template Parameters Optional. Additional parameters after the path parameters
+ * @template Response Optional. The success response for the createOrUpdate operation
+ * @template Error Optional. The error response, if non-standard.
  */
 @autoRoute
 @doc("Create a {name}", Resource)
@@ -96,42 +131,53 @@ op ArmResourceRead<
 op ArmResourceCreateOrUpdateAsync<
   Resource extends ArmResource,
   BaseParameters = DefaultBaseParameters<Resource>,
-  LroHeaders extends TypeSpec.Reflection.Model = {}
->(
-  ...ResourceInstanceParameters<Resource, BaseParameters>,
-
-  @doc("Resource create parameters.")
-  @body
-  resource: Resource,
-): ArmResourceUpdatedResponse<Resource> | ArmResourceCreatedResponse<
+  LroHeaders extends TypeSpec.Reflection.Model = {},
+  Parameters extends {} = {},
+  Response extends {} = ArmResourceUpdatedResponse<Resource> | ArmResourceCreatedResponse<
+    Resource,
+    LroHeaders
+  >,
+  Error extends {} = ErrorResponse
+> is ArmCreateOperation<
+  ResourceInstanceParameters<Resource, BaseParameters> & Parameters,
   Resource,
-  LroHeaders
-> | ErrorResponse;
+  ArmResourceUpdatedResponse<Resource> | ArmResourceCreatedResponse<Resource, LroHeaders>,
+  Error
+>;
 
 /**
  * DEPRECATED: Please use ArmResourceCreateOrReplaceSync instead
  * @template Resource the resource being patched
  * @template BaseParameters Optional. Allows overriding the operation parameters
+ * @template Parameters Optional. Additional parameters after the path parameters
+ * @template Response Optional. The success response for the createOrUpdate operation
+ * @template Error Optional. The error response, if non-standard.
  */
+#deprecated "Please use ArmResourceCreateOrReplaceSync instead"
 @autoRoute
 @doc("Create a {name}", Resource)
 @armResourceCreateOrUpdate(Resource)
 @put
 op ArmResourceCreateOrUpdateSync<
   Resource extends ArmResource,
-  BaseParameters = DefaultBaseParameters<Resource>
->(
-  ...ResourceInstanceParameters<Resource, BaseParameters>,
-
-  @doc("Resource create parameters.")
-  @body
-  resource: Resource,
-): ArmResponse<Resource> | ErrorResponse;
+  BaseParameters = DefaultBaseParameters<Resource>,
+  Parameters extends {} = {},
+  Response extends {} = ArmResponse<Resource>,
+  Error extends {} = ErrorResponse
+> is ArmCreateOperation<
+  ResourceInstanceParameters<Resource, BaseParameters> & Parameters,
+  Resource,
+  Response,
+  Error
+>;
 
 /**
- * Synchronous PUT operation for ARM resources
+ * Synchronous PUT operation for Azure Resource Manager resources
  * @template Resource the resource being patched
  * @template BaseParameters Optional. Allows overriding the operation parameters
+ * @template Parameters Optional. Additional parameters after the path parameters
+ * @template Response Optional. The success response for the createOrUpdate operation
+ * @template Error Optional. The error response, if non-standard.
  */
 @autoRoute
 @doc("Create a {name}", Resource)
@@ -139,26 +185,51 @@ op ArmResourceCreateOrUpdateSync<
 @put
 op ArmResourceCreateOrReplaceSync<
   Resource extends ArmResource,
-  BaseParameters = DefaultBaseParameters<Resource>
->(
-  ...ResourceInstanceParameters<Resource, BaseParameters>,
-
-  @doc("Resource create parameters.")
-  @body
-  resource: Resource,
-): ArmResourceUpdatedResponse<Resource> | ArmResourceCreatedSyncResponse<Resource> | ErrorResponse;
+  BaseParameters = DefaultBaseParameters<Resource>,
+  Parameters extends {} = {},
+  Response extends {} = ArmResourceUpdatedResponse<Resource> | ArmResourceCreatedSyncResponse<Resource>,
+  Error extends {} = ErrorResponse
+> is ArmCreateOperation<
+  ResourceInstanceParameters<Resource, BaseParameters> & Parameters,
+  Resource,
+  Response,
+  Error
+>;
 
+/**
+ * @dev A long-running resource CreateOrUpdate (PUT)
+ * @template Resource the resource being patched
+ * @template BaseParameters Optional. Allows overriding the operation parameters
+ * @template LroHeaders Optional.  Allows overriding the lro headers returned on resource create
+ * @template Parameters Optional. Additional parameters after the path parameters
+ * @template Response Optional. The success response for the createOrReplace operation
+ * @template Error Optional. The error response, if non-standard.
+ */
 op ArmResourceCreateOrReplaceAsync<
   Resource extends ArmResource,
   BaseParameters = DefaultBaseParameters<Resource>,
-  LroHeaders extends TypeSpec.Reflection.Model = {}
-> is ArmResourceCreateOrUpdateAsync<Resource, BaseParameters, LroHeaders>;
+  LroHeaders extends TypeSpec.Reflection.Model = {},
+  Parameters extends {} = {},
+  Response extends {} = ArmResourceUpdatedResponse<Resource> | ArmResourceCreatedResponse<
+    Resource,
+    LroHeaders
+  >,
+  Error extends {} = ErrorResponse
+> is ArmResourceCreateOrUpdateAsync<
+  Resource,
+  BaseParameters,
+  LroHeaders,
+  Parameters,
+  Response,
+  Error
+>;
 
 /**
  * @dev A long-running resource update that only allows updating resource tags (the minimum)
  * @template Resource the resource being patched
  * @template BaseParameters Optional. Allows overriding the operation parameters
  * @template LroHeaders Optional.  Allows overriding the lro headers that appear in the Accepted response
+ * @template Parameters Optional. Additional parameters after the path parameters
  */
 op ArmTagsPatchAsync<
   Resource extends ArmResource,
@@ -168,8 +239,15 @@ op ArmTagsPatchAsync<
     Azure.Core.StatusMonitorPollingOptions<ArmOperationStatus>,
     Resource,
     string
-  >
-> is ArmCustomPatchAsync<Resource, TagsUpdateModel<Resource>, BaseParameters, LroHeaders>;
+  >,
+  Parameters extends {} = {}
+> is ArmCustomPatchAsync<
+  Resource,
+  TagsUpdateModel<Resource>,
+  BaseParameters,
+  LroHeaders,
+  Parameters
+>;
 
 /**
  * @dev A long-running resource update using the items from the resource marked with visibility "update"
@@ -177,6 +255,7 @@ op ArmTagsPatchAsync<
  * @template Properties The model type of the resource properties
  * @template BaseParameters Optional. Allows overriding the operation parameters
  * @template LroHeaders Optional.  Allows overriding the lro headers returned in the Accepted response
+ * @template Parameters Optional. Additional parameters after the path parameters
  */
 op ArmResourcePatchAsync<
   Resource extends ArmResource,
@@ -186,12 +265,14 @@ op ArmResourcePatchAsync<
     Azure.Core.StatusMonitorPollingOptions<ArmOperationStatus>,
     Resource,
     string
-  >
+  >,
+  Parameters extends {} = {}
 > is ArmCustomPatchAsync<
   Resource,
   ResourceUpdateModel<Resource, Properties>,
   BaseParameters,
-  LroHeaders
+  LroHeaders,
+  Parameters
 >;
 
 /**
@@ -200,6 +281,9 @@ op ArmResourcePatchAsync<
  * @template PatchModel The input model for the PATCH request
  * @template BaseParameters Optional. Allows overriding the operation parameters
  * @template LroHeaders Optional.  Allows overriding the lro headers returned in the Accepted response
+ * @template Parameters Optional. Additional parameters after the path parameters
+ * @template Response Optional. The success response for the patch operation
+ * @template Error Optional. The error response, if non-standard.
  */
 @autoRoute
 @doc("Update a {name}", Resource)
@@ -220,45 +304,59 @@ op ArmCustomPatchAsync<
     Azure.Core.StatusMonitorPollingOptions<ArmOperationStatus>,
     Resource,
     string
-  >
->(
-  ...ResourceInstanceParameters<Resource, BaseParameters>,
-
-  @doc("The resource properties to be updated.")
-  @body
-  properties: PatchModel,
-): ArmResponse<Resource> | ArmAcceptedLroResponse<
-  "Resource update request accepted.",
-  LroHeaders
-> | ErrorResponse;
+  >,
+  Parameters extends {} = {},
+  Response extends {} = ArmResponse<Resource> | ArmAcceptedLroResponse<
+    "Resource update request accepted.",
+    LroHeaders
+  >,
+  Error extends {} = ErrorResponse
+> is ArmUpdateOperation<
+  ResourceInstanceParameters<Resource, BaseParameters> & Parameters,
+  PatchModel,
+  Response,
+  Error
+>;
 
 /**
  * @dev A resource update that only allows updating resource tags (the minimum)
  * @template Resource the resource being patched
  * @template BaseParameters Optional. Allows overriding the operation parameters
+ * @template Parameters Optional. Additional parameters after the path parameters
  */
 op ArmTagsPatchSync<
   Resource extends ArmResource,
-  BaseParameters = DefaultBaseParameters<Resource>
-> is ArmCustomPatchSync<Resource, TagsUpdateModel<Resource>, BaseParameters>;
+  BaseParameters = DefaultBaseParameters<Resource>,
+  Parameters extends {} = {}
+> is ArmCustomPatchSync<Resource, TagsUpdateModel<Resource>, BaseParameters, Parameters>;
 
 /**
  * @dev A resource update using the items from the resource marked with visibility "update"
  * @template Resource the resource being patched
  * @template Properties The model type of the resource properties
  * @template BaseParameters Optional. Allows overriding the operation parameters
+ * @template Parameters Optional. Additional parameters after the path parameters
  */
 op ArmResourcePatchSync<
   Resource extends ArmResource,
   Properties extends TypeSpec.Reflection.Model,
-  BaseParameters = DefaultBaseParameters<Resource>
-> is ArmCustomPatchSync<Resource, ResourceUpdateModel<Resource, Properties>, BaseParameters>;
+  BaseParameters = DefaultBaseParameters<Resource>,
+  Parameters extends {} = {}
+> is ArmCustomPatchSync<
+  Resource,
+  ResourceUpdateModel<Resource, Properties>,
+  BaseParameters,
+  Parameters
+>;
 
 /**
  * A resource update using a custom PATCH payload (synchronous)
  * @template Resource the resource being patched
  * @template PatchModel The input model for the PATCH request
  * @template BaseParameters Optional. Allows overriding the operation parameters
+ * @template Parameters Optional. Additional parameters after the path parameters
+ * @template Response Optional. The success response for the patch operation
+ * @template Error Optional. The error response, if non-standard.
  */
 @autoRoute
 @doc("Update a {name}", Resource)
@@ -267,20 +365,24 @@ op ArmResourcePatchSync<
 op ArmCustomPatchSync<
   Resource extends ArmResource,
   PatchModel extends TypeSpec.Reflection.Model = TagsUpdateModel<Resource>,
-  BaseParameters = DefaultBaseParameters<Resource>
->(
-  ...ResourceInstanceParameters<Resource, BaseParameters>,
-
-  @doc("The resource properties to be updated.")
-  @body
-  properties: PatchModel,
-): ArmResponse<Resource> | ErrorResponse;
+  BaseParameters = DefaultBaseParameters<Resource>,
+  Parameters extends {} = {},
+  Response extends {} = ArmResponse<Resource>,
+  Error extends {} = ErrorResponse
+> is ArmUpdateOperation<
+  ResourceInstanceParameters<Resource, BaseParameters> & Parameters,
+  PatchModel,
+  Response,
+  Error
+>;
 
 /**
  * @dev Delete a resource asynchronously
  * @template Resource The resource being deleted
  * @template Response The response type for the operation
  * @template BaseParameters Optional. Allows overriding the parameters for the operation
+ * @template Parameters Optional. Additional parameters after the path parameters
+ * @template Error Optional. The error response, if non-standard.
  */
 @autoRoute
 @doc("Delete a {name}", Resource)
@@ -296,45 +398,54 @@ op ArmCustomPatchSync<
 op ArmResourceDeleteAsyncBase<
   Resource extends ArmResource,
   Response,
-  BaseParameters = DefaultBaseParameters<Resource>
->(...ResourceInstanceParameters<Resource, BaseParameters>): Response | ErrorResponse;
+  BaseParameters = DefaultBaseParameters<Resource>,
+  Parameters extends {} = {},
+  Error extends {} = ErrorResponse
+>(...ResourceInstanceParameters<Resource, BaseParameters>, ...Parameters): Response | Error;
 
 /**
  * @dev Delete a resource asynchronously.  DEPRECATED: Use ArmResourceDeleteWithoutOkAsync instead
  * @template Resource The resource being deleted
  * @template BaseParameters Optional. Allows overriding the parameters for the operation
  * @template LroHeaders Optional. Allows overriding the headers in the Accepted response
+ * @template Parameters Optional. Additional parameters after the path parameters
+ * @template Response Optional. The success response(s) for the delete operation
+ * @template Error Optional. The error response, if non-standard.
  */
 op ArmResourceDeleteAsync<
   Resource extends ArmResource,
   BaseParameters = DefaultBaseParameters<Resource>,
-  LroHeaders extends TypeSpec.Reflection.Model = ArmLroLocationHeader
-> is ArmResourceDeleteAsyncBase<
-  Resource,
-  ArmDeletedResponse | ArmDeleteAcceptedLroResponse<LroHeaders> | ArmDeletedNoContentResponse,
-  BaseParameters
->;
+  LroHeaders extends TypeSpec.Reflection.Model = ArmLroLocationHeader,
+  Parameters extends {} = {},
+  Response extends {} = ArmDeletedResponse | ArmDeleteAcceptedLroResponse<LroHeaders> | ArmDeletedNoContentResponse,
+  Error extends {} = ErrorResponse
+> is ArmResourceDeleteAsyncBase<Resource, Response, BaseParameters, Parameters, Error>;
 
 /**
  * @dev Delete a resource asynchronously
  * @template Resource The resource being deleted
  * @template BaseParameters Optional. Allows overriding the parameters for the operation
  * @template LroHeaders Optional. Allows overriding the headers returned in the Accepted response
+ * @template Parameters Optional. Additional parameters after the path parameters
+ * @template Response Optional. The success response(s) for the delete operation
+ * @template Error Optional. The error response, if non-standard.
  */
 op ArmResourceDeleteWithoutOkAsync<
   Resource extends ArmResource,
   BaseParameters = DefaultBaseParameters<Resource>,
-  LroHeaders extends TypeSpec.Reflection.Model = ArmLroLocationHeader
-> is ArmResourceDeleteAsyncBase<
-  Resource,
-  ArmDeleteAcceptedLroResponse<LroHeaders> | ArmDeletedNoContentResponse,
-  BaseParameters
->;
+  LroHeaders extends TypeSpec.Reflection.Model = ArmLroLocationHeader,
+  Parameters extends {} = {},
+  Response extends {} = ArmDeleteAcceptedLroResponse<LroHeaders> | ArmDeletedNoContentResponse,
+  Error extends {} = ErrorResponse
+> is ArmResourceDeleteAsyncBase<Resource, Response, BaseParameters, Parameters, Error>;
 
 /**
  * Delete a resource synchronously
  * @template Resource The resource being deleted
  * @template BaseParameters Optional. Allows overriding the parameters for the operation
+ * @template Parameters Optional. Additional parameters after the path parameters
+ * @template Response Optional. The success response(s) for the delete operation
+ * @template Error Optional. The error response, if non-standard.
  */
 @autoRoute
 @doc("Delete a {name}", Resource)
@@ -342,10 +453,11 @@ op ArmResourceDeleteWithoutOkAsync<
 @delete
 op ArmResourceDeleteSync<
   Resource extends ArmResource,
-  BaseParameters = DefaultBaseParameters<Resource>
->(
-  ...ResourceInstanceParameters<Resource, BaseParameters>,
-): ArmDeletedResponse | ArmDeletedNoContentResponse | ErrorResponse;
+  BaseParameters = DefaultBaseParameters<Resource>,
+  Parameters extends {} = {},
+  Response extends {} = ArmDeletedResponse | ArmDeletedNoContentResponse,
+  Error = ErrorResponse
+>(...ResourceInstanceParameters<Resource, BaseParameters>, ...Parameters): Response | Error;
 
 /**
  * A long-running resource action.
@@ -353,6 +465,8 @@ op ArmResourceDeleteSync<
  * @template Request The request model for the action
  * @template Response The response type for the action
  * @template BaseParameters Optional. Allows overriding the parameters for the operation
+ * @template Parameters Optional. Additional parameters after the path parameters
+ * @template Error Optional. The error response, if non-standard.
  */
 @autoRoute
 @extension("x-ms-long-running-operation", true)
@@ -368,14 +482,17 @@ op ArmResourceActionAsyncBase<
   Resource extends ArmResource,
   Request extends TypeSpec.Reflection.Model | void,
   Response extends TypeSpec.Reflection.Model | void,
-  BaseParameters extends TypeSpec.Reflection.Model
+  BaseParameters extends TypeSpec.Reflection.Model,
+  Parameters extends {} = {},
+  Error extends {} = ErrorResponse
 >(
   ...ResourceInstanceParameters<Resource, BaseParameters>,
+  ...Parameters,
 
   @doc("The content of the action request")
   @body
   body: Request,
-): Response | ErrorResponse;
+): Response | Error;
 
 /**
  * @dev A long-running resource action.
@@ -384,8 +501,10 @@ op ArmResourceActionAsyncBase<
  * @template Response The response model for the action
  * @template BaseParameters Optional. Allows overriding the parameters for the operation
  * @template LroHeaders Optional. Allows overriding the headers returned in the Accepted response
+ * @template Parameters Optional. Additional parameters after the path parameters
+ * @template Error Optional. The error response, if non-standard.
  */
-@returnsDoc("ARM operation completed successfully.")
+@returnsDoc("Azure operation completed successfully.")
 op ArmResourceActionAsync<
   Resource extends ArmResource,
   Request extends TypeSpec.Reflection.Model | void,
@@ -395,12 +514,16 @@ op ArmResourceActionAsync<
     Azure.Core.StatusMonitorPollingOptions<ArmOperationStatus>,
     Response,
     string
-  >
+  >,
+  Parameters extends {} = {},
+  Error extends {} = ErrorResponse
 > is ArmResourceActionAsyncBase<
   Resource,
   Request,
   ArmAcceptedLroResponse<"Resource operation accepted.", LroHeaders> | Response,
-  BaseParameters
+  BaseParameters,
+  Parameters,
+  Error
 >;
 
 /**
@@ -409,23 +532,28 @@ op ArmResourceActionAsync<
  * @template Request The request model for the action
  * @template Response The response model for the action
  * @template BaseParameters Optional. Allows overriding the parameters for the operation
+ * @template Parameters Optional. Additional parameters after the path parameters
+ * @template Error Optional. The error response, if non-standard.
  */
 @autoRoute
 @armResourceAction(Resource)
 @post
-@returnsDoc("ARM operation completed successfully.")
+@returnsDoc("Azure operation completed successfully.")
 op ArmResourceActionSync<
   Resource extends ArmResource,
   Request extends TypeSpec.Reflection.Model | void,
   Response extends TypeSpec.Reflection.Model | void,
-  BaseParameters = DefaultBaseParameters<Resource>
+  BaseParameters = DefaultBaseParameters<Resource>,
+  Parameters extends {} = {},
+  Error extends {} = ErrorResponse
 >(
   ...ResourceInstanceParameters<Resource, BaseParameters>,
+  ...Parameters,
 
   @doc("The content of the action request")
   @body
   body: Request,
-): Response | ErrorResponse;
+): Response | Error;
 
 /**
  * @dev A long-running resource action that returns no content. DEPRECATED: Use 'ArmResourceActionNoResponseContentAsync' instead
@@ -433,7 +561,8 @@ op ArmResourceActionSync<
  * @template Request The request model for the action
  * @template BaseParameters Optional. Allows overriding the parameters for the operation
  * @template LroHeaders Optional. Allows overriding the headers returned in the Accepted response
- *
+ * @template Parameters Optional. Additional parameters after the path parameters
+ * @template Error Optional. The error response, if non-standard.
  */
 op ArmResourceActionNoContentAsync<
   Resource extends ArmResource,
@@ -443,12 +572,16 @@ op ArmResourceActionNoContentAsync<
     Azure.Core.StatusMonitorPollingOptions<ArmOperationStatus>,
     void,
     string
-  >
+  >,
+  Parameters extends {} = {},
+  Error extends {} = ErrorResponse
 > is ArmResourceActionAsyncBase<
   Resource,
   Request,
   ArmAcceptedLroResponse | ArmNoContentResponse<"Action completed successfully.">,
-  BaseParameters
+  BaseParameters,
+  Parameters,
+  Error
 >;
 
 /**
@@ -457,6 +590,8 @@ op ArmResourceActionNoContentAsync<
  * @template Request The request model for the action
  * @template BaseParameters Optional. Allows overriding the parameters for the operation
  * @template Headers Optional. Allows overriding the headers returned in the Accepted response
+ * @template Parameters Optional. Additional parameters after the path parameters
+ * @template Error Optional. The error response, if non-standard.
  */
 op ArmResourceActionNoResponseContentAsync<
   Resource extends ArmResource,
@@ -466,12 +601,16 @@ op ArmResourceActionNoResponseContentAsync<
     Azure.Core.StatusMonitorPollingOptions<ArmOperationStatus>,
     void,
     string
-  >
+  >,
+  Parameters extends {} = {},
+  Error extends {} = ErrorResponse
 > is ArmResourceActionAsyncBase<
   Resource,
   Request,
   ArmAcceptedLroResponse<"Resource operation accepted.", LroHeaders>,
-  BaseParameters
+  BaseParameters,
+  Parameters,
+  Error
 >;
 
 /**
@@ -479,6 +618,8 @@ op ArmResourceActionNoResponseContentAsync<
  * @template Resource The resource being acted upon
  * @template Request The request model for the action
  * @template BaseParameters Optional. Allows overriding the parameters for the operation
+ * @template Parameters Optional. Additional parameters after the path parameters
+ * @template Error Optional. The error response, if non-standard.
  */
 @autoRoute
 @armResourceAction(Resource)
@@ -486,14 +627,17 @@ op ArmResourceActionNoResponseContentAsync<
 op ArmResourceActionNoContentSync<
   Resource extends ArmResource,
   Request extends TypeSpec.Reflection.Model | void,
-  BaseParameters = DefaultBaseParameters<Resource>
+  BaseParameters = DefaultBaseParameters<Resource>,
+  Parameters extends {} = {},
+  Error extends {} = ErrorResponse
 >(
   ...ResourceInstanceParameters<Resource, BaseParameters>,
+  ...Parameters,
 
   @doc("The content of the action request")
   @body
   body: Request,
-): ArmNoContentResponse<"Action completed successfully."> | ErrorResponse;
+): ArmNoContentResponse<"Action completed successfully."> | Error;
 
 /**
  * @dev Adds check global name availability operation, normally used if

package/lib/private.decorators.tsp

@@ -5,7 +5,7 @@ namespace Azure.ResourceManager.Private;
 using TypeSpec.Reflection;
 
 /**
- * Update the ARM provider namespace for a given entity.
+ * Update the Azure Resource Manager provider namespace for a given entity.
  */
 extern dec armUpdateProviderNamespace(target: Reflection.Operation);
 
@@ -25,7 +25,7 @@ alias ArmCommonTypeVersionSpec = {
 
 /**
  * @param definitionName Definition name
- * @param version Arm Version
+ * @param version Azure Resource Manager Version
  * @param referenceFile Reference file
  */
 extern dec armCommonDefinition(
@@ -37,7 +37,7 @@ extern dec armCommonDefinition(
 
 /**
  * @param definitionName Definition name
- * @param version Arm Version
+ * @param version Azure Resource Manager Version
  * @param referenceFile Reference file
  */
 extern dec armCommonParameter(
@@ -48,7 +48,7 @@ extern dec armCommonParameter(
 );
 
 /**
- * This decorator is used to identify ARM resource types and extract their
+ * This decorator is used to identify Azure Resource Manager resource types and extract their
  * metadata.  It is *not* meant to be used directly by a spec author, it instead
  * gets implicitly applied when the spec author defines a model type in this form:
  *
@@ -58,7 +58,7 @@ extern dec armCommonParameter(
  * `@armResource` decorator, so it also gets applied to the type which absorbs the
  * `TrackedResource<Resource>` definition by using the `is` keyword.
  *
- * @param properties Arm resource properties
+ * @param properties Azure Resource Manager resource properties
  */
 extern dec armResourceInternal(target: Model, properties: Model);
 

package/lib/responses.tsp

@@ -7,20 +7,20 @@ using Azure.ResourceManager.Private;
 namespace Azure.ResourceManager;
 
 /**
- * The ARM synchronous OK response
+ * The Azure Resource Manager synchronous OK response
  * @template ResponseBody The contents of the response body
  */
-@doc("ARM operation completed successfully.")
+@doc("Azure operation completed successfully.")
 model ArmResponse<ResponseBody> {
   ...OkResponse;
   ...Body<ResponseBody>;
 }
 
 /**
- * The ARM 201 response for a resource
+ * The Azure Resource Manager 201 response for a resource
  * @template ResponseBody The contents of the response body
  */
-@doc("ARM create operation completed successfully.")
+@doc("Azure create operation completed successfully.")
 model ArmCreatedResponse<ResponseBody> {
   ...CreatedResponse;
   ...Azure.Core.Foundations.RetryAfterHeader;
@@ -36,14 +36,14 @@ model ArmDeletedResponse {
 }
 
 /**
- * @dev The response for asynchronous ARM delete ACCEPTED
+ * @dev The response for asynchronous Azure Resource Manager delete ACCEPTED
  * @template LroHeaders Optional.  Allows overriding the Lro headers returned in the response.
  */
 model ArmDeleteAcceptedLroResponse<LroHeaders extends TypeSpec.Reflection.Model = ArmLroLocationHeader>
   is ArmAcceptedLroResponse<"Resource deletion accepted.", LroHeaders>;
 
 /**
- * @dev The response for synchronous ARM delete ACCEPTED
+ * @dev The response for synchronous Azure Resource Manager delete ACCEPTED
  */
 model ArmDeleteAcceptedResponse is ArmAcceptedResponse<"Resource deletion accepted.">;
 
@@ -58,7 +58,7 @@ model ArmAcceptedResponse<Message extends valueof string = "Resource operation a
 }
 
 /**
- * @dev The standard ARM response for asynchronous PATCH, POST, and DELETE operations
+ * @dev The standard Azure Resource Manager response for asynchronous PATCH, POST, and DELETE operations
  * @template Description The description of the response status (defaults to `Resource operation accepted`)
  * @template LroHeaders Optional.  The lro headers that appear in the Accepted response
  */
@@ -73,7 +73,7 @@ model ArmAcceptedLroResponse<
 }
 
 /**
- * Standard ARM operation status response
+ * Standard Azure Resource Manager operation status response
  * @template Properties Optional resource-specific properties
  * @template StatusValues The set of allowed values for operation status
  */
@@ -174,12 +174,12 @@ model ArmCombinedLroHeaders<
 }
 
 /**
- * @dev ARM response for a properly formed delete request, with no resource found
+ * @dev Azure Resource Manager response for a properly formed delete request, with no resource found
  */
-model ArmDeletedNoContentResponse is ArmNoContentResponse<"Resource deleted successfully.">;
+model ArmDeletedNoContentResponse is ArmNoContentResponse<"Resource does not exist.">;
 
 /**
- * Standard ARM NoContent (204) response
+ * Standard Azure Resource Manager NoContent (204) response
  * @template Message The description of the response status (defaults to `Operation completed successfully`)
  */
 @doc(Message)
@@ -226,7 +226,7 @@ model ArmResourceCreatedSyncResponse<Resource extends Azure.ResourceManager.Foun
 }
 
 /**
- * The standard ARM error response
+ * The standard Azure Resource Manager error response
  */
 @error
 @armCommonDefinition("ErrorResponse", Azure.ResourceManager.CommonTypes.Versions.v3)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure-tools/typespec-azure-resource-manager",
-  "version": "0.39.0-dev.0",
+  "version": "0.39.0-dev.1",
   "author": "Microsoft Corporation",
   "description": "TypeSpec Azure Resource Manager library",
   "homepage": "https://azure.github.io/typespec-azure",
@@ -41,7 +41,7 @@
   "peerDependencies": {
     "@typespec/compiler": "~0.52.0 || >=0.53.0-dev <0.53.0",
     "@azure-tools/typespec-azure-core": "~0.38.0 || >=0.39.0-dev <0.39.0",
-    "@azure-tools/typespec-autorest": "~0.38.0 || >=0.39.0-dev <0.39.0",
+    "@azure-tools/typespec-autorest": "~0.38.1 || >=0.39.0-dev <0.39.0",
     "@typespec/openapi": "~0.52.0 || >=0.53.0-dev <0.53.0",
     "@typespec/rest": "~0.52.0 || >=0.53.0-dev <0.53.0",
     "@typespec/http": "~0.52.0 || >=0.53.0-dev <0.53.0",
@@ -51,7 +51,7 @@
     "@typespec/compiler": "~0.52.0 || >=0.53.0-dev <0.53.0",
     "@typespec/openapi": "~0.52.0 || >=0.53.0-dev <0.53.0",
     "@azure-tools/typespec-azure-core": "~0.38.0 || >=0.39.0-dev <0.39.0",
-    "@azure-tools/typespec-autorest": "~0.38.0 || >=0.39.0-dev <0.39.0",
+    "@azure-tools/typespec-autorest": "~0.38.1 || >=0.39.0-dev <0.39.0",
     "@typespec/rest": "~0.52.0 || >=0.53.0-dev <0.53.0",
     "@typespec/http": "~0.52.0 || >=0.53.0-dev <0.53.0",
     "@typespec/versioning": "~0.52.0 || >=0.53.0-dev <0.53.0",