Skip Navigation

Create a multiregion Premium tier API Management instance

Last updated: 28-03-2022

This template demonstrates how to create an API Management instance with additional locations. The primary location is the same as location of the resource group. For additional locations, the template shows NorthCentralUs and East US2. The primary location should be different from additional locations.

This Azure Resource Manager (ARM) template was created by a member of the community and not by Microsoft. Each ARM template is licensed to you under a licence agreement by its owner, not Microsoft. Microsoft is not responsible for ARM templates provided and licensed by community members and does not screen for security, compatibility or performance. Community ARM templates are not supported under any Microsoft support programme or service and are made available AS IS without warranty of any kind.


Parameter Name Description
apiManagementServiceName Name of the API Management service.
publisherEmail The email address of the owner of the service
publisherName The name of the owner of the service
skuCount The instance size of this API Management service.
location Location of the primary region of API Management service.
additionalLocations Additional Locations to setup the ApiManagement gateway.
disableGatewayInAdditionalLocation Ability to enable/disable Gateway proxy in any region including primary region.
minApiVersionToAllowOnControlPlane Minimum Api-Version to allow on all clients to Control Plane to prevent users with read-only permissions from accessing service secrets.

Use the template


New-AzResourceGroup -Name <resource-group-name> -Location <resource-group-location> #use this command when you need to create a new resource group for your deployment
New-AzResourceGroupDeployment -ResourceGroupName <resource-group-name> -TemplateUri
Install and configure Azure PowerShell

Command line

az group create --name <resource-group-name> --location <resource-group-location> #use this command when you need to create a new resource group for your deployment
az group deployment create --resource-group <my-resource-group> --template-uri
Install and Configure the Azure Cross-Platform Command-Line Interface