@azure-tools/typespec-azure-resource-manager 0.43.0-dev.9 → 0.44.0-dev.0

package/lib/common-types/types.tsp

@@ -1,259 +1,220 @@
 using TypeSpec.Http;
+using TypeSpec.Rest;
 using TypeSpec.OpenAPI;
+using TypeSpec.Versioning;
 using Azure.Core;
-using Azure.ResourceManager.Private;
 
-namespace Azure.ResourceManager.Foundations;
+namespace Azure.ResourceManager.CommonTypes;
 
-/**
- * Base model that defines common properties for all Azure Resource Manager resources.
- */
-@doc("Common properties for all Azure Resource Manager resources.")
+/** Common fields that are returned in the response for all Azure Resource Manager resources */
+@extension("x-ms-azure-resource", true)
 model Resource {
-  @doc("Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}")
+  /** Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} */
+  @typeChangedFrom(Versions.v4, string)
   @visibility("read")
-  id?: string;
+  id?: armResourceIdentifier;
 
-  @doc("The name of the resource")
+  /** The name of the resource */
   @visibility("read")
   name?: string;
 
-  @doc("The type of the resource. E.g. \"Microsoft.Compute/virtualMachines\" or \"Microsoft.Storage/storageAccounts\"")
+  /** The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts" */
   @visibility("read")
   type?: string;
 
-  @doc("Azure Resource Manager metadata containing createdBy and modifiedBy information.")
+  /** Azure Resource Manager metadata containing createdBy and modifiedBy information. */
   @visibility("read")
   systemData?: SystemData;
 }
 
 /** The resource model definition for an Azure Resource Manager resource with an etag. */
-@armCommonDefinition("TrackedResource", Azure.ResourceManager.CommonTypes.Versions.v3)
-@armCommonDefinition("TrackedResource", Azure.ResourceManager.CommonTypes.Versions.v4)
-@armCommonDefinition("TrackedResource", Azure.ResourceManager.CommonTypes.Versions.v5)
 model AzureEntityResource extends Resource {
   /** Resource Etag. */
   @visibility("read")
-  etag: string;
+  etag?: string;
 }
 
 /**
- * Standard type definition for Azure Resource Manager Tags property.
- *
- * It is included in the TrackedResource template definition.
+ * The resource model definition for an Azure Resource Manager tracked top level resource which has 'tags' and a 'location'
  */
