Configure Azure Traffic Manager Endpoints

The azure-native:trafficmanager:Endpoint resource, part of the Pulumi Azure Native provider, defines Traffic Manager endpoints that represent backend targets in a traffic routing profile. This guide focuses on four capabilities: performance-based location routing, geographic region mapping, subnet-based traffic steering, and health probe header customization.

Endpoints belong to Traffic Manager profiles and reference external DNS names or Azure resource IDs. The examples are intentionally small. Combine them with your own profiles, routing methods, and backend infrastructure.

Route traffic to external endpoints by location

Global applications route users to the nearest datacenter to minimize latency using Traffic Manager’s Performance routing method.

import * as pulumi from "@pulumi/pulumi";
import * as azure_native from "@pulumi/azure-native";

const endpoint = new azure_native.trafficmanager.Endpoint("endpoint", {
    endpointLocation: "North Europe",
    endpointName: "azsmnet7187",
    endpointStatus: azure_native.trafficmanager.EndpointStatus.Enabled,
    endpointType: "ExternalEndpoints",
    name: "azsmnet7187",
    profileName: "azsmnet6386",
    resourceGroupName: "azuresdkfornetautoresttrafficmanager1421",
    target: "foobar.contoso.com",
    type: "Microsoft.network/TrafficManagerProfiles/ExternalEndpoints",
});

import pulumi
import pulumi_azure_native as azure_native

endpoint = azure_native.trafficmanager.Endpoint("endpoint",
    endpoint_location="North Europe",
    endpoint_name="azsmnet7187",
    endpoint_status=azure_native.trafficmanager.EndpointStatus.ENABLED,
    endpoint_type="ExternalEndpoints",
    name="azsmnet7187",
    profile_name="azsmnet6386",
    resource_group_name="azuresdkfornetautoresttrafficmanager1421",
    target="foobar.contoso.com",
    type="Microsoft.network/TrafficManagerProfiles/ExternalEndpoints")

package main

