Merge pull request #268786 from aahill/aoai-rest-update

updating version

Author: prmerger-automator[bot]

articles/ai-services/openai/references/azure-search.md

@@ -5,7 +5,7 @@ description: Learn how to use Azure OpenAI on your Azure Search data Python & RE
 manager: nitinme
 ms.service: azure-ai-openai
 ms.topic: conceptual
-ms.date: 02/14/2024
+ms.date: 03/12/2024
 author: mrbullwinkle
 ms.author: mbullwin
 recommendations: false
@@ -14,7 +14,7 @@ ms.custom: devx-track-python
 
 # Data source - Azure AI Search
 
-The configurable options of Azure AI Search when using Azure OpenAI On Your Data. This data source is supported in API version `2024-02-15-preview`.
+The configurable options of Azure AI Search when using Azure OpenAI On Your Data. This data source is supported in API version `2024-02-01`.
 
 |Name | Type | Required | Description |
 |--- | --- | --- | --- |
@@ -141,7 +141,7 @@ token_provider = get_bearer_token_provider(DefaultAzureCredential(), "https://co
 client = AzureOpenAI(
     azure_endpoint=endpoint,
     azure_ad_token_provider=token_provider,
-    api_version="2024-02-15-preview",
+    api_version="2024-02-01",
 )
 
 completion = client.chat.completions.create(
@@ -176,7 +176,7 @@ print(completion.model_dump_json(indent=2))
 
 ```bash
 az rest --method POST \
- --uri $AzureOpenAIEndpoint/openai/deployments/$ChatCompletionsDeploymentName/chat/completions?api-version=2024-02-15-preview \
+ --uri $AzureOpenAIEndpoint/openai/deployments/$ChatCompletionsDeploymentName/chat/completions?api-version=2024-02-01 \
  --resource https://cognitiveservices.azure.com/ \
  --body \
 '

articles/ai-services/openai/references/cosmos-db.md

@@ -5,7 +5,7 @@ description: Learn how to use Azure OpenAI on your Azure Cosmos DB data Python &
 manager: nitinme
 ms.service: azure-ai-openai
 ms.topic: conceptual
-ms.date: 02/14/2024
+ms.date: 03/12/2024
 author: mrbullwinkle
 ms.author: mbullwin
 recommendations: false
@@ -14,7 +14,7 @@ ms.custom: devx-track-python
 
 # Data source - Azure Cosmos DB for MongoDB vCore
 
-The configurable options of Azure Cosmos DB for MongoDB vCore when using Azure OpenAI On Your Data. This data source is supported in API version `2024-02-15-preview`.
+The configurable options of Azure Cosmos DB for MongoDB vCore when using Azure OpenAI On Your Data. This data source is supported in API version `2024-02-01`.
 
 |Name | Type | Required | Description |
 |--- | --- | --- | --- |
@@ -127,7 +127,7 @@ token_provider = get_bearer_token_provider(
 client = AzureOpenAI(
     azure_endpoint=endpoint,
     azure_ad_token_provider=token_provider,
-    api_version="2024-02-15-preview",
+    api_version="2024-02-01",
 )
 
 completion = client.chat.completions.create(
@@ -178,7 +178,7 @@ print(completion.model_dump_json(indent=2))
 ```bash
 
 az rest --method POST \
- --uri $AzureOpenAIEndpoint/openai/deployments/$ChatCompletionsDeploymentName/chat/completions?api-version=2024-02-15-preview \
+ --uri $AzureOpenAIEndpoint/openai/deployments/$ChatCompletionsDeploymentName/chat/completions?api-version=2024-02-01 \
  --resource https://cognitiveservices.azure.com/ \
  --body \
 '

articles/ai-services/openai/references/on-your-data.md

@@ -5,7 +5,7 @@ description: Learn how to use Azure OpenAI On Your Data Python & REST API.
 manager: nitinme
 ms.service: azure-ai-openai
 ms.topic: conceptual
-ms.date: 02/14/2024
+ms.date: 03/12/2024
 author: mrbullwinkle
 ms.author: mbullwin
 recommendations: false
@@ -14,10 +14,10 @@ ms.custom: devx-track-python
 
 # Azure OpenAI On Your Data API Reference
 
-This article provides reference documentation for Python and REST for the new Azure OpenAI On Your Data API. The latest preview api-version is `2024-02-15-preview` [Swagger spec](https://github.com/Azure/azure-rest-api-specs/blob/main/specification/cognitiveservices/data-plane/AzureOpenAI/inference/preview/2024-02-15-preview/inference.json).
+This article provides reference documentation for Python and REST for the new Azure OpenAI On Your Data API. The latest API version is `2024-02-01` [Swagger spec](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/cognitiveservices/data-plane/AzureOpenAI/inference/stable/2024-02-01).
 
 > [!NOTE]
-> Since `2024-02-15-preview` we introduced the following breaking changes comparing to earlier API versions:
+> Since API version `2024-02-15-preview` we introduced the following breaking changes comparing to earlier API versions:
 > * The API path is changed from `/extensions/chat/completions` to `/chat/completions`.
 > * The naming convention of property keys and enum values is changed from camel casing to snake casing. Example: `deploymentName` is changed to `deployment_name`.
 > * The data source type `AzureCognitiveSearch` is changed to `azure_search`.
@@ -27,6 +27,13 @@ This article provides reference documentation for Python and REST for the new Az
 POST {endpoint}/openai/deployments/{deployment-id}/chat/completions?api-version={api-version}
 ```
 
+**Supported versions**
+* `2024-02-15-preview` [Swagger spec](https://github.com/Azure/azure-rest-api-specs/blob/main/specification/cognitiveservices/data-plane/AzureOpenAI/inference/preview/2024-02-15-preview/inference.json)
+* `2024-02-01` [Swagger spec](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/cognitiveservices/data-plane/AzureOpenAI/inference/stable/2024-02-01).
+
+> [!NOTE]
+> [Azure Machine learning indexes](./azure-machine-learning.md), [Pinecone](./pinecone.md), and [Elasticsearch](./elasticsearch.md) are only supported in the `2024-02-15-preview` API version.
+
 ## URI parameters
 
 |Name               | In   | Type     | Required | Description                                                                           |
@@ -118,7 +125,7 @@ token_provider = get_bearer_token_provider(DefaultAzureCredential(), "https://co
 client = AzureOpenAI(
     azure_endpoint=endpoint,
     azure_ad_token_provider=token_provider,
-    api_version="2024-02-15-preview",
+    api_version="2024-02-01",
 )
 
 completion = client.chat.completions.create(
@@ -164,7 +171,7 @@ print(completion.model_dump_json(indent=2))
 
 ```bash
 az rest --method POST \
- --uri $AzureOpenAIEndpoint/openai/deployments/$ChatCompletionsDeploymentName/chat/completions?api-version=2024-02-15-preview \
+ --uri $AzureOpenAIEndpoint/openai/deployments/$ChatCompletionsDeploymentName/chat/completions?api-version=2024-02-01 \
  --resource https://cognitiveservices.azure.com/ \
  --body \
 '