Skip to content

Commit 30e8267

Browse files
author
gitName
committed
review pass
1 parent e438c32 commit 30e8267

File tree

1 file changed

+15
-13
lines changed

1 file changed

+15
-13
lines changed

articles/api-management/configure-service-update-settings.md

Lines changed: 15 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -4,32 +4,34 @@ description: Learn how to configure settings for applying service updates to you
44
author: dlepow
55
ms.service: azure-api-management
66
ms.topic: how-to
7-
ms.date: 03/18/2025
7+
ms.date: 04/02/2025
88
ms.author: danlep
99
---
1010

1111
# Configure service update settings for your API Management instances
1212

13-
[!INCLUDE [api-management-availability-all-tiers](../../includes/api-management-availability-all-tiers.md)]
13+
[!INCLUDE [api-management-availability-premium-dev-standard-basic](../../includes/api-management-availability-premium-dev-standard-basic.md)]
1414

15-
This article shows you how to configure service update settings in your API Management instance. Azure periodically applies service updates automatically to API Management instances, using a phased rollout approach. These updates include new features, security enhancements, and reliability improvements.
15+
16+
This article shows you how to configure *service update* settings in your API Management instance. Azure periodically applies service updates automatically to API Management instances, using a phased rollout approach. These updates include new features, security enhancements, and reliability improvements.
1617

1718
You can't control exactly when Azure updates each instance, but API Management lets you select an *update group* for your instance, and also a *maintenance window* during the day when you want your instance to receive updates.
1819

19-
* **Update group** - A set of instances that receive updates during a production rollout, which can take from several days to several weeks. Choose from:
20-
* **Early** - Receive updates early. Updates might include preview builds.
21-
* **Default** - Receive updates according to the usual phased rollout.
22-
* **Late** - Receive updates later. Updates include the most stable builds.
20+
* **Update group** - A set of instances that receive API Management service updates during a production rollout, which can take from several days to several weeks to complete.
21+
22+
Choose from:
23+
* **Early** - Receive updates early in the rollout, for testing and early access to new features. This option is not recommended for production deployments.
24+
* **Default** - Receive updates as part of the regular release rollout. This option is recommended for most services, including production deployments.
25+
* **Late** - Receive updates later than the previous groups, typically weeks after the initial rollout. This option is recommended for mission-critical deployments only.
2326

2427
> [!NOTE]
2528
> Azure deploys all updates using a [safe deployment practices (SDP) framework](https://azure.microsoft.com/blog/advancing-safe-deployment-practices/). Updates released early in a rollout might be less stable and replaced later by stable releases. All instances are eventually updated to the most stable release builds.
2629
27-
For example, you might want to add a test instance to the **Early** update group. This instance receives updates before your production instances, which you might put in the **Late** update group. You can monitor the test instance for any issues caused by the updates before they reach your production instances. [Learn more about canary deployments](#canary-deployment-strategies) with API Management
30+
For example, you might want to add a test instance to the **Early** update group. This instance receives updates before your production instances, which you put in the **Default** or **Late** update group. You can monitor the test instance for any issues caused by the updates before they reach your production instances. [Learn more about canary deployments](#canary-deployment-strategies) with API Management
2831

2932
* **Maintenance window** - An 8-hour daily period when you want your instance to receive updates. By default, the maintenance window is 10 PM to 6 AM in the instance's timezone.
3033

31-
Service disruptions are rare during an update, but you might want to reduce risk by selecting times of low service use. For example, set a maintenance window during weekday evenings and weekend mornings for your production instances.
32-
34+
Service disruptions are rare during an update, but you might want to reduce risk by selecting times of low service use. For example, for production instances, set a maintenance window during weekday evenings and weekend mornings.
3335

3436
## Configure service update settings
3537

@@ -53,7 +55,7 @@ Here's how to know about service updates that are expected or are in progress.
5355

5456
To receive notifications automatically, [set up an alert](/azure/azure-monitor/alerts/alerts-activity-log) on the Activity log.
5557

56-
* Updates roll out to regions in the following phases: Azure EUAP regions, followed by West Central US, followed by remaining regions in several later phases. The sequence of regions updated in the later deployment phases differs from service to service. You can expect at least 24 hours between each phase of the production rollout.
58+
* By default, updates roll out to regions in the following phases: Azure EUAP regions, followed by West Central US, followed by remaining regions in several later phases. The sequence of regions updated in the later deployment phases differs from service to service. You can expect at least 24 hours between each phase of the production rollout.
5759

5860
* Within a region, API Management instances in the Premium tier receive updates several hours later than those in other service tiers.
5961

@@ -62,9 +64,9 @@ Here's how to know about service updates that are expected or are in progress.
6264
6365
## Canary deployment strategies
6466

65-
Here are example strategies to use an API Management instance as a canary deployment that receives updates earlier than your production instances.
67+
You can use an API Management instances assigned to a specific update group or deployed in a specific Azure region as a canary deployment that receives updates earlier than your production instances.
6668

67-
* **Add instance to Early update group** - Use an API Management instance in the Early update group to validate updates early in the production pipeline. This instance is effectively your canary deployment.
69+
* **Add instance to Early update group** - Use an API Management instance in the Early update group to validate updates early in a production rollout. This instance is effectively your canary deployment.
6870

6971
* **Deploy in canary region** - If you have access to an Azure EUAP region, use an instance there to validate updates as soon as they're released to the production pipeline. Learn about the [Azure region access request process](/troubleshoot/azure/general/region-access-request-process).
7072

0 commit comments

Comments
 (0)