Skip to content

Commit 953ac9f

Browse files
Merge pull request #309684 from ncheruvu-MSFT/docs-editor/inject-vnet-v2-1765999259
Update inject-vnet-v2.md
2 parents 1cc3141 + 206e507 commit 953ac9f

1 file changed

Lines changed: 23 additions & 2 deletions

File tree

articles/api-management/inject-vnet-v2.md

Lines changed: 23 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -54,6 +54,29 @@ If you want to enable *public* inbound access to an API Management instance in t
5454
* Minimum: /27 (32 addresses)
5555
* Recommended: /24 (256 addresses) - to accommodate scaling of API Management instance
5656

57+
### Examples
58+
59+
The following table shows subnet sizing examples for API Management virtual network injection, illustrating how different CIDR blocks affect the number of scale-out units possible:
60+
61+
| Subnet CIDR | Total IP addresses | Azure reserved IPs | API Management instance IPs | Internal load balancer IP | Remaining IPs for scale-out | Max scale-out units | Total max units |
62+
|-------------|---------------------|---------------------|------------------------------|----------------------------|-----------------------------|----------------------|------------------|
63+
| /27 | 32 | 5 | 2 | 1 | 24 | 12 | 13 |
64+
| /26 | 64 | 5 | 2 | 1 | 56 | 28 | 29 |
65+
| /25 | 128 | 5 | 2 | 1 | 120 | 30* | 30* |
66+
67+
68+
### Key Points
69+
70+
- **Minimum subnet size**: /27 (provides 24 usable IP addresses for API Management)
71+
- **Azure reserved IPs**: 5 addresses per subnet (first and last for protocol conformance, plus 3 for Azure services)
72+
- **Scale-out requirement**: Each scale-out unit requires 2 IP addresses
73+
- **Internal load balancer**: Only required when API Management is deployed in internal virtual network mode
74+
- **Premium V2 limit**: * Currently supports up to 30 units maximum.
75+
76+
> [!IMPORTANT]
77+
> API Management is a member of Azure Integration Services and is typically deployed as a pivotal service in enterprise architectures. It is prudent to err on the higher side of available IPs for the API Management subnet as changing it later can have far-reaching impact.
78+
> The private IP addresses of internal load balancer and API Management units are assigned dynamically. Therefore, it is impossible to anticipate the private IP of the API Management instance prior to its deployment. Additionally, changing to a different subnet and then returning might cause a change in the private IP address.
79+
5780
### Network security group
5881

5982
[!INCLUDE [api-management-virtual-network-v2-nsg-rules](../../includes/api-management-virtual-network-v2-nsg-rules.md)]
@@ -76,8 +99,6 @@ You must have at least the following role-based access control permissions on th
7699
| Microsoft.Network/virtualNetworks/subnets/read | Read a virtual network subnet definition |
77100
| Microsoft.Network/virtualNetworks/subnets/join/action | Joins a virtual network |
78101

79-
80-
81102
## Inject API Management in a virtual network
82103

83104
When you [create](get-started-create-service-instance.md) a Premium v2 instance using the Azure portal, you can optionally configure settings for virtual network injection.

0 commit comments

Comments
 (0)