-@doc("The Azure Resource Manager Resource tags.")
-model ArmTagsProperty {
-  @doc("Resource tags.")
+model TrackedResource extends Resource {
+  /** Resource tags. */
   tags?: Record<string>;
-}
 
-/**
- * The base tracked resource.
- */
-@armCommonDefinition("TrackedResource", Azure.ResourceManager.CommonTypes.Versions.v3)
-@armCommonDefinition("TrackedResource", Azure.ResourceManager.CommonTypes.Versions.v4)
-@armCommonDefinition("TrackedResource", Azure.ResourceManager.CommonTypes.Versions.v5)
-@doc("The resource model definition for an Azure Resource Manager tracked top level resource which has 'tags' and a 'location'")
-model TrackedResource extends Resource {
-  @doc("The geo-location where the resource lives")
+  /** The geo-location where the resource lives */
   @visibility("read", "create")
   location: string;
-
-  ...ArmTagsProperty;
 }
 
 /**
- * The base proxy resource.
+ * The resource model definition for a Azure Resource Manager proxy resource. It will not have tags and a location
  */
-@doc("The base proxy resource.")
-@armCommonDefinition("ProxyResource", Azure.ResourceManager.CommonTypes.Versions.v3)
-@armCommonDefinition("ProxyResource", Azure.ResourceManager.CommonTypes.Versions.v4)
-@armCommonDefinition("ProxyResource", Azure.ResourceManager.CommonTypes.Versions.v5)
 model ProxyResource extends Resource {}
 
 /**
  * The base extension resource.
  */
 // Note that ProxyResource is the base definition for both kinds of resources
-@doc("The base extension resource.")
-@armCommonDefinition("ProxyResource", Azure.ResourceManager.CommonTypes.Versions.v3)
-@armCommonDefinition("ProxyResource", Azure.ResourceManager.CommonTypes.Versions.v4)
-@armCommonDefinition("ProxyResource", Azure.ResourceManager.CommonTypes.Versions.v5)
 model ExtensionResource extends Resource {}
 
 /**
- * The SKU (Stock Keeping Unit) assigned to this resource.
+ * The resource model definition containing the full set of allowed properties for a resource. Except properties bag, there cannot be a top level property outside of this set.
+ */
+@extension("x-ms-azure-resource", true)
+model ResourceModelWithAllowedPropertySet extends TrackedResource {
+  /** The fully qualified resource ID of the resource that manages this resource. Indicates if this resource is managed by another Azure resource.
+   * If this is present, complete mode deployment will not delete the resource if it is removed from the template since it is managed by another resource. */
+  managedBy?: string;
+
+  /** 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("read", "create")
+  kind?: string;
+
+  /** The etag field is *not* required. If it is provided in the response body, it must also be provided as a header per the normal etag convention.
+   * Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19),
+   * If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. */
+  eTag?: string;
+
+  identity?: Identity;
+  sku?: Sku;
+  plan?: Plan;
+}
+
+/**
+ * The resource model definition representing SKU
  */
-@doc("The SKU (Stock Keeping Unit) assigned to this resource.")
-@armCommonDefinition("Sku", Azure.ResourceManager.CommonTypes.Versions.v3)
-@armCommonDefinition("Sku", Azure.ResourceManager.CommonTypes.Versions.v4)
-@armCommonDefinition("Sku", Azure.ResourceManager.CommonTypes.Versions.v5)
 model Sku {
-  @doc("The name of the SKU, usually a combination of letters and numbers, for example, 'P3'")
+  /** The name of the SKU. Ex - P3. It is typically a letter+number code */
   name: string;
 
-  @doc("This field is required to be implemented by the Resource Provider if the service has more than one tier, but is not required on a PUT.")
+  /** This field is required to be implemented by the Resource Provider if the service has more than one tier, but is not required on a PUT. */
   tier?: SkuTier;
 
-  @doc("The SKU size. When the name field is the combination of tier and some other value, this would be the standalone code.")
+  /** The SKU size. When the name field is the combination of tier and some other value, this would be the standalone code. */
   size?: string;
 
-  @doc("If the service has different generations of hardware, for the same SKU, then that can be captured here.")
+  /** If the service has different generations of hardware, for the same SKU, then that can be captured here. */
   family?: string;
 
-  @doc("If the SKU supports scale out/in then the capacity integer should be included. If scale out/in is not possible for the resource this may be omitted.")
+  /** If the SKU supports scale out/in then the capacity integer should be included. If scale out/in is not possible for the resource this may be omitted. */
   capacity?: int32;
 }
 
 /**
- * Available service tiers for the SKU.
+ * This field is required to be implemented by the Resource Provider if the service has more than one tier, but is not required on a PUT.
  */
-@doc("Available service tiers for the SKU.")
-enum SkuTier {
-  @doc("The Free service tier.")
-  Free,
+union SkuTier {
+  /** The Free service tier. */
+  Free: "Free",
 
-  @doc("The Basic service tier.")
-  Basic,
+  /** The Basic service tier. */
+  Basic: "Basic",
 
-  @doc("The Standard service tier.")
-  Standard,
+  /** The Standard service tier. */
+  Standard: "Standard",
 
-  @doc("The Premium service tier.")
-  Premium,
+  /** The Premium service tier. */
+  Premium: "Premium",
 }
 
 /**
  * A list of REST API operations supported by an Azure Resource Provider. It contains an URL link to get the next set of results.
  */
-@armCommonDefinition("OperationListResult", Azure.ResourceManager.CommonTypes.Versions.v3)
-@armCommonDefinition("OperationListResult", Azure.ResourceManager.CommonTypes.Versions.v4)
-@armCommonDefinition("OperationListResult", Azure.ResourceManager.CommonTypes.Versions.v5)
-@doc("""
-A list of REST API operations supported by an Azure Resource Provider. It contains an URL link to get the next set of results.
-""")
+@friendlyName("OperationListResult")
 model OperationListResult is Azure.Core.Page<Operation>;
 
 /**
  * Details of a REST API operation, returned from the Resource Provider Operations API
  */
-@armCommonDefinition("Operation", Azure.ResourceManager.CommonTypes.Versions.v3)
-@armCommonDefinition("Operation", Azure.ResourceManager.CommonTypes.Versions.v4)
-@armCommonDefinition("Operation", Azure.ResourceManager.CommonTypes.Versions.v5)
-@doc("Details of a REST API operation, returned from the Resource Provider Operations API")
 model Operation {
-  @doc("""
-  The name of the operation, as per Resource-Based Access Control (RBAC). Examples: "Microsoft.Compute/virtualMachines/write", "Microsoft.Compute/virtualMachines/capture/action"
-  """)
+  /** 
+    The name of the operation, as per Resource-Based Access Control (RBAC). Examples: "Microsoft.Compute/virtualMachines/write", "Microsoft.Compute/virtualMachines/capture/action"
+     */
   @visibility("read")
   name?: string;
 
-  @doc("""
-  Whether the operation applies to data-plane. This is "true" for data-plane operations and "false" for Azure Resource Manager/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;
 
-  @doc("Localized display information for this particular operation.")
+  /** Localized display information for this particular operation. */
   display?: OperationDisplay;
 
-  @doc("""
-  The intended executor of the operation; as in Resource Based Access Control (RBAC) and audit logs UX. Default value is "user,system"
-  """)
+  /** 
+    The intended executor of the operation; as in Resource Based Access Control (RBAC) and audit logs UX. Default value is "user,system"
+     */
   @visibility("read")
   origin?: Origin;
 
-  @doc("""
-  Extensible enum. Indicates the action type. "Internal" refers to actions that are for internal only APIs.
-  """)
+  /** 
+    Extensible enum. Indicates the action type. "Internal" refers to actions that are for internal only APIs.
+     */
   actionType?: ActionType;
 }
 
 /**
  * Localized display information for and operation.
  */
-@armCommonDefinition("OperationDisplay", Azure.ResourceManager.CommonTypes.Versions.v3)
-@armCommonDefinition("OperationDisplay", Azure.ResourceManager.CommonTypes.Versions.v4)
-@armCommonDefinition("OperationDisplay", Azure.ResourceManager.CommonTypes.Versions.v5)
-@doc("Localized display information for and operation.")
 model OperationDisplay {
-  @doc("""
+  /** 
   The localized friendly form of the resource provider name, e.g. "Microsoft Monitoring Insights" or "Microsoft Compute".
-  """)
+   */
   provider?: string;
 
-  @doc("""
-  The localized friendly name of the resource type related to this operation. E.g. "Virtual Machines" or "Job Schedule Collections".
-  """)
+  /** 
+    The localized friendly name of the resource type related to this operation. E.g. "Virtual Machines" or "Job Schedule Collections".
+     */
   resource?: string;
 
-  @doc("""
-  The concise, localized friendly name for the operation; suitable for dropdowns. E.g. "Create or Update Virtual Machine", "Restart Virtual Machine".
-  """)
+  /** 
+    The concise, localized friendly name for the operation; suitable for dropdowns. E.g. "Create or Update Virtual Machine", "Restart Virtual Machine".
+     */
   operation?: string;
 
-  @doc("The short, localized friendly description of the operation; suitable for tool tips and detailed views.")
+  /** The short, localized friendly description of the operation; suitable for tool tips and detailed views. */
   description?: string;
 }
 
 /**
  * The current status of an async operation.
  */
-@armCommonDefinition("OperationStatusResult", Azure.ResourceManager.CommonTypes.Versions.v3)
-@armCommonDefinition("OperationStatusResult", Azure.ResourceManager.CommonTypes.Versions.v4)
-@armCommonDefinition("OperationStatusResult", Azure.ResourceManager.CommonTypes.Versions.v5)
-@doc("The current status of an async operation.")
 model OperationStatusResult {
-  @doc("Fully qualified ID for the async operation.")
+  /** Fully qualified ID for the async operation. */
   id?: string;
 
-  @doc("Name of the async operation.")
+  /** Name of the async operation. */
   name?: string;
 
-  @doc("Operation status.")
+  /** Operation status. */
   status: string;
 
-  @doc("Percent of the operation that is complete.")
+  /** Percent of the operation that is complete. */
   @minValue(0)
   @maxValue(100)
   percentComplete?: float64;
 
-  @doc("The start time of the operation.")
+  /** The start time of the operation. */
   startTime?: utcDateTime;
 
-  @doc("The end time of the operation.")
+  /** The end time of the operation. */
   endTime?: utcDateTime;
 
-  @doc("The operations list.")
-  operations: OperationStatusResult[];
+  /** The operations list. */
+  operations?: OperationStatusResult[];
 
-  @doc("If present, details of the operation error.")
+  /** If present, details of the operation error. */
   error?: ErrorDetail;
 }
 
-/**
- * The default operationId parameter type.
- */
-@doc("The default operationId parameter type.")
-model OperationIdParameter {
-  @path
-  @minLength(1)
-  @doc("The ID of an ongoing async operation.")
-  @armCommonParameter("OperationIdParameter", Azure.ResourceManager.CommonTypes.Versions.v3)
-  @armCommonParameter("OperationIdParameter", Azure.ResourceManager.CommonTypes.Versions.v4)
-  @armCommonParameter("OperationIdParameter", Azure.ResourceManager.CommonTypes.Versions.v5)
-  operationId: string;
-}
-
 /**
  * Extensible enum. Indicates the action type. "Internal" refers to actions that are for internal only APIs.
  */
-@doc("""
-Extensible enum. Indicates the action type. "Internal" refers to actions that are for internal only APIs.
-""")
 union ActionType {
-  @doc("Actions are for internal-only APIs.")
+  /** Actions are for internal-only APIs. */
   Internal: "Internal",
 
   string,
@@ -262,17 +223,14 @@ union ActionType {
 /**
  * The intended executor of the operation; as in Resource Based Access Control (RBAC) and audit logs UX. Default value is "user,system"
  */
-@doc("""
-The intended executor of the operation; as in Resource Based Access Control (RBAC) and audit logs UX. Default value is "user,system"
-""")
 union Origin {
-  @doc("Indicates the operation is initiated by a user.")
+  /** Indicates the operation is initiated by a user. */
   user: "user",
 
-  @doc("Indicates the operation is initiated by a system.")
+  /** Indicates the operation is initiated by a system. */
   system: "system",
 
-  @doc("Indicates the operation is initiated by a user or system.")
+  /** Indicates the operation is initiated by a user or system. */
   `user,system`: "user,system",
 
   string,
@@ -281,47 +239,47 @@ union Origin {
 /**
  * The error detail.
  */
-@armCommonDefinition("ErrorDetail", Azure.ResourceManager.CommonTypes.Versions.v3)
-@armCommonDefinition("ErrorDetail", Azure.ResourceManager.CommonTypes.Versions.v4)
-@armCommonDefinition("ErrorDetail", Azure.ResourceManager.CommonTypes.Versions.v5)
-@doc("The error detail.")
 model ErrorDetail {
-  @doc("The error code.")
+  /** The error code. */
   @visibility("read")
   code?: string;
 
-  @doc("The error message.")
+  /** The error message. */
   @visibility("read")
   message?: string;
 
-  @doc("The error target.")
+  /** The error target. */
   @visibility("read")
   target?: string;
 
+  /** The error details. */
   @extension("x-ms-identifiers", ["message", "target"])
-  @doc("The error details.")
   @visibility("read")
   details?: ErrorDetail[];
 
-  @extension("x-ms-identifiers", ["message", "target"])
-  @doc("The error additional info.")
+  /** The error additional info. */
   @visibility("read")
   additionalInfo?: ErrorAdditionalInfo[];
 }
 
+/**
+ * Common error response for all Azure Resource Manager APIs to return error details for failed operations.
+ */
+@error
+model ErrorResponse {
+  /** The error object. */
+  error?: ErrorDetail;
+}
+
 /**
  * The resource management error additional info.
  */
-@armCommonDefinition("ErrorAdditionalInfo", Azure.ResourceManager.CommonTypes.Versions.v3)
-@armCommonDefinition("ErrorAdditionalInfo", Azure.ResourceManager.CommonTypes.Versions.v4)
-@armCommonDefinition("ErrorAdditionalInfo", Azure.ResourceManager.CommonTypes.Versions.v5)
-@doc("The resource management error additional info.")
 model ErrorAdditionalInfo {
-  @doc("The additional info type.")
+  /** The additional info type. */
   @visibility("read")
   type?: string;
 
-  @doc("The additional info.")
+  /** The additional info. */
   @visibility("read")
   info?: {};
 }
@@ -329,124 +287,288 @@ model ErrorAdditionalInfo {
 /**
  * Metadata pertaining to creation and last modification of the resource.
  */
-@armCommonDefinition("systemData", Azure.ResourceManager.CommonTypes.Versions.v3)
-@armCommonDefinition("systemData", Azure.ResourceManager.CommonTypes.Versions.v4)
-@armCommonDefinition("systemData", Azure.ResourceManager.CommonTypes.Versions.v5)
-@doc("Metadata pertaining to creation and last modification of the resource.")
 model SystemData {
-  @visibility("read")
-  @doc("The identity that created the resource.")
+  /** The identity that created the resource. */
   createdBy?: string;
 
-  @visibility("read")
-  @doc("The type of identity that created the resource.")
+  /** The type of identity that created the resource. */
   createdByType?: createdByType;
 
-  @visibility("read")
-  @doc("The type of identity that created the resource.")
-  createdAt?: plainDate;
+  /** The timestamp of resource creation (UTC). */
+  createdAt?: utcDateTime;
 
-  @visibility("read")
-  @doc("The identity that last modified the resource.")
+  /** The identity that last modified the resource. */
   lastModifiedBy?: string;
 
-  @visibility("read")
-  @doc("The type of identity that last modified the resource.")
+  /** The type of identity that last modified the resource. */
   lastModifiedByType?: createdByType;
 
-  @visibility("read")
-  @doc("The timestamp of resource last modification (UTC)")
-  lastModifiedAt?: plainDate;
+  /** The timestamp of resource last modification (UTC) */
+  lastModifiedAt?: utcDateTime;
 }
 
 /**
  * The kind of entity that created the resource.
  */
 // NOTE: This is how the extensible enum is named in types.json
-@doc("The kind of entity that created the resource.")
 union createdByType {
-  @doc("The entity was created by a user.")
+  /** The entity was created by a user. */
   User: "User",
 
-  @doc("The entity was created by an application.")
+  /** The entity was created by an application. */
   Application: "Application",
 
-  @doc("The entity was created by a managed identity.")
+  /** The entity was created by a managed identity. */
   ManagedIdentity: "ManagedIdentity",
 
-  @doc("The entity was created by a key.")
+  /** The entity was created by a key. */
   Key: "Key",
 
   string,
 }
 
+union ResourceIdentityType {
+  SystemAssigned: "SystemAssigned",
+}
+
+/** Identity for the resource. */
+model Identity {
+  /** The principal ID of resource identity. The value must be an UUID. */
+  @typeChangedFrom(Versions.v4, string)
+  @visibility("read")
+  principalId?: uuid;
+
+  /** The tenant ID of resource. The value must be an UUID. */
+  @typeChangedFrom(Versions.v4, string)
+  @visibility("read")
+  tenantId?: uuid;
+
+  /** The identity type. */
+  type?: ResourceIdentityType;
+}
+
+model KeyVaultProperties {
+  /** Key vault uri to access the encryption key. */
+  keyIdentifier?: string;
+
+  /** The client ID of the identity which will be used to access key vault. */
+  identity?: string;
+}
 /**
- * Details of the resource plan.
+ * Plan for the resource.
  */
-@doc("Details of the resource plan.")
-@armCommonDefinition("Plan", Azure.ResourceManager.CommonTypes.Versions.v3)
-@armCommonDefinition("Plan", Azure.ResourceManager.CommonTypes.Versions.v4)
-@armCommonDefinition("Plan", Azure.ResourceManager.CommonTypes.Versions.v5)
 model Plan {
-  @doc("A user defined name of the 3rd Party Artifact that is being procured.")
+  /** A user defined name of the 3rd Party Artifact that is being procured. */
   name: string;
 
-  @doc("The publisher of the 3rd Party Artifact that is being bought. E.g. NewRelic")
+  /** The publisher of the 3rd Party Artifact that is being bought. E.g. NewRelic */
   publisher: string;
 
-  @doc("The 3rd Party artifact that is being procured. E.g. NewRelic. Product maps to the OfferID specified for the artifact at the time of Data Market onboarding. ")
+  /** The 3rd Party artifact that is being procured. E.g. NewRelic. Product maps to the OfferID specified for the artifact at the time of Data Market onboarding. */
   product: string;
 
-  @doc("A publisher provided promotion code as provisioned in Data Market for the said product/artifact.")
+  /** A publisher provided promotion code as provisioned in Data Market for the said product/artifact. */
   promotionCode?: string;
 
-  @doc("The version of the desired product/artifact.")
+  /** The version of the desired product/artifact. */
   version?: string;
 }
 
 /**
  * The check availability request body.
  */
-@armCommonDefinition("CheckNameAvailabilityRequest", Azure.ResourceManager.CommonTypes.Versions.v3)
-@armCommonDefinition("CheckNameAvailabilityRequest", Azure.ResourceManager.CommonTypes.Versions.v4)
-@armCommonDefinition("CheckNameAvailabilityRequest", Azure.ResourceManager.CommonTypes.Versions.v5)
-@doc("The check availability request body.")
 model CheckNameAvailabilityRequest {
-  @doc("The name of the resource for which availability needs to be checked.")
+  /** The name of the resource for which availability needs to be checked. */
   name?: string;
 
-  @doc("The resource type.")
+  /** The resource type. */
   type?: string;
 }
 
 /**
  * The check availability result.
  */
-@armCommonDefinition("CheckNameAvailabilityResponse", Azure.ResourceManager.CommonTypes.Versions.v3)
-@armCommonDefinition("CheckNameAvailabilityResponse", Azure.ResourceManager.CommonTypes.Versions.v4)
-@armCommonDefinition("CheckNameAvailabilityResponse", Azure.ResourceManager.CommonTypes.Versions.v5)
-@doc("The check availability result.")
 model CheckNameAvailabilityResponse {
-  @doc("Indicates if the resource name is available.")
+  /** Indicates if the resource name is available. */
   nameAvailable?: boolean;
 
-  @doc("The reason why the given name is not available.")
+  /** The reason why the given name is not available. */
   reason?: CheckNameAvailabilityReason;
 
-  @doc("Detailed reason why the given name is not available.")
+  /** Detailed reason why the given name is not available. */
   message?: string;
 }
 
 /**
  * Possible reasons for a name not being available.
  */
-@doc("Possible reasons for a name not being available.")
 union CheckNameAvailabilityReason {
-  @doc("Name is invalid.")
+  /** Name is invalid. */
   Invalid: "Invalid",
 
-  @doc("Name already exists.")
+  /** Name already exists. */
   AlreadyExists: "AlreadyExists",
 
   string,
 }
+
+/** Indicates whether or not the encryption is enabled for container registry. */
+union EncryptionStatus {
+  /** Encryption is enabled. */
+  enabled: "enabled",
+
+  /** Encryption is disabled. */
+  disabled: "disabled",
+
+  string,
+}
+/**
+ * Configuration of key for data encryption
+ */
+model EncryptionProperties {
+  /** Indicates whether or not the encryption is enabled for container registry. */
+  status?: EncryptionStatus;
+
+  /** Key vault properties. */
+  keyVaultProperties?: KeyVaultProperties;
+}
+
+/**
+ * Metadata pertaining to the geographic location of the resource.
+ */
+model LocationData {
+  /** A canonical name for the geographic or physical location. */
+  @maxLength(256)
+  name: string;
+
+  /** The city or locality where the resource is located. */
+  city?: string;
+
+  /** The district, state, or province where the resource is located. */
+  district?: string;
+
+  /** The country or region where the resource is located */
+  countryOrRegion?: string;
+}
+
+/**
+ * The default api-version parameter type.
+ */
+model ApiVersionParameter {
+  /** The API version to use for this operation. */
+  @query("api-version")
+  @minLength(1)
+  apiVersion: string;
+}
+
+/**
+ * The default operationId parameter type.
+ */
+model OperationIdParameter {
+  /** The ID of an ongoing async operation. */
+  @path
+  @minLength(1)
+  operationId: string;
+}
+
+/**
+ * The default location parameter type.
+ */
+model LocationParameter {
+  /** The name of Azure region. */
+  @path
+  @minLength(1)
+  @segment("locations")
+  location: string;
+}
+
+/**
+ * The default resource group parameter type.
+ */
+model ResourceGroupNameParameter {
+  /** The name of the resource group. The name is case insensitive. */
+  @path
+  @minLength(1)
+  @maxLength(90)
+  @segment("resourceGroups")
+  @pattern("^[-\\w\\._\\(\\)]+$")
+  resourceGroupName: string;
+}
+
+/**
+ * The default subscriptionId parameter type.
+ */
+model SubscriptionIdParameter {
+  /** The ID of the target subscription. The value must be an UUID. */
+  @typeChangedFrom(Versions.v4, string)
+  @path
+  @segment("subscriptions")
+  subscriptionId: uuid;
+}
+
+/** The default location parameter type. */
+model LocationResourceParameter {
+  /** The name of the Azure region. */
+  @path
+  @minLength(1)
+  @segment("locations")
+  @key
+  location: string;
+}
+
+/**
+ * The default ManagementGroupName parameter type.
+ */
+@added(Versions.v4)
+model ManagementGroupNameParameter {
+  /** The name of the management group. The name is case insensitive. */
+  @path
+  @minLength(1)
+  @maxLength(90)
+  @segment("managementGroups")
+  managementGroupName: string;
+}
+
+/**
+ * The default Scope parameter type.
+ */
+@added(Versions.v4)
+model ScopeParameter {
+  /** The scope at which the operation is performed. */
+  @path
+  @segment("scope")
+  @minLength(1)
+  @extension("x-ms-skip-url-encoding", true)
+  scope: string;
+}
+
+/**
+ * The default ManagementGroupName parameter type.
+ */
+@added(Versions.v4)
+model TenantIdParameter {
+  /** The Azure tenant ID. This is a GUID-formatted string (e.g. 00000000-0000-0000-0000-000000000000) */
+  @path
+  @segment("tenant")
+  tenantId: uuid;
+}
+
+/**
+ * The default ARM If-Match header type.
+ */
+@added(Versions.v4)
+model IfMatchHeader {
+  /** The If-Match header that makes a request conditional. */
+  @header("If-Match")
+  ifMatch: string;
+}
+
+/**
+ * The default ARM If-Match header type.
+ */
+@added(Versions.v4)
+model IfNoneMatchHeader {
+  /** The If-None-Match header that makes a request conditional. */
+  @header("If-None-Match")
+  ifNoneMatch: string;
+}