TrafficManagerManagementClient

Name: TrafficManagerManagementClient API
Brand: TrafficManagerManagementClient
Availability: InStock

★ Only Publicly Available OpenAPI DocumentCloud InfrastructureNetworkingoauth216 EndpointsREST

For Agents

Provisions Azure Traffic Manager profiles, attaches endpoints, and reads geographic hierarchies and heat map data so agents can configure global DNS-based traffic routing.

Connect the TrafficManagerManagementClient to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the TrafficManagerManagementClient, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Install Jentic One Beta (Self-Hosted)

Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with TrafficManagerManagementClient API.

Create, update, and delete Traffic Manager profiles to control global DNS-based routing across regions

Attach Azure, external, or nested-profile endpoints to a profile and set their priority, weight, or geographic mapping

Check whether a relative Traffic Manager domain name (the trafficmanager.net subdomain) is available before creating a profile

Pull the geographic hierarchy used by Geographic routing so an agent can validate region codes before assigning them to endpoints

GET STARTED

Start building with TrafficManagerManagementClient API

Explore with Jentic

View OpenAPI Document

Use for: Create a Traffic Manager profile with priority routing across two Azure regions, Add a new external endpoint to an existing Traffic Manager profile, Check whether the relative DNS name 'mycheckout' is available on trafficmanager.net, Retrieve the heat map for a Traffic Manager profile to see user distribution

Not supported: Does not run authoritative DNS zones, terminate TLS, or balance traffic at the TCP layer — use Azure DNS, Application Gateway, or Front Door for those concerns; Traffic Manager only does DNS-level global routing.

Jentic publishes the only available OpenAPI document for TrafficManagerManagementClient, keeping it validated and agent-ready.

Jentic publishes the only available OpenAPI specification for TrafficManagerManagementClient, keeping it validated and agent-ready. The Azure Traffic Manager Management Client is the ARM control plane for Microsoft.Network/trafficmanagerprofiles. It lets agents create, update, and delete Traffic Manager profiles, attach endpoints (Azure, external, or nested) for global DNS-level traffic routing, query geographic hierarchies for geo routing, manage user metrics keys for Real User Measurements, and pull heat map analytics. Authentication uses Azure Active Directory OAuth 2.0 against management.azure.com.

Use Cases

Patterns agents use TrafficManagerManagementClient API for, with concrete tasks.

★ Multi-region failover routing

An application with primary and secondary Azure regions needs DNS-level failover so that if the primary endpoint stops responding, traffic shifts to the secondary within the TTL window. The Traffic Manager Management Client creates a profile in priority routing mode, attaches both regional endpoints with priority 1 and 2, and configures the monitor settings (path, port, expected status). Failover is automatic once the probe marks the higher-priority endpoint Degraded.

Create a Traffic Manager profile named 'checkout-failover' in resource group 'web-rg' with trafficRoutingMethod=Priority, attach two AzureEndpoints pointing at the primary and secondary App Service hostnames with priorities 1 and 2, and verify both endpoints reach Online status.

Weighted traffic split for canary release

Releasing a new build to 5% of users before ramping to 100% requires weighted DNS routing. The agent creates or updates a Traffic Manager profile with trafficRoutingMethod=Weighted and sets endpoint weights (95 for stable, 5 for canary). To shift traffic, the agent updates the endpoint weights through the trafficmanagerprofiles/{endpointType}/{endpointName} PATCH and Traffic Manager applies it on the next DNS resolution.

Update endpoint 'canary' on profile 'checkout' (resource group 'web-rg') to weight=20 and endpoint 'stable' to weight=80, then read the profile back and confirm the new weights are applied.

Geographic routing with hierarchy validation

A regulated workload must route EU users to an EU endpoint and APAC users to an APAC endpoint. The agent first GETs the trafficManagerGeographicHierarchies/default resource to validate the region codes (e.g., GEO-EU, GEO-AP), then creates a profile with trafficRoutingMethod=Geographic and assigns those region codes to each endpoint. Validating against the live hierarchy prevents invalid-region 400s at create time.

Get the Traffic Manager geographic hierarchy, then create a profile 'geo-checkout' with two endpoints — one mapped to GEO-EU and one to GEO-AP — and verify the create response contains the expected geoMapping arrays.

Agent-driven heat map analysis

An AI agent analyzing user distribution can fetch the Traffic Manager heat map for a profile and feed the latitude/longitude buckets into a downstream report. Through Jentic the agent searches once for 'Azure Traffic Manager heat map', loads the GET on heatMaps/{heatMapType}, and executes it with the profile name. The Azure AD token is issued from the Jentic vault — no service principal credentials touch the agent.

