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

package/lib/Legacy/operations.tsp

@@ -32,6 +32,7 @@ interface LegacyOperations<
   @autoRoute
   @doc("Create a {name}", Resource)
   @armResourceCreateOrUpdate(Resource)
+  @Private.armUpdateProviderNamespace
   @Azure.Core.Foundations.Private.defaultFinalStateVia(#["location", "azure-async-operation"])
   @put
   CreateOrUpdateAsync<
@@ -62,6 +63,7 @@ interface LegacyOperations<
   @autoRoute
   @doc("Create a {name}", Resource)
   @armResourceCreateOrUpdate(Resource)
+  @Private.armUpdateProviderNamespace
   @put
   CreateOrUpdateSync<
     Resource extends Foundations.SimpleResource,
@@ -87,6 +89,7 @@ interface LegacyOperations<
   @autoRoute
   @doc("Update a {name}", Resource)
   @armResourceUpdate(Resource)
+  @Private.armUpdateProviderNamespace
   @patch(#{ implicitOptionality: false })
   CustomPatchAsync<
     Resource extends Foundations.SimpleResource,
@@ -121,6 +124,7 @@ interface LegacyOperations<
   @autoRoute
   @doc("Update a {name}", Resource)
   @armResourceUpdate(Resource)
+  @Private.armUpdateProviderNamespace
   @patch(#{ implicitOptionality: false })
   CustomPatchSync<
     Resource extends Foundations.SimpleResource,
@@ -147,6 +151,7 @@ interface LegacyOperations<
   @doc("Delete a {name}", Resource)
   @delete
   @deletesResource(Resource)
+  @Private.armUpdateProviderNamespace
   @armResourceDelete(Resource)
   DeleteWithoutOkAsync<
     Resource extends Foundations.SimpleResource,
@@ -168,6 +173,7 @@ interface LegacyOperations<
   @delete
   @deletesResource(Resource)
   @armResourceDelete(Resource)
+  @Private.armUpdateProviderNamespace
   DeleteSync<
     Resource extends Foundations.SimpleResource,
     Parameters extends {} = {},
@@ -185,12 +191,33 @@ interface LegacyOperations<
   @get
   @readsResource(Resource)
   @armResourceRead(Resource)
+  @Private.armUpdateProviderNamespace
   Read<
     Resource extends Foundations.SimpleResource,
     Parameters extends {} = {},
     Response extends {} = ArmResponse<Resource>
   >(...ParentParameters, ...ResourceTypeParameter, ...Parameters): Response | ErrorType;
 
+  /**
+   * Check a resource's existence via HEAD operation
+   * @template Resource The resource being checked
+   * @template Parameters Optional. Additional parameters after the path parameters
+   * @template Response Optional. The success response for a head operation (by default NoContent or NotFound response).
+   */
+  @autoRoute
+  @doc("Check for the existence of a {name}", Resource)
+  @Private.armUpdateProviderNamespace
+  @head
+  CheckExistence<
+    Resource extends Foundations.SimpleResource,
+    Parameters extends {} = {},
+    Response extends {} = ArmResourceExistsResponse | ArmResourceNotFoundResponse
+  > is Foundations.ArmReadOperation<
+    ParentParameters & ResourceTypeParameter & Parameters,
+    Response,
+    ErrorType
+  >;
+
   /**
    * List a resource
    * @template Resource The resource being listed
@@ -203,6 +230,7 @@ interface LegacyOperations<
   @listsResource(Resource)
   @segmentOf(Resource)
   @armResourceList(Resource)
+  @Private.armUpdateProviderNamespace
   List<
     Resource extends Foundations.SimpleResource,
     Parameters extends {} = {},
@@ -222,6 +250,7 @@ interface LegacyOperations<
   @armResourceAction(Resource)
   @Private.enforceConstraint(Resource, Foundations.Resource)
   @post
+  @Private.armUpdateProviderNamespace
   @returnsDoc("Azure operation completed successfully.")
   ActionSync<
     Resource extends Foundations.SimpleResource,
@@ -243,8 +272,9 @@ interface LegacyOperations<
    * A long-running resource action.
    * @template Resource The resource being acted upon
    * @template Request The request model for the action
+   * @template Result The result model for the action when the operation is successful
    * @template LroHeaders Optional. Allows overriding the headers returned in the Accepted response
-   * @template Response The response model for the action
+   * @template Response The union of successful responses for the action
    * @template Parameters Optional. Additional parameters after the path parameters
    * @template OptionalRequestBody Optional. Indicates whether the request body is optional
    */
@@ -253,6 +283,7 @@ interface LegacyOperations<
   @autoRoute
   @armResourceAction(Resource)
   @Private.enforceConstraint(Resource, Foundations.Resource)
+  @Private.armUpdateProviderNamespace
   @post
   @returnsDoc("Azure operation completed successfully.")
   ActionAsync<
@@ -282,13 +313,21 @@ interface LegacyOperations<
   ): Response | ErrorType;
 }
 /**
- * @dev Get the provider namespace key-value pair
+ * @dev DEPRECATED: Use ProviderParameter instead. Get the provider namespace key-value pair
  * @template Resource Optional.  The resource to get the provider namespace for.
  */
 model Provider<Resource extends {} = TenantActionScope> {
   ...ProviderNamespace<Resource>;
 }
 
+/**
+ * @dev Get the provider namespace key-value pair
+ * @template Resource The resource to get the provider namespace for.
+ */
+model ProviderParameter<Resource extends {}> {
+  ...ProviderNamespace<Resource>;
+}
+
 /**
  * A long-running resource update using a custom PATCH payload (Asynchronous)
  * @template Resource the resource being patched

package/lib/arm.tsp

@@ -8,6 +8,7 @@ import "@azure-tools/typespec-azure-core";
 import "./foundations/arm.foundations.tsp";
 import "./Legacy/arm.legacy.tsp";
 import "./common-types/common-types.tsp";
+import "./extension/extension.tsp";
 import "./backcompat.tsp";
 import "./private.decorators.tsp";
 import "./models.tsp";

package/lib/common-types/internal.tsp

@@ -18,6 +18,15 @@ enum ResourceHome {
 
   @doc("The resource is bound to an extension")
   Extension,
+
+  @doc("The resource is a built in tenant resource")
+  BuiltIn,
+
+  @doc("The resource is a built in subscription resource")
+  BuiltInSubscription,
+
+  @doc("The resource is a built in resource group resource")
+  BuiltInResourceGroup,
 }
 
 /** Alias of keyEncryptionKeyIdentity for back compatibility. Please change to keyEncryptionKeyIdentity. */

package/lib/common-types/types-ref.tsp

@@ -376,7 +376,10 @@ namespace Azure.ResourceManager.CommonTypes;
     ResourceHome.Subscription,
     ResourceHome.Location,
     ResourceHome.Tenant,
-    ResourceHome.Extension
+    ResourceHome.Extension,
+    ResourceHome.BuiltIn,
+    ResourceHome.BuiltInSubscription,
+    ResourceHome.BuiltInResourceGroup
   ]
 );
 
