Skip to content

Commit e00a9aa

Browse files
authored
Merge pull request #6192 from LHL407/new-azure-openai-articles
[AQ] edit pass: New Azure OpenAI articles
2 parents d7293e1 + 73f1fbd commit e00a9aa

File tree

8 files changed

+492
-526
lines changed

8 files changed

+492
-526
lines changed
Lines changed: 46 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
2-
title: Azure OpenAI in Azure AI Foundry Models model retirements
2+
title: Azure OpenAI in Azure AI Foundry Model Retirements
33
titleSuffix: Azure OpenAI
4-
description: Learn about the model deprecations and retirements in Azure OpenAI.
4+
description: Learn about model deprecations and retirements in Azure OpenAI.
55
ms.service: azure-ai-openai
66
ms.topic: conceptual
77
ms.date: 07/16/2025
@@ -12,95 +12,92 @@ ms.author: mbullwin
1212
recommendations: false
1313
---
1414

15-
# Azure OpenAI in Azure AI Foundry Models model deprecations and retirements
15+
# Azure OpenAI in Azure AI Foundry model deprecations and retirements
1616

17-
## Overview
18-
19-
Azure OpenAI 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.
17+
Azure OpenAI models are continually refreshed with newer and more capable models. As part of this process, we deprecate and retire older models. This article provides information about models that are currently available, deprecated, and retired.
2018

2119
### Terminology
2220

23-
* Deprecation
24-
* 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.
25-
* Retirement
26-
* When a model is retired, it's no longer available for use. Azure OpenAI deployments of a retired model always return error responses.
21+
- **Deprecation**: When a model is deprecated, it's no longer available for new customers. It continues to be available for use by customers who have existing deployments until the model is retired.
22+
- **Retirement**: When a model is retired, it's no longer available for use. Azure OpenAI deployments of a retired model always return error responses.
2723

2824
## Notifications
2925

30-
Azure OpenAI notifies customers of active Azure OpenAI deployments for models with upcoming retirements. We notify customers of upcoming retirements as follows for each deployment:
26+
Azure OpenAI notifies customers of active Azure OpenAI deployments for models with upcoming retirements. We notify customers of upcoming retirements for each deployment in the following ways:
3127

32-
1. At model launch, we programmatically designate a "not sooner than" retirement date (for preview models this is between 90-120 days from launch, for generally available (GA) models this is 365 days from launch).
33-
2. At least 60 days notice before model retirement for Generally Available (GA) models.
34-
3. At least 30 days notice before preview model version upgrades.
28+
- We notify customers at model launch by programmatically designating a *not sooner than* retirement date. For preview models, it's 90-120 days from launch. For generally available (GA) models, it's 365 days from launch.
29+
- We provide customers with at least 60 days' notice before model retirement for GA models.
30+
- We provide customers with least 30 days' notice before preview model version upgrades.
3531

36-
Retirements are done on a rolling basis, region by region. There is no schedule for when a specific region, or SKU will be upgraded.
32+
Retirements are done on a rolling basis, region by region. There's no schedule for when a specific region or SKU is upgraded.
3733

38-
### Who is notified of upcoming retirements
34+
### Notifications of upcoming retirements
3935

4036
Azure OpenAI notifies customers via two methods:
41-
- **Azure Resource Health** - Anyone with reader permissions or above can see Azure health alerts, as well as configure personalized alerts via email, SMS, etc. See [Create Service Health Alerts](/azure/service-health/alerts-activity-log-service-notifications-portal)
42-
- **Email** - email notifications are automatically sent to subscription owners. Any individual with reader permissions may however configure their own alerts by following the guidance above.
4337

44-
**Azure Service Health filter configuration**:
38+
- **Azure Resource Health**: Anyone with **reader** permissions or higher can see Azure health alerts and configure personalized alerts via email and SMS. See [Create Service Health alerts](/azure/service-health/alerts-activity-log-service-notifications-portal).
39+
- **Email**: Email notifications are automatically sent to subscription owners. However, any individual with **reader** permissions can configure their own alerts by following the previous guidance.
40+
41+
#### Azure Service Health filter configuration
4542

46-
**Services** = `azure OpenAI service` (Casing reflects current UX experience).
43+
The service is `azure OpenAI service`. (The casing reflects the current UX experience.)
4744

48-
**Event types**
49-
- `Health advisories = Upgrade, Deprecation, & Retirement Notifications`
50-
- `Service issue = Outages` (Recommended only if you wish to be notified of outages)
45+
Event types include:
5146

52-
If you wish to receive SMS text-based alerts rather than just e-mails, you will need to select **Create action group** and under **Notification type**, select **Email/SMS message/Push/Voice** and then configure your phone number.
47+
- `Health advisories = Upgrade, Deprecation, & Retirement Notifications`.
48+
- `Service issue = Outages`. (We recommend this event type only if you want to be notified of outages.)
49+
50+
If you want to receive SMS text-based alerts versus just emails, select **Create action group**. Then, under **Notification type**, select **Email/SMS message/Push/Voice** and configure your phone number.
5351

5452
## Model availability
5553

56-
1. At least one year of model availability for GA models after the release date of a model in at least one region worldwide
57-
2. For global deployments, all future model versions starting with `gpt-4o` and `gpt-4 0409` will be available with their (`N`) next succeeding model (`N+1`) for comparison together.
58-
1. Customers have 60 days to try out a new GA model in at least one global, or standard region, before any upgrades happen to a newer GA model.
54+
For the availability of models, see the following information:
55+
56+
- There is at least one year of model availability for GA models after the release date of a model in at least one region worldwide
57+
- For global deployments, all future model versions starting with `gpt-4o` and `gpt-4 0409` will be available with their (`N`) next succeeding model (`N+1`) for comparison together.
58+
- Customers have 60 days to try out a new GA model in at least one global or standard region before any upgrades happen to a newer GA model.
5959

