Issue with creating Self-hosted Gateway in Azure API Management (Developer Tier) — Gateway Limit Reached

Question

Issue with creating Self-hosted Gateway in Azure API Management (Developer Tier) — Gateway Limit Reached

Siarhei Radziush 0

I am currently using the Developer Pricing tier for my Azure API Management instance. I am encountering a validation error when attempting to add a new Self-hosted Gateway.

Error Message: "You've reached the maximum number of Gateways (1) in Service. Please delete one or more Gateway(s) from Service to continue..."

Despite the error message, the Gateways list in the Azure Portal is currently empty (0 gateways created).
Refreshing the portal, clearing the cache, and attempting the operation in an Incognito/In-private session did not resolve the issue.

Could you please investigate why the service is reporting that the quota has been reached and assist in resetting the Gateway count for this APIM instance so that I can proceed with the deployment?
User's image

Pravallika KV 10,490 Reputation points Microsoft External Staff Moderator

2026-02-10T12:40:55.8866667+00:00
Hi @Siarhei Radziush ,

Thanks for reaching out to Microsoft Q&A.

You've reached the maximum number of Gateways (1) in Service. Please delete one or more Gateway(s) from Service to continue..."

The error message indicates that you have hit the maximum gateway limit of 1 for the Developer tier, but since your list shows no gateways created, you can check below some steps to troubleshoot and resolve the issue:

Sometimes, there might be residual settings or configurations that aren’t visible directly through the Azure Portal. You can use Azure CLI or PowerShell to list out any existing gateways to see if there's a hidden one consuming your quota.

Ensure that there are no issues or constraints with your Azure subscription that may be affecting the deployment of new gateways.

Sometimes, configuration changes can take a little while to propagate. After checking the above, try refreshing the portal and attempting the creation again.

Hope this helps!

References:

Provision a Self-hosted Gateway in Azure API Management

Self-hosted Gateway Overview

Azure API Management Support Policies
Pravallika KV 10,490 Reputation points Microsoft External Staff Moderator

2026-02-12T10:15:58.9533333+00:00

@Siarhei Radziush , following up to see if you had a chance to check the suggestions provided and if it was helpful. Please let me know if you have any questions.
Siarhei Radziush 0 Reputation points

2026-02-13T12:20:09.6+00:00

Hi, I checked everything you mentioned and unfortunately nothing helped.
Pravallika KV 10,490 Reputation points Microsoft External Staff Moderator

2026-02-16T13:15:15.1566667+00:00

Hi @Siarhei Radziush , I have reached out to over private message. Could you please check and respond?
Pravallika KV 10,490 Reputation points Microsoft External Staff Moderator

2026-02-18T17:18:55.04+00:00

Hi @Siarhei Radziush , following up to see if you had a chance to check the above response and fill the form. Please let me know if you have any questions.
Praveen Kumar Gudipudi 1,870 Reputation points Microsoft External Staff Moderator

2026-02-20T12:20:35.3433333+00:00
Hi @Siarhei Radziush ,

Could you please run below script in CLI and provide me the output.

az apim gateway list \

--resource-group <resource-group-name> \

--service-name <apim-name>

If it shows '0' please provide:

APIM SKU

Region
Siarhei Radziush 0 Reputation points

2026-02-20T15:47:06.4666667+00:00

Hi all,

Thank you for the support, but I had to create a ticket to Microsoft support and they resolved the issue from their side.

Thanks again for the help.
Praveen Kumar Gudipudi 1,870 Reputation points Microsoft External Staff Moderator

2026-02-22T11:46:33.9366667+00:00

Hi @Siarhei Radziush ,

Thanks for the confirmation.

Could you please share the resolution steps because this will assist others in the community who might have similar questions. Thank you!

1 answer

Your answer

Pravallika KV 10,490 Reputation points Microsoft External Staff Moderator

2026-02-10T12:40:55.8866667+00:00

Hi @Siarhei Radziush ,

Thanks for reaching out to Microsoft Q&A.

You've reached the maximum number of Gateways (1) in Service. Please delete one or more Gateway(s) from Service to continue..."

The error message indicates that you have hit the maximum gateway limit of 1 for the Developer tier, but since your list shows no gateways created, you can check below some steps to troubleshoot and resolve the issue:

Sometimes, there might be residual settings or configurations that aren’t visible directly through the Azure Portal. You can use Azure CLI or PowerShell to list out any existing gateways to see if there's a hidden one consuming your quota.

Ensure that there are no issues or constraints with your Azure subscription that may be affecting the deployment of new gateways.

Sometimes, configuration changes can take a little while to propagate. After checking the above, try refreshing the portal and attempting the creation again.

Hope this helps!

References:

Provision a Self-hosted Gateway in Azure API Management

Self-hosted Gateway Overview

Azure API Management Support Policies
Pravallika KV 10,490 Reputation points Microsoft External Staff Moderator

2026-02-12T10:15:58.9533333+00:00

@Siarhei Radziush , following up to see if you had a chance to check the suggestions provided and if it was helpful. Please let me know if you have any questions.
Siarhei Radziush 0 Reputation points

2026-02-13T12:20:09.6+00:00

Hi, I checked everything you mentioned and unfortunately nothing helped.
Pravallika KV 10,490 Reputation points Microsoft External Staff Moderator

2026-02-16T13:15:15.1566667+00:00

Hi @Siarhei Radziush , I have reached out to over private message. Could you please check and respond?
Pravallika KV 10,490 Reputation points Microsoft External Staff Moderator

2026-02-18T17:18:55.04+00:00

Hi @Siarhei Radziush , following up to see if you had a chance to check the above response and fill the form. Please let me know if you have any questions.
Praveen Kumar Gudipudi 1,870 Reputation points Microsoft External Staff Moderator

2026-02-20T12:20:35.3433333+00:00

Hi @Siarhei Radziush ,

Could you please run below script in CLI and provide me the output.

az apim gateway list \

--resource-group <resource-group-name> \

--service-name <apim-name>

If it shows '0' please provide:

APIM SKU

Region
Siarhei Radziush 0 Reputation points

2026-02-20T15:47:06.4666667+00:00

Hi all,

Thank you for the support, but I had to create a ticket to Microsoft support and they resolved the issue from their side.

Thanks again for the help.
Praveen Kumar Gudipudi 1,870 Reputation points Microsoft External Staff Moderator

2026-02-22T11:46:33.9366667+00:00

Hi @Siarhei Radziush ,

Thanks for the confirmation.

Could you please share the resolution steps because this will assist others in the community who might have similar questions. Thank you!

Answer 1

hi Siarhei Radziush,

the fastest and most reliable option is to recreate the APIM instance. For the Developer tier this is usually acceptable and much quicker than troubleshooting. A new instance starts with a clean gateway quota. If recreating the instance is not an option, the only remaining path is Microsoft Support. Only they can remove a stuck gateway object or manually reset the gateway counter for that APIM instance. This cannot be fixed through the portal, CLI, or Terraform.

One more important point. If you need more than one self hosted gateway, or need reliable behaviour, the Developer tier is not suitable. It is a non production SKU with hard limits and quirks like this. For real usage, you need at least the Basic or Standard tier.

The limit is genuinely reached even if the portal shows zero. This is a stuck gateway in the backend. Either recreate the APIM instance or open a support ticket.

rgds,

Alex

Share via

Issue with creating Self-hosted Gateway in Azure API Management (Developer Tier) — Gateway Limit Reached

1 answer

Your answer