update

Author: cxznmhdcxz

specification/maps/Maps.Management/Creator.tsp

@@ -24,6 +24,8 @@ model Creator
     NamePattern = "^[^%&:\\\\/#?]+$"
   >;
 
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property" "For backward compatibility"
+  @doc("The system meta data relating to this resource.")
   @visibility(Lifecycle.Read)
   systemData?: Azure.ResourceManager.CommonTypes.SystemData;
 }

specification/maps/Maps.Management/MapsAccount.tsp

@@ -34,6 +34,8 @@ model MapsAccount
   #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property" "For backward compatibility"
   kind?: Kind;
 
+  #suppress "@azure-tools/typespec-azure-core/documentation-required" "backward-compatible"
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property" "For backward compatibility"
   systemData?: Azure.ResourceManager.CommonTypes.SystemData;
   ...Azure.ResourceManager.ManagedServiceIdentityProperty;
 }

specification/maps/Maps.Management/PrivateEndpointConnection.tsp

@@ -17,25 +17,6 @@ namespace Microsoft.Maps;
 model PrivateEndpointConnection is PrivateEndpointConnectionResource;
 alias PrivateEndpointOperations = PrivateEndpoints<PrivateEndpointConnection>;
 
-model PrivateEndpointConnectionPUTHeader {
-  ...ArmAsyncOperationHeader<FinalResult = PrivateEndpointConnection>;
-  ...Azure.Core.Foundations.RetryAfterHeader;
-}
-@@doc(PrivateEndpointConnectionPUTHeader.azureAsyncOperation,
-  "Operation Status Location URI"
-);
-model PrivateEndpointConnectionDELETEHeader {
-  ...ArmAsyncOperationHeader;
-  ...Azure.Core.Foundations.RetryAfterHeader;
-  ...ArmLroLocationHeader;
-}
-@@doc(PrivateEndpointConnectionDELETEHeader.azureAsyncOperation,
-  "Operation Status Location URI"
-);
-@@doc(PrivateEndpointConnectionDELETEHeader.location,
-  "Operation Results Location URI"
-);
-
 @armResourceOperations
 interface PrivateEndpointConnections {
   /**
@@ -46,10 +27,16 @@ interface PrivateEndpointConnections {
   /**
    * Create or update the state of specified private endpoint connection associated with the Maps account.
    */
+  #suppress "@azure-tools/typespec-azure-core/invalid-final-state" "back-compatible"
+  @Azure.Core.useFinalStateVia("location")
   create is PrivateEndpointOperations.CreateOrReplaceAsync<
     MapsAccount,
     PrivateEndpointConnection,
-    LroHeaders = PrivateEndpointConnectionPUTHeader
+    Response = PrivateEndpointConnection | ArmCreatedResponse<
+      PrivateEndpointConnection,
+      ExtraHeaders = ArmAsyncOperationHeader &
+        Azure.Core.Foundations.RetryAfterHeader
+    > | ErrorResponse
   >;
 
   /**
@@ -58,7 +45,9 @@ interface PrivateEndpointConnections {
   delete is PrivateEndpointOperations.DeleteAsync<
     MapsAccount,
     PrivateEndpointConnection,
-    LroHeaders = PrivateEndpointConnectionDELETEHeader
+    Response = ArmNoContentResponse<"Resource does not exist."> | ArmAcceptedResponse<ExtraHeaders = ArmAsyncOperationHeader &
+      Azure.Core.Foundations.RetryAfterHeader &
+      ArmLroLocationHeader> | ErrorResponse
   >;
 
   /**

specification/maps/Maps.Management/PrivateLinkResource.tsp

@@ -11,19 +11,6 @@ using TypeSpec.Http;
 using TypeSpec.OpenAPI;
 
 namespace Microsoft.Maps;
-// /**
-//  * A private link resource.
-//  */
-// @parentResource(MapsAccount)
-// model PrivateLinkResource
-//   is Azure.ResourceManager.ProxyResource<PrivateLinkResourceProperties> {
-//   ...ResourceNameParameter<
-//     Resource = PrivateLinkResource,
-//     KeyName = "privateLinkResourceName",
-//     SegmentName = "privateLinkResources",
-//     NamePattern = "^.*$"
-//   >;
-// }
 
 model PrivateLink is PrivateLinkResource;
 alias PrivateLinkOperations = PrivateLinks<PrivateLink>;

specification/maps/Maps.Management/back-compatible.tsp

@@ -33,4 +33,5 @@ using TypeSpec.OpenAPI;
 
 @@clientLocation(OperationStatusOperationGroup.get, "OperationStatus");
 
+#suppress "@azure-tools/typespec-azure-core/no-openapi" "backward compatibility."
 @@operationId(Operations.list, "Maps_ListOperations");

specification/maps/Maps.Management/main.tsp

@@ -26,7 +26,7 @@ using Azure.Core;
 using Azure.ResourceManager;
 using TypeSpec.Versioning;
 /**
- * Azure Maps Resource Provider
+ * Resource Provider
  */
 @armProviderNamespace
 @service(#{ title: "Azure Maps Resource Provider" })

specification/maps/Maps.Management/models.tsp

@@ -243,12 +243,12 @@ model MapsAccountProperties {
   /**
    * All encryption configuration for a resource.
    */
-  encryption?: Azure.ResourceManager.CommonTypes.EncryptionProperties;
+  encryption?: EncryptionConfiguration;
 
   /**
    * List of additional data processing regions for the Maps Account, which may result in requests being processed in another geography. Some features or results may be restricted to specific regions. By default, Maps REST APIs process requests according to the account location or the [geographic scope](https://learn.microsoft.com/azure/azure-maps/geographic-scope).
    */
-  @extension("x-ms-identifires", #["locationName"])
+  @identifiers(#["locationName"])
   locations?: LocationsItem[];
 
   /**
@@ -286,6 +286,7 @@ model CorsRules {
   /**
    * The list of CORS rules. You can include up to five CorsRule elements in the request.
    */
+  #suppress "@azure-tools/typespec-client-generator-core/property-name-conflict" "backward-compatible"
   @maxItems(5)
   @identifiers(#[])
   corsRules?: CorsRule[];
@@ -414,9 +415,8 @@ model AccountSasParameters {
   /**
    * Required parameter which represents the desired maximum request per second to allowed for the given SAS token. This does not guarantee perfect accuracy in measurements but provides application safe guards of abuse with eventual enforcement.
    */
-  @minValue(0)
   @maxValue(500)
-  @extension("exclusiveMinimum", true)
+  @minValueExclusive(0)
   maxRatePerSecond: int32 = 500;
 
   /**
@@ -437,6 +437,7 @@ model MapsAccountSasToken {
   /**
    * The shared access signature access token.
    */
+  #suppress "@azure-tools/typespec-azure-resource-manager/secret-prop" "backward-compatible"
   @visibility(Lifecycle.Read)
   accountSasToken?: string;
 }
@@ -454,12 +455,14 @@ model MapsAccountKeys {
   /**
    * The primary key for accessing the Maps REST APIs.
    */
+  #suppress "@azure-tools/typespec-azure-resource-manager/secret-prop" "backward-compatible"
   @visibility(Lifecycle.Read)
   primaryKey?: string;
 
   /**
    * The secondary key for accessing the Maps REST APIs.
    */
+  #suppress "@azure-tools/typespec-azure-resource-manager/secret-prop" "backward-compatible"
   @visibility(Lifecycle.Read)
   secondaryKey?: string;
 
@@ -568,6 +571,16 @@ model PrivateLinkResourceList is Azure.Core.Page<PrivateLinkResource>;
 /**
  * A list of private endpoint connections
  */
-model PrivateEndpointConnectionList
-  is Azure.Core.Page<PrivateEndpointConnection>;
-@@extension(PrivateEndpointConnectionList.nextLink, "x-nullable", true);
+// model PrivateEndpointConnectionList
+//   is Azure.Core.Page<PrivateEndpointConnection>;
+// @@extension(PrivateEndpointConnectionList.nextLink, "x-nullable", true);
+model PrivateEndpointConnectionList {
+  @doc("The {name} items on this page", PrivateEndpointConnection)
+  @pageItems
+  value: PrivateEndpointConnection[];
+
+  #suppress "@azure-tools/typespec-azure-core/no-nullable" "backward-compatible"
+  @doc("The link to the next page of items")
+  @nextLink
+  nextLink?: ResourceLocation<PrivateEndpointConnection> | null;
+}

specification/maps/Maps.Management/routes.tsp

@@ -19,6 +19,7 @@ interface OperationResultOperationGroup {
    * Get the result of a long running azure asynchronous operation.
    */
   #suppress "@azure-tools/typespec-azure-core/no-openapi" "non-standard operations"
+  #suppress "@azure-tools/typespec-azure-resource-manager/no-response-body"
   @operationId("OperationResult_Get")
   @route("/subscriptions/{subscriptionId}/providers/Microsoft.Maps/locations/{location}/operationResults/{operationId}")
   @get
@@ -28,6 +29,7 @@ interface OperationResultOperationGroup {
     ...LocationResourceParameter,
     ...Azure.ResourceManager.CommonTypes.OperationIdParameter,
   ): OkResponse | ArmAcceptedResponse<ExtraHeaders = {
+    @doc("")
     @header("Location")
     location?: string;
   }> | ErrorResponse;

specification/maps/resource-manager/Microsoft.Maps/Maps/preview/2025-10-01-preview/maps-management.json

@@ -3,7 +3,7 @@
   "info": {
     "title": "Azure Maps Resource Provider",
     "version": "2025-10-01-preview",
-    "description": "Azure Maps Resource Provider",
+    "description": "Resource Provider",
     "x-typespec-generated": [
       {
         "emitter": "@azure-tools/typespec-autorest"
@@ -62,7 +62,7 @@
         "tags": [
           "Operations"
         ],
-        "description": "List the operations for the provider",
+        "description": "List operations available for the Maps Resource Provider",
         "parameters": [
           {
             "$ref": "../../../../../../common-types/resource-management/v6/types.json#/parameters/ApiVersionParameter"
@@ -157,7 +157,8 @@
             "description": "Resource operation accepted.",
             "headers": {
               "Location": {
-                "type": "string"
+                "type": "string",
+                "description": ""
               }
             }
           },
@@ -1024,20 +1025,20 @@
         ],
         "responses": {
           "200": {
-            "description": "Resource 'PrivateEndpointConnection' update operation succeeded",
+            "description": "The request has succeeded.",
             "schema": {
               "$ref": "../../../../../../common-types/resource-management/v6/privatelinks.json#/definitions/PrivateEndpointConnection"
             }
           },
           "201": {
-            "description": "Resource 'PrivateEndpointConnection' create operation succeeded",
+            "description": "Azure create operation completed successfully.",
             "schema": {
               "$ref": "../../../../../../common-types/resource-management/v6/privatelinks.json#/definitions/PrivateEndpointConnection"
             },
             "headers": {
               "Azure-AsyncOperation": {
                 "type": "string",
-                "description": "Operation Status Location URI"
+                "description": "A link to the status monitor"
               },
               "Retry-After": {
                 "type": "integer",
@@ -1059,7 +1060,7 @@
           }
         },
         "x-ms-long-running-operation-options": {
-          "final-state-via": "azure-async-operation",
+          "final-state-via": "location",
           "final-state-schema": "../../../../../../common-types/resource-management/v6/privatelinks.json#/definitions/PrivateEndpointConnection"
         },
         "x-ms-long-running-operation": true
@@ -1095,15 +1096,15 @@
         ],
         "responses": {
           "202": {
-            "description": "Resource deletion accepted.",
+            "description": "Resource operation accepted.",
             "headers": {
               "Azure-AsyncOperation": {
                 "type": "string",
-                "description": "Operation Status Location URI"
+                "description": "A link to the status monitor"
               },
               "Location": {
                 "type": "string",
-                "description": "Operation Results Location URI"
+                "description": "The Location header contains the URL where the status of the long running operation can be checked."
               },
               "Retry-After": {
                 "type": "integer",
@@ -1322,8 +1323,6 @@
           "format": "int32",
           "description": "Required parameter which represents the desired maximum request per second to allowed for the given SAS token. This does not guarantee perfect accuracy in measurements but provides application safe guards of abuse with eventual enforcement.",
           "default": 500,
-          "minimum": 0,
-          "exclusiveMinimum": true,
           "maximum": 500
         },
         "start": {
@@ -1384,6 +1383,7 @@
         },
         "systemData": {
           "$ref": "../../../../../../common-types/resource-management/v6/types.json#/definitions/systemData",
+          "description": "The system meta data relating to this resource.",
           "readOnly": true
         }
       },
@@ -1631,7 +1631,7 @@
           "description": "Specifies CORS rules for the Blob service. You can include up to five CorsRule elements in the request. If no CorsRule elements are included in the request body, all CORS rules will be deleted, and CORS will be disabled for the Blob service."
         },
         "encryption": {
-          "$ref": "../../../../../../common-types/resource-management/v6/types.json#/definitions/encryptionProperties",
+          "$ref": "../../../../../../common-types/resource-management/v6/customermanagedkeys.json#/definitions/encryption",
           "description": "All encryption configuration for a resource."
         },
         "locations": {
@@ -1640,7 +1640,7 @@
           "items": {
             "$ref": "#/definitions/LocationsItem"
           },
-          "x-ms-identifires": [
+          "x-ms-identifiers": [
             "locationName"
           ]
         },