@azure-tools/typespec-azure-resource-manager 0.59.0-dev.3 → 0.59.0-dev.6

package/lib/Legacy/interfaces.tsp

@@ -29,7 +29,7 @@ interface Operations<
   @get
   @list
   list(
-    ...ApiVersionParameter,
+    ...CommonTypes.ApiVersionParameter,
 
     @path
     @segment("providers")

package/lib/Legacy/operations.tsp

@@ -403,10 +403,10 @@ model ProviderParameter<Resource extends {}> {
 @doc("Update a {name}", Resource)
 @armResourceUpdate(Resource)
 @Private.enforceConstraint(Resource, Foundations.Resource)
-@patch(#{ implicitOptionality: true })
+@patch(#{ implicitOptionality: false })
 op CustomPatchAsync<
   Resource extends Foundations.SimpleResource,
-  PatchModel extends TypeSpec.Reflection.Model = TagsUpdateModel<Resource>,
+  PatchModel extends TypeSpec.Reflection.Model | void = TagsUpdateModel<Resource>,
   BaseParameters = DefaultBaseParameters<Resource>,
   LroHeaders extends TypeSpec.Reflection.Model = ArmLroLocationHeader<
     Azure.Core.StatusMonitorPollingOptions<ArmOperationStatus>,
@@ -443,10 +443,10 @@ op CustomPatchAsync<
 @doc("Update a {name}", Resource)
 @armResourceUpdate(Resource)
 @Private.enforceConstraint(Resource, Foundations.Resource)
-@patch(#{ implicitOptionality: true })
+@patch(#{ implicitOptionality: false })
 op CustomPatchSync<
   Resource extends Foundations.SimpleResource,
-  PatchModel extends TypeSpec.Reflection.Model = TagsUpdateModel<Resource>,
+  PatchModel extends TypeSpec.Reflection.Model | void = TagsUpdateModel<Resource>,
   BaseParameters = DefaultBaseParameters<Resource>,
   Parameters extends {} = {},
   Response extends {} = ArmResponse<Resource>,
@@ -460,6 +460,96 @@ op CustomPatchSync<
   OptionalRequestBody
 >;
 
+/**
+ * A long-running resource CreateOrUpdate (PUT)
+ * @template Resource the resource being created or updated
+ * @template Request The request body for the operation
+ * @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.
+ * @template OptionalRequestBody Optional. Indicates whether the request body is optional
+ */
+@autoRoute
+@doc("Create a {name}", Resource)
+@armResourceCreateOrUpdate(Resource)
+@Private.enforceConstraint(Resource, Foundations.Resource)
+@Azure.Core.Foundations.Private.defaultFinalStateVia(#["location", "azure-async-operation"])
+@put
+op CreateOrUpdateAsync<
+  Resource extends Foundations.SimpleResource,
+  Request extends {} | void = Resource,
+  BaseParameters = DefaultBaseParameters<Resource>,
+  LroHeaders extends TypeSpec.Reflection.Model = ArmAsyncOperationHeader<FinalResult = Resource> &
+    Azure.Core.Foundations.RetryAfterHeader,
+  Parameters extends {} = {},
+  Response extends {} = ArmResourceUpdatedResponse<Resource> | ArmResourceCreatedResponse<
+    Resource,
+    LroHeaders
+  >,
+  Error extends {} = ErrorResponse,
+  OptionalRequestBody extends valueof boolean = false
+> is CreateOperation<
+  ResourceInstanceParameters<Resource, BaseParameters> & Parameters,
+  Request,
+  Response,
+  Error,
+  OptionalRequestBody
+>;
+
+/**
+ * Synchronous PUT operation for Azure Resource Manager resources
+ * @template Resource the resource being created or replaced
+ * @template Request The request body for the operation
+ * @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.
+ * @template OptionalRequestBody Optional. Indicates whether the request body is optional
+ */
+@autoRoute
+@doc("Create a {name}", Resource)
+@armResourceCreateOrUpdate(Resource)
+@Private.enforceConstraint(Resource, Foundations.Resource)
+@put
+op CreateOrUpdateSync<
+  Resource extends Foundations.SimpleResource,
+  Request extends {} | void = Resource,
+  BaseParameters = DefaultBaseParameters<Resource>,
+  Parameters extends {} = {},
+  Response extends {} = ArmResourceUpdatedResponse<Resource> | ArmResourceCreatedSyncResponse<Resource>,
+  Error extends {} = ErrorResponse,
+  OptionalRequestBody extends valueof boolean = false
+> is CreateOperation<
+  ResourceInstanceParameters<Resource, BaseParameters> & Parameters,
+  Request,
+  Response,
+  Error,
+  OptionalRequestBody
+>;
+
+/**
+ * @dev The base template for Azure Resource Manager PUT Operations.
+ * @template HttpParameters The parameter object for the operation.
+ * @template BodyParameter The body parameter
+ * @template Response The response or union of responses for success.
+ * @template ErrorResponse The error response.
+ */
+op CreateOperation<
+  HttpParameters extends {},
+  BodyParameter extends {} | void,
+  Response extends {},
+  ErrorResponse extends {},
+  OptionalRequestBody extends valueof boolean = false
+>(
+  ...HttpParameters,
+
+  @doc("Resource create parameters.")
+  @armBodyRoot(OptionalRequestBody)
+  resource: BodyParameter,
+): Response | ErrorResponse;
+
 /**
  * @dev The base template for Legacy Azure Resource Manager PATCH Operations.
  * @template HttpParameters The parameter object for the operation.
@@ -470,7 +560,7 @@ op CustomPatchSync<
  */
 op UpdateOperation<
   HttpParameters extends {},
-  BodyParameter extends {},
+  BodyParameter extends {} | void,
   Response extends {},
   ErrorResponse extends {},
   OptionalRequestBody extends valueof boolean = false

package/lib/foundations/arm.foundations.tsp

@@ -29,16 +29,16 @@ alias BaseParameters<Resource extends {}> = DefaultBaseParameters<Resource>;
  */
 @resourceBaseParametersOf(Resource)
 model DefaultBaseParameters<Resource extends {}> {
-  ...ApiVersionParameter;
+  ...CommonTypes.ApiVersionParameter;
 
   // unless tenant or extension
-  ...SubscriptionIdParameter;
+  ...CommonTypes.SubscriptionIdParameter;
 
   // deprecated, should not be used
-  ...LocationParameter;
+  ...CommonTypes.LocationParameter;
 
   // unless tenant, subscription, location, or extension
-  ...ResourceGroupParameter;
+  ...CommonTypes.ResourceGroupNameParameter;
 
   // unless tenant, subscription, location, or resourceGroup
   ...ResourceUriParameter;
@@ -59,14 +59,14 @@ model ArmTagsProperty {
  * The static parameters for a tenant-based resource
  */
 model TenantBaseParameters {
-  ...ApiVersionParameter;
+  ...CommonTypes.ApiVersionParameter;
 }
 
 /**
  * The static parameters for a subscription based resource
  */
 model SubscriptionBaseParameters is TenantBaseParameters {
-  ...SubscriptionIdParameter;
+  ...CommonTypes.SubscriptionIdParameter;
 }
 
 /**
@@ -80,7 +80,7 @@ model LocationBaseParameters is SubscriptionBaseParameters {
  * The static parameters for a resource-group based resource
  */
 model ResourceGroupBaseParameters is SubscriptionBaseParameters {
-  ...ResourceGroupParameter;
+  ...CommonTypes.ResourceGroupNameParameter;
 }
 
 /**
@@ -234,7 +234,7 @@ op checkNameAvailability<
   Response extends TypeSpec.Reflection.Model = CheckNameAvailabilityResponse,
   AdditionalParams extends TypeSpec.Reflection.Model = {}
 >(
-  ...ApiVersionParameter,
+  ...CommonTypes.ApiVersionParameter,
   ...ScopeParameters,
   ...AdditionalParams,
 

package/lib/interfaces.tsp

@@ -21,7 +21,7 @@ interface Operations {
   @get
   @list
   list(
-    ...ApiVersionParameter,
+    ...CommonTypes.ApiVersionParameter,
 
     @path
     @segment("providers")

package/lib/operations.tsp

@@ -689,7 +689,7 @@ op checkGlobalNameAvailability<
   Response extends TypeSpec.Reflection.Model = CheckNameAvailabilityResponse,
   AdditionalParams extends TypeSpec.Reflection.Model = {}
 > is checkNameAvailability<
-  SubscriptionIdParameter & DefaultProviderNamespace,
+  CommonTypes.SubscriptionIdParameter & DefaultProviderNamespace,
   Request,
   Response,
   AdditionalParams
@@ -709,7 +709,7 @@ op checkLocalNameAvailability<
   Response extends TypeSpec.Reflection.Model = CheckNameAvailabilityResponse,
   AdditionalParams extends TypeSpec.Reflection.Model = {}
 > is checkNameAvailability<
-  SubscriptionIdParameter & DefaultProviderNamespace & LocationResourceParameter,
+  CommonTypes.SubscriptionIdParameter & DefaultProviderNamespace & LocationResourceParameter,
   Request,
   Response,
   AdditionalParams

package/package.json

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