60-
### Considerations for the Azure public cloud
60+
### Considerations for Azure public cloud
6161

62-
Be aware of the following:
62+
Be aware of the following information:
6363

64-
1. All model version combinations will **not** be available in all regions.
65-
2. Model version `N` and `N+1` might not always be available in the same region.
66-
3. GA model version `N` might upgrade to a future model version `N+X` in some regions based on capacity limitations, and without the new model version `N+X` separately being available to test in the same region. The new model version will be available to test in other regions before any upgrades are scheduled.
67-
4. Preview model versions and GA versions of the same model won't always be available to test together in the same region. There will be preview and GA versions available to test in different regions.
68-
5. We reserve the right to limit future customers using a particular region to balance service quality for existing customers.
69-
6. As always at Microsoft, security is of the utmost importance. If a model or model version is found to have compliance or security issues, we reserve the right to invoke the need to do emergency retirements. See the terms of service for more information.
64+
- Not all model version combinations will be available in all regions.
65+
- Model version `N` and `N+1` might not always be available in the same region.
66+
- A GA model version `N` might upgrade to a future model version `N+X` in some regions based on capacity limitations, and without the new model version `N+X` separately being available to test in the same region. The new model version will be available to test in other regions before any upgrades are scheduled.
67+
- Preview model versions and GA versions of the same model won't always be available to test together in the same region. There will be preview and GA versions available to test in different regions.
68+
- We reserve the right to limit future customers' use of a particular region to balance service quality for existing customers.
69+
- As always at Microsoft, security is of the utmost importance. If a model or model version is found to have compliance or security issues, we reserve the right to invoke the need to do emergency retirements. Refer to the terms of service for more information.
7070

7171
### Special considerations for Azure Government clouds
7272

73-
1. Global standard deployments won't be available in government clouds.
74-
2. Not all models or model versions available in commercial / public cloud will be available in government clouds.
75-
3. In the Azure Government clouds, we intend to support only one version of a given model at a time.
76-
1. For example only one version of `gpt-35-turbo 0125` and `gpt-4o (2024-05-13)`.
77-
4. There will however be a 30 day overlap between new model versions, where more than two will be available.
78-
1. For example if `gpt-35-turbo 0125` or `gpt-4o (2024-05-13)` is updated to a future version, or
79-
2. for model family changes beyond version updates, such as when moving from `gpt-4 1106-preview` to `gpt-4o (2024-05-13)`.
73+
- Global standard deployments aren't available in government clouds.
74+
- Not all models or model versions available in commercial and public clouds will be available in government clouds.
75+
- In Azure Government clouds, we intend to support only one version of a given model at a time. For example, only one version of `gpt-35-turbo 0125` and `gpt-4o (2024-05-13)`.
76+
- However, there's a 30-day overlap between new model versions, when more than two will be available. For example, if `gpt-35-turbo 0125` or `gpt-4o (2024-05-13)` is updated to a future version. Another example is model family changes beyond version updates, like when moving from `gpt-4 1106-preview` to `gpt-4o (2024-05-13)`.
8077

81-
## How to get ready for model retirements and version upgrades
78+
## Preparation for model retirements and version upgrades
8279

8380
To prepare for model retirements and version upgrades, we recommend that customers test 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.
8481

85-
For more information on the model evaluation process, see the [Getting started with model evaluation guide](https://techcommunity.microsoft.com/t5/ai-azure-ai-services-blog/how-to-evaluate-amp-upgrade-model-versions-in-the-azure-openai/ba-p/4218880).
82+
For more information on the model evaluation process, see the [Getting started with model evaluation](https://techcommunity.microsoft.com/t5/ai-azure-ai-services-blog/how-to-evaluate-amp-upgrade-model-versions-in-the-azure-openai/ba-p/4218880) blog post.
8683

8784
For information on the model upgrade process, see [How to upgrade to a new model or version](./model-versions.md).
8885

89-
For more information on how to manage model upgrades and migrations for provisioned deployments, see [Managing models on provisioned deployment types](../how-to/working-with-models.md#managing-models-on-provisioned-deployment-types)
86+
For more information on how to manage model upgrades and migrations for provisioned deployments, see [Managing models on provisioned deployment types](../how-to/working-with-models.md#managing-models-on-provisioned-deployment-types).
9087

9188
## Current models
9289

9390
> [!NOTE]
94-
> Not all models go through a deprecation period prior to retirement. Some models/versions only have a retirement date.
91+
> Not all models go through a deprecation period before retirement. Some models or versions only have a retirement date.
9592
>
96-
> **Fine-tuned models** are subject to a [different](#fine-tuned-models) deprecation and retirement schedule from their equivalent base model.
93+
> Fine-tuned models are subject to a [different](#fine-tuned-models) deprecation and retirement schedule from their equivalent base model.
9794
9895
These models are currently available for use in Azure OpenAI.
9996

10097
[!INCLUDE [Model retirement table](../includes/retirement/models.md)]
10198

10299
## Retirement and deprecation history
103100

104-
- To track individual updates to this article refer to the [Git History](https://github.com/MicrosoftDocs/azure-ai-docs/commits/main/articles/ai-foundry/openai/includes/retirement/models.md)
101+
To track individual updates to this article, refer to the [Git history](https://github.com/MicrosoftDocs/azure-ai-docs/commits/main/articles/ai-foundry/openai/includes/retirement/models.md).
105102

106-
- For a list of retired models, refer to the [retired models page](./legacy-models.md).
103+
For a list of retired models, refer to the [retired models page](./legacy-models.md).

0 commit comments

Comments
 (0)