Merge branch 'main' into patch-17

Author: ssalgadodev

articles/ai-services/.openpublishing.redirection.ai-services.json

@@ -769,6 +769,16 @@
       "source_path_from_root": "/articles/ai-services/speech-service/video-translation-studio.md",
       "redirect_url": "/azure/ai-services/speech-service/video-translation-get-started",
       "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/ai-services/qnamaker/how-to/migrate-to-openai.md",
+      "redirect_url": "/azure/ai-services/qnamaker/overview/overview",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/ai-services/language-service/question-answering/how-to/azure-openai-integration.md",
+      "redirect_url": "/azure/ai-services/language-service/question-answering/overview",
+      "redirect_document_id": true
     }
   ]
 }

articles/ai-services/computer-vision/includes/quickstarts-sdk/identity-java-sdk.md

@@ -51,19 +51,7 @@ Get started with facial recognition using the Face client library for Java. Foll
         <dependency>
           <groupId>com.azure</groupId>
           <artifactId>azure-ai-vision-face</artifactId>
-          <version>1.0.0-beta.1</version>
-        </dependency>
-        <!-- https://mvnrepository.com/artifact/org.apache.httpcomponents/httpclient -->
-        <dependency>
-          <groupId>org.apache.httpcomponents</groupId>
-          <artifactId>httpclient</artifactId>
-          <version>4.5.13</version>
-        </dependency>
-        <!-- https://mvnrepository.com/artifact/com.google.code.gson/gson -->
-        <dependency>
-          <groupId>com.google.code.gson</groupId>
-          <artifactId>gson</artifactId>
-          <version>2.11.0</version>
+          <version>1.0.0-beta.2</version>
         </dependency>
       </dependencies>
     </project>

articles/ai-services/computer-vision/language-support.md

@@ -258,7 +258,7 @@ The latest [Multimodal embeddings](./concept-image-retrieval.md) model supports
 | Norwegian             | `no`          | ✅ |  |
 | Nyanja                | `ny`          | ✅ |  |
 | Occitan               | `oc`          | ✅ |  |
-| Oriya                 | `or`          | ✅ |  |
+| Odia                  | `or`          | ✅ |  |
 | Oromo                 | `om`          | ✅ |  |
 | Pashto                | `ps`          | ✅ |  |
 | Persian               | `fa`          | ✅ |  |

articles/ai-services/computer-vision/tutorials/liveness.md

@@ -445,7 +445,7 @@ The high-level steps involved in liveness with verification orchestration are il
 
         var sessionClient = new FaceSessionClient(endpoint, credential);
 
-        var createContent = new CreateLivenessSessionContent(LivenessOperationMode.Passive)
+        var createContent = new CreateLivenessWithVerifySessionContent(LivenessOperationMode.Passive)
         {
             DeviceCorrelationId = "723d6d03-ef33-40a8-9682-23a1feb7bccd"
         };
@@ -472,7 +472,7 @@ The high-level steps involved in liveness with verification orchestration are il
             .credential(new AzureKeyCredential(accountKey))
             .buildClient();
 
-        CreateLivenessSessionContent parameters = new CreateLivenessSessionContent(LivenessOperationMode.PASSIVE)
+        CreateLivenessWithVerifySessionContent parameters = new CreateLivenessWithVerifySessionContent(LivenessOperationMode.PASSIVE)
             .setDeviceCorrelationId("723d6d03-ef33-40a8-9682-23a1feb7bccd")
             .setSendResultsToClient(false);
 
