Merge branch 'main' of into data-sources-section

Author: AbbyMSFT

articles/ai-services/speech-service/includes/containers-speech-config-ws.md

@@ -128,6 +128,6 @@ speech_config = speechsdk.SpeechConfig(
 ::: zone-end
 
 ::: zone pivot="programming-language-cli"
-When you use the Speech CLI in a container, include the `--host wss://localhost:5000/` option. You must also specify `--key none` to ensure that the CLI doesn't try to use a Speech key for authentication. For information about how to configure the Speech CLI, see [Get started with the Azure AI Speech CLI](../spx-basics.md?tabs=dockerinstall#download-and-install).
+When you use the Speech CLI in a container, include the `--host ws://localhost:5000/` option. You must also specify `--key none` to ensure that the CLI doesn't try to use a Speech key for authentication. For information about how to configure the Speech CLI, see [Get started with the Azure AI Speech CLI](../spx-basics.md?tabs=dockerinstall#download-and-install).
 ::: zone-end
 

articles/app-service/environment/migrate.md

@@ -148,7 +148,7 @@ Migration requires a three to six hour service window for App Service Environmen
 - The existing App Service Environment is shut down and replaced by the new App Service Environment v3.
 - All App Service plans in the App Service Environment are converted from the Isolated to Isolated v2 tier.
 - All of the apps that are on your App Service Environment are temporarily down. **You should expect about one hour of downtime during this period**.
-  - If you can't support downtime, see the [side by side migration feature](side-by-side-migrate.md) or the[migration-alternatives](migration-alternatives.md#migrate-manually).
+  - If you can't support downtime, see the [side by side migration feature](side-by-side-migrate.md) or the [migration-alternatives](migration-alternatives.md#migrate-manually).
 - The public addresses that are used by the App Service Environment change to the IPs generated during the IP generation step.
 
 As in the IP generation step, you can't scale, modify your App Service Environment, or deploy apps to it during this process. When migration is complete, the apps that were on the old App Service Environment are running on the new App Service Environment v3.

articles/azure-app-configuration/howto-set-up-private-access.md

@@ -70,7 +70,7 @@ This command will prompt your web browser to launch and load an Azure sign-in pa
 
 1. Select **Next : Virtual Network >**.
 
-   1. Select an existing **Virtual network** to deploy the private endpoint to. If you don't have a virtual network, [create a virtual network](../private-link/create-private-endpoint-portal.md#create-a-virtual-network-and-bastion-host).
+   1. Select an existing **Virtual network** to deploy the private endpoint to. If you don't have a virtual network, [create a virtual network](../private-link/create-private-endpoint-portal.md).
 
    1. Select a **Subnet** from the list.
 

articles/azure-maps/media/power-bi-visual/cluster-bubble-layer.png

@@ -76,34 +76,15 @@ The **Category labels** settings enable you to customize font setting such as fo
 
 :::image type="content" source="./media/power-bi-visual/category-labels-example.png" alt-text="A screenshot showing the category labels on an Azure Maps map in Power BI." lightbox="./media/power-bi-visual/category-labels-example.png":::
 
-## Adding a cluster bubble layer
-
-Cluster bubble layers enable you to use enhanced data aggregation capabilities based on different zoom levels. Cluster bubble layers are designed to optimize the visualization and analysis of data by allowing dynamic adjustments to granularity as users zoom in or out on the map.
-
-:::image type="content" source="./media/power-bi-visual/cluster-bubble-layer.png" lightbox="./media/power-bi-visual/cluster-bubble-layer.png" alt-text="A screenshot showing an Azure Maps Power BI visual with a cluster bubble layer.":::
-
-Azure Maps Power BI visual offers a range of configuration options to provide flexibility when customizing the appearance of cluster bubbles. With parameters like cluster bubble size, color, text size, text color, border color, and border width, you can tailor the visual representation of clustered data to align with your reporting needs.
-
-:::image type="content" source="./media/power-bi-visual/visualizations-settings-cluster-bubbles.png" alt-text="A screenshot showing the format visual options for a cluster bubble layer.":::
-
-| Setting       | Description                                       | Values  |
-|---------------|---------------------------------------------------|---------|
-| Bubble Size   | The size of each cluster bubble. Default: 12 px   | 1-50 px |
-| Cluster Color | Fill color of each cluster bubble.                |         |
-| Text Size     | The size of the number indicating the quantity of clustered bubbles. Default: 18 px.| 1-60 px|
-| Text Color    | Text color of the number displayed in the cluster bubbles.| |
-| Border Color  | The color of the bubbles outline.                 |         |
-| Border Width  | The width of the border in pixels. Default: 2 px  | 1-20 px |
-
 ## Next steps
 
 Change how your data is displayed on the map:
 
 > [!div class="nextstepaction"]
-> [Add a 3D column layer](power-bi-visual-add-3d-column-layer.md)
+> [Add a cluster bubble layer](power-bi-visual-cluster-bubbles.md)
 
 > [!div class="nextstepaction"]
-> [Add a heat map layer](power-bi-visual-add-heat-map-layer.md)
+> [Add a 3D column layer](power-bi-visual-add-3d-column-layer.md)
 
 Add more context to the map:
 
@@ -113,9 +94,6 @@ Add more context to the map:
 > [!div class="nextstepaction"]
 > [Add a tile layer](power-bi-visual-add-tile-layer.md)
 
-> [!div class="nextstepaction"]
-> [Show real-time traffic](power-bi-visual-show-real-time-traffic.md)
-
 Customize the visual:
 
 > [!div class="nextstepaction"]

articles/azure-maps/media/power-bi-visual/visualizations-settings-cluster-bubbles.png

@@ -0,0 +1,59 @@
+---
+title: Add a cluster bubble layer to an Azure Maps Power BI visual
+titleSuffix: Microsoft Azure Maps
+description: In this article, you learn how to use the cluster bubble layer in an Azure Maps Power BI visual.
+author: deniseatmicrosoft
+ms.author: limingchen
+ms.date: 02/27/2024
+ms.topic: how-to
+ms.service: azure-maps
+services: azure-maps
+---
+
+# Add a cluster bubble layer
+
+Cluster bubble layers enable you to use enhanced data aggregation capabilities based on different zoom levels. Cluster bubble layers are designed to optimize the visualization and analysis of data by allowing dynamic adjustments to granularity as users zoom in or out on the map.
+
+:::image type="content" source="./media/power-bi-visual/cluster-bubble-layer.png" lightbox="./media/power-bi-visual/cluster-bubble-layer.png" alt-text="A screenshot showing an Azure Maps Power BI visual with a cluster bubble layer.":::
+
+Azure Maps Power BI visual offers a range of configuration options to provide flexibility when customizing the appearance of cluster bubbles. With parameters like cluster bubble size, color, text size, text color, border color, and border width, you can tailor the visual representation of clustered data to align with your reporting needs.
+
+:::image type="content" source="./media/power-bi-visual/visualizations-settings-cluster-bubbles.png" alt-text="A screenshot showing the format visual options for a cluster bubble layer.":::
+
+| Setting       | Description                                       | Values  |
+|---------------|---------------------------------------------------|---------|
+| Bubble Size   | The size of each cluster bubble. Default: 12 px   | 1-50 px |
+| Cluster Color | Fill color of each cluster bubble.                |         |
+| Text Size     | The size of the number indicating the quantity of clustered bubbles. Default: 18 px.| 1-60 px|
+| Text Color    | Text color of the number displayed in the cluster bubbles.| |
+| Border Color  | The color of the bubbles outline.                 |         |
+| Border Width  | The width of the border in pixels. Default: 2 px  | 1-20 px |
+
+## Next steps
+
+Change how your data is displayed on the map:
+
+> [!div class="nextstepaction"]
+> [Add a 3D column layer](power-bi-visual-add-3d-column-layer.md)
+
+> [!div class="nextstepaction"]
+> [Add a heat map layer](power-bi-visual-add-heat-map-layer.md)
+
+Add more context to the map:
+
+> [!div class="nextstepaction"]
+> [Add a reference layer](power-bi-visual-add-reference-layer.md)
+
+> [!div class="nextstepaction"]
+> [Add a tile layer](power-bi-visual-add-tile-layer.md)
+
+> [!div class="nextstepaction"]
+> [Show real-time traffic](power-bi-visual-show-real-time-traffic.md)
+
+Customize the visual:
+
+> [!div class="nextstepaction"]
+> [Tips and tricks for color formatting in Power BI](/power-bi/visuals/service-tips-and-tricks-for-color-formatting)
+
+> [!div class="nextstepaction"]
+> [Customize visualization titles, backgrounds, and legends](/power-bi/visuals/power-bi-visualization-customize-title-background-and-legend)

articles/azure-maps/power-bi-visual-add-bubble-layer.md

@@ -367,6 +367,8 @@ items:
       href: power-bi-visual-understanding-layers.md
     - name: Add a bubble layer
       href: power-bi-visual-add-bubble-layer.md
+    - name: Add a cluster bubble layer
+      href: power-bi-visual-cluster-bubbles.md
     - name: Add a pie chart layer
       href: power-bi-visual-add-pie-chart-layer.md
     - name: Add a 3D column layer

articles/azure-maps/power-bi-visual-cluster-bubbles.md

@@ -183,6 +183,35 @@ You can use the `CreateReleaseAnnotation` PowerShell script to create annotation
         [parameter(Mandatory = $true)][string]$releaseName,
         [parameter(Mandatory = $false)]$releaseProperties = @()
     )
