[APIM] Workspaces changes - migration

Author: dlepow

articles/api-management/breaking-changes/workspaces-breaking-changes-june-2024.md

@@ -5,17 +5,17 @@ services: api-management
 author: dlepow
 ms.service: api-management
 ms.topic: reference
-ms.date: 04/24/2024
+ms.date: 05/08/2024
 ms.author: danlep
 ---
 
 # Workspaces - breaking changes (June 2024)
 
 [!INCLUDE [api-management-availability-premium-dev-standard](../../../includes/api-management-availability-premium-dev-standard.md)]
 
-On 14 June 2024, as part of our development of [workspaces](../workspaces-overview.md) (preview) in Azure API Management, we're introducing several breaking changes. 
+After 14 June 2024, as part of our development of [workspaces](../workspaces-overview.md) (preview) in Azure API Management, we're introducing several breaking changes. 
 
-Your workspaces and APIs managed in them may stop working beyond 14 June 2024 if they still rely on the capabilities set to change. APIs and resources managed outside workspaces aren't affected by this change.
+After 14 June 2024, your workspaces and APIs managed in them may stop working if they still rely on the capabilities set to change. APIs and resources managed outside workspaces aren't affected by this change.
 
 ## Is my service affected by these changes?
 
@@ -58,7 +58,45 @@ The `context.Workspace` object can be used instead.
 
 ## What is the deadline for the change?
 
-The breaking changes are effective 14 June 2024. We strongly recommend that you make all required changes to the configuration of workspaces before then.
+The breaking changes will be introduced after 14 June 2024. We strongly recommend that you make all required changes to the configuration of workspaces before that date.
+
+## What do I need to do?
+
+If your workspaces are affected by these changes, you need to update your workspace configurations to align with the new capabilities.
+
+### Standard tier customers 
+
+If you're using workspaces in the **Standard** tier, [upgrade](../upgrade-and-scale.md) to the **Premium** tier to continue using workspaces.
+
+### Developer tier customers
+
+The Developer tier was designed for single-user or single-team use cases. It's unable to facilitate multi-team collaboration with workspaces because of the limited computing resources, lack of SLA, and no infrastructure redundancy. If you're using workspaces preview in the **Developer** tier, you can choose one of the following options:
+
+* **Aggregate in a Premium tier instance**
+
+    Aggregate multiple non-production environments in a single Premium tier instance. Use workspaces in the Premium tier to isolate the different environments.
+
+* **Use Developer tier instances for development, migrate to workspaces in Premium tier**
+
+    You might use Developer tier instances for development environments. For higher environments, you can migrate the configuration of these Developer-tier services into workspaces of a Premium tier service. Note that with this approach you may run into issues or conflicts when managing the configurations across environments. 
+
+    If you are currently using workspaces in a Developer tier instance, you can migrate the workspace configurations to a Developer tier instance without workspaces:
+
+    1. Export a Resource Manager template from your API Management instance. You can export the template from the [Azure portal](..azure-resource-manager/templates/export-template-portal.md) or by using other tools.
+    1. Remove the following substring of the resource ID values: `/workspaces/[^/]+`
+    1. Deploy the template. For more information, see [Quickstart: Create and deploy ARM templates by using the Azure portal](../azure-resource-manager/templates/quickstart-create-templates-use-the-portal.md).
+
+    Depending on your use case, you may need to perform additional configuration changes in your API Management instance.
+
+### Assignment of workspace-level entities
+
+If you assigned workspace-level entities to service-level entities in the workspaces preview, see the following table for migration guidance.
+
+|Assignment no longer supported  |Recommended migration step  |
+|---------|---------|
+|Assign workspace APIs to service-level products    | Use workspace-level products        |
+|Assign workspace APIs or products to service-level tags     | Use workspace-level tags        |
+|Assign service-level groups to workspace products for visibility controls     |         |
 
 ## Help and support