@@ -398,7 +401,13 @@ namespace Azure.ResourceManager.CommonTypes;
   Azure.ResourceManager.CommonTypes.Versions.v6
 );
 @@resourceParameterBaseFor(SubscriptionIdParameter.subscriptionId,
-  [ResourceHome.ResourceGroup, ResourceHome.Subscription, ResourceHome.Location]
+  [
+    ResourceHome.ResourceGroup,
+    ResourceHome.Subscription,
+    ResourceHome.Location,
+    ResourceHome.BuiltInSubscription,
+    ResourceHome.BuiltInResourceGroup
+  ]
 );
 
 /** ResourceGroupNameParameter */
@@ -419,7 +428,7 @@ namespace Azure.ResourceManager.CommonTypes;
   Azure.ResourceManager.CommonTypes.Versions.v6
 );
 @@resourceParameterBaseFor(ResourceGroupNameParameter.resourceGroupName,
-  [ResourceHome.ResourceGroup]
+  [ResourceHome.ResourceGroup, ResourceHome.BuiltInResourceGroup]
 );
 
 /** ManagementGroupNameParameter */

package/lib/decorators.tsp

@@ -180,7 +180,7 @@ extern dec armCommonTypesVersion(
  *
  * @param propertiesType: The type of the resource properties.
  */
-extern dec armVirtualResource(target: Model);
+extern dec armVirtualResource(target: Model, provider?: valueof string);
 
 /**
  * This decorator sets the base type of the given resource.

package/lib/extension/extension.tsp

@@ -0,0 +1,6 @@
+import "@azure-tools/typespec-azure-core";
+import "./operations.tsp";
+import "./parameters.tsp";
+import "./private.decorators.tsp";
+
+namespace Azure.ResourceManager.Extension;