Merge branch 'MicrosoftDocs:main' into main

Author: gmndrg

articles/advisor/advisor-reference-reliability-recommendations.md

@@ -4,7 +4,7 @@ description: Full list of available reliability recommendations in Advisor.
 author: mabrahms
 ms.author: v-mabrahms
 ms.topic: article
-ms.date: 09/27/2023
+ms.date: 12/11/2023
 ---
 
 # Reliability recommendations
@@ -544,7 +544,7 @@ Learn more about [Front Door Profile - RenewExpiredBYOC (Renew the expired Azure
 
 Deploying two or more medium or large sized instances ensures business continuity during outages caused by planned or unplanned maintenance.
 
-Learn more about [Application gateway - AppGateway (Upgrade your SKU or add more instances to ensure fault tolerance)](https://aka.ms/aa_gatewayrec_learnmore).
+Learn more about [Improve the reliability of your application by using Azure Advisor - Ensure application gateway fault tolerance)](/azure/advisor/advisor-high-availability-recommendations#ensure-application-gateway-fault-tolerance).
 
 ### Avoid hostname override to ensure site integrity
 

articles/ai-studio/how-to/create-manage-compute.md

@@ -111,7 +111,6 @@ You can start or stop a compute instance from the Azure AI Studio.
 
     :::image type="content" source="../media/compute/compute-start-stop.png" alt-text="Screenshot of the option to start or stop a compute instance." lightbox="../media/compute/compute-start-stop.png":::
 
-
 ## Next steps
 
 - [Create and manage prompt flow runtimes](./create-manage-runtime.md)

articles/ai-studio/how-to/create-manage-runtime.md

@@ -147,6 +147,17 @@ Go to the page for runtime details and select **Update**. On the **Edit compute
 
 Every time you open the page for runtime details, AI Studio checks whether there are new versions of the runtime. If new versions are available, a notification appears at the top of the page. You can also manually check the latest version by selecting the **Check version** button.
 
+## Switch compute instance runtime to automatic runtime
+
+Automatic runtime has following advantages over compute instance runtime:
+- Automatic manage lifecycle of runtime and underlying compute. You don't need to manually create and managed them anymore.
+- Easily customize packages by adding packages in the `requirements.txt` file in the flow folder, instead of creating a custom environment.
+
+We would recommend you to switch to automatic runtime if you're using compute instance runtime. If you have a compute instance runtime, you can switch it to an automatic runtime (preview) by using the following steps:
+- Prepare your `requirements.txt` file in the flow folder. Make sure that you don't pin the version of `promptflow` and `promptflow-tools` in `requirements.txt`, because we already include them in the runtime base image. Packages specified in `requirements.txt` will be installed when the runtime is started. 
+- If you want to keep the automatic runtime (preview) as long running compute like compute instance, you can disable the idle shutdown toggle under automatic runtime (preview) `edit` option.
+
+
 ## Next steps
 
 - [Learn more about prompt flow](./prompt-flow.md)

articles/api-center/TOC.yml

@@ -32,6 +32,8 @@
 #- name: API discovery and consumption
 - name: Reference
   items:
+      - name: Azure CLI
+        href: /cli/azure/apic
       - name: REST API
         href: /rest/api/apicenter/
       - name: REST API SDKs
@@ -43,4 +45,4 @@
           - name: Python
             href: https://pypi.org/project/azure-mgmt-apicenter
       - name: Resource Manager template
-        href: /azure/templates/microsoft.apicenter/allversions
+        href: /azure/templates/microsoft.apicenter/allversions

articles/dev-box/how-to-determine-your-quota-usage.md

@@ -6,16 +6,18 @@ ms.service: dev-box
 author: RoseHJM
 ms.author: rosemalcolm
 ms.topic: how-to 
-ms.date: 01/09/2024 
+ms.date: 01/16/2024 
 --- 
 
 # Determine resource usage and quota for Microsoft Dev Box  
 
-To ensure that resources are available for customers, Microsoft Dev Box has a limit on the number of each type of resource that can be used in a subscription. This limit is called a quota.  There are different types of quota related to Dev Box that you might see in the Developer portal and Azure portal, such as quota for Dev Box vCPU for box creation as well as portal resource limits for Dev Centers, network connections, and Dev Box Definitions.
+To ensure that resources are available for customers, Microsoft Dev Box has a limit on the number of each type of resource that can be used in a subscription. This limit is called a quota.  There are different types of quotas related to Dev Box that you might see in the Developer portal and Azure portal, such as quota for Dev Box vCPU for box creation as well as resource limits for Dev Centers, network connections, and Dev Box Definitions.
 
-Keeping track of how your quota of virtual machine cores is being used across your subscriptions can be difficult. You might want to know what your current usage is, how much is remaining, and in what regions you have capacity. To help you understand where and how you're using your quota, Azure provides the **Usage + Quotas** page in the Azure portal. 
+Understanding quota limits that affect your Dev Box resources helps you to plan for future use. You can check the [default quota level](/azure/azure-resource-manager/management/azure-subscription-service-limits?branch=main#microsoft-dev-box-limits) for each resource, view your current usage, and determine how much quota remains in each region. By monitoring the rate at which your quota is used, you can plan and prepare to [request a quota limit increase](how-to-request-quota-increase.md) before you reach the quota limit for the resource.
 
-For example, if dev box users encounter a vCPU quota error such as, *QuotaExceeded*, error during dev box creation there may be a need to increase this quota. A great place to start is to determine the current quota available.   
+To help you understand where and how you're using your quota, Azure provides the **Usage + Quotas** page in the Azure portal. Each subscription has its own **Usage + quotas** page that covers all the various services in the subscription.
+
+For example, if dev box users encounter a vCPU quota error such as, *QuotaExceeded*, during dev box creation there might be a need to increase this quota. A great place to start is to determine the current quota available.   
 
 
 ## Determine your Dev Box usage and quota by subscription in Azure portal
@@ -30,34 +32,20 @@ For example, if dev box users encounter a vCPU quota error such as, *QuotaExceed
 
    :::image type="content" source="media/how-to-determine-your-quota-usage/select-dev-box.png" alt-text="Screenshot showing the Usage and quotas page, with Dev Box highlighted in the Provider filter dropdown list." lightbox="media/how-to-determine-your-quota-usage/select-dev-box.png":::    
 
-1. In this example, you can see the **Quota name**, the **Region**, the **Subscription** the quota is assigned to, the **Current Usage**, and whether or not the limit is **Adjustable**.
-
-   :::image type="content" source="media/how-to-determine-your-quota-usage/example-subscription.png" alt-text="Screenshot showing the Usage and quotas page, with column headings highlighted." lightbox="media/how-to-determine-your-quota-usage/example-subscription.png":::    
+1. You can see the **Quota name**, the **Region**, the **Subscription** the quota is assigned to, the **Current Usage**, and whether or not the limit is **Adjustable**.
 
 1. Notice that Azure groups the usage by level: **Regular**, **Low**, and **No usage**: 
 
-   :::image type="content" source="media/how-to-determine-your-quota-usage/example-subscription-groups.png" alt-text="Screenshot showing the Usage and quotas page, with virtual machine size groups highlighted." lightbox="media/how-to-determine-your-quota-usage/example-subscription-groups.png" :::
- 
 1. To view quota and usage information for specific regions, select the **Region:** filter, select the regions to display, and then select **Apply**. 
-
-   :::image type="content" source="media/how-to-determine-your-quota-usage/select-regions.png" alt-text="Screenshot showing the Usage and quotas page, with the Regions dropdown list highlighted." lightbox="media/how-to-determine-your-quota-usage/select-regions.png":::
 
 1. To view only the items that are using part of your quota, select the **Usage:** filter, and then select **Only items with usage**. 
 
-   :::image type="content" source="media/how-to-determine-your-quota-usage/select-items-with-usage.png" alt-text="Screenshot showing the Usage and quotas page, with the Usage dropdown list and Only show items with usage option highlighted." lightbox="media/how-to-determine-your-quota-usage/select-items-with-usage.png" :::
- 
 1. To view items that are using above a certain amount of your quota, select the **Usage:** filter, and then select **Select custom usage**. 
-
-   :::image type="content" source="media/how-to-determine-your-quota-usage/select-custom-usage-before.png" alt-text="Screenshot showing the Usage and quotas page, with the Usage dropdown list and Select custom usage option highlighted." lightbox="media/how-to-determine-your-quota-usage/select-custom-usage-before.png" :::
 
 1. You can then set a custom usage threshold, so only the items using above the specified percentage of the quota are displayed.  
- 
-   :::image type="content" source="media/how-to-determine-your-quota-usage/select-custom-usage.png" alt-text="Screenshot showing the Usage and quotas page, with Select custom usage option and configuration settings highlighted." lightbox="media/how-to-determine-your-quota-usage/select-custom-usage.png":::
 
 1. Select **Apply**. 
 
-Each subscription has its own **Usage + quotas** page that covers all the various services in the subscription and not just Microsoft Dev Box. 
-
 ## Related content 
 
 - Check the default quota for each resource type by subscription type with [Microsoft Dev Box limits](../azure-resource-manager/management/azure-subscription-service-limits.md#microsoft-dev-box-limits)