rename, link

Author: gitName

articles/api-management/TOC.yml

@@ -91,8 +91,8 @@
         href: migrate-stv1-to-stv2-no-vnet.md
       - name: Migrate a VNet-injected instance
         href: migrate-stv1-to-stv2-vnet.md
-    - name: Validate service updates
-      href: validate-service-updates.md
+    - name: Configure update settings
+      href: configure-update-settings.md
     - name: Move instances between regions
       href: api-management-howto-migrate.md
     - name: Recover a deleted instance

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

@@ -0,0 +1,81 @@
+---
+title: Configure API Management settings for service updates
+description: Learn how to configure settings for applying service updates to your Azure API Management instance. Settings include the upgrade group and the maintenance window.
+author: dlepow
+ms.service: azure-api-management
+ms.topic: how-to
+ms.date: 03/18/2025
+ms.author: danlep
+---
+
+# Configure service update settings for your API Management instances 
+
+[!INCLUDE [api-management-availability-all-tiers](../../includes/api-management-availability-all-tiers.md)]
+
+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. 
+
+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. 
+
+* **Update group** - A set of instances that receive updates during a production rollout, which can take from several days to several weeks. Choose from:
+    * **Early** - Receive updates early. Updates might include preview builds.
+    * **Default** - Receive updates according to the usual phased rollout.
+    * **Late** - Receive updates later. Updates include the most stable builds.
+
+    > [!NOTE]
+    > 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.
+
+    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
+
+ * **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. 
+
+    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. 
+
+
+## Configure service update settings
+
+1. Sign in to the [Azure portal](https://portal.azure.com) and go to your API Management instance.
+1. In the left menu, select **Deployment + infrastructure** > **Service update settings**.
+1. Under **Update group**, review the current setting and select **Edit** to change it.
+    > [!NOTE]
+    > Only the **Early** update group is available for API Management instances in the Developer tier.
+
+1. Under **Maintenance window**, review the current settings and select **Edit** to change them. For each day you can select the default window, a different standard window, or a custom window by day.
+ 
+## Know when your instances are receiving updates 
+
+Here's how to know about service updates that are expected or are in progress. 
+
+* API Management updates are announced on the [API Management GitHub repo](https://github.com/Azure/API-Management/releases). Subscribe to receive notifications from this repository to know when update rollouts begin. 
+
+* Monitor service updates that are taking place in your API Management instance by using the Azure [Activity log](/azure/azure-monitor/essentials/activity-log). The "Scheduled maintenance" event is emitted when an update begins.
+
+    :::image type="content" source="media/configure-service-update-settings/scheduled-maintenance.png" alt-text="Scheduled maintenance event in Activity log in the portal.":::
+
+    To receive notifications automatically, [set up an alert](/azure/azure-monitor/alerts/alerts-activity-log) on the Activity log.
+
+* 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.
+
+* Within a region, API Management instances in the Premium tier receive updates several hours later than those in other service tiers.
+
+> [!TIP]
+> If your API Management instance is deployed to multiple locations (regions), the timing of updates is determined by the instance's **Primary** location.
+
+## Canary deployment strategies
+  
+Here are example strategies to use an API Management instance as a canary deployment that receives updates earlier than your production instances.
+
+* **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. 
+
+* **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).
+
+    > [!NOTE]
+    > Because of capacity constraints in EUAP regions, you might not be able to scale API Management instances as needed.  
+
+* **Deploy in pilot region** - Use an instance in the West Central US to simulate your production environment, or use it in production for noncritical API traffic. While this region receives updates after the EUAP regions, a deployment there is more likely to identify regressions that are specific to your service configuration.
+
+* **Deploy duplicate instances in a region** - If your production workload is a Premium tier instance in a specific region, consider deploying a similarly configured instance in a lower tier that receives updates earlier. For example, configure a preproduction instance in the Developer tier to validate updates. 
+ 
+## Related content
+
+* Learn [how to monitor](api-management-howto-use-azure-monitor.md) your API Management instance.
+* Learn about other options to [observe](observability.md) your API Management instance.

articles/api-management/media/validate-service-updates/scheduled-maintenance.png renamed to articles/api-management/media/configure-service-update-settings/scheduled-maintenance.png

@@ -36,7 +36,7 @@ The following table shows Microsoft's responsibilities, shared responsibilities,
 We have the following tagging strategy for the [self-hosted gateway container image](self-hosted-gateway-overview.md#packaging), following the major, minor, patch convention: `{major}.{minor}.{patch}`. You can find a full list of [available tags](https://mcr.microsoft.com/product/azure-api-management/gateway/tags). As a best practice, we recommend that customers run the latest stable version of our container image. Given the continuous releases of our container image, we'll provide official support for the following versions: 
 
 > [!TIP]
-> We highly encourage customers to upgrade to a newer self-hosted gateway by following [Safe Deployment Practices (SDP)](validate-service-updates.md#what-is-the-azure-safe-deployment-practices-framework).
+> We highly encourage customers to upgrade to a newer self-hosted gateway by following [Safe Deployment Practices (SDP)](https://azure.microsoft.com/blog/advancing-safe-deployment-practices/).
 
 ### Supported versions 
 

articles/api-management/media/validate-service-updates/azure-safe-deployment-practices-framework-expanded.png

@@ -1,6 +1,11 @@
 {
   "redirections": [
     {
+      "source_path_from_root": "/articles/api-management/validate-service-updates.md",
+      "redirect_url": "/azure/api-management/configure-update-setting",
+      "redirect_document_id": false
+    },
+   {
       "source_path_from_root": "/articles/api-management/api-management-in-workspace.md",
       "redirect_url": "/azure/api-management/how-to-create-workspace",
       "redirect_document_id": false