Skip to content

Commit 3c13e1e

Browse files
authored
Merge pull request #205230 from dlepow/ipfix
[APIM] Consolidated IP address guidance
2 parents 63de6c1 + edc9d48 commit 3c13e1e

File tree

2 files changed

+13
-7
lines changed

2 files changed

+13
-7
lines changed

articles/api-management/api-management-howto-ip-addresses.md

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -98,12 +98,14 @@ For traffic restriction purposes, you can use the range of IP addresses of Azure
9898

9999
## Changes to the IP addresses
100100

101-
In the Developer, Basic, Standard, and Premium tiers of API Management, the public IP addresses (VIP) and private VIP addresses (if configured in the internal VNet mode) are static for the lifetime of a service, with the following exceptions:
101+
In the Developer, Basic, Standard, and Premium tiers of API Management, the public IP address or addresses (VIP) and private VIP addresses (if configured in the internal VNet mode) are static for the lifetime of a service, with the following exceptions:
102102

103-
* The service is deleted and then re-created.
103+
* The API Management service is deleted and then re-created.
104104
* The service subscription is [suspended](https://github.com/Azure/azure-resource-manager-rpc/blob/master/v1.0/subscription-lifecycle-api-reference.md#subscription-states) or [warned](https://github.com/Azure/azure-resource-manager-rpc/blob/master/v1.0/subscription-lifecycle-api-reference.md#subscription-states) (for example, for nonpayment) and then reinstated.
105-
* Azure Virtual Network is added to or removed from the service.
106-
* API Management service is switched between External and Internal VNet deployment mode.
107-
* [Availability zones](../availability-zones/migrate-api-mgt.md) are enabled, added, or removed.
105+
* (Developer and Premium tiers) Azure Virtual Network is added to or removed from the service.
106+
* (Developer and Premium tiers) API Management service is switched between external and internal VNet deployment mode.
107+
* (Premium tier) [Availability zones](../availability-zones/migrate-api-mgt.md) are enabled, added, or removed.
108+
* (Premium tier) In [multi-regional deployments](api-management-howto-deploy-multi-region.md), the regional IP address changes if a region is vacated and then reinstated.
108109

109-
In [multi-regional deployments](api-management-howto-deploy-multi-region.md), the regional IP address changes if a region is vacated and then reinstated.
110+
> [!IMPORTANT]
111+
> When changing from an external to internal virtual network (or vice versa), changing subnets in the network, or updating availability zones for the API Management instance, you must configure a different [public IP address](api-management-using-with-vnet.md?tabs=stv2#prerequisites) resource than the one configured previously. You may swap back to the original IP address if needed.

includes/api-management-virtual-network-prerequisites.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,11 @@ Some prerequisites differ depending on the version (`stv2` or `stv1`) of the [co
2525

2626
* The IP address must be in the same region and subscription as the API Management instance and the virtual network.
2727

28-
* When creating a public IP resource, ensure you assign a **DNS name label** to it. The label you choose to use does not matter but a label is required if this resource will be assigned to an API Management service.
28+
* When creating a public IP address resource, ensure you assign a **DNS name label** to it. The label you choose to use does not matter but a label is required if this resource will be assigned to an API Management service.
29+
30+
* For best network performance, it's recommended to use the default **Routing preference**: **Microsoft network**.
31+
32+
* When creating a public IP address in a region where you plan to enable [zone redundancy](../articles/availability-zones/migrate-api-mgt.md) for your API Management instance, configure the **Zone-redundant** setting.
2933

3034
* The value of the IP address is assigned as the virtual public IPv4 address of the API Management instance in that region.
3135

0 commit comments

Comments
 (0)