Merge pull request #252134 from MicrosoftDocs/main

9/19/2023 PM Publish

Author: Taojunshen

.openpublishing.redirection.azure-kubernetes-service.json

@@ -19,6 +19,11 @@
             "source_path_from_root": "/articles/aks/aks-planned-maintenance-weekly-releases.md",
             "redirect_url": "/azure/aks/planned-maintenance",
             "redirect_document_id": false
+        },
+        {
+            "source_path_from_root": "/articles/aks/create-k8s-cluster-with-aks-application-gateway-ingress.md",
+            "redirect_url": "/azure/application-gateway/for-containers/overview",
+            "redirect_document_id": false
         }
     ]
 }

.openpublishing.redirection.json

@@ -22362,6 +22362,11 @@
             "redirect_url": "/azure/communication-services/how-tos/calling-sdk/lobby",
             "redirect_document_id": false
         },
+        {
+            "source_path_from_root": "/articles/communication-services/tutorials/widgets/click-to-call-widget.md",
+            "redirect_url": "/azure/communication-services/tutorials/calling-widget/calling-widget-overview",
+            "redirect_document_id": false
+        },
         {
             "source_path_from_root": "/articles/load-balancer/tutorial-load-balancer-standard-manage-portal.md",
             "redirect_url": "/azure/load-balancer/quickstart-load-balancer-standard-public-portal",

articles/active-directory-domain-services/policy-reference.md

@@ -1,7 +1,7 @@
 ---
 title: Built-in policy definitions for Azure Active Directory Domain Services
 description: Lists Azure Policy built-in policy definitions for Azure Active Directory Domain Services. These built-in policy definitions provide common approaches to managing your Azure resources.
-ms.date: 09/15/2023
+ms.date: 09/19/2023
 ms.service: active-directory
 ms.subservice: domain-services
 author: justinha

articles/ai-services/computer-vision/how-to/generate-thumbnail.md

@@ -27,13 +27,13 @@ To call the API, do the following steps:
     1. Replace the value of `<thumbnailFile>` with the path and name of the file in which to save the returned thumbnail image.
     1. Replace the first part of the request URL (`westcentralus`) with the text in your own endpoint URL.
         [!INCLUDE [Custom subdomains notice](../../../../includes/cognitive-services-custom-subdomains-note.md)]
-    1. Optionally, change the image URL in the request body (`https://upload.wikimedia.org/wikipedia/commons/thumb/5/56/Shorkie_Poo_Puppy.jpg/1280px-Shorkie_Poo_Puppy.jpg\`) to the URL of a different image from which to generate a thumbnail.
+    1. Optionally, change the image URL in the request body (`https://learn.microsoft.com/azure/ai-services/computer-vision/media/quickstarts/presentation.png`) to the URL of a different image from which to generate a thumbnail.
 1. Open a command prompt window.
 1. Paste the command from the text editor into the command prompt window.
 1. Press enter to run the program.
 
     ```bash
-    curl -H "Ocp-Apim-Subscription-Key: <subscriptionKey>" -o <thumbnailFile> -H "Content-Type: application/json" "https://westus.api.cognitive.microsoft.com/vision/v3.2/generateThumbnail?width=100&height=100&smartCropping=true" -d "{\"url\":\"https://upload.wikimedia.org/wikipedia/commons/thumb/5/56/Shorkie_Poo_Puppy.jpg/1280px-Shorkie_Poo_Puppy.jpg\"}"
+    curl -H "Ocp-Apim-Subscription-Key: <subscriptionKey>" -o <thumbnailFile> -H "Content-Type: application/json" "https://westus.api.cognitive.microsoft.com/vision/v3.2/generateThumbnail?width=100&height=100&smartCropping=true" -d "{\"url\":\"https://learn.microsoft.com/azure/ai-services/computer-vision/media/quickstarts/presentation.png\"}"
     ```
 
 ## Examine the response

articles/ai-services/computer-vision/includes/image-analysis-curl-quickstart.md

@@ -39,14 +39,14 @@ To analyze an image for various visual features, do the following steps:
 1. Copy the following command into a text editor.
 
     ```bash
-    curl.exe -H "Ocp-Apim-Subscription-Key: <subscriptionKey>" -H "Content-Type: application/json" "https://westcentralus.api.cognitive.microsoft.com/vision/v3.2/analyze?visualFeatures=Tags" -d "{'url':'https://upload.wikimedia.org/wikipedia/commons/thumb/3/3c/Salto_del_Angel-Canaima-Venezuela08.jpg/800px-Salto_del_Angel-Canaima-Venezuela08.jpg'}"
+    curl.exe -H "Ocp-Apim-Subscription-Key: <subscriptionKey>" -H "Content-Type: application/json" "https://westcentralus.api.cognitive.microsoft.com/vision/v3.2/analyze?visualFeatures=Tags" -d "{'url':'https://learn.microsoft.com/azure/ai-services/computer-vision/media/quickstarts/presentation.png'}"
     ```
 
 1. Make the following changes in the command where needed:
     1. Replace the value of `<subscriptionKey>` with your key.
     1. Replace the first part of the request URL (`westcentralus`) with the text in your own endpoint URL.
         [!INCLUDE [Custom subdomains notice](../../../../includes/cognitive-services-custom-subdomains-note.md)]
-    1. Optionally, change the image URL in the request body (`https://upload.wikimedia.org/wikipedia/commons/thumb/3/3c/Salto_del_Angel-Canaima-Venezuela08.jpg/800px-Salto_del_Angel-Canaima-Venezuela08.jpg`) to the URL of a different image to be analyzed.
+    1. Optionally, change the image URL in the request body (`https://learn.microsoft.com/azure/ai-services/computer-vision/media/quickstarts/presentation.png`) to the URL of a different image to be analyzed.
 1. Open a command prompt window.
 1. Paste your edited `curl` command from the text editor into the command prompt window, and then run the command.
 

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

@@ -70,10 +70,12 @@ There is an [upload limit](../quotas-limits.md), and there are some caveats abou
 ### Azure OpenAI resources
 
 You can protect Azure OpenAI resources in [virtual networks and private endpoints](/azure/ai-services/cognitive-services-virtual-networks) the same way as any Azure AI service.
+> [!NOTE]
+> If you disable public network access for your Azure OpenAI resources, you can call the `/extensions/chat/completions` API or chat with your existing index in Azure OpenAI Studio. However, vector search and blob/file ingestion in the studio is not supported.
 
 ### Azure Cognitive Search resources
 
-If you have an Azure Cognitive Search resource protected by a private network, and want to allow Azure OpenAI on your data to access your search service, complete [an application form](https://aka.ms/applyacsvpnaoaionyourdata). The application will be reviewed in five business days and you will be contacted via email about the results. If you are eligible, we will send a private endpoint request to your search service, and you will need to approve the request.
+If you have an Azure Cognitive Search resource protected by a private network, and want to allow Azure OpenAI on your data to access your search service, complete [an application form](https://aka.ms/applyacsvpnaoaionyourdata). The application will be reviewed in ten business days and you will be contacted via email about the results. If you are eligible, we will send a private endpoint request to your search service, and you will need to approve the request.
 
 :::image type="content" source="../media/use-your-data/approve-private-endpoint.png" alt-text="A screenshot showing private endpoint approval screen." lightbox="../media/use-your-data/approve-private-endpoint.png":::
 
@@ -96,6 +98,7 @@ To add a new data source to your Azure OpenAI resource, you need the following A
 |---------|---------|
 |[Cognitive Services Contributor](../how-to/role-based-access-control.md#cognitive-services-contributor) | You want to use Azure OpenAI on your data. |
 |[Search Index Data Contributor](/azure/role-based-access-control/built-in-roles#search-index-data-contributor)     | You have an existing Azure Cognitive Search index that you want to use, instead of creating a new one.        |
+|[Search Service Contributor](/azure/role-based-access-control/built-in-roles#search-service-contributor)     | You plan to create a new Azure Cognitive Search index.        |
 |[Storage Blob Data Contributor](/azure/role-based-access-control/built-in-roles#storage-blob-data-contributor)     | You have an existing Blob storage container that you want to use, instead of creating a new one.        |
 
 ## Document-level access control
@@ -221,6 +224,7 @@ Azure OpenAI on your data provides several search options you can use when you a
 > [!IMPORTANT]
 > * [Semantic search](/azure/search/semantic-search-overview#availability-and-pricing) and [vector search](https://azure.microsoft.com/pricing/details/cognitive-services/openai-service/) are subject to additional pricing. You need to choose **Basic or higher SKU** to enable semantic search or vector search. See [pricing tier difference](/azure/search/search-sku-tier) and [service limits](/azure/search/search-limits-quotas-capacity) for more information.
 > * To help improve the quality of the information retrieval and model response, we recommend enabling [semantic search](/azure/search/semantic-search-overview) for the following languages: English, French, Spanish, Portuguese, Italian, Germany, Chinese(Zh), Japanese, Korean, Russian, Arabic
+> * If you enable vector search, you need to enable public network access for your Azure OpenAI resources.
 
 | Search option       | Retrieval type | Additional pricing? |Benefits|
 |---------------------|------------------------|---------------------| -------- |

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

@@ -34,7 +34,7 @@ In this quickstart you can use your own data with Azure OpenAI models. Using Azu
 
 - An Azure OpenAI resource with a chat model deployed (for example, GPT-3 or GPT-4). For more information about model deployment, see the [resource deployment guide](./how-to/create-resource.md).
 
-    - Your chat model must use version `0301`. You can view or change your model version in [Azure OpenAI Studio](./concepts/models.md#model-updates).
+    - Your chat model can use version `gpt-35-turbo (0301)`, `gpt-35-turbo-16k`, `gpt-4`, and `gpt-4-32k`. You can view or change your model version in [Azure OpenAI Studio](./concepts/models.md#model-updates).
 
 - Be sure that you are assigned at least the [Cognitive Services Contributor](./how-to/role-based-access-control.md#cognitive-services-contributor) role for the Azure OpenAI resource. 
 

articles/ai-services/policy-reference.md

@@ -1,7 +1,7 @@
 ---
 title: Built-in policy definitions for Azure AI services
 description: Lists Azure Policy built-in policy definitions for Azure AI services. These built-in policy definitions provide common approaches to managing your Azure resources.
-ms.date: 09/13/2023
+ms.date: 09/19/2023
 author: nitinme
 ms.author: nitinme
 ms.service: cognitive-services

articles/ai-services/translator/reference/rest-api-guide.md

@@ -8,13 +8,13 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: translator-text
 ms.topic: reference
-ms.date: 07/18/2023
+ms.date: 09/18/2023
 ms.author: lajanuar
 ---
 
 # Text Translation REST API
 
-Text Translation is a cloud-based feature of the Azure AI Translator service and is part of the Azure AI service family of REST APIs. The Text Translation API translates text between language pairs across all [supported languages and dialects](../../language-support.md). The available methods are listed in the table below:
+Text Translation is a cloud-based feature of the Azure AI Translator service and is part of the Azure AI service family of REST APIs. The Text Translation API translates text between language pairs across all [supported languages and dialects](../../language-support.md). The available methods are listed in the following table:
 
 | Request| Method| Description|
 |---------|--------------|---------|

articles/ai-services/translator/reference/v3-0-break-sentence.md

@@ -23,26 +23,29 @@ Send a `POST` request to:
 
 ```HTTP
 https://api.cognitive.microsofttranslator.com/breaksentence?api-version=3.0
+
 ```
 
+_See_ [**Virtual Network Support**](v3-0-reference.md#virtual-network-support) for Translator service selected network and private endpoint configuration and support.
+
 ## Request parameters
 
 Request parameters passed on the query string are:
 
 | Query Parameter | Description |
 | -------| ----------- |
 | api-version <img width=200/>   | **Required query parameter**.<br/>Version of the API requested by the client. Value must be `3.0`. |
-| language | **Optional query parameter**.<br/>Language tag identifying the language of the input text. If a code isn't specified, automatic language detection will be applied. |
-| script    | **Optional query parameter**.<br/>Script tag identifying the script used by the input text. If a script isn't specified, the default script of the language will be assumed.  | 
+| language | **Optional query parameter**.<br/>Language tag identifying the language of the input text. If a code isn't specified, automatic language detection is applied. |
+| script    | **Optional query parameter**.<br/>Script tag identifying the script used by the input text. If a script isn't specified, the default script of the language is assumed. |
 
 Request headers include:
 
 | Headers | Description |
 | ------- | ----------- |
 | Authentication header(s) <img width=200/>  | **Required request header**.<br/>See <a href="v3-0-reference.md#authentication">available options for authentication</a>. |
 | Content-Type | **Required request header**.<br/>Specifies the content type of the payload. Possible values are: `application/json`. |
-| Content-Length    | **Required request header**.<br/>The length of the request body.  | 
-| X-ClientTraceId   | **Optional**.<br/>A client-generated GUID to uniquely identify the request. You can omit this header if you include the trace ID in the query string using a query parameter named `ClientTraceId`.  | 
+| Content-Length    | **Required request header**.<br/>The length of the request body.  |
+| X-ClientTraceId   | **Optional**.<br/>A client-generated GUID to uniquely identify the request. You can omit this header if you include the trace ID in the query string using a query parameter named `ClientTraceId`.  |
 
 ## Request body
 
@@ -59,21 +62,21 @@ The following limitations apply:
 * The array can have at most 100 elements.
 * The text value of an array element can't exceed 50,000 characters including spaces.
 * The entire text included in the request can't exceed 50,000 characters including spaces.
-* If the `language` query parameter is specified, then all array elements must be in the same language. Otherwise, language auto-detection is applied to each array element independently.
+* If the `language` query parameter is specified, then all array elements must be in the same language. Otherwise, language autodetection is applied to each array element independently.
 
 ## Response body
 
 A successful response is a JSON array with one result for each string in the input array. A result object includes the following properties:
 
-* `sentLen`: An array of integers representing the lengths of the sentences in the text element. The length of the array is the number of sentences, and the values are the length of each sentence. 
+* `sentLen`: An array of integers representing the lengths of the sentences in the text element. The length of the array is the number of sentences, and the values are the length of each sentence.
 
 * `detectedLanguage`: An object describing the detected language through the following properties:
 
   * `language`: Code of the detected language.
 
   * `score`: A float value indicating the confidence in the result. The score is between zero (0) and one (1.0). A low score (<= 0.4) indicates a low confidence.
 
-The `detectedLanguage` property is only present in the result object when language auto-detection is requested.
+The `detectedLanguage` property is only present in the result object when language autodetection is requested.
 
 An example JSON response is:
 
@@ -95,57 +98,30 @@ An example JSON response is:
 
 ## Response headers
 
-<table width="100%">
-  <th width="20%">Headers</th>
-  <th>Description</th>
-  <tr>
-    <td>X-RequestId</td>
-    <td>Value generated by the service to identify the request. It's used for troubleshooting purposes.</td>
-  </tr>
-</table> 
+|Headers|Description|
+|--- |--- |
+|X-RequestId|Value generated by the service to identify the request. It's used for troubleshooting purposes.|
 
 ## Response status codes
 
-The following are the possible HTTP status codes that a request returns. 
-
-<table width="100%">
-  <th width="20%">Status Code</th>
-  <th>Description</th>
-  <tr>
-    <td>200</td>
-    <td>Success.</td>
-  </tr>
-  <tr>
-    <td>400</td>
-    <td>One of the query parameters is missing or not valid. Correct request parameters before retrying.</td>
-  </tr>
-  <tr>
-    <td>401</td>
-    <td>The request couldn't be authenticated. Check that credentials are specified and valid.</td>
-  </tr>
-  <tr>
-    <td>403</td>
-    <td>The request isn't authorized. Check the details error message. This response code often indicates that all free translations provided with a trial subscription have been used up.</td>
-  </tr>
-  <tr>
-    <td>429</td>
-    <td>The server rejected the request because the client has exceeded request limits.</td>
-  </tr>
-  <tr>
-    <td>500</td>
-    <td>An unexpected error occurred. If the error persists, report it with: date and time of the failure, request identifier from response header `X-RequestId`, and client identifier from request header `X-ClientTraceId`.</td>
-  </tr>
-  <tr>
-    <td>503</td>
-    <td>Server temporarily unavailable. Retry the request. If the error persists, report it with: date and time of the failure, request identifier from response header `X-RequestId`, and client identifier from request header `X-ClientTraceId`.</td>
-  </tr>
-</table> 
-
-If an error occurs, the request will also return a JSON error response. The error code is a 6-digit number combining the 3-digit HTTP status code followed by a 3-digit number to further categorize the error. Common error codes can be found on the [v3 Translator reference page](./v3-0-reference.md#errors). 
+The following are the possible HTTP status codes that a request returns.
+
+|Status Code|Description|
+|--- |--- |
+|200|Success.|
+|400|One of the query parameters is missing or not valid. Correct request parameters before retrying.|
+|401|The request couldn't be authenticated. Check that credentials are specified and valid.|
+|403|The request isn't authorized. Check the details error message. This response code often indicates that all free translations provided with a trial subscription have been used up.|
+|429|The server rejected the request because the client has exceeded request limits.|
+|500|An unexpected error occurred. If the error persists, report it with: date and time of the failure, request identifier from response header `X-RequestId`, and client identifier from request header `X-ClientTraceId`.|
+|503|Server temporarily unavailable. Retry the request. If the error persists, report it with: date and time of the failure, request identifier from response header `X-RequestId`, and client identifier from request header `X-ClientTraceId`.|
+
+
+If an error occurs, the request returns a JSON error response. The error code is a 6-digit number combining the 3-digit HTTP status code followed by a 3-digit number to further categorize the error. Common error codes can be found on the [v3 Translator reference page](./v3-0-reference.md#errors).
 
 ## Examples
 
-The following example shows how to obtain sentence boundaries for a single sentence. The language of the sentence is automatically detected by the service.
+The following example shows how to obtain sentence boundaries for a single sentence. The service automatically detects the sentence language.
 
 ```curl
 curl -X POST "https://api.cognitive.microsofttranslator.com/breaksentence?api-version=3.0" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d "[{'Text':'How are you? I am fine. What did you do today?'}]"