Skip to content

Commit 542e9db

Browse files
authored
Update api-management-howto-deploy-multi-region.md
Disable routing only available for default routing.
1 parent 9d12e49 commit 542e9db

File tree

1 file changed

+6
-3
lines changed

1 file changed

+6
-3
lines changed

articles/api-management/api-management-howto-deploy-multi-region.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: Learn how to deploy a Premium tier Azure API Management instance to
55
author: dlepow
66
ms.service: api-management
77
ms.topic: how-to
8-
ms.date: 01/26/2023
8+
ms.date: 01/26/2024
99
ms.author: danlep
1010
---
1111

@@ -125,12 +125,15 @@ Under some conditions, you might need to temporarily disable routing to one of t
125125
* To redirect traffic to other regions during a planned disaster recovery drill that simulates an unavailable region, or during a regional failure
126126

127127
To disable routing to a regional gateway in your API Management instance, update the gateway's `disableGateway` property value to `true`. You can set the value using the [Create or update service](/rest/api/apimanagement/current-ga/api-management-service/create-or-update) REST API, the [az apim update](/cli/azure/apim#az-apim-update) command in the Azure CLI, the [set-azapimanagement](/powershell/module/az.apimanagement/set-azapimanagement) Azure PowerShell cmdlet, or other Azure tools.
128+
129+
>[!NOTE]
130+
> You can only disable routing to a regional gateway when you are using API Management's default routing, not a custom routing solution.
128131

129132
To disable a regional gateway using the Azure CLI:
130133

131134
1. Use the [az apim show](/cli/azure/apim#az-apim-show) command to show the locations, gateway status, and regional URLs configured for the API Management instance.
132135
```azurecli
133-
az apim show --name contoso --resource-group myResourceGroup \
136+
az apim show --name contoso --resource-group apim-hello-world-resource \
134137
--query "additionalLocations[].{Location:location,Disabled:disableGateway,Url:gatewayRegionalUrl}" \
135138
--output table
136139
```
@@ -144,7 +147,7 @@ To disable a regional gateway using the Azure CLI:
144147
```
145148
1. Use the [az apim update](/cli/azure/apim#az-apim-update) command to disable the gateway in an available location, such as West US 2.
146149
```azurecli
147-
az apim update --name contoso --resource-group myResourceGroup \
150+
az apim update --name contoso --resource-group apim-hello-world-resource \
148151
--set additionalLocations[location="West US 2"].disableGateway=true
149152
```
150153

0 commit comments

Comments
 (0)