import (
	trafficmanager "github.com/pulumi/pulumi-azure-native-sdk/trafficmanager/v3"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := trafficmanager.NewEndpoint(ctx, "endpoint", &trafficmanager.EndpointArgs{
			EndpointLocation:  pulumi.String("North Europe"),
			EndpointName:      pulumi.String("azsmnet7187"),
			EndpointStatus:    pulumi.String(trafficmanager.EndpointStatusEnabled),
			EndpointType:      pulumi.String("ExternalEndpoints"),
			Name:              pulumi.String("azsmnet7187"),
			ProfileName:       pulumi.String("azsmnet6386"),
			ResourceGroupName: pulumi.String("azuresdkfornetautoresttrafficmanager1421"),
			Target:            pulumi.String("foobar.contoso.com"),
			Type:              pulumi.String("Microsoft.network/TrafficManagerProfiles/ExternalEndpoints"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;

return await Deployment.RunAsync(() => 
{
    var endpoint = new AzureNative.TrafficManager.Endpoint("endpoint", new()
    {
        EndpointLocation = "North Europe",
        EndpointName = "azsmnet7187",
        EndpointStatus = AzureNative.TrafficManager.EndpointStatus.Enabled,
        EndpointType = "ExternalEndpoints",
        Name = "azsmnet7187",
        ProfileName = "azsmnet6386",
        ResourceGroupName = "azuresdkfornetautoresttrafficmanager1421",
        Target = "foobar.contoso.com",
        Type = "Microsoft.network/TrafficManagerProfiles/ExternalEndpoints",
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azurenative.trafficmanager.Endpoint;
import com.pulumi.azurenative.trafficmanager.EndpointArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var endpoint = new Endpoint("endpoint", EndpointArgs.builder()
            .endpointLocation("North Europe")
            .endpointName("azsmnet7187")
            .endpointStatus("Enabled")
            .endpointType("ExternalEndpoints")
            .name("azsmnet7187")
            .profileName("azsmnet6386")
            .resourceGroupName("azuresdkfornetautoresttrafficmanager1421")
            .target("foobar.contoso.com")
            .type("Microsoft.network/TrafficManagerProfiles/ExternalEndpoints")
            .build());

    }
}

resources:
  endpoint:
    type: azure-native:trafficmanager:Endpoint
    properties:
      endpointLocation: North Europe
      endpointName: azsmnet7187
      endpointStatus: Enabled
      endpointType: ExternalEndpoints
      name: azsmnet7187
      profileName: azsmnet6386
      resourceGroupName: azuresdkfornetautoresttrafficmanager1421
      target: foobar.contoso.com
      type: Microsoft.network/TrafficManagerProfiles/ExternalEndpoints

The endpointLocation property specifies the Azure region closest to your external endpoint. Traffic Manager uses this location to calculate latency from client DNS resolvers. The target property points to your external DNS name, and endpointType must be “ExternalEndpoints” for non-Azure targets.

Map geographic regions to specific endpoints

Compliance requirements or data residency rules often mandate that traffic from certain regions reach specific endpoints.

import * as pulumi from "@pulumi/pulumi";
import * as azure_native from "@pulumi/azure-native";

const endpoint = new azure_native.trafficmanager.Endpoint("endpoint", {
    endpointName: "My%20external%20endpoint",
    endpointStatus: azure_native.trafficmanager.EndpointStatus.Enabled,
    endpointType: "ExternalEndpoints",
    geoMapping: [
        "GEO-AS",
        "GEO-AF",
    ],
    name: "My external endpoint",
    profileName: "azuresdkfornetautoresttrafficmanager8224",
    resourceGroupName: "azuresdkfornetautoresttrafficmanager2191",
    target: "foobar.contoso.com",
    type: "Microsoft.network/TrafficManagerProfiles/ExternalEndpoints",
});

import pulumi
import pulumi_azure_native as azure_native

endpoint = azure_native.trafficmanager.Endpoint("endpoint",
    endpoint_name="My%20external%20endpoint",
    endpoint_status=azure_native.trafficmanager.EndpointStatus.ENABLED,
    endpoint_type="ExternalEndpoints",
    geo_mapping=[
        "GEO-AS",
        "GEO-AF",
    ],
    name="My external endpoint",
    profile_name="azuresdkfornetautoresttrafficmanager8224",
    resource_group_name="azuresdkfornetautoresttrafficmanager2191",
    target="foobar.contoso.com",
    type="Microsoft.network/TrafficManagerProfiles/ExternalEndpoints")

package main

import (
	trafficmanager "github.com/pulumi/pulumi-azure-native-sdk/trafficmanager/v3"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := trafficmanager.NewEndpoint(ctx, "endpoint", &trafficmanager.EndpointArgs{
			EndpointName:   pulumi.String("My%20external%20endpoint"),
			EndpointStatus: pulumi.String(trafficmanager.EndpointStatusEnabled),
			EndpointType:   pulumi.String("ExternalEndpoints"),
			GeoMapping: pulumi.StringArray{
				pulumi.String("GEO-AS"),
				pulumi.String("GEO-AF"),
			},
			Name:              pulumi.String("My external endpoint"),
			ProfileName:       pulumi.String("azuresdkfornetautoresttrafficmanager8224"),
			ResourceGroupName: pulumi.String("azuresdkfornetautoresttrafficmanager2191"),
			Target:            pulumi.String("foobar.contoso.com"),
			Type:              pulumi.String("Microsoft.network/TrafficManagerProfiles/ExternalEndpoints"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;

return await Deployment.RunAsync(() => 
{
    var endpoint = new AzureNative.TrafficManager.Endpoint("endpoint", new()
    {
        EndpointName = "My%20external%20endpoint",
        EndpointStatus = AzureNative.TrafficManager.EndpointStatus.Enabled,
        EndpointType = "ExternalEndpoints",
        GeoMapping = new[]
        {
            "GEO-AS",
            "GEO-AF",
        },
        Name = "My external endpoint",
        ProfileName = "azuresdkfornetautoresttrafficmanager8224",
        ResourceGroupName = "azuresdkfornetautoresttrafficmanager2191",
        Target = "foobar.contoso.com",
        Type = "Microsoft.network/TrafficManagerProfiles/ExternalEndpoints",
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azurenative.trafficmanager.Endpoint;
import com.pulumi.azurenative.trafficmanager.EndpointArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var endpoint = new Endpoint("endpoint", EndpointArgs.builder()
            .endpointName("My%20external%20endpoint")
            .endpointStatus("Enabled")
            .endpointType("ExternalEndpoints")
            .geoMapping(            
                "GEO-AS",
                "GEO-AF")
            .name("My external endpoint")
            .profileName("azuresdkfornetautoresttrafficmanager8224")
            .resourceGroupName("azuresdkfornetautoresttrafficmanager2191")
            .target("foobar.contoso.com")
            .type("Microsoft.network/TrafficManagerProfiles/ExternalEndpoints")
            .build());

    }
}

resources:
  endpoint:
    type: azure-native:trafficmanager:Endpoint
    properties:
      endpointName: My%20external%20endpoint
      endpointStatus: Enabled
      endpointType: ExternalEndpoints
      geoMapping:
        - GEO-AS
        - GEO-AF
      name: My external endpoint
      profileName: azuresdkfornetautoresttrafficmanager8224
      resourceGroupName: azuresdkfornetautoresttrafficmanager2191
      target: foobar.contoso.com
      type: Microsoft.network/TrafficManagerProfiles/ExternalEndpoints

The geoMapping property lists geographic codes that route to this endpoint. Traffic Manager supports continent-level codes like “GEO-AS” (Asia) and “GEO-AF” (Africa), plus individual country codes. Your profile must use the Geographic routing method for these mappings to take effect.

Route traffic based on client IP subnets

Some deployments route traffic based on the client’s source IP address, directing specific networks to designated endpoints.

import * as pulumi from "@pulumi/pulumi";
import * as azure_native from "@pulumi/azure-native";

const endpoint = new azure_native.trafficmanager.Endpoint("endpoint", {
    endpointName: "My%20external%20endpoint",
    endpointStatus: azure_native.trafficmanager.EndpointStatus.Enabled,
    endpointType: "ExternalEndpoints",
    name: "My external endpoint",
    profileName: "azuresdkfornetautoresttrafficmanager8224",
    resourceGroupName: "azuresdkfornetautoresttrafficmanager2191",
    subnets: [
        {
            first: "1.2.3.0",
            scope: 24,
        },
        {
            first: "25.26.27.28",
            last: "29.30.31.32",
        },
    ],
    target: "foobar.contoso.com",
    type: "Microsoft.network/TrafficManagerProfiles/ExternalEndpoints",
});

import pulumi
import pulumi_azure_native as azure_native

endpoint = azure_native.trafficmanager.Endpoint("endpoint",
    endpoint_name="My%20external%20endpoint",
    endpoint_status=azure_native.trafficmanager.EndpointStatus.ENABLED,
    endpoint_type="ExternalEndpoints",
    name="My external endpoint",
    profile_name="azuresdkfornetautoresttrafficmanager8224",
    resource_group_name="azuresdkfornetautoresttrafficmanager2191",
    subnets=[
        {
            "first": "1.2.3.0",
            "scope": 24,
        },
        {
            "first": "25.26.27.28",
            "last": "29.30.31.32",
        },
    ],
    target="foobar.contoso.com",
    type="Microsoft.network/TrafficManagerProfiles/ExternalEndpoints")

package main

import (
	trafficmanager "github.com/pulumi/pulumi-azure-native-sdk/trafficmanager/v3"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := trafficmanager.NewEndpoint(ctx, "endpoint", &trafficmanager.EndpointArgs{
			EndpointName:      pulumi.String("My%20external%20endpoint"),
			EndpointStatus:    pulumi.String(trafficmanager.EndpointStatusEnabled),
			EndpointType:      pulumi.String("ExternalEndpoints"),
			Name:              pulumi.String("My external endpoint"),
			ProfileName:       pulumi.String("azuresdkfornetautoresttrafficmanager8224"),
			ResourceGroupName: pulumi.String("azuresdkfornetautoresttrafficmanager2191"),
			Subnets: trafficmanager.EndpointPropertiesSubnetsItemArray{
				&trafficmanager.EndpointPropertiesSubnetsItemArgs{
					First: pulumi.String("1.2.3.0"),
					Scope: pulumi.Int(24),
				},
				&trafficmanager.EndpointPropertiesSubnetsItemArgs{
					First: pulumi.String("25.26.27.28"),
					Last:  pulumi.String("29.30.31.32"),
				},
			},
			Target: pulumi.String("foobar.contoso.com"),
			Type:   pulumi.String("Microsoft.network/TrafficManagerProfiles/ExternalEndpoints"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;

return await Deployment.RunAsync(() => 
{
    var endpoint = new AzureNative.TrafficManager.Endpoint("endpoint", new()
    {
        EndpointName = "My%20external%20endpoint",
        EndpointStatus = AzureNative.TrafficManager.EndpointStatus.Enabled,
        EndpointType = "ExternalEndpoints",
        Name = "My external endpoint",
        ProfileName = "azuresdkfornetautoresttrafficmanager8224",
        ResourceGroupName = "azuresdkfornetautoresttrafficmanager2191",
        Subnets = new[]
        {
            new AzureNative.TrafficManager.Inputs.EndpointPropertiesSubnetsItemArgs
            {
                First = "1.2.3.0",
                Scope = 24,
            },
            new AzureNative.TrafficManager.Inputs.EndpointPropertiesSubnetsItemArgs
            {
                First = "25.26.27.28",
                Last = "29.30.31.32",
            },
        },
        Target = "foobar.contoso.com",
        Type = "Microsoft.network/TrafficManagerProfiles/ExternalEndpoints",
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azurenative.trafficmanager.Endpoint;
import com.pulumi.azurenative.trafficmanager.EndpointArgs;
import com.pulumi.azurenative.trafficmanager.inputs.EndpointPropertiesSubnetsItemArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var endpoint = new Endpoint("endpoint", EndpointArgs.builder()
            .endpointName("My%20external%20endpoint")
            .endpointStatus("Enabled")
            .endpointType("ExternalEndpoints")
            .name("My external endpoint")
            .profileName("azuresdkfornetautoresttrafficmanager8224")
            .resourceGroupName("azuresdkfornetautoresttrafficmanager2191")
            .subnets(            
                EndpointPropertiesSubnetsItemArgs.builder()
                    .first("1.2.3.0")
                    .scope(24)
                    .build(),
                EndpointPropertiesSubnetsItemArgs.builder()
                    .first("25.26.27.28")
                    .last("29.30.31.32")
                    .build())
            .target("foobar.contoso.com")
            .type("Microsoft.network/TrafficManagerProfiles/ExternalEndpoints")
            .build());

    }
}

resources:
  endpoint:
    type: azure-native:trafficmanager:Endpoint
    properties:
      endpointName: My%20external%20endpoint
      endpointStatus: Enabled
      endpointType: ExternalEndpoints
      name: My external endpoint
      profileName: azuresdkfornetautoresttrafficmanager8224
      resourceGroupName: azuresdkfornetautoresttrafficmanager2191
      subnets:
        - first: 1.2.3.0
          scope: 24
        - first: 25.26.27.28
          last: 29.30.31.32
      target: foobar.contoso.com
      type: Microsoft.network/TrafficManagerProfiles/ExternalEndpoints

The subnets property defines IP ranges that route to this endpoint. Each subnet entry uses either first and scope (CIDR notation) or first and last (IP range). Traffic Manager matches the client’s source IP against these ranges. Your profile must use the Subnet routing method.

Add custom headers to health probe requests

Health probes sometimes need custom headers for authentication, routing hints, or application-specific metadata.

import * as pulumi from "@pulumi/pulumi";
import * as azure_native from "@pulumi/azure-native";

const endpoint = new azure_native.trafficmanager.Endpoint("endpoint", {
    customHeaders: [
        {
            name: "header-1",
            value: "value-1",
        },
        {
            name: "header-2",
            value: "value-2",
        },
    ],
    endpointLocation: "North Europe",
    endpointName: "azsmnet7187",
    endpointStatus: azure_native.trafficmanager.EndpointStatus.Enabled,
    endpointType: "ExternalEndpoints",
    name: "azsmnet7187",
    profileName: "azsmnet6386",
    resourceGroupName: "azuresdkfornetautoresttrafficmanager1421",
    target: "foobar.contoso.com",
    type: "Microsoft.network/TrafficManagerProfiles/ExternalEndpoints",
});

import pulumi
import pulumi_azure_native as azure_native

endpoint = azure_native.trafficmanager.Endpoint("endpoint",
    custom_headers=[
        {
            "name": "header-1",
            "value": "value-1",
        },
        {
            "name": "header-2",
            "value": "value-2",
        },
    ],
    endpoint_location="North Europe",
    endpoint_name="azsmnet7187",
    endpoint_status=azure_native.trafficmanager.EndpointStatus.ENABLED,
    endpoint_type="ExternalEndpoints",
    name="azsmnet7187",
    profile_name="azsmnet6386",
    resource_group_name="azuresdkfornetautoresttrafficmanager1421",
    target="foobar.contoso.com",
    type="Microsoft.network/TrafficManagerProfiles/ExternalEndpoints")

package main

import (
	trafficmanager "github.com/pulumi/pulumi-azure-native-sdk/trafficmanager/v3"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := trafficmanager.NewEndpoint(ctx, "endpoint", &trafficmanager.EndpointArgs{
			CustomHeaders: trafficmanager.EndpointPropertiesCustomHeadersItemArray{
				&trafficmanager.EndpointPropertiesCustomHeadersItemArgs{
					Name:  pulumi.String("header-1"),
					Value: pulumi.String("value-1"),
				},
				&trafficmanager.EndpointPropertiesCustomHeadersItemArgs{
					Name:  pulumi.String("header-2"),
					Value: pulumi.String("value-2"),
				},
			},
			EndpointLocation:  pulumi.String("North Europe"),
			EndpointName:      pulumi.String("azsmnet7187"),
			EndpointStatus:    pulumi.String(trafficmanager.EndpointStatusEnabled),
			EndpointType:      pulumi.String("ExternalEndpoints"),
			Name:              pulumi.String("azsmnet7187"),
			ProfileName:       pulumi.String("azsmnet6386"),
			ResourceGroupName: pulumi.String("azuresdkfornetautoresttrafficmanager1421"),
			Target:            pulumi.String("foobar.contoso.com"),
			Type:              pulumi.String("Microsoft.network/TrafficManagerProfiles/ExternalEndpoints"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;

return await Deployment.RunAsync(() => 
{
    var endpoint = new AzureNative.TrafficManager.Endpoint("endpoint", new()
    {
        CustomHeaders = new[]
        {
            new AzureNative.TrafficManager.Inputs.EndpointPropertiesCustomHeadersItemArgs
            {
                Name = "header-1",
                Value = "value-1",
            },
            new AzureNative.TrafficManager.Inputs.EndpointPropertiesCustomHeadersItemArgs
            {
                Name = "header-2",
                Value = "value-2",
            },
        },
        EndpointLocation = "North Europe",
        EndpointName = "azsmnet7187",
        EndpointStatus = AzureNative.TrafficManager.EndpointStatus.Enabled,
        EndpointType = "ExternalEndpoints",
        Name = "azsmnet7187",
        ProfileName = "azsmnet6386",
        ResourceGroupName = "azuresdkfornetautoresttrafficmanager1421",
        Target = "foobar.contoso.com",
        Type = "Microsoft.network/TrafficManagerProfiles/ExternalEndpoints",
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azurenative.trafficmanager.Endpoint;
import com.pulumi.azurenative.trafficmanager.EndpointArgs;
import com.pulumi.azurenative.trafficmanager.inputs.EndpointPropertiesCustomHeadersItemArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var endpoint = new Endpoint("endpoint", EndpointArgs.builder()
            .customHeaders(            
                EndpointPropertiesCustomHeadersItemArgs.builder()
                    .name("header-1")
                    .value("value-1")
                    .build(),
                EndpointPropertiesCustomHeadersItemArgs.builder()
                    .name("header-2")
                    .value("value-2")
                    .build())
            .endpointLocation("North Europe")
            .endpointName("azsmnet7187")
            .endpointStatus("Enabled")
            .endpointType("ExternalEndpoints")
            .name("azsmnet7187")
            .profileName("azsmnet6386")
            .resourceGroupName("azuresdkfornetautoresttrafficmanager1421")
            .target("foobar.contoso.com")
            .type("Microsoft.network/TrafficManagerProfiles/ExternalEndpoints")
            .build());

    }
}

resources:
  endpoint:
    type: azure-native:trafficmanager:Endpoint
    properties:
      customHeaders:
        - name: header-1
          value: value-1
        - name: header-2
          value: value-2
      endpointLocation: North Europe
      endpointName: azsmnet7187
      endpointStatus: Enabled
      endpointType: ExternalEndpoints
      name: azsmnet7187
      profileName: azsmnet6386
      resourceGroupName: azuresdkfornetautoresttrafficmanager1421
      target: foobar.contoso.com
      type: Microsoft.network/TrafficManagerProfiles/ExternalEndpoints

The customHeaders property adds name-value pairs to health probe HTTP requests. Your backend service receives these headers with each probe and can use them for authentication, routing decisions, or application logic. The headers don’t affect client traffic, only health checks.

Beyond these examples

These snippets focus on specific endpoint-level features: geographic and subnet-based routing, performance-based location selection, and health probe customization. They’re intentionally minimal rather than full traffic management solutions.

The examples reference pre-existing infrastructure such as Traffic Manager profiles with configured routing methods, resource groups, and external DNS targets or Azure resources. They focus on configuring the endpoint rather than provisioning profiles or backends.

To keep things focused, common endpoint patterns are omitted, including:

Always Serve mode (alwaysServe) for bypassing health checks
Priority and weight configuration for routing methods
Nested endpoints (minChildEndpoints properties)
IPv4/IPv6-specific child endpoint thresholds

These omissions are intentional: the goal is to illustrate how each endpoint feature is wired, not provide drop-in traffic management modules. See the Traffic Manager Endpoint resource reference for all available configuration options.

Let's configure Azure Traffic Manager Endpoints

Get started with Pulumi Cloud, then follow our quick setup guide to deploy this infrastructure.

Try Pulumi Cloud for FREE

Frequently Asked Questions

Endpoint Configuration & Types

What properties can't I change after creating an endpoint?

Four properties are immutable: endpointName, endpointType, profileName, and resourceGroupName. Changing any of these requires recreating the endpoint.

What's the difference between target and targetResourceId?

Use target for DNS names or IP addresses (required for ExternalEndpoints). Use targetResourceId for Azure resource URIs, which is not applicable to ExternalEndpoints.

How do I configure an external endpoint?

Set endpointType to ExternalEndpoints, provide a target (DNS name or IP), and specify type as Microsoft.network/TrafficManagerProfiles/ExternalEndpoints.

Traffic Routing Methods

What traffic routing methods are available and which properties do they use?

Traffic Manager supports five routing methods:

Performance - Requires endpointLocation (e.g., “North Europe”)
Geographic - Uses geoMapping with region codes (e.g., “GEO-AS”, “GEO-AF”)
Priority - Uses priority values (1-1000, lower = higher priority)
Weighted - Uses weight values (1-1000)
Subnet - Uses subnets with CIDR or IP ranges

How do priority values work in Priority routing?

Priority values range from 1 to 1000 (lower = higher priority). Each endpoint must have a unique priority value, and if you specify priority on one endpoint, you must specify it on all endpoints in the profile.

What subnet formats are supported for Subnet routing?

Two formats are supported: CIDR notation using first (IP address) and scope (prefix length), or IP range using first and last IP addresses.

How do I configure geographic routing with region codes?

Set geoMapping to an array of country/region codes like GEO-AS (Asia) or GEO-AF (Africa). Consult Traffic Manager Geographic documentation for the full list of accepted values.

Health Monitoring & Status

Can I disable health probing for an endpoint?

Yes, set alwaysServe to Enabled. This disables health probing and always includes the endpoint in traffic routing regardless of health status.

How do I add custom headers to health checks?

Configure customHeaders as an array of objects with name and value properties (e.g., {name: "header-1", value: "value-1"}).

What does endpointStatus control?

When set to Enabled, the endpoint is probed for health and included in traffic routing. When Disabled, the endpoint is excluded from routing.

Nested Endpoints

How do child endpoint thresholds work for nested endpoints?

Use minChildEndpoints to set the minimum available child endpoints required for the parent to be considered available. You can also specify separate thresholds for IPv4 (minChildEndpointsIPv4) and IPv6 (minChildEndpointsIPv6) endpoints. These properties only apply to NestedEndpoints type.

Using a different cloud?

Explore networking guides for other cloud providers:

AWS Guides GCP Guides