Merge pull request #259720 from MicrosoftDocs/repo_sync_working_branch

Confirm merge from repo_sync_working_branch to main to sync with https://github.com/MicrosoftDocs/azure-docs (branch main)

Author: Saisang

articles/ai-services/openai/how-to/migration.md

@@ -149,7 +149,7 @@ client = AzureOpenAI(
     api_key=os.getenv("AZURE_OPENAI_KEY"),  
     api_version="2023-10-01-preview",
     azure_endpoint = os.getenv("AZURE_OPENAI_ENDPOINT")
-    )
+)
 
 deployment_name='REPLACE_WITH_YOUR_DEPLOYMENT_NAME' #This will correspond to the custom name you chose for your deployment when you deployed a model. 
 

articles/ai-services/openai/how-to/switching-endpoints.md

@@ -123,7 +123,7 @@ OpenAI uses the `model` keyword argument to specify what model to use. Azure Ope
 ```python
 completion = client.completions.create(
     model='gpt-3.5-turbo-instruct',
-    prompt="<prompt>)
+    prompt="<prompt>")
 )
 
 chat_completion = client.chat.completions.create(

articles/ai-services/translator/translator-text-apis.md

@@ -519,14 +519,20 @@ public class TranslatorText {
 
 ```javascript
 const axios = require('axios').default;
-    const { v4: uuidv4 } = require('uuid');
+const { v4: uuidv4 } = require('uuid');
 
-    let key = "<your-translator-key>";
-    let endpoint = "https://api.cognitive.microsofttranslator.com";
+let key = "<your-translator-key>";
+let endpoint = "https://api.cognitive.microsofttranslator.com";
 