+
+    # Function to ensure all Unicode characters in a JSON string are properly escaped
+    function Convert-UnicodeToEscapeHex {
+      param (
+        [parameter(Mandatory = $true)][string]$JsonString
+      )
+      $JsonObject = ConvertFrom-Json -InputObject $JsonString
+      foreach ($property in $JsonObject.PSObject.Properties) {
+        $name = $property.Name
+        $value = $property.Value
+        if ($value -is [string]) {
+          $value = [regex]::Unescape($value)
+          $OutputString = ""
+          foreach ($char in $value.ToCharArray()) {
+            $dec = [int]$char
+            if ($dec -gt 127) {
+              $hex = [convert]::ToString($dec, 16)
+              $hex = $hex.PadLeft(4, '0')
+              $OutputString += "\u$hex"
+            }
+            else {
+              $OutputString += $char
+            }
+          }
+          $JsonObject.$name = $OutputString
+        }
+      }
+      return ConvertTo-Json -InputObject $JsonObject -Compress
+    }
     
     $annotation = @{
         Id = [GUID]::NewGuid();
@@ -192,7 +221,11 @@ You can use the `CreateReleaseAnnotation` PowerShell script to create annotation
         Properties = ConvertTo-Json $releaseProperties -Compress
     }
     
-    $body = (ConvertTo-Json $annotation -Compress) -replace '(\\+)"', '$1$1"' -replace "`"", "`"`""
+    $annotation = ConvertTo-Json $annotation -Compress
+    $annotation = Convert-UnicodeToEscapeHex -JsonString $annotation  
+ 
+    $body = $annotation -replace '(\\+)"', '$1$1"' -replace "`"", "`"`""
+
     az rest --method put --uri "$($aiResourceId)/Annotations?api-version=2015-05-01" --body "$($body) "
 
     # Use the following command for Linux Azure DevOps Hosts or other PowerShell scenarios

articles/azure-maps/toc.yml

@@ -706,6 +706,8 @@ Authorization: Bearer <token>
 
 - Moving a cluster to another resource group or subscription isn't currently supported.
 
+- Moving a cluster to another region isn't supported.
+
 - Cluster update shouldn't include both identity and key identifier details in the same operation. In case you need to update both, the update should be in two consecutive operations.
 
 - Lockbox isn't currently available in China.