Skip to content

Commit 755268c

Browse files
Update API Management subnet size examples to tabular format
1 parent f3d55a0 commit 755268c

File tree

1 file changed

+21
-9
lines changed

1 file changed

+21
-9
lines changed

articles/api-management/virtual-network-injection-resources.md

Lines changed: 21 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -40,17 +40,29 @@ The minimum size of the subnet in which API Management can be deployed is /29, w
4040

4141
* When deploying into an [internal virtual network](./api-management-using-with-internal-vnet.md), the instance requires an extra IP address for the internal load balancer.
4242

43+
> [!NOTE]
44+
> When considering a subnet size, it is advisable to err on the side of caution due to the integral role that API Management typically holds. Consider growth and scaling in your sizing.
45+
4346
### Examples
4447

45-
* **/29 subnet**: 8 possible IP addresses - 5 reserved Azure IP addresses - 2 API Management IP addresses for one instance - 1 IP address for internal load balancer, if used in internal mode = 0 remaining IP addresses left for scale-out units.
46-
47-
* **/28 subnet**: 16 possible IP addresses - 5 reserved Azure IP addresses - 2 API Management IP addresses for one instance - 1 IP address for internal load balancer, if used in internal mode = 8 remaining IP addresses left for four scale-out units (2 IP addresses/scale-out unit) for a total of five units.
48-
49-
* **/27 subnet**: 32 possible IP addresses - 5 reserved Azure IP addresses - 2 API Management IP addresses for one instance - 1 IP address for internal load balancer, if used in internal mode = 24 remaining IP addresses left for 12 scale-out units (2 IP addresses/scale-out unit) for a total of 13 units.
50-
51-
* **/26 subnet**: 64 possible IP addresses - 5 reserved Azure IP addresses - 2 API Management IP addresses for one instance - 1 IP address for internal load balancer, if used in internal mode = 56 remaining IP addresses left for 28 scale-out units (2 IP addresses/scale-out unit) for a total of 29 units.
52-
53-
* **/25 subnet**: 128 possible IP addresses - 5 reserved Azure IP addresses - 2 API Management IP addresses for one instance - 1 IP address for internal load balancer, if used in internal mode = 120 remaining IP addresses left for 60 scale-out units (2 IP addresses/scale-out unit) for a total of 61 units. This is a large, theoretical number of scale-out units.
48+
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:
49+
50+
| 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 |
51+
|------------:|-------------------:|-------------------:|----------------------------:|--------------------------:|----------------------------:|--------------------:|----------------:|
52+
| /29 | 8 | 5 | 2 | 1 | 0 | 0 | 1 |
53+
| /28 | 16 | 5 | 2 | 1 | 8 | 4 | 5 |
54+
| /27 | 32 | 5 | 2 | 1 | 24 | 12 | 13 |
55+
| /26 | 64 | 5 | 2 | 1 | 56 | 28 | 29 |
56+
| /25 | 128 | 5 | 2 | 1 | 120 | 60* | 61* |
57+
58+
## Key Points
59+
60+
- **Minimum subnet size**: /29 (provides 3 usable IP addresses for API Management)
61+
- **Azure reserved IPs**: 5 addresses per subnet (first and last for protocol conformance, plus 3 for Azure services)
62+
- **Scale-out requirement**: Each scale-out unit requires 2 IP addresses
63+
- **Internal load balancer**: Only required when API Management is deployed in internal virtual network mode
64+
- **Premium SKU limit**: * Currently supports up to 31 units maximum
65+
- **Recommended sizing**: For high-scale scenarios approaching the Premium SKU limit, consider /26 or /25 subnets
5466

5567
> [!NOTE]
5668
> It is currently possible to scale the Premium SKU to 31 units. If you foresee demand approaching this limit, consider the /26 subnet or /25 subnet.

0 commit comments

Comments
 (0)