Search Jentic for 'azure traffic manager heat map', then call the heatMaps GET on profile 'checkout-failover' in resource group 'web-rg' with heatMapType='default' and return the top 10 query buckets by query count.

Key Endpoints

16 endpoints — jentic publishes the only available openapi specification for trafficmanagermanagementclient, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/subscriptions/{subscriptionId}/providers/Microsoft.Network/trafficmanagerprofiles

List Traffic Manager profiles in the subscription

PUT

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficmanagerprofiles/{profileName}

Create or update a Traffic Manager profile

PUT

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficmanagerprofiles/{profileName}/{endpointType}/{endpointName}

Create or update an endpoint inside a profile

POST

/providers/Microsoft.Network/checkTrafficManagerNameAvailability

Check relative DNS name availability

GET

/providers/Microsoft.Network/trafficManagerGeographicHierarchies/default

Get the geographic hierarchy for geo routing

GET

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficmanagerprofiles/{profileName}/heatMaps/{heatMapType}

Read heat map analytics for a profile

GET

/subscriptions/{subscriptionId}/providers/Microsoft.Network/trafficmanagerprofiles

List Traffic Manager profiles in the subscription

PUT

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficmanagerprofiles/{profileName}

Create or update a Traffic Manager profile

PUT

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficmanagerprofiles/{profileName}/{endpointType}/{endpointName}

Create or update an endpoint inside a profile

POST

/providers/Microsoft.Network/checkTrafficManagerNameAvailability

Check relative DNS name availability

GET

/providers/Microsoft.Network/trafficManagerGeographicHierarchies/default

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Azure AD client credentials live encrypted in the Jentic vault. Agents only ever see a scoped OAuth bearer token at call time; the underlying client secret and tenant configuration never reach the agent prompt.

Intent-based discovery

Agents query Jentic with intents like 'create azure traffic manager profile' and Jentic returns the matching Microsoft.Network/trafficmanagerprofiles operation with the JSON schema for trafficRoutingMethod, endpoints, and monitor settings ready to fill.

Time to first call

Direct ARM integration: 2-3 days for MSAL setup, polling long-running PUTs, retry on 429, and endpoint payload assembly. Through Jentic: under 1 hour.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

DnsManagementClient

Manages authoritative Azure DNS zones that often sit alongside Traffic Manager

Use to create CNAMEs pointing your custom domain at the Traffic Manager profile's trafficmanager.net hostname.

Complementary

NetworkManagementClient

Provisions the underlying VNet, public IPs, and load balancers Traffic Manager routes to

Use first to create the regional endpoints (public IPs, App Gateways) you then register inside a Traffic Manager profile.

Alternative

PrivateDnsManagementClient

Resolves names inside a virtual network without public DNS

Use when the routing needs to stay internal to a VNet — Traffic Manager is public-DNS only.

FAQs

Specific to using TrafficManagerManagementClient API through Jentic.

Why is there no official OpenAPI spec for TrafficManagerManagementClient?

Microsoft Azure does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call TrafficManagerManagementClient via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up .

What authentication does the TrafficManagerManagementClient use?

It uses Azure Active Directory OAuth 2.0 with the user_impersonation scope against https://login.microsoftonline.com/common/oauth2/authorize. Jentic stores the Azure AD client secret encrypted in its vault and issues a short-lived bearer token to the agent at execution time, so the secret never enters agent context.

Can I create a weighted routing profile with the TrafficManagerManagementClient?

Yes. PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficmanagerprofiles/{profileName} with trafficRoutingMethod set to Weighted and per-endpoint weights creates the profile. You then PUT each endpoint via the {endpointType}/{endpointName} sub-resource.

What are the rate limits for the TrafficManagerManagementClient?

Calls go through Azure Resource Manager and are subject to the standard ARM read and write throttling buckets (roughly 12,000 reads and 1,200 writes per hour per subscription per region). The exact limit is not in the spec; respect the Retry-After header on a 429.

How do I attach an endpoint to a profile through Jentic?

Run pip install jentic, then client.search('add Azure Traffic Manager endpoint'), client.load on the returned operation (PUT on .../trafficmanagerprofiles/{profileName}/{endpointType}/{endpointName}), and client.execute with the endpoint payload (target, priority, weight, endpointStatus). Jentic injects the Azure AD token from the vault.

How do I check whether a Traffic Manager DNS name is available?

Call POST /providers/Microsoft.Network/checkTrafficManagerNameAvailability with body {name, type:'Microsoft.Network/trafficManagerProfiles'}. The response indicates whether the requested {name}.trafficmanager.net is free or already taken.