Issues migrating API Management instance

Question

Issues migrating API Management instance

Luka De Bakker 0

Hello Azure Community,

This past week I've tried migrating an API Management instance to another subscription on the same tenant, to afterwards move this subscription to another tenant (with the API Management instance on it by then).

What is the best / easiest way to migrate this API management instance? I've tried using the UI in the Azure Portal to move it, and this provides nothing but vague error messages (see attached) that none of us can really solve. (even though the validation step succeeds).

Screenshot 2025-03-27 at 11.48.02

Thank you in advance!

Shireesha Eeraboina 2,815 Reputation points Microsoft External Staff

2025-04-14T06:35:19.1166667+00:00
Hi Luka De Bakker,

It looks like the API Management (APIM) resource move failed due to a conflict—this can happen if there are linked resources like monitoring (e.g., diagnostic settings or action groups) still attached. These dependencies can prevent the move.

You can try one of these options to fix it:

Use Azure CLI or PowerShell to attempt the move, as they often provide more detailed error messages.

Alternatively, consider exporting your APIM configuration and recreating it in the target subscription as a workaround.

For more information, please refer to this doc: Move resources to a new subscription

I hope this addresses your query. Please let me know if you need any further assistance or clarification.
Shireesha Eeraboina 2,815 Reputation points Microsoft External Staff

2025-04-15T04:50:38.78+00:00

Hello Luka De Bakker,

Just checking in to see if the information above was helpful. If you have any further updates on this issue, please feel free to post them here.
Shireesha Eeraboina 2,815 Reputation points Microsoft External Staff

2025-04-16T04:38:01.25+00:00

Hello Luka De Bakker,

Following up to see if you had a chance to review the above response. If you have any further updates on this issue, please feel free to post them here.

Your answer

Shireesha Eeraboina 2,815 Reputation points Microsoft External Staff

2025-04-14T06:35:19.1166667+00:00

Hi Luka De Bakker,

It looks like the API Management (APIM) resource move failed due to a conflict—this can happen if there are linked resources like monitoring (e.g., diagnostic settings or action groups) still attached. These dependencies can prevent the move.

You can try one of these options to fix it:

Use Azure CLI or PowerShell to attempt the move, as they often provide more detailed error messages.

Alternatively, consider exporting your APIM configuration and recreating it in the target subscription as a workaround.

For more information, please refer to this doc: Move resources to a new subscription

I hope this addresses your query. Please let me know if you need any further assistance or clarification.
Shireesha Eeraboina 2,815 Reputation points Microsoft External Staff

2025-04-15T04:50:38.78+00:00

Hello Luka De Bakker,

Just checking in to see if the information above was helpful. If you have any further updates on this issue, please feel free to post them here.
Shireesha Eeraboina 2,815 Reputation points Microsoft External Staff

2025-04-16T04:38:01.25+00:00

Hello Luka De Bakker,

Following up to see if you had a chance to review the above response. If you have any further updates on this issue, please feel free to post them here.

Share via

Issues migrating API Management instance

Your answer