-    // location, also known as region.
-    // required if you're using a multi-service or regional (not global) resource. It can be found in the Azure portal on the Keys and Endpoint page.
-    let location = "<YOUR-RESOURCE-LOCATION>";
+// location, also known as region.
+// required if you're using a multi-service or regional (not global) resource. It can be found in the Azure portal on the Keys and Endpoint page.
+let location = "<YOUR-RESOURCE-LOCATION>";
+
+let params = new URLSearchParams();
+params.append("api-version", "3.0");
+params.append("from", "en");
+params.append("to", "sw");
+params.append("to", "it");
 
 axios({
     baseURL: endpoint,
@@ -539,11 +545,7 @@ axios({
         'Content-type': 'application/json',
         'X-ClientTraceId': uuidv4().toString()
     },
-    params: {
-        'api-version': '3.0',
-        'from': 'en',
-        'to': ['sw', 'it']
-    },
+    params: params,
     data: [{
         'text': 'Hello, friend! What did you do today?'
     }],
@@ -810,6 +812,11 @@ let endpoint = "https://api.cognitive.microsofttranslator.com";
 // This is required if using an Azure AI multi-service resource.
 let location = "<YOUR-RESOURCE-LOCATION>";
 
+let params = new URLSearchParams();
+params.append("api-version", "3.0");
+params.append("to", "en");
+params.append("to", "it");
+
 axios({
     baseURL: endpoint,
     url: '/translate',
@@ -821,10 +828,7 @@ axios({
         'Content-type': 'application/json',
         'X-ClientTraceId': uuidv4().toString()
     },
-    params: {
-        'api-version': '3.0',
-        'to': ['en', 'it']
-    },
+    params: params,
     data: [{
         'text': 'Halo, rafiki! Ulifanya nini leo?'
     }],
@@ -1086,6 +1090,9 @@ let endpoint = "https://api.cognitive.microsofttranslator.com";
 // This is required if using an Azure AI multi-service resource.
 let location = "<YOUR-RESOURCE-LOCATION>";
 
+let params = new URLSearchParams();
+params.append("api-version", "3.0");
+
 axios({
     baseURL: endpoint,
     url: '/detect',
@@ -1097,9 +1104,7 @@ axios({
         'Content-type': 'application/json',
         'X-ClientTraceId': uuidv4().toString()
     },
-    params: {
-        'api-version': '3.0'
-    },
+    params: params,
     data: [{
         'text': 'Hallo Freund! Was hast du heute gemacht?'
     }],
@@ -1365,6 +1370,11 @@ let endpoint = "https://api.cognitive.microsofttranslator.com";
 // This is required if using an Azure AI multi-service resource.
 let location = "<YOUR-RESOURCE-LOCATION>";
 
+let params = new URLSearchParams();
+params.append("api-version", "3.0");
+params.append("to", "th");
+params.append("toScript", "latn");
+
 axios({
     baseURL: endpoint,
     url: '/translate',
@@ -1376,11 +1386,7 @@ axios({
         'Content-type': 'application/json',
         'X-ClientTraceId': uuidv4().toString()
     },
-    params: {
-        'api-version': '3.0',
-        'to': 'th',
-        'toScript': 'latn'
-    },
+    params: params,
     data: [{
         'text': 'Hello, friend! What did you do today?'
     }],
@@ -1650,6 +1656,12 @@ let endpoint = "https://api.cognitive.microsofttranslator.com";
 // This is required if using an Azure AI multi-service resource.
 let location = "<YOUR-RESOURCE-LOCATION>";
 
+let params = new URLSearchParams();
+params.append("api-version", "3.0");
+params.append("language", "th");
+params.append("fromScript", "thai");
+params.append("toScript", "latn");
+
 axios({
     baseURL: endpoint,
     url: '/transliterate',
@@ -1661,12 +1673,7 @@ axios({
         'Content-type': 'application/json',
         'X-ClientTraceId': uuidv4().toString()
     },
-    params: {
-        'api-version': '3.0',
-        'language': 'th',
-        'fromScript': 'thai',
-        'toScript': 'latn'
-    },
+    params: params,
     data: [{
         'text': 'สวัสดีเพื่อน! วันนี้คุณทำอะไร'
     }],
@@ -1926,6 +1933,11 @@ let endpoint = "https://api.cognitive.microsofttranslator.com";
 // This is required if using an Azure AI multi-service resource.
 let location = "<YOUR-RESOURCE-LOCATION>";
 
+let params = new URLSearchParams();
+params.append("api-version", "3.0");
+params.append("to", "es");
+params.append("includeSentenceLength", true);
+
 axios({
     baseURL: endpoint,
     url: '/translate',
@@ -1937,11 +1949,7 @@ axios({
         'Content-type': 'application/json',
         'X-ClientTraceId': uuidv4().toString()
     },
-    params: {
-        'api-version': '3.0',
-        'to': 'es',
-        'includeSentenceLength': true
-    },
+    params: params,
     data: [{
         'text': 'Can you tell me how to get to Penn Station? Oh, you aren\'t sure? That\'s fine.'
     }],
@@ -2209,6 +2217,9 @@ let endpoint = "https://api.cognitive.microsofttranslator.com";
 // This is required if using an Azure AI multi-service resource.
 let location = "<YOUR-RESOURCE-LOCATION>";
 
+let params = new URLSearchParams();
+params.append("api-version", "3.0");
+
 axios({
     baseURL: endpoint,
     url: '/breaksentence',
@@ -2220,9 +2231,7 @@ axios({
         'Content-type': 'application/json',
         'X-ClientTraceId': uuidv4().toString()
     },
-    params: {
-        'api-version': '3.0'
-    },
+    params: params,
     data: [{
         'text': 'Can you tell me how to get to Penn Station? Oh, you aren\'t sure? That\'s fine.'
     }],
@@ -2477,6 +2486,11 @@ let endpoint = "https://api.cognitive.microsofttranslator.com";
 // This is required if using an Azure AI multi-service resource.
 let location = "<YOUR-RESOURCE-LOCATION>";
 
+let params = new URLSearchParams();
+params.append("api-version", "3.0");
+params.append("from", "en");
+params.append("to", "es");
+
 axios({
     baseURL: endpoint,
     url: '/dictionary/lookup',
@@ -2488,11 +2502,7 @@ axios({
         'Content-type': 'application/json',
         'X-ClientTraceId': uuidv4().toString()
     },
-    params: {
-        'api-version': '3.0',
-        'from': 'en',
-        'to': 'es'
-    },
+    params: params,
     data: [{
         'text': 'sunlight'
     }],
@@ -2900,6 +2910,11 @@ let endpoint = "https://api.cognitive.microsofttranslator.com";
 // This is required if using an Azure AI multi-service resource.
 let location = "<YOUR-RESOURCE-LOCATION>";
 
+let params = new URLSearchParams();
+params.append("api-version", "3.0");
+params.append("from", "en");
+params.append("to", "es");
+
 axios({
     baseURL: endpoint,
     url: '/dictionary/examples',
@@ -2911,11 +2926,7 @@ axios({
         'Content-type': 'application/json',
         'X-ClientTraceId': uuidv4().toString()
     },
-    params: {
-        'api-version': '3.0',
-        'from': 'en',
-        'to': 'es'
-    },
+    params: params,
     data: [{
         'text': 'sunlight',
         'translation': 'luz solar'

articles/azure-monitor/containers/container-insights-troubleshoot.md

@@ -88,6 +88,8 @@ To diagnose the problem if you can't view status information or no results are r
     ama-logs-windows-6drwq                  1/1       Running   0          1d
     ```
 
+1. If the pods are in a running state, but there is no data in Log Analytics or data appears to only send during a certain part of the day, it might be an indication that the daily cap has been met. When this limit is met each day, data stops ingesting into the Log Analytics Workspace and resets at the reset time. For more information, see [Log Analytics Daily Cap](../../azure-monitor/logs/daily-cap.md#determine-your-daily-cap).
+
 ## Container insights agent ReplicaSet Pods aren't scheduled on a non-AKS cluster
 
 Container insights agent ReplicaSet Pods have a dependency on the following node selectors on the worker (or agent) nodes for the scheduling:

articles/azure-monitor/essentials/data-platform-metrics.md

@@ -61,7 +61,7 @@ For a complete list of data sources that can send data to Azure Monitor Metrics,
 ## REST API 
 Azure Monitor provides REST APIs that allow you to get data in and out of Azure Monitor Metrics.
 - **Custom metrics API** - [Custom metrics](./metrics-custom-overview.md) allow you to load your own metrics into the Azure Monitor Metrics database. Those metrics can then be used by the same analysis tools that process Azure Monitor platform metrics. 
-- **Azure Monitor Metrics REST API** - Allows you to access Azure Monitor platform metrics definitions and values. For more information, see [Azure Monitor REST API](/rest/api/monitor/).  For information on how to use the API, see the [Azure monitoring REST API walkthrough](./rest-api-walkthrough.md).
+- **Azure Monitor Metrics REST API** - Allows you to access Azure Monitor platform metrics definitions and values. For more information, see [Azure Monitor REST API](/rest/api/monitor/metrics/list).  For information on how to use the API, see the [Azure monitoring REST API walkthrough](./rest-api-walkthrough.md).
 - **Azure Monitor Metrics Batch REST API**  - [Azure Monitor Metrics Batch API](/rest/api/monitor/metrics-batch/) is a high-volume API designed for customers with large volume metrics queries. It's similar to the existing standard Azure Monitor Metrics REST API, but provides the capability to retrieve metric data for up to 50 resource IDs in the same subscription and region in a single batch API call. This improves query throughput and reduces the risk of throttling.   
 
 ## Security
@@ -145,6 +145,8 @@ Platform and custom metrics are stored for **93 days** with the following except
 
 While platform and custom metrics are stored for 93 days, you can only query (in the **Metrics** tile) for a maximum of 30 days' worth of data on any single chart. This limitation doesn't apply to log-based metrics. If you see a blank chart or your chart displays only part of metric data, verify that the difference between start and end dates in the time picker doesn't exceed the 30-day interval. After you've selected a 30-day interval, you can [pan](./metrics-charts.md#pan) the chart to view the full retention window.
 
+> [!NOTE]
+> Moving or renaming an Azure Resource may result in a lost of metric history for that resource.
 
 ### Prometheus metrics
 Prometheus metrics are stored for **18 months**, but a PromQL query can only span a maximum of 32 days.

articles/communication-services/quickstarts/advanced-messaging/whatsapp/connect-whatsapp-business-account.md

@@ -20,6 +20,10 @@ Get started with the Azure Communication Services Advanced Messaging, which exte
 -   Receive inquiries from your customers for product feedback or support, price quotes, and reschedule appointments.
 -   Send your customer's notifications like appointment reminders, product discounts, transaction receipts, and one-time passcodes.
 
+## Overview
+
+This document provides information about registering a WhatsApp Business Account with Azure Communication Services. This [video](https://learn.microsoft.com/_themes/docs.theme/master/en-us/_themes/global/video-embed.html?id=04c63978-6f27-4289-93d6-625d8569ee28) demonstrates the process. 
+
 ## Prerequisites
 
 - [Create Azure Communication Resource](../../create-communication-resource.md)

articles/container-apps/tutorial-ci-cd-runners-jobs.md

@@ -415,7 +415,7 @@ You can now create a job that uses to use the container image. In this section,
     az containerapp job create -n "$JOB_NAME" -g "$RESOURCE_GROUP" --environment "$ENVIRONMENT" `
         --trigger-type Event `
         --replica-timeout 1800 `
-        --replica-retry-limit 1 `
+        --replica-retry-limit 0 `
         --replica-completion-count 1 `
         --parallelism 1 `
         --image "$CONTAINER_REGISTRY_NAME.azurecr.io/$CONTAINER_IMAGE_NAME" `
@@ -695,7 +695,7 @@ You can run a manual job to register an offline placeholder agent. The job runs
     az containerapp job create -n "$PLACEHOLDER_JOB_NAME" -g "$RESOURCE_GROUP" --environment "$ENVIRONMENT" \
         --trigger-type Manual \
         --replica-timeout 300 \
-        --replica-retry-limit 1 \
+        --replica-retry-limit 0 \
         --replica-completion-count 1 \
         --parallelism 1 \
         --image "$CONTAINER_REGISTRY_NAME.azurecr.io/$CONTAINER_IMAGE_NAME" \
@@ -812,7 +812,7 @@ az containerapp job create -n "$JOB_NAME" -g "$RESOURCE_GROUP" --environment "$E
     --polling-interval 30 \
     --scale-rule-name "azure-pipelines" \
     --scale-rule-type "azure-pipelines" \
-    --scale-rule-metadata "poolName=container-apps" "targetPipelinesQueueLength=1" \
+    --scale-rule-metadata "poolName=$AZP_POOL" "targetPipelinesQueueLength=1" \
     --scale-rule-auth "personalAccessToken=personal-access-token" "organizationURL=organization-url" \
     --cpu "2.0" \
     --memory "4Gi" \
@@ -835,7 +835,7 @@ az containerapp job create -n "$JOB_NAME" -g "$RESOURCE_GROUP" --environment "$E
     --polling-interval 30 `
     --scale-rule-name "azure-pipelines" `
     --scale-rule-type "azure-pipelines" `
-    --scale-rule-metadata "poolName=container-apps" "targetPipelinesQueueLength=1" `
+    --scale-rule-metadata "poolName=$AZP_POOL" "targetPipelinesQueueLength=1" `
     --scale-rule-auth "personalAccessToken=personal-access-token" "organizationURL=organization-url" `
     --cpu "2.0" `
     --memory "4Gi" `

articles/cost-management-billing/savings-plan/savings-plan-compute-overview.md

@@ -22,7 +22,7 @@ You can buy savings plans in the [Azure portal](https://portal.azure.com/) or wi
 
 ## Why buy a savings plan?
 
-If you have consistent compute spend, but your use of disparate resources makes reservations infeasible, buying a savings plan gives you the ability to reduce your costs. For example, If you consistently spend at least $X every hour, but your usage comes from different resources and/or different datacenter regions, you likely can't effectively cover these costs with reservations. When you buy a savings plan, your hourly usage, up to your commitment amount, is discounted. For this usage, you no longer charged at the pay-as-you-go rates.
+If you have consistent compute spend, but your use of disparate resources makes reservations infeasible, buying a savings plan gives you the ability to reduce your costs. For example, if you consistently spend at least $X every hour, but your usage comes from different resources and/or different datacenter regions, you likely can't effectively cover these costs with reservations. When you buy a savings plan, your hourly usage, up to your commitment amount, is discounted. For this usage, you no longer charged at the pay-as-you-go rates.
 
 ## How savings plan benefits are applied
 
@@ -107,4 +107,4 @@ If you have Azure savings plan for compute questions, contact your account team,
 
 - Learn [how discounts apply to savings plans](discount-application.md).
 - [Trade in reservations for a savings plan](reservation-trade-in.md).
-- [Buy a savings plan](buy-savings-plan.md).
+- [Buy a savings plan](buy-savings-plan.md).

articles/machine-learning/how-to-assign-roles.md

@@ -36,7 +36,7 @@ Azure Machine Learning workspaces have a five built-in roles that are available
 | Role | Access level |
 | --- | --- |
 | **AzureML Data Scientist** | Can perform all actions within an Azure Machine Learning workspace, except for creating or deleting compute resources and modifying the workspace itself. |
-| **AzureML Compute Operator** | Can create, manage and access compute resources within a workspace.|
+| **AzureML Compute Operator** | Can create, manage, delete, and access compute resources within a workspace.|
 | **Reader** | Read-only actions in the workspace. Readers can list and view assets, including [datastore](how-to-access-data.md) credentials, in a workspace. Readers can't create or update these assets. |
 | **Contributor** | View, create, edit, or delete (where applicable) assets in a workspace. For example, contributors can create an experiment, create or attach a compute cluster, submit a run, and deploy a web service. |
 | **Owner** | Full access to the workspace, including the ability to view, create, edit, or delete (where applicable) assets in a workspace. Additionally, you can change role assignments. |

articles/openshift/howto-create-private-cluster-4x.md

@@ -220,7 +220,7 @@ az aro create \
 ```
 
 > [!NOTE]
-> The UserDefinedRouting flag can only be used when creating clusters with `--apiserver-visibility Private` and `--ingress-visibility Private` parameters.
+> The UserDefinedRouting flag can only be used when creating clusters with `--apiserver-visibility Private` and `--ingress-visibility Private` parameters. Ensure you are using the latest Azure CLI. Clusters deployed with Azure CLI 2.52.0 and older will get deployed with public IPs.
 > 
 
 This User Defined Routing option prevents a public IP address from being provisioned. User Defined Routing (UDR) allows you to create custom routes in Azure to override the default system routes or to add more routes to a subnet's route table. See