@azure-tools/typespec-azure-resource-manager 0.67.0-dev.2 → 0.67.0-dev.3

package/lib/operations.tsp

@@ -137,6 +137,42 @@ op ArmResourceCheckExistence<
   Error
 >;
 
+/**
+ * A resource GET operation template for an Azure Resource Manager Operation Status endpoint.
+ * The path is determined by the `Scope` parameter. Use one of the four standard scope models:
+ * - `TenantActionScope` (default): `GET /providers/{providerNamespace}/operationStatuses/{operationId}`
+ * - `SubscriptionActionScope`: `GET /subscriptions/{subscriptionId}/providers/{providerNamespace}/operationStatuses/{operationId}`
+ * - `TenantLocationActionScope`: `GET /providers/{providerNamespace}/locations/{location}/operationStatuses/{operationId}`
+ * - `SubscriptionLocationActionScope`: `GET /subscriptions/{subscriptionId}/providers/{providerNamespace}/locations/{location}/operationStatuses/{operationId}`
+ *
+ * @template Response The type of the response body. Defaults to ArmOperationStatus.
+ * @template Scope The scope of the operation. Defaults to TenantActionScope.
+ * @template Parameters Optional. Additional non-path parameters (e.g. query or header parameters).
+ * @template Error Optional. The error response, if non-standard.
+ */
+@autoRoute
+@doc("Get the status of an async operation.")
+@get
+@armResourceCollectionAction
+@Private.armUpdateProviderNamespace
+op GetResourceOperationStatus<
+  Response extends {} = ArmOperationStatus,
+  Scope extends {} = TenantActionScope,
+  Parameters extends {} = {},
+  Error extends {} = ErrorResponse
+>(
+  ...Azure.ResourceManager.Foundations.DefaultBaseParameters<Scope>,
+  ...ProviderNamespace<Scope>,
+  ...Scope,
+
+  @path
+  @segment("operationStatuses")
+  @doc("The operation ID.")
+  operationId: string,
+
+  ...Parameters,
+): ArmResponse<Response> | Error;
+
 /**
  * A long-running resource CreateOrUpdate (PUT)
  * @template Resource the resource being created or updated

package/lib/parameters.tsp

@@ -219,6 +219,38 @@ model TenantActionScope {
   name: string;
 }
 
+/**
+ * Scope for operation status endpoints at the tenant level with a location path segment.
+ * Use with `GetResourceOperationStatus` to produce:
+ * `GET /providers/{providerNamespace}/locations/{location}/operationStatuses/{operationId}`
+ *
+ * @example
+ * ```typespec
+ * op getStatus is GetResourceOperationStatus<ArmOperationStatus, TenantLocationActionScope>;
+ * ```
+ */
+@armVirtualResource
+@tenantResource
+model TenantLocationActionScope {
+  ...LocationResourceParameter;
+}
+
+/**
+ * Scope for operation status endpoints at the subscription level with a location path segment.
+ * Use with `GetResourceOperationStatus` to produce:
+ * `GET /subscriptions/{subscriptionId}/providers/{providerNamespace}/locations/{location}/operationStatuses/{operationId}`
+ *
+ * @example
+ * ```typespec
+ * op getStatus is GetResourceOperationStatus<ArmOperationStatus, SubscriptionLocationActionScope>;
+ * ```
+ */
+@armVirtualResource
+@subscriptionResource
+model SubscriptionLocationActionScope {
+  ...LocationResourceParameter;
+}
+
 /**
  * Template used by ArmProviderAction templates. This produces following action route:
  * `/{resourceUri}/providers/Microsoft.SomeRP/someAction`

package/lib/responses.tsp

@@ -136,7 +136,9 @@ model ArmAcceptedLroResponse<
 }
 
 /**
- * Standard Azure Resource Manager operation status response
+ * Standard Azure Resource Manager operation status response, used as the response
+ * body for `GetResourceOperationStatus`.
+ *
  * @template Properties Optional resource-specific properties
  * @template StatusValues The set of allowed values for operation status
  */
@@ -153,12 +155,9 @@ model ArmOperationStatus<
   status: StatusValues;
 
   /** The unique identifier for the operationStatus resource */
-  @key
-  @path
-  @segment("operationStatuses")
   id: string;
 
-  /** The name of the  operationStatus resource */
+  /** The name of the operationStatus resource */
   @visibility(Lifecycle.Read)
   name?: string;
 

package/package.json

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