Merge branch 'MicrosoftDocs:main' into issues/121151-config-identity-provider

Author: RyanHill-MSFT

articles/advisor/advisor-get-started.md

@@ -5,7 +5,7 @@ author: mabrahms
 ms.author: v-mabrahms
 ms.service: azure
 ms.topic: article
-ms.date: 12/1/2023
+ms.date: 03/07/2024
 
 ---
 
@@ -18,81 +18,83 @@ Learn how to access Advisor through the Azure portal, get and manage recommendat
 
 ## Open Advisor
 
-To access Azure Advisor, sign in to the [Azure portal](https://portal.azure.com) and open [Advisor](https://aka.ms/azureadvisordashboard). The Advisor score page opens by default. 
+To access Azure Advisor, sign in to the [Azure portal](https://portal.azure.com). From there, select the [Advisor](https://aka.ms/azureadvisordashboard) icon at the top of the page, use the search bar at the top to search for Advisor, or use the left navigation pane **Advisor** link.<br> The Advisor **Overview** page opens by default.
 
-You can also use the search bar at the top, or the left navigation pane, to find Advisor.
+## View the Advisor dashboard
 
-:::image type="content" source="./media/advisor-get-started/advisor-score-page.png" alt-text="Screenshot of the Azure Advisor opening score page." lightbox="./media/advisor-get-started/advisor-score-page.png":::
+See personalized and actionable recommendations on the Advisor **Overview** page.
 
-## Read your score
-See how your system configuration measures against Azure best practices.
+:::image type="content" source="./media/advisor-get-started/advisor-overview-page-m-1.png" alt-text="Screenshot of the Azure Advisor opening **Overview** page." lightbox="./media/advisor-get-started/advisor-overview-page-m-1.png":::
 
-:::image type="content" source="./media/advisor-get-started/advisor-score-page-graphs-detail.png" alt-text="Screenshot detail of Azure Advisor workloads score graphs." lightbox="./media/advisor-get-started/advisor-score-page-graphs-detail.png":::
+* The links at the top offer options for **Feedback**, downloading recommendations as comma-separated or PDFs, and a quick-link to Advisor **Workbooks**.
+* The blue filter buttons below them focus the recommendations.
+* The tiles represent the different recommendation categories and include your current score in that category.
+* The **Get started** link takes you to options for direct access to Advisor workbooks, recommendations, and the Well Architected Framework main page.
 
-* The far-left graphic is your overall system Advisor score against Azure best practices. The **Learn more** link opens the [Optimize Azure workloads by using Advisor score](azure-advisor-score.md) page. 
+### Filter and access recommendations
 
-* The middle graphic depicts the trend of your system Advisor score history. Roll over the graphic to activate a slider to see your trend at different points of time. Use the drop-down menu to pick a trend time frame.
+The tiles on the Advisor **Overview** page show the different categories of recommendations for all the subscriptions that you have access to, by default.
 
-* The far-right graphic shows a breakdown of your best practices Advisor score per category. Click a category bar to open the recommendations page for that category.
+You can filter the display using the buttons at the top of the page:
 
-## Get recommendations
+* **Subscription**: Choose *All* for Advisor recommendations on all subscriptions. Alternatively, select specific subscriptions. Apply changes by clicking outside of the button.
+* **Recommendation Status**: *Active* (the default, recommendations not postponed or dismissed), *Postponed* or *Dismissed*. Apply changes by clicking outside of the button.
+* **Resource Group**: Choose *All* (the default) or specific resource groups. Apply changes by clicking outside of the button.
+* **Type**: Choose *All* (the default) or specific resources. Apply changes by clicking outside of the button.
+* For more advanced filtering, select **Add filter**.
 
-To display a specific list of recommendations, click a category tile. 
+To display a specific list of recommendations, select a category tile.
 
-The tiles on the Advisor score page show the different categories of recommendations per subscription:  
+:::image type="content" source="./media/advisor-get-started/advisor-reliability-tile-small.png" alt-text="Screenshot detail of the Azure Advisor **Reliability** recommendation tile." lightbox="./media/advisor-get-started/advisor-reliability-tile-small.png":::
 
-* To get recommendations for a specific category, click one of the tiles. To open a list of all recommendations for all categories, click the **All recommendations** tile. By default, the **Cost** tile is selected. 
+Each tile provides information about the recommendations for that category:
 
-* You can filter the display using the buttons at the top of the page:
-   * **Subscription**: Choose *All* for Advisor recommendations on all subscriptions. Alternatively, select specific subscriptions. Apply changes by clicking outside of the button.
-   * **Recommendation Status**: *Active* (the default, recommendations that you haven't postponed or dismissed), *Postponed* or *Dismissed*. Apply changes by clicking outside of the button.
-   * **Resource Group**: Choose *All* (the default) or specific resource groups. Apply changes by clicking outside of the button.
-   * **Type**: Choose *All* (the default) or specific resources. Apply changes by clicking outside of the button.
-   * **Commitments**: Applicable only to cost recommendations. Adjust your subscription **Cost** recommendations to reflect your committed **Term (years)** and chosen **Look-back period (days)**. Apply changes by clicking **Apply**.
-   * For more advanced filtering, click **Add filter**.
+* Your overall score for the category.
+* The total number of recommendations for the category, and the specific number per impact.
+* The number of impacted resources by the recommendations.
 
-* The **Commitments** button lets you adjust your subscription **Cost** recommendations to reflect your committed **Term (years)** and chosen **Look-back period (days)**.
+For detailed graphics and information on your Advisor score, see [Optimize Azure workloads by using Advisor score](/azure/advisor/azure-advisor-score).
 
-## Get recommendation details and solution options
+### Get recommendation details and solution options
 
 View recommendation details – such as the recommended actions and impacted resources – and the solution options, including postponing or dismissing a recommendation.
 
-1. To review details of a recommendation, including the affected resources, open the recommendation list for a category and then click the **Description** or the **Impacted resources** link for a specific recommendation. The following screenshot shows a **Reliability** recommendation details page.
+1. To review details of a recommendation, including the affected resources, open the recommendation list for a category and then select the **Description** or the **Impacted resources** link for a specific recommendation. The following screenshot shows a **Reliability** recommendation details page.
 
    :::image type="content" source="./media/advisor-get-started/advisor-score-reliability-recommendation-page.png" alt-text="Screenshot of Azure Advisor reliability recommendation details example." lightbox="./media/advisor-get-started/advisor-score-reliability-recommendation-page.png":::
 
-1. To see action details, click a **Recommended actions** link. The Azure page where you can act opens. Alternatively, open a page to the affected resources to take the recommended action (the two pages may be the same).
+1. To see action details, select a **Recommended actions** link. The Azure page where you can act opens. Alternatively, open a page to the affected resources to take the recommended action (the two pages might be the same).
 
    Understand the recommendation before you act by clicking the **Learn more** link on the recommended action page, or at the top of the recommendations details page.
 
-1.   You can postpone the recommendation.
-   
+1. You can postpone the recommendation.
+
    :::image type="content" source="./media/advisor-get-started/advisor-recommendation-postpone.png" alt-text="Sreenshot of Azure Advisor recommendation postpone option." lightbox="./media/advisor-get-started/advisor-recommendation-postpone.png":::
 
    You can't dismiss the recommendation without certain privileges. For information on permissions, see [Permissions in Azure Advisor](permissions.md).
 
-## Download recommendations
+### Download recommendations
 
-To download your recommendations from the Advisor score or any recommendation details page, click **Download as CSV** or **Download as PDF** on the action bar at the top. The download option respects any filters you have applied to Advisor.  If you select the download option while viewing a specific recommendation category or recommendation, the downloaded summary only includes information for that category or recommendation.
+To download your recommendations, select **Download as CSV** or **Download as PDF** on the action bar at the top of any recommendation list or details page. The download option respects any filters you applied to Advisor. If you select the download option while viewing a specific recommendation category or recommendation, the downloaded summary only includes information for that category or recommendation.
 
 ## Configure recommendations
 
 You can exclude subscriptions or resources, such as 'test' resources, from Advisor recommendations and configure Advisor to generate recommendations only for specific subscriptions and resource groups.
 
 > [!NOTE]
-> To change subscriptions or Advisor compute rules, you must be a subscription Owner.  If you do not have the required permissions, the option is disabled in the user interface. For information on permissions, see [Permissions in Azure Advisor](permissions.md). For details on right sizing VMs, see [Reduce service costs by using Azure Advisor](advisor-cost-recommendations.md).
+> To change subscriptions or Advisor compute rules, you must be a subscription owner.  If you do not have the required permissions, the option is disabled in the user interface. For information on permissions, see [Permissions in Azure Advisor](permissions.md). For details on right sizing VMs, see [Reduce service costs by using Azure Advisor](advisor-cost-recommendations.md).
+
+From any Azure Advisor page, select **Configuration** in the left navigation pane. The Advisor Configuration page opens with the **Resources** tab selected, by default.
 
-From any Azure Advisor page, click **Configuration** in the left navigation pane. The Advisor Configuration page opens with the **Resources** tab selected, by default. 
+Use the **Resources** tab to select or unselect subscriptions for Advisor recommendations. When ready, select **Apply**. The page refreshes.
 
 :::image type="content" source="./media/advisor-get-started/advisor-configure-resources.png" alt-text="Screenshot of Azure Advisor configuration option for resources." lightbox="./media/advisor-get-started/advisor-configure-resources.png":::
 
-* **Resources**: Uncheck any subscriptions you don't want to receive Advisor recommendations for, click **Apply**. The page refreshes.
+Use the **VM/VMSS right sizing** tab to adjust Advisor virtual machine (VM) and virtual machine scale sets (VMSS) recommendations. Specifically, you can set up a filter for each subscription to only show recommendations for machines with certain CPU utilization. This setting filters recommendations by machine, but doesn't change how they're generated. Follow these steps.
 
-* **VM/VMSS right sizing**: You can adjust Advisor virtual machine (VM) and virtual machine scale sets (VMSS) recommendations. Specifically, you can setup a filter for each subscription to only show recommendations for machines with certain CPU utilization. This setting will filter recommendations but will not change how they are generated.
+1. Select the subscriptions you’d like to set up a filter for average CPU utilization, and then select **Edit**. Not all subscriptions can be edited for VM/VMSS right sizing and certain privileges are required; for more information on permissions, see [Permissions in Azure Advisor](permissions.md).
 
-  1. Select the subscriptions you’d like to setup a filter for average CPU utilization, and then click **Edit**. Not all subscriptions can be edited for VM/VMSS right sizing and certain privileges are required; for more information on permissions, see [Permissions in Azure Advisor](permissions.md).
-    
-  1. Select the desired average CPU utilization value and click **Apply**. It can take up to 24 hours for the new settings to be reflected in recommendations.
+1. Select the desired average CPU utilization value and select **Apply**. It can take up to 24 hours for the new settings to be reflected in recommendations.
 
   :::image type="content" source="./media/advisor-get-started/advisor-configure-rules.png" alt-text="Screenshot of Azure Advisor configuration option for VM/VMSS sizing rules." lightbox="./media/advisor-get-started/advisor-configure-rules.png":::
 

articles/advisor/media/advisor-get-started/advisor-overview-page-m-1.png

@@ -460,6 +460,13 @@ You can send a streaming request using the `stream` parameter, allowing data to
 
 When you chat with a model, providing a history of the chat will help the model return higher quality results. You don't need to include the `context` property of the assistant messages in your API requests for better response quality. See [the API reference documentation](../references/on-your-data.md#examples) for examples.
 
+#### Function Calling
+
+Some Azure OpenAI models allow you to define [tools and tool_choice parameters](../how-to/function-calling.md) to enable function calling. You can set up function calling through [REST API](../reference.md#chat-completions) `/chat/completions`. If both `tools` and [data sources](../references/on-your-data.md#request-body) are in the request, the following policy is applied.
+1. If `tool_choice` is `none`, the tools are ignored, and only the data sources are used to generate the answer.
+1. Otherwise, if `tool_choice` is not specified, or specified as `auto` or an object, the data sources are ignored, and the response will contain the selected functions name and the arguments, if any. Even if the model decides no function is selected, the data sources are still ignored.
+
+If the policy above doesn't meet your need, please consider other options, for example: [prompt flow](/azure/machine-learning/prompt-flow/overview-what-is-prompt-flow) or [Assistants API](../how-to/assistant.md).
 
 ## Token usage estimation for Azure OpenAI On Your Data
 

articles/advisor/media/advisor-get-started/advisor-reliability-tile-small.png

@@ -103,18 +103,24 @@ These resource requests and limits are defined for each container, as shown in t
 1. Create a manifest file to define the autoscaler behavior and resource limits, as shown in the following condensed example manifest file `aks-store-quickstart-hpa.yaml`:
 
     ```yaml
-    apiVersion: autoscaling/v1
+    apiVersion: autoscaling/v2
     kind: HorizontalPodAutoscaler
     metadata:
       name: store-front-hpa
     spec:
       maxReplicas: 10 # define max replica count
       minReplicas: 3  # define min replica count
-      targetCPUUtilizationPercentage: 50 # target CPU utilization
       scaleTargetRef:
         apiVersion: apps/v1
         kind: Deployment
         name: store-front
+      metrics:
+      - type: Resource
+        resource:
+          name: cpu
+          target:
+            type: Utilization
+            averageUtilization: 50
     ```
 
 2. Apply the autoscaler manifest file using the `kubectl apply` command.

articles/advisor/media/advisor-get-started/advisor-score-page-graphs-detail.png

@@ -39,7 +39,7 @@ Next, repeat the process to [peer ExpressRoute Global Reach](./tutorial-expressr
 
 ## Storage policies supported
 
-The following SPBM policies are supported with a PFTT of "Dual Site Mirroring" and SFTT of "RAID 1 (Mirroring)" enabled as the default policies for the cluster:
+The following SPBM policies are supported with a Primary Failures To Tolerate (PFTT) of "Dual Site Mirroring" and Secondary Failures To Tolerate (SFTT) of "RAID 1 (Mirroring)" enabled as the default policies for the cluster:
 
 - Site disaster tolerance settings (PFTT):
     - Dual site mirroring

articles/advisor/media/advisor-get-started/advisor-score-page.png

@@ -4,7 +4,7 @@ description: This article describes how to move Azure VMware Solution resources
 ms.custom: "subject-moving-resources, engagement-fy23"
 ms.topic: how-to
 ms.service: azure-vmware
-ms.date: 2/23/2024
+ms.date: 3/28/2024
 
 # Customer intent: As an Azure service administrator, I want to move my Azure VMware Solution resources from Azure Region A to Azure Region B.
 ---
@@ -18,9 +18,9 @@ You can move Azure VMware Solution resources to a different region for several r
 
 This article helps you plan and migrate Azure VMware Solution from one Azure region to another, such as Azure region A to Azure region B.
 
-The diagram shows the recommended ExpressRoute connectivity between the two Azure VMware Solution environments.  An HCX site pairing and service mesh are created between the two environments.  The HCX migration traffic and Layer-2 extension moves (depicted by the red line) between the two environments. For VMware recommended HCX planning, see [Planning an HCX Migration](https://vmc.techzone.vmware.com/vmc-solutions/docs/deploy/planning-an-hcx-migration#section1).
+The diagram shows the recommended ExpressRoute connectivity between the two Azure VMware Solution environments.  An HCX site pairing and service mesh are created between the two environments.  The HCX migration traffic and Layer-2 extension moves (depicted by the purple line) between the two environments. For VMware recommended HCX planning, see [Planning an HCX Migration](https://vmc.techzone.vmware.com/vmc-solutions/docs/deploy/planning-an-hcx-migration#section1).
 
-:::image type="content" source="media/move-across-regions/move-ea-csp-across-regions-2.png" alt-text="Diagram showing ExpressRoute Global Reach communication between the source and target Azure VMware Solution environments." border="false":::
+:::image type="content" source="media/move-across-regions/move-ea-csp-across-regions-2.png" alt-text="Diagram showing ExpressRoute Global Reach communication between the source and target Azure VMware Solution environments." border="false" lightbox="media/move-across-regions/move-ea-csp-across-regions-2.png":::
 
 >[!NOTE]
 >You don't need to migrate any workflow back to on-premises because the traffic will flow between the private clouds (source and target):
@@ -29,7 +29,7 @@ The diagram shows the recommended ExpressRoute connectivity between the two Azur
 
 The diagram shows the connectivity between both Azure VMware Solution environments. 
 
-:::image type="content" source="media/move-across-regions/move-ea-csp-across-regions-connectivity-diagram.png" alt-text="Diagram showing communication between the source and target Azure VMware Solution environments." border="false":::
+:::image type="content" source="media/move-across-regions/move-ea-csp-across-regions-connectivity-diagram.png" alt-text="Diagram showing communication between the source and target Azure VMware Solution environments." border="false" lightbox="media/move-across-regions/move-ea-csp-across-regions-connectivity-diagram.png":::
 
 In this article, walk through the steps to: 
 

articles/ai-services/openai/concepts/use-your-data.md

@@ -69,6 +69,8 @@ items:
     href: architecture-storage.md
   - name: Migrate
     href: architecture-migrate.md
+  - name: Well Architected Framework
+    href: https://learn.microsoft.com/azure/well-architected/azure-vmware/
   - name: Cloud Adoption Framework
     items:
       - name: Azure VMware Solution landing zone accelerator