Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into WI-214554b-freshness-updates-march-2024

Author: AlizaBernstein

.openpublishing.redirection.active-directory.json

@@ -33690,6 +33690,6 @@
             "source_path_from_root": "/articles/active-directory-domain-services/contact-us.md",
             "redirect_url": "/azure/active-directory/fundamentals/support-help-options",
             "redirect_document_id": false
-        },
+        }
     ]
-}
+}

.openpublishing.redirection.kubernetes-fleet.json

@@ -0,0 +1,9 @@
+{
+    "redirections": [
+       {
+            "source_path_from_root": "/articles/kubernetes-fleet/architectural-overview.md",
+            "redirect_url": "/azure/kubernetes-fleet/concepts-fleet",
+            "redirect_document_id": true
+        }
+    ]
+}

.openpublishing.redirection.sql-database.json

@@ -2580,6 +2580,6 @@
             "source_path_from_root": "/articles/sql-data-warehouse/sql-data-warehouse-security-threat-detection.md",
             "redirect_url": "/azure/sql-database/sql-database-threat-detection-overview",
             "redirect_document_id": false
-        },
+        }
     ]
 }

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

@@ -136,7 +136,7 @@ Learn more about [Log Analytics workspace - DeleteRestoredTables (Consider remov
 
 ### Consider enabling autopause on Spark compute
 
-Auto-pause releases and shuts down unused Compute resources after a set idle period of inactivity.
+Autopause releases and shuts down unused Compute resources after a set idle period of inactivity.
 
 Learn more about [Synapse workspace - EnableSynapseSparkComputeAutoPauseGuidance (Consider enabling autopause feature on spark compute.)](https://aka.ms/EnableSynapseSparkComputeAutoPauseGuidance).
 
@@ -154,15 +154,15 @@ Learn more about [Synapse workspace - EnableSynapseSparkComputeAutoScaleGuidance
 
 Customers running high IO workloads in Standard HDDs can upgrade to Standard SSDs and benefit from better performance and SLA and now experience a limit on the maximum number of billed transactions.
 
-Learn more about [Disk - UpgradeHDDtoSDD (Standard SSD disks billing caps.)]().
+Learn more about [Understand Azure Disk Storage billing](/azure/virtual-machines/disks-understand-billing).
 
 ### Underutilized Disks Identified
 
 You have disks that are utilized less than 10%, right-size to save cost.
 
-Learn more about [Disk - wiprounderutilizeddisks (Underutilized Disks Identified)]().
+Learn more about [Managed disks: Find and delete unattached disks](/azure/virtual-machines/disks-find-unattached-portal).
 
-### You have disks that have not been attached to a VM for more than 30 days. Evaluate if you still need the disk.
+### You have disks that haven't been attached to a VM for more than 30 days. Evaluate if you still need the disk.
 
 We've observed that you have disks that haven't been attached to a VM for more than 30 days. Evaluate if you still need the disk. If you decide to delete the disk, recovery isn't possible. We recommend that you create a snapshot before deletion or ensure the data in the disk is no longer required.
 
@@ -176,7 +176,7 @@ Learn more about [Virtual machine scale set - LowUsageVmss (Right-size or shutdo
 
 ### Use Virtual Machines with Ephemeral OS Disk enabled to save cost and get better performance
 
-With Ephemeral OS Disk, You get these benefits: Save on storage cost for OS disk. Get lower read/write latency to OS disk. Faster VM Reimage operation by resetting OS (and Temporary disk) to its original state. It is preferable to use Ephemeral OS Disk for short-lived IaaS VMs or VMs with stateless workloads.
+With Ephemeral OS Disk, You get these benefits: Save on storage cost for OS disk. Get lower read/write latency to OS disk. Faster VM Reimage operation by resetting OS (and Temporary disk) to its original state. It's preferable to use Ephemeral OS Disk for short-lived IaaS VMs or VMs with stateless workloads.
 
 Learn more about [Subscription - EphemeralOsDisk (Use Virtual Machines with Ephemeral OS Disk enabled to save cost and get better performance)](/azure/virtual-machines/windows/ephemeral-os-disks).
 
@@ -205,7 +205,7 @@ Learn more about [PostgreSQL server - OrcasPostgreSqlCpuRightSize (Right-size un
 
 ### Review the configuration of your Azure Cosmos DB free tier account
 
-Your Azure Cosmos DB free tier account currently contains resources with a total provisioned throughput exceeding 1000 Request Units per second (RU/s). Because the free tier only covers the first 1000 RU/s of throughput provisioned across your account, any throughput beyond 1000 RU/s is billed at the regular pricing. As a result, we anticipate that you're charged for the throughput currently provisioned on your Azure Cosmos DB account.
+Your Azure Cosmos DB free tier account currently contains resources with a total provisioned throughput exceeding 1,000 Request Units per second (RU/s). Because the free tier only covers the first 1000 RU/s of throughput provisioned across your account, any throughput beyond 1000 RU/s is billed at the regular pricing. As a result, we anticipate that you're charged for the throughput currently provisioned on your Azure Cosmos DB account.
 
 Learn more about [Azure Cosmos DB account - CosmosDBFreeTierOverage (Review the configuration of your Azure Cosmos DB free tier account)](../cosmos-db/understand-your-bill.md#azure-free-tier).
 
@@ -256,13 +256,13 @@ Learn more about [ExpressRoute circuit - ExpressRouteCircuit (Delete ExpressRout
 
 ### Repurpose or delete idle virtual network gateways
 
-We noticed that your virtual network gateway has been idle for over 90 days. This gateway is being billed hourly. Reconfigure this gateway, or delete it if you do not intend to use it anymore.
+We noticed that your virtual network gateway has been idle for over 90 days. This gateway is being billed hourly. Reconfigure this gateway, or delete it if you don't intend to use it anymore.
 
 Learn more about [Virtual network gateway - IdleVNetGateway (Repurpose or delete idle virtual network gateways)](https://aka.ms/aa_idlevpngateway_learnmore).
 
 ### Consider migrating to Front Door Standard/Premium
 
-Your Front Door Classic tier contains a large number of domains or routing rules, which adds extra charges. Front Door Standard or Premium do not charge per additional domain or routing rule. Consider migrating to save costs.
+Your Front Door Classic tier contains a large number of domains or routing rules, which adds extra charges. Front Door Standard or Premium tiers don't charge per additional domain or routing rule. Consider migrating to save costs.
 
 Learn more about [Front Door pricing](https://aka.ms/afd-pricing).
 

articles/ai-services/document-intelligence/concept-layout.md

@@ -45,7 +45,7 @@ Document structure layout analysis is the process of analyzing a document to ext
 
 The following illustration shows the typical components in an image of a sample page.
 
-  :::image type="content" source="media/document-layout-example.png" alt-text="Illustration of document layout example.":::
+  :::image type="content" source="media/document-layout-example-new.png" alt-text="Illustration of document layout example.":::
 
 ## Development options
 

articles/ai-services/document-intelligence/media/document-layout-example-new.png

@@ -19,9 +19,7 @@ monikerRange: '>=doc-intel-3.0.0'
 
 [!INCLUDE [applies to v4.0 v3.1 v3.0](includes/applies-to-v40-v31-v30.md)]
 
-Document Intelligence Studio is an online tool to visually explore, understand, train, and integrate features from the Document Intelligence service into your applications. The studio provides a platform for you to experiment with the different Document Intelligence models and sample returned data in an interactive manner without the need to write code.
-
-[Document Intelligence Studio](https://documentintelligence.ai.azure.com/studio/) is an online tool for visually exploring, understanding, and integrating features from the Document Intelligence service into your applications. Use the Document Intelligence Studio to:
+[Document Intelligence Studio](https://documentintelligence.ai.azure.com/studio/) is an online tool to visually explore, understand, train, and integrate features from the Document Intelligence service into your applications. The studio provides a platform for you to experiment with the different Document Intelligence models and sample returned data in an interactive manner without the need to write code. Use the Document Intelligence Studio to:
 * Learn more about the different capabilities in Document Intelligence.
 * Use your Document Intelligence resource to test models on sample documents or upload your own documents.
 * Experiment with different add-on and preview features to adapt the output to your needs.

articles/ai-services/document-intelligence/studio-overview.md

@@ -9,7 +9,7 @@ ms.topic: quickstart
 author: mrbullwinkle
 ms.author: mbullwin
 ms.date: 02/01/2024
-zone_pivot_groups: openai-quickstart
+zone_pivot_groups: openai-quickstart-assistants
 recommendations: false
 ---
 
@@ -30,6 +30,12 @@ Azure OpenAI Assistants (Preview) allows you to create AI assistants tailored to
 
 ::: zone-end
 
+::: zone pivot="programming-language-csharp"
+
+[!INCLUDE [C# quickstart](includes/assistants-csharp.md)]
+
+::: zone-end
+
 ::: zone pivot="rest-api"
 
 [!INCLUDE [REST API quickstart](includes/assistants-rest.md)]

articles/ai-services/openai/assistants-quickstart.md

@@ -0,0 +1,128 @@
+---
+title: Azure OpenAI Service model retirements
+titleSuffix: Azure OpenAI
+description: Learn about the model deprecations and retirements in Azure OpenAI.
+ms.service: azure-ai-openai
+ms.topic: conceptual
+ms.date: 03/12/2024
+ms.custom: 
+manager: nitinme
+author: mrbullwinkle
+ms.author: mbullwin 
+recommendations: false
+---
+
+# Azure OpenAI Service model deprecations and retirements
+
+## Overview
+
+Azure OpenAI Service models are continually refreshed with newer and more capable models. As part of this process, we deprecate and retire older models. This document provides information about the models that are currently available, deprecated, and retired.
+
+### Terminology
+
+* Retirement
+	* When a model is retired, it's no longer available for use. Azure OpenAI Service deployments of a retired model always return error responses.
+* Deprecation
+	* When a model is deprecated, it's no longer available for new customers. It continues to be available for use by customers with existing deployments until the model is retired.
+
+## Preretirement notification
+
+Azure OpenAI notifies customers of active Azure OpenAI Service deployments for models with upcoming retirements. We notify customers of upcoming retirements as follows for each deployment:
+
+* At least 60 days before retirement 
+* At least 30 days before retirement 
+* At retirement
+
+Retirements are done on a rolling basis, region by region.
+
+### Who is notified of upcoming retirements
+
+Azure OpenAI notifies those who are members of the following roles for each subscription with a deployment of a model with an upcoming retirement.
+
+* Owner
+* Contributor
+* Reader
+* Monitoring contributor
+* Monitoring reader
+
+## How to get ready for model retirements and version upgrades
+
+To prepare for model retirements and version upgrades, we recommend that customers evaluate their applications with the new models and versions and evaluate their behavior. We also recommend that customers update their applications to use the new models and versions before the retirement date.
+
+For more information, see [How to upgrade to a new model or version](./model-versions.md).
+
+## Current models
+
+These models are currently available for use in Azure OpenAI Service.
+
+| Model | Version | Retirement date |
+| ---- | ---- | ---- |
+| `gpt-35-turbo` | 0301 | No earlier than June 13, 2024 |
+| `gpt-35-turbo`<br>`gpt-35-turbo-16k` | 0613 | No earlier than July 13, 2024 |
+| `gpt-35-turbo` | 1106 | No earlier than Nov 17, 2025 |
+| `gpt-35-turbo` | 0125 | No earlier than Feb 22, 2025 |
+| `gpt-4`<br>`gpt-4-32k` | 0314 | No earlier than July 13, 2024 |
+| `gpt-4`<br>`gpt-4-32k` | 0613 | No earlier than Sep 30, 2024 |
+| `gpt-4` | 1106-preview | To be upgraded to a stable version with date to be announced |
+| `gpt-4` | 0125-preview | To be upgraded to a stable version with date to be announced |
+| `gpt-4` | vision-preview | To be upgraded to a stable version with date to be announced |
+| `gpt-3.5-turbo-instruct` | 0914 | No earlier than Sep 14, 2025 |
+| `text-embedding-ada-002` | 2 | No earlier than April 3, 2025 |
+| `text-embedding-ada-002` | 1 | No earlier than April 3, 2025 |
+| `text-embedding-3-small` | | No earlier than Feb 2, 2025 |
+| `text-embedding-3-large` | | No earlier than Feb 2, 2025 |
+
+
+## Deprecated models
+
+These models were deprecated on July 6, 2023 and will be retired on July 5, 2024. These models are no longer available for new deployments. Deployments created before July 6, 2023 remain available to customers until July 5, 2024. We recommend customers migrate their applications to deployments of replacement models before the July 5, 2024 retirement.
+
+If you're an existing customer looking for information about these models, see [Legacy models](./legacy-models.md).
+
+| Model | Deprecation date | Retirement date | Suggested replacement |
+| --------- | --------------------- | ------------------- | -------------------- | 
+| ada | July 6, 2023 | July 5, 2024 | babbage-002 |
+| babbage | July 6, 2023 | July 5, 2024 | babbage-002 |
+| curie | July 6, 2023 | July 5, 2024 | davinci-002 |
+| davinci | July 6, 2023 | July 5, 2024 | davinci-002 |
+| text-ada-001 | July 6, 2023 | July 5, 2024 | gpt-35-turbo-instruct |
+| text-babbage-001 | July 6, 2023 | July 5, 2024 | gpt-35-turbo-instruct |
+| text-curie-001 | July 6, 2023 | July 5, 2024 | gpt-35-turbo-instruct |
+| text-davinci-002 | July 6, 2023 | July 5, 2024 | gpt-35-turbo-instruct |
+| text-davinci-003 | July 6, 2023 | July 5, 2024 | gpt-35-turbo-instruct |
+| code-cushman-001 | July 6, 2023 | July 5, 2024 | gpt-35-turbo-instruct |
+| code-davinci-002 | July 6, 2023 | July 5, 2024 | gpt-35-turbo-instruct |
+| text-similarity-ada-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
+| text-similarity-babbage-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
+| text-similarity-curie-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
+| text-similarity-davinci-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
+| text-search-ada-doc-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
+| text-search-ada-query-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
+| text-search-babbage-doc-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
+| text-search-babbage-query-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
+| text-search-curie-doc-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
+| text-search-curie-query-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
+| text-search-davinci-doc-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
+| text-search-davinci-query-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
+| code-search-ada-code-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
+| code-search-ada-text-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
+| code-search-babbage-code-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
+| code-search-babbage-text-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
+
+## Retirement and deprecation history
+
+### March 13, 2024
+
+We published this document to provide information about the current models, deprecated models, and upcoming retirements.
+
+### February 23, 2024
+
+We announced the upcoming in-place upgrade of `gpt-4` version `1106-preview` to `0125-preview` to start no earlier than March 8, 2024.
+
+### November 30, 2023
+
+The default version of `gpt-4` and `gpt-3-32k` was updated from `0314` to `0613` starting on November 30, 2023. The upgrade of `0314` deployments set for autoupgrade to `0613` was completed on December 3, 2023.
+
+### July 6, 2023
+
+We announced the deprecation of models with upcoming retirement on July 5, 2024.