@@ -500,7 +500,7 @@ The high-level steps involved in liveness with verification orchestration are il
             reference_image_content = fd.read()
 
         created_session = await face_session_client.create_liveness_with_verify_session(
-            CreateLivenessSessionContent(
+            CreateLivenessWithVerifySessionContent(
                 liveness_operation_mode=LivenessOperationMode.PASSIVE,
                 device_correlation_id="723d6d03-ef33-40a8-9682-23a1feb7bccd",
             ),

articles/ai-services/computer-vision/use-case-alt-text.md

@@ -21,7 +21,7 @@ Alt text, or alternative text, is an HTML attribute added to the `<img>` tag
 
 `<img src="elephant.jpg" alt="An elephant in a grassland.">`
 
-Alt text enables website owners to describe an image in plain text. These image descriptions improve accessibility by enabling screen readers such as Microsoft Narrator, JAWS, and NVDA to accurately communicate image content to their vision-impaired and blind users.
+Alt text enables website owners to describe an image in plain text. These image descriptions improve accessibility by enabling screen readers such as Microsoft Narrator, JAWS, and NVDA to accurately communicate image content to their users who are blind or with visual impairment.
 
 Alt text is also vital for image search engine optimization (SEO). It helps search engines understand the visual content in your images. The search engine is then better able to include and rank your website in search results when users search for the content in your website.  
 

articles/ai-services/containers/docker-compose-recipe.md

@@ -7,7 +7,7 @@ author: aahill
 manager: nitinme
 ms.service: azure-ai-services
 ms.topic: how-to
-ms.date: 02/22/2024
+ms.date: 11/06/2024
 ms.author: aahi
 
 # SME: Brendan Walsh

articles/ai-services/content-safety/concepts/custom-categories.md

@@ -49,7 +49,7 @@ This implementation works on text content and image content.
 
 ## How it works
 
-#### [Custom categories (standard) API](#tab/standard)
+### [Custom categories (standard) API](#tab/standard)
 
 The Azure AI Content Safety custom categories feature uses a multi-step process for creating, training, and using custom content classification models. Here's a look at the workflow:
 

articles/ai-services/content-safety/how-to/use-blocklist.md

@@ -53,7 +53,7 @@ Copy the cURL command below to a text editor and make the following changes:
 
 
 ```shell
-curl --location --request PATCH '<endpoint>/contentsafety/text/blocklists/<your_list_name>?api-version=2023-10-01' \
+curl --location --request PATCH '<endpoint>/contentsafety/text/blocklists/<your_list_name>?api-version=2024-09-01' \
 --header 'Ocp-Apim-Subscription-Key: <enter_your_key_here>' \
 --header 'Content-Type: application/json' \
 --data-raw '{
@@ -245,7 +245,7 @@ Copy the cURL command below to a text editor and make the following changes:
 1. Replace the value of the `"text"` field with the item you'd like to add to your blocklist. The maximum length of a blocklistItem is 128 characters.
 
 ```shell
-curl --location --request POST '<endpoint>/contentsafety/text/blocklists/<your_list_name>:addOrUpdateBlocklistItems?api-version=2023-10-01' \
+curl --location --request POST '<endpoint>/contentsafety/text/blocklists/<your_list_name>:addOrUpdateBlocklistItems?api-version=2024-09-01' \
 --header 'Ocp-Apim-Subscription-Key: <enter_your_key_here>' \
 --header 'Content-Type: application/json' \
 --data-raw '"blocklistItems": [{
@@ -487,7 +487,7 @@ Copy the cURL command below to a text editor and make the following changes:
 1. Optionally change the value of the `"text"` field to whatever text you want to analyze. 
 
 ```shell
-curl --location --request POST '<endpoint>/contentsafety/text:analyze?api-version=2023-10-01&' \
+curl --location --request POST '<endpoint>/contentsafety/text:analyze?api-version=2024-09-01&' \
 --header 'Ocp-Apim-Subscription-Key: <enter_your_key_here>' \
 --header 'Content-Type: application/json' \
 --data-raw '{
@@ -727,7 +727,7 @@ Copy the cURL command below to a text editor and make the following changes:
 1. Replace `<your_list_name>` (in the request URL) with the name you used in the list creation step.
 
 ```shell
-curl --location --request GET '<endpoint>/contentsafety/text/blocklists/<your_list_name>/blocklistItems?api-version=2023-10-01' \
+curl --location --request GET '<endpoint>/contentsafety/text/blocklists/<your_list_name>/blocklistItems?api-version=2024-09-01' \
 --header 'Ocp-Apim-Subscription-Key: <enter_your_key_here>' \
 --header 'Content-Type: application/json'
 ```
@@ -900,7 +900,7 @@ Copy the cURL command below to a text editor and make the following changes:
 
 
 ```shell
-curl --location --request GET '<endpoint>/contentsafety/text/blocklists?api-version=2023-10-01' \
+curl --location --request GET '<endpoint>/contentsafety/text/blocklists?api-version=2024-09-01' \
 --header 'Ocp-Apim-Subscription-Key: <enter_your_key_here>' \
 --header 'Content-Type: application/json'
 ```
@@ -1048,7 +1048,7 @@ Copy the cURL command below to a text editor and make the following changes:
 1. Replace `<your_list_name>` (in the request URL) with the name you used in the list creation step.
 
 ```shell
-cURL --location '<endpoint>contentsafety/text/blocklists/<your_list_name>?api-version=2023-10-01' \
+cURL --location '<endpoint>contentsafety/text/blocklists/<your_list_name>?api-version=2024-09-01' \
 --header 'Ocp-Apim-Subscription-Key: <enter_your_key_here>' \
 --data ''
 ```
@@ -1199,7 +1199,7 @@ Copy the cURL command below to a text editor and make the following changes:
 
 
 ```shell
-cURL --location '<endpoint>contentsafety/text/blocklists/<your_list_name>/blocklistItems/<your_item_id>?api-version=2023-10-01' \
+cURL --location '<endpoint>contentsafety/text/blocklists/<your_list_name>/blocklistItems/<your_item_id>?api-version=2024-09-01' \
 --header 'Ocp-Apim-Subscription-Key: <enter_your_key_here>' \
 --data ''
 ```
@@ -1387,7 +1387,7 @@ Copy the cURL command below to a text editor and make the following changes:
 
 
 ```shell
-curl --location --request DELETE '<endpoint>/contentsafety/text/blocklists/<your_list_name>:removeBlocklistItems?api-version=2023-10-01' \
+curl --location --request POST '<endpoint>/contentsafety/text/blocklists/<your_list_name>:removeBlocklistItems?api-version=2024-09-01' \
 --header 'Ocp-Apim-Subscription-Key: <enter_your_key_here>' \
 --header 'Content-Type: application/json'
 --data-raw '"blocklistItemIds":[
@@ -1573,7 +1573,7 @@ Copy the cURL command below to a text editor and make the following changes:
 1. Replace `<your_list_name>` (in the request URL) with the name you used in the list creation step.
 
 ```shell
-curl --location --request DELETE '<endpoint>/contentsafety/text/blocklists/<your_list_name>?api-version=2023-10-01' \
+curl --location --request DELETE '<endpoint>/contentsafety/text/blocklists/<your_list_name>?api-version=2024-09-01' \
 --header 'Ocp-Apim-Subscription-Key: <enter_your_key_here>' \
 --header 'Content-Type: application/json' \
 ```

articles/ai-services/content-safety/includes/storage-account-access.md

@@ -10,7 +10,9 @@ ms.author: pafarley
 ---
 
 
-Next, you need to give your Content Safety resource access to read from the Azure Storage resource. Enable system-assigned Managed identity for the Azure AI Content Safety instance and assign the role of **Storage Blob Data Contributor/Owner/Reader** to the identity:
+Next, you need to give your Content Safety resource access to read from the Azure Storage resource. Enable system-assigned Managed identity for the Azure AI Content Safety instance and assign the role of **Storage Blob Data Contributor/Owner** to the identity:
+> [!IMPORTANT]
+> **Only Storage Blob Data Contributor or Storage Blob Data Owner are valid roles to proceed.**
 
 1. Enable managed identity for the Azure AI Content Safety instance. 
 

articles/ai-services/content-safety/overview.md

@@ -99,6 +99,15 @@ Currently, Azure AI Content Safety has an **F0** and **S0** pricing tier. See th
 
 ## Service limits
 
+> [!CAUTION]
+> **Deprecation Notice**
+>
+> As part of Content Safety versioning and lifecycle management, we are announcing the deprecation of certain Public Preview and GA versions of our service APIs. Following our deprecation policy:
+> * **Public Preview versions**: Each new Public Preview version will trigger the deprecation of the previous preview version after a 90-day period, provided no breaking changes are introduced.
+> * **GA versions**: When a new GA version is released, the prior GA version will be deprecated after a 90-day period if compatibility is maintained.
+>
+> See the [What's new](./whats-new.md) page for upcoming deprecations.
+
 ### Input requirements
 
 See the following list for the input requirements for each feature.
@@ -147,7 +156,7 @@ To use the Content Safety APIs, you must create your Azure AI Content Safety res
 | Australia East                     | ✅                  |                    | ✅    |                 | ✅                 | ✅             | ✅                         | ✅                         | ✅    | ✅           |
 | Canada East                          |                    |                    | ✅    |                 | ✅                 | ✅             | ✅                         | ✅                         | ✅    | ✅           |
 | Central US                             |                    |                    | ✅    |                 | ✅                 | ✅             | ✅                         | ✅                         | ✅    | ✅           |
-| East US                            | ✅                 | ✅                 | ✅    | ✅              | ✅                 | ✅             | ✅                         | ✅                         | ✅    | ✅           |
+| East US                            | ✅                 |                  | ✅    | ✅              | ✅                 | ✅             | ✅                         | ✅                         | ✅    | ✅           |
 | East US 2                           |                    | ✅                 | ✅    |                 | ✅                 | ✅             | ✅                         | ✅                         | ✅    | ✅           |
 | France Central                        |                    | ✅                 | ✅    |                 | ✅                 | ✅             | ✅                         | ✅                         | ✅    | ✅           |
 | Japan East                            |                    |                    | ✅    |                 | ✅                 | ✅             | ✅                         | ✅                         | ✅    | ✅           |