Skip to content

Commit 4f1981d

Browse files
Merge pull request #218017 from greg-lindsay/minchild
minchild validations
2 parents 7ecd89b + b179208 commit 4f1981d

File tree

1 file changed

+19
-3
lines changed

1 file changed

+19
-3
lines changed

articles/traffic-manager/traffic-manager-nested-profiles.md

Lines changed: 19 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ ms.service: traffic-manager
1010
ms.topic: article
1111
ms.tgt_pltfrm: na
1212
ms.workload: infrastructure-services
13-
ms.date: 04/22/2022
13+
ms.date: 11/10/2022
1414
ms.author: greglin
1515
---
1616

@@ -20,6 +20,22 @@ Traffic Manager includes a range of traffic-routing methods that allow you to co
2020

2121
Each Traffic Manager profile specifies a single traffic-routing method. However, there are scenarios that require more sophisticated traffic routing than the routing provided by a single Traffic Manager profile. You can nest Traffic Manager profiles to combine the benefits of more than one traffic-routing method. Nested profiles allow you to override the default Traffic Manager behavior to support larger and more complex application deployments.
2222

23+
To create a nested profile, you add a 'child' profile as an endpoint to a 'parent' profile. Some examples are provided in this article.
24+
25+
## MinChildEndpoints
26+
27+
When you add a child profile as an endpoint in the parent profile, the **MinChildEndpoints** parameter is created and assigned a default value of **1**. This parameter determines the minimum number of endpoints that must be available in the child profile for it to be healthy. Below this threshold, the parent profile will consider the entire child profile as unavailable, and direct traffic to the other parent profile endpoints.
28+
29+
The following parameters are available in the parent profile:
30+
31+
- **MinChildEndpoints**: The minimum number of healthy child endpoints for the nested profile status to be healthy.
32+
- **MinChildEndpointsIPv4**: The minimum number of healthy IPv4 child endpoints for the nested profile status to be healthy.
33+
- **MinChildEndpointsIPv6**: The minimum number of healthy IPv6 child endpoints for the nested profile status to be healthy.
34+
35+
> [!IMPORTANT]
36+
> There must be at least one IPv4 and one IPv6 endpoint for any nested MultiValue profile. Always configure values for MinChildEndpointsIPv4 and MinChildEndpointsIPv6 based on your multivalue routing mechanism and do not simply use the default values.<br>
37+
> The value of **MinChildEndpoints** must be high enough to allow for all endpoint types to be available. An error message is displayed for values that are too low.
38+
2339
The following examples illustrate how to use nested Traffic Manager profiles in various scenarios.
2440

2541
## Example 1: Combining 'Performance' and 'Weighted' traffic routing
@@ -48,9 +64,9 @@ Returning to the previous example, suppose the production deployment in West Eur
4864

4965
![Nested Profile failover (default behavior)][3]
5066

51-
You might be happy with this arrangement. Or you might be concerned that all traffic for West Europe is now going to the test deployment instead of a limited subset traffic. Regardless of the health of the test deployment, you want to fail over to the other regions when the production deployment in West Europe fails. To enable this failover, you can specify the 'MinChildEndpoints' parameter when configuring the child profile as an endpoint in the parent profile. The parameter determines the minimum number of available endpoints in the child profile. The default value is '1'. For this scenario, you set the MinChildEndpoints value to 2. Below this threshold, the parent profile considers the entire child profile to be unavailable and directs traffic to the other endpoints.
67+
You might be happy with this arrangement. Or you might be concerned that all traffic for West Europe is now going to the test deployment instead of a limited subset traffic. Regardless of the health of the test deployment, you want to fail over to the other regions when the production deployment in West Europe fails.
5268

53-
The following figure illustrates this configuration:
69+
In the scenario below, the **MinChildEndpoints** value is set to 2. Below this threshold, the parent profile considers the entire child profile to be unavailable and directs traffic to the other endpoints:
5470

5571
![Nested Profile failover with 'MinChildEndpoints' = 2][4]
5672

0 commit comments

Comments
 (0)