Microsoft.Network (preview:2024-04-01)

2025/06/12 • 17 new methods

Endpoints_Update (new)
Description :  Update a Traffic Manager endpoint.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficmanagerprofiles/{profileName}/{endpointType}/{endpointName}
{
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
profileName:
{
Description: The name of the Traffic Manager profile. ,
Required: True ,
}
string ,
endpointType:
{
Description: The type of the Traffic Manager endpoint to be updated. ,
Required: True ,
}
string ,
endpointName:
{
Description: The name of the Traffic Manager endpoint to be updated. ,
Required: True ,
}
string ,
parameters:
{
Description: The Traffic Manager endpoint parameters supplied to the Update operation. ,
Required: True ,
}
{
properties:
{
Description: The properties of the Traffic Manager endpoint. ,
Required: False ,
}
{
targetResourceId:
{
Description: The Azure Resource URI of the of the endpoint. Not applicable to endpoints of type 'ExternalEndpoints'. ,
Required: False ,
}
string ,
target:
{
Description: The fully-qualified DNS name or IP address of the endpoint. Traffic Manager returns this value in DNS responses to direct traffic to this endpoint. ,
Required: False ,
}
string ,
endpointStatus:
{
Description: The status of the endpoint. If the endpoint is Enabled, it is probed for endpoint health and is included in the traffic routing method. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
weight:
{
Description: The weight of this endpoint when using the 'Weighted' traffic routing method. Possible values are from 1 to 1000. ,
Format: int64 ,
Required: False ,
}
integer ,
priority:
{
Description: The priority of this endpoint when using the 'Priority' traffic routing method. Possible values are from 1 to 1000, lower values represent higher priority. This is an optional parameter. If specified, it must be specified on all endpoints, and no two endpoints can share the same priority value. ,
Format: int64 ,
Required: False ,
}
integer ,
endpointLocation:
{
Description: Specifies the location of the external or nested endpoints when using the 'Performance' traffic routing method. ,
Required: False ,
}
string ,
endpointMonitorStatus:
{
Description: The monitoring status of the endpoint. ,
Enum:
{
CheckingEndpoint: No description available. ,
Online: No description available. ,
Degraded: No description available. ,
Disabled: No description available. ,
Inactive: No description available. ,
Stopped: No description available. ,
Unmonitored: No description available. ,
}
,
Required: False ,
}
enum ,
minChildEndpoints:
{
Description: The minimum number of endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
minChildEndpointsIPv4:
{
Description: The minimum number of IPv4 (DNS record type A) endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
minChildEndpointsIPv6:
{
Description: The minimum number of IPv6 (DNS record type AAAA) endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
geoMapping:
{
Description: The list of countries/regions mapped to this endpoint when using the 'Geographic' traffic routing method. Please consult Traffic Manager Geographic documentation for a full list of accepted values. ,
Required: False ,
}
[
string ,
]
,
subnets:
{
Description: The list of subnets, IP addresses, and/or address ranges mapped to this endpoint when using the 'Subnet' traffic routing method. An empty list will match all ranges not covered by other endpoints. ,
Required: False ,
}
[
{
first:
{
Description: First address in the subnet. ,
Required: False ,
}
string ,
last:
{
Description: Last address in the subnet. ,
Required: False ,
}
string ,
scope:
{
Description: Block size (number of leading bits in the subnet mask). ,
Required: False ,
}
integer ,
}
,
]
,
customHeaders:
{
Description: List of custom headers. ,
Required: False ,
}
[
{
name:
{
Description: Header name. ,
Required: False ,
}
string ,
value:
{
Description: Header value. ,
Required: False ,
}
string ,
}
,
]
,
alwaysServe:
{
Description: If Always Serve is enabled, probing for endpoint health will be disabled and endpoints will be included in the traffic routing method. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The properties of the Traffic Manager endpoint. ,
Required: False ,
}
{
targetResourceId:
{
Description: The Azure Resource URI of the of the endpoint. Not applicable to endpoints of type 'ExternalEndpoints'. ,
Required: False ,
}
string ,
target:
{
Description: The fully-qualified DNS name or IP address of the endpoint. Traffic Manager returns this value in DNS responses to direct traffic to this endpoint. ,
Required: False ,
}
string ,
endpointStatus:
{
Description: The status of the endpoint. If the endpoint is Enabled, it is probed for endpoint health and is included in the traffic routing method. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
weight:
{
Description: The weight of this endpoint when using the 'Weighted' traffic routing method. Possible values are from 1 to 1000. ,
Format: int64 ,
Required: False ,
}
integer ,
priority:
{
Description: The priority of this endpoint when using the 'Priority' traffic routing method. Possible values are from 1 to 1000, lower values represent higher priority. This is an optional parameter. If specified, it must be specified on all endpoints, and no two endpoints can share the same priority value. ,
Format: int64 ,
Required: False ,
}
integer ,
endpointLocation:
{
Description: Specifies the location of the external or nested endpoints when using the 'Performance' traffic routing method. ,
Required: False ,
}
string ,
endpointMonitorStatus:
{
Description: The monitoring status of the endpoint. ,
Enum:
{
CheckingEndpoint: No description available. ,
Online: No description available. ,
Degraded: No description available. ,
Disabled: No description available. ,
Inactive: No description available. ,
Stopped: No description available. ,
Unmonitored: No description available. ,
}
,
Required: False ,
}
enum ,
minChildEndpoints:
{
Description: The minimum number of endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
minChildEndpointsIPv4:
{
Description: The minimum number of IPv4 (DNS record type A) endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
minChildEndpointsIPv6:
{
Description: The minimum number of IPv6 (DNS record type AAAA) endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
geoMapping:
{
Description: The list of countries/regions mapped to this endpoint when using the 'Geographic' traffic routing method. Please consult Traffic Manager Geographic documentation for a full list of accepted values. ,
Required: False ,
}
[
string ,
]
,
subnets:
{
Description: The list of subnets, IP addresses, and/or address ranges mapped to this endpoint when using the 'Subnet' traffic routing method. An empty list will match all ranges not covered by other endpoints. ,
Required: False ,
}
[
{
first:
{
Description: First address in the subnet. ,
Required: False ,
}
string ,
last:
{
Description: Last address in the subnet. ,
Required: False ,
}
string ,
scope:
{
Description: Block size (number of leading bits in the subnet mask). ,
Required: False ,
}
integer ,
}
,
]
,
customHeaders:
{
Description: List of custom headers. ,
Required: False ,
}
[
{
name:
{
Description: Header name. ,
Required: False ,
}
string ,
value:
{
Description: Header value. ,
Required: False ,
}
string ,
}
,
]
,
alwaysServe:
{
Description: If Always Serve is enabled, probing for endpoint health will be disabled and endpoints will be included in the traffic routing method. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The content of the error. ,
Required: False ,
}
{
code:
{
Description: Error code ,
Required: False ,
}
string ,
message:
{
Description: Error message ,
Required: False ,
}
string ,
target:
{
Description: Error target ,
Required: False ,
}
string ,
details:
{
Description: Error details ,
Required: False ,
}
[
string ,
]
,
}
,
}
Endpoints_Get (new)
Description :  Gets a Traffic Manager endpoint.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficmanagerprofiles/{profileName}/{endpointType}/{endpointName}
{
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
profileName:
{
Description: The name of the Traffic Manager profile. ,
Required: True ,
}
string ,
endpointType:
{
Description: The type of the Traffic Manager endpoint. ,
Required: True ,
}
string ,
endpointName:
{
Description: The name of the Traffic Manager endpoint. ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The properties of the Traffic Manager endpoint. ,
Required: False ,
}
{
targetResourceId:
{
Description: The Azure Resource URI of the of the endpoint. Not applicable to endpoints of type 'ExternalEndpoints'. ,
Required: False ,
}
string ,
target:
{
Description: The fully-qualified DNS name or IP address of the endpoint. Traffic Manager returns this value in DNS responses to direct traffic to this endpoint. ,
Required: False ,
}
string ,
endpointStatus:
{
Description: The status of the endpoint. If the endpoint is Enabled, it is probed for endpoint health and is included in the traffic routing method. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
weight:
{
Description: The weight of this endpoint when using the 'Weighted' traffic routing method. Possible values are from 1 to 1000. ,
Format: int64 ,
Required: False ,
}
integer ,
priority:
{
Description: The priority of this endpoint when using the 'Priority' traffic routing method. Possible values are from 1 to 1000, lower values represent higher priority. This is an optional parameter. If specified, it must be specified on all endpoints, and no two endpoints can share the same priority value. ,
Format: int64 ,
Required: False ,
}
integer ,
endpointLocation:
{
Description: Specifies the location of the external or nested endpoints when using the 'Performance' traffic routing method. ,
Required: False ,
}
string ,
endpointMonitorStatus:
{
Description: The monitoring status of the endpoint. ,
Enum:
{
CheckingEndpoint: No description available. ,
Online: No description available. ,
Degraded: No description available. ,
Disabled: No description available. ,
Inactive: No description available. ,
Stopped: No description available. ,
Unmonitored: No description available. ,
}
,
Required: False ,
}
enum ,
minChildEndpoints:
{
Description: The minimum number of endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
minChildEndpointsIPv4:
{
Description: The minimum number of IPv4 (DNS record type A) endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
minChildEndpointsIPv6:
{
Description: The minimum number of IPv6 (DNS record type AAAA) endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
geoMapping:
{
Description: The list of countries/regions mapped to this endpoint when using the 'Geographic' traffic routing method. Please consult Traffic Manager Geographic documentation for a full list of accepted values. ,
Required: False ,
}
[
string ,
]
,
subnets:
{
Description: The list of subnets, IP addresses, and/or address ranges mapped to this endpoint when using the 'Subnet' traffic routing method. An empty list will match all ranges not covered by other endpoints. ,
Required: False ,
}
[
{
first:
{
Description: First address in the subnet. ,
Required: False ,
}
string ,
last:
{
Description: Last address in the subnet. ,
Required: False ,
}
string ,
scope:
{
Description: Block size (number of leading bits in the subnet mask). ,
Required: False ,
}
integer ,
}
,
]
,
customHeaders:
{
Description: List of custom headers. ,
Required: False ,
}
[
{
name:
{
Description: Header name. ,
Required: False ,
}
string ,
value:
{
Description: Header value. ,
Required: False ,
}
string ,
}
,
]
,
alwaysServe:
{
Description: If Always Serve is enabled, probing for endpoint health will be disabled and endpoints will be included in the traffic routing method. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The content of the error. ,
Required: False ,
}
{
code:
{
Description: Error code ,
Required: False ,
}
string ,
message:
{
Description: Error message ,
Required: False ,
}
string ,
target:
{
Description: Error target ,
Required: False ,
}
string ,
details:
{
Description: Error details ,
Required: False ,
}
[
string ,
]
,
}
,
}
Endpoints_CreateOrUpdate (new)
Description :  Create or update a Traffic Manager endpoint.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficmanagerprofiles/{profileName}/{endpointType}/{endpointName}
{
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
profileName:
{
Description: The name of the Traffic Manager profile. ,
Required: True ,
}
string ,
endpointType:
{
Description: The type of the Traffic Manager endpoint to be created or updated. ,
Required: True ,
}
string ,
endpointName:
{
Description: The name of the Traffic Manager endpoint to be created or updated. ,
Required: True ,
}
string ,
parameters:
{
Description: The Traffic Manager endpoint parameters supplied to the CreateOrUpdate operation. ,
Required: True ,
}
{
properties:
{
Description: The properties of the Traffic Manager endpoint. ,
Required: False ,
}
{
targetResourceId:
{
Description: The Azure Resource URI of the of the endpoint. Not applicable to endpoints of type 'ExternalEndpoints'. ,
Required: False ,
}
string ,
target:
{
Description: The fully-qualified DNS name or IP address of the endpoint. Traffic Manager returns this value in DNS responses to direct traffic to this endpoint. ,
Required: False ,
}
string ,
endpointStatus:
{
Description: The status of the endpoint. If the endpoint is Enabled, it is probed for endpoint health and is included in the traffic routing method. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
weight:
{
Description: The weight of this endpoint when using the 'Weighted' traffic routing method. Possible values are from 1 to 1000. ,
Format: int64 ,
Required: False ,
}
integer ,
priority:
{
Description: The priority of this endpoint when using the 'Priority' traffic routing method. Possible values are from 1 to 1000, lower values represent higher priority. This is an optional parameter. If specified, it must be specified on all endpoints, and no two endpoints can share the same priority value. ,
Format: int64 ,
Required: False ,
}
integer ,
endpointLocation:
{
Description: Specifies the location of the external or nested endpoints when using the 'Performance' traffic routing method. ,
Required: False ,
}
string ,
endpointMonitorStatus:
{
Description: The monitoring status of the endpoint. ,
Enum:
{
CheckingEndpoint: No description available. ,
Online: No description available. ,
Degraded: No description available. ,
Disabled: No description available. ,
Inactive: No description available. ,
Stopped: No description available. ,
Unmonitored: No description available. ,
}
,
Required: False ,
}
enum ,
minChildEndpoints:
{
Description: The minimum number of endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
minChildEndpointsIPv4:
{
Description: The minimum number of IPv4 (DNS record type A) endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
minChildEndpointsIPv6:
{
Description: The minimum number of IPv6 (DNS record type AAAA) endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
geoMapping:
{
Description: The list of countries/regions mapped to this endpoint when using the 'Geographic' traffic routing method. Please consult Traffic Manager Geographic documentation for a full list of accepted values. ,
Required: False ,
}
[
string ,
]
,
subnets:
{
Description: The list of subnets, IP addresses, and/or address ranges mapped to this endpoint when using the 'Subnet' traffic routing method. An empty list will match all ranges not covered by other endpoints. ,
Required: False ,
}
[
{
first:
{
Description: First address in the subnet. ,
Required: False ,
}
string ,
last:
{
Description: Last address in the subnet. ,
Required: False ,
}
string ,
scope:
{
Description: Block size (number of leading bits in the subnet mask). ,
Required: False ,
}
integer ,
}
,
]
,
customHeaders:
{
Description: List of custom headers. ,
Required: False ,
}
[
{
name:
{
Description: Header name. ,
Required: False ,
}
string ,
value:
{
Description: Header value. ,
Required: False ,
}
string ,
}
,
]
,
alwaysServe:
{
Description: If Always Serve is enabled, probing for endpoint health will be disabled and endpoints will be included in the traffic routing method. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The properties of the Traffic Manager endpoint. ,
Required: False ,
}
{
targetResourceId:
{
Description: The Azure Resource URI of the of the endpoint. Not applicable to endpoints of type 'ExternalEndpoints'. ,
Required: False ,
}
string ,
target:
{
Description: The fully-qualified DNS name or IP address of the endpoint. Traffic Manager returns this value in DNS responses to direct traffic to this endpoint. ,
Required: False ,
}
string ,
endpointStatus:
{
Description: The status of the endpoint. If the endpoint is Enabled, it is probed for endpoint health and is included in the traffic routing method. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
weight:
{
Description: The weight of this endpoint when using the 'Weighted' traffic routing method. Possible values are from 1 to 1000. ,
Format: int64 ,
Required: False ,
}
integer ,
priority:
{
Description: The priority of this endpoint when using the 'Priority' traffic routing method. Possible values are from 1 to 1000, lower values represent higher priority. This is an optional parameter. If specified, it must be specified on all endpoints, and no two endpoints can share the same priority value. ,
Format: int64 ,
Required: False ,
}
integer ,
endpointLocation:
{
Description: Specifies the location of the external or nested endpoints when using the 'Performance' traffic routing method. ,
Required: False ,
}
string ,
endpointMonitorStatus:
{
Description: The monitoring status of the endpoint. ,
Enum:
{
CheckingEndpoint: No description available. ,
Online: No description available. ,
Degraded: No description available. ,
Disabled: No description available. ,
Inactive: No description available. ,
Stopped: No description available. ,
Unmonitored: No description available. ,
}
,
Required: False ,
}
enum ,
minChildEndpoints:
{
Description: The minimum number of endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
minChildEndpointsIPv4:
{
Description: The minimum number of IPv4 (DNS record type A) endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
minChildEndpointsIPv6:
{
Description: The minimum number of IPv6 (DNS record type AAAA) endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
geoMapping:
{
Description: The list of countries/regions mapped to this endpoint when using the 'Geographic' traffic routing method. Please consult Traffic Manager Geographic documentation for a full list of accepted values. ,
Required: False ,
}
[
string ,
]
,
subnets:
{
Description: The list of subnets, IP addresses, and/or address ranges mapped to this endpoint when using the 'Subnet' traffic routing method. An empty list will match all ranges not covered by other endpoints. ,
Required: False ,
}
[
{
first:
{
Description: First address in the subnet. ,
Required: False ,
}
string ,
last:
{
Description: Last address in the subnet. ,
Required: False ,
}
string ,
scope:
{
Description: Block size (number of leading bits in the subnet mask). ,
Required: False ,
}
integer ,
}
,
]
,
customHeaders:
{
Description: List of custom headers. ,
Required: False ,
}
[
{
name:
{
Description: Header name. ,
Required: False ,
}
string ,
value:
{
Description: Header value. ,
Required: False ,
}
string ,
}
,
]
,
alwaysServe:
{
Description: If Always Serve is enabled, probing for endpoint health will be disabled and endpoints will be included in the traffic routing method. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (201)

{
properties:
{
Description: The properties of the Traffic Manager endpoint. ,
Required: False ,
}
{
targetResourceId:
{
Description: The Azure Resource URI of the of the endpoint. Not applicable to endpoints of type 'ExternalEndpoints'. ,
Required: False ,
}
string ,
target:
{
Description: The fully-qualified DNS name or IP address of the endpoint. Traffic Manager returns this value in DNS responses to direct traffic to this endpoint. ,
Required: False ,
}
string ,
endpointStatus:
{
Description: The status of the endpoint. If the endpoint is Enabled, it is probed for endpoint health and is included in the traffic routing method. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
weight:
{
Description: The weight of this endpoint when using the 'Weighted' traffic routing method. Possible values are from 1 to 1000. ,
Format: int64 ,
Required: False ,
}
integer ,
priority:
{
Description: The priority of this endpoint when using the 'Priority' traffic routing method. Possible values are from 1 to 1000, lower values represent higher priority. This is an optional parameter. If specified, it must be specified on all endpoints, and no two endpoints can share the same priority value. ,
Format: int64 ,
Required: False ,
}
integer ,
endpointLocation:
{
Description: Specifies the location of the external or nested endpoints when using the 'Performance' traffic routing method. ,
Required: False ,
}
string ,
endpointMonitorStatus:
{
Description: The monitoring status of the endpoint. ,
Enum:
{
CheckingEndpoint: No description available. ,
Online: No description available. ,
Degraded: No description available. ,
Disabled: No description available. ,
Inactive: No description available. ,
Stopped: No description available. ,
Unmonitored: No description available. ,
}
,
Required: False ,
}
enum ,
minChildEndpoints:
{
Description: The minimum number of endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
minChildEndpointsIPv4:
{
Description: The minimum number of IPv4 (DNS record type A) endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
minChildEndpointsIPv6:
{
Description: The minimum number of IPv6 (DNS record type AAAA) endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
geoMapping:
{
Description: The list of countries/regions mapped to this endpoint when using the 'Geographic' traffic routing method. Please consult Traffic Manager Geographic documentation for a full list of accepted values. ,
Required: False ,
}
[
string ,
]
,
subnets:
{
Description: The list of subnets, IP addresses, and/or address ranges mapped to this endpoint when using the 'Subnet' traffic routing method. An empty list will match all ranges not covered by other endpoints. ,
Required: False ,
}
[
{
first:
{
Description: First address in the subnet. ,
Required: False ,
}
string ,
last:
{
Description: Last address in the subnet. ,
Required: False ,
}
string ,
scope:
{
Description: Block size (number of leading bits in the subnet mask). ,
Required: False ,
}
integer ,
}
,
]
,
customHeaders:
{
Description: List of custom headers. ,
Required: False ,
}
[
{
name:
{
Description: Header name. ,
Required: False ,
}
string ,
value:
{
Description: Header value. ,
Required: False ,
}
string ,
}
,
]
,
alwaysServe:
{
Description: If Always Serve is enabled, probing for endpoint health will be disabled and endpoints will be included in the traffic routing method. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The content of the error. ,
Required: False ,
}
{
code:
{
Description: Error code ,
Required: False ,
}
string ,
message:
{
Description: Error message ,
Required: False ,
}
string ,
target:
{
Description: Error target ,
Required: False ,
}
string ,
details:
{
Description: Error details ,
Required: False ,
}
[
string ,
]
,
}
,
}
Endpoints_Delete (new)
Description :  Deletes a Traffic Manager endpoint.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficmanagerprofiles/{profileName}/{endpointType}/{endpointName}
{
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
profileName:
{
Description: The name of the Traffic Manager profile. ,
Required: True ,
}
string ,
endpointType:
{
Description: The type of the Traffic Manager endpoint to be deleted. ,
Required: True ,
}
string ,
endpointName:
{
Description: The name of the Traffic Manager endpoint to be deleted. ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
boolean:
{
Description: The result of the operation or request. ,
Required: False ,
}
boolean ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The content of the error. ,
Required: False ,
}
{
code:
{
Description: Error code ,
Required: False ,
}
string ,
message:
{
Description: Error message ,
Required: False ,
}
string ,
target:
{
Description: Error target ,
Required: False ,
}
string ,
details:
{
Description: Error details ,
Required: False ,
}
[
string ,
]
,
}
,
}
Profiles_CheckTrafficManagerRelativeDnsNameAvailability (new)
Description :  Checks the availability of a Traffic Manager Relative DNS name.
Reference :  Link ¶

⚼ Request

POST:  /providers/Microsoft.Network/checkTrafficManagerNameAvailability
{
parameters:
{
Description: The Traffic Manager name parameters supplied to the CheckTrafficManagerNameAvailability operation. ,
Required: True ,
}
{
name:
{
Description: The name of the resource. ,
Required: False ,
}
string ,
type:
{
Description: The type of the resource. ,
Required: False ,
}
string ,
}
,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
name:
{
Description: The relative name. ,
Required: False ,
}
string ,
type:
{
Description: Traffic Manager profile resource type. ,
Required: False ,
}
string ,
nameAvailable:
{
Description: Describes whether the relative name is available or not. ,
Required: False ,
}
boolean ,
reason:
{
Description: The reason why the name is not available, when applicable. ,
Required: False ,
}
string ,
message:
{
Description: Descriptive message that explains why the name is not available, when applicable. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The content of the error. ,
Required: False ,
}
{
code:
{
Description: Error code ,
Required: False ,
}
string ,
message:
{
Description: Error message ,
Required: False ,
}
string ,
target:
{
Description: Error target ,
Required: False ,
}
string ,
details:
{
Description: Error details ,
Required: False ,
}
[
string ,
]
,
}
,
}
Profiles_checkTrafficManagerNameAvailabilityV2 (new)
Description :  Checks the availability of a Traffic Manager Relative DNS name.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/providers/Microsoft.Network/checkTrafficManagerNameAvailabilityV2
{
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
parameters:
{
Description: The Traffic Manager name parameters supplied to the CheckTrafficManagerNameAvailability operation. ,
Required: True ,
}
{
name:
{
Description: The name of the resource. ,
Required: False ,
}
string ,
type:
{
Description: The type of the resource. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
name:
{
Description: The relative name. ,
Required: False ,
}
string ,
type:
{
Description: Traffic Manager profile resource type. ,
Required: False ,
}
string ,
nameAvailable:
{
Description: Describes whether the relative name is available or not. ,
Required: False ,
}
boolean ,
reason:
{
Description: The reason why the name is not available, when applicable. ,
Required: False ,
}
string ,
message:
{
Description: Descriptive message that explains why the name is not available, when applicable. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The content of the error. ,
Required: False ,
}
{
code:
{
Description: Error code ,
Required: False ,
}
string ,
message:
{
Description: Error message ,
Required: False ,
}
string ,
target:
{
Description: Error target ,
Required: False ,
}
string ,
details:
{
Description: Error details ,
Required: False ,
}
[
string ,
]
,
}
,
}
Profiles_ListByResourceGroup (new)
Description :  Lists all Traffic Manager profiles within a resource group.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficmanagerprofiles
{
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Gets the list of Traffic manager profiles. ,
Required: False ,
}
[
{
properties:
{
Description: The properties of the Traffic Manager profile. ,
Required: False ,
}
{
profileStatus:
{
Description: The status of the Traffic Manager profile. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
trafficRoutingMethod:
{
Description: The traffic routing method of the Traffic Manager profile. ,
Enum:
{
Performance: No description available. ,
Priority: No description available. ,
Weighted: No description available. ,
Geographic: No description available. ,
MultiValue: No description available. ,
Subnet: No description available. ,
}
,
Required: False ,
}
enum ,
dnsConfig:
{
Description: The DNS settings of the Traffic Manager profile. ,
Required: False ,
}
{
relativeName:
{
Description: The relative DNS name provided by this Traffic Manager profile. This value is combined with the DNS domain name used by Azure Traffic Manager to form the fully-qualified domain name (FQDN) of the profile. ,
Required: False ,
}
string ,
fqdn:
{
Description: The fully-qualified domain name (FQDN) of the Traffic Manager profile. This is formed from the concatenation of the RelativeName with the DNS domain used by Azure Traffic Manager. ,
Required: False ,
}
string ,
ttl:
{
Description: The DNS Time-To-Live (TTL), in seconds. This informs the local DNS resolvers and DNS clients how long to cache DNS responses provided by this Traffic Manager profile. ,
Format: int64 ,
Required: False ,
}
integer ,
}
,
monitorConfig:
{
Description: The endpoint monitoring settings of the Traffic Manager profile. ,
Required: False ,
}
{
profileMonitorStatus:
{
Description: The profile-level monitoring status of the Traffic Manager profile. ,
Enum:
{
CheckingEndpoints: No description available. ,
Online: No description available. ,
Degraded: No description available. ,
Disabled: No description available. ,
Inactive: No description available. ,
}
,
Required: False ,
}
enum ,
protocol:
{
Description: The protocol (HTTP, HTTPS or TCP) used to probe for endpoint health. ,
Enum:
{
HTTP: No description available. ,
HTTPS: No description available. ,
TCP: No description available. ,
}
,
Required: False ,
}
enum ,
port:
{
Description: The TCP port used to probe for endpoint health. ,
Format: int64 ,
Required: False ,
}
integer ,
path:
{
Description: The path relative to the endpoint domain name used to probe for endpoint health. ,
Required: False ,
}
string ,
intervalInSeconds:
{
Description: The monitor interval for endpoints in this profile. This is the interval at which Traffic Manager will check the health of each endpoint in this profile. ,
Format: int64 ,
Required: False ,
}
integer ,
timeoutInSeconds:
{
Description: The monitor timeout for endpoints in this profile. This is the time that Traffic Manager allows endpoints in this profile to response to the health check. ,
Format: int64 ,
Required: False ,
}
integer ,
toleratedNumberOfFailures:
{
Description: The number of consecutive failed health check that Traffic Manager tolerates before declaring an endpoint in this profile Degraded after the next failed health check. ,
Format: int64 ,
Required: False ,
}
integer ,
customHeaders:
{
Description: List of custom headers. ,
Required: False ,
}
[
{
name:
{
Description: Header name. ,
Required: False ,
}
string ,
value:
{
Description: Header value. ,
Required: False ,
}
string ,
}
,
]
,
expectedStatusCodeRanges:
{
Description: List of expected status code ranges. ,
Required: False ,
}
[
{
min:
{
Description: Min status code. ,
Required: False ,
}
integer ,
max:
{
Description: Max status code. ,
Required: False ,
}
integer ,
}
,
]
,
}
,
endpoints:
{
Description: The list of endpoints in the Traffic Manager profile. ,
Required: False ,
}
[
{
properties:
{
Description: The properties of the Traffic Manager endpoint. ,
Required: False ,
}
{
targetResourceId:
{
Description: The Azure Resource URI of the of the endpoint. Not applicable to endpoints of type 'ExternalEndpoints'. ,
Required: False ,
}
string ,
target:
{
Description: The fully-qualified DNS name or IP address of the endpoint. Traffic Manager returns this value in DNS responses to direct traffic to this endpoint. ,
Required: False ,
}
string ,
endpointStatus:
{
Description: The status of the endpoint. If the endpoint is Enabled, it is probed for endpoint health and is included in the traffic routing method. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
weight:
{
Description: The weight of this endpoint when using the 'Weighted' traffic routing method. Possible values are from 1 to 1000. ,
Format: int64 ,
Required: False ,
}
integer ,
priority:
{
Description: The priority of this endpoint when using the 'Priority' traffic routing method. Possible values are from 1 to 1000, lower values represent higher priority. This is an optional parameter. If specified, it must be specified on all endpoints, and no two endpoints can share the same priority value. ,
Format: int64 ,
Required: False ,
}
integer ,
endpointLocation:
{
Description: Specifies the location of the external or nested endpoints when using the 'Performance' traffic routing method. ,
Required: False ,
}
string ,
endpointMonitorStatus:
{
Description: The monitoring status of the endpoint. ,
Enum:
{
CheckingEndpoint: No description available. ,
Online: No description available. ,
Degraded: No description available. ,
Disabled: No description available. ,
Inactive: No description available. ,
Stopped: No description available. ,
Unmonitored: No description available. ,
}
,
Required: False ,
}
enum ,
minChildEndpoints:
{
Description: The minimum number of endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
minChildEndpointsIPv4:
{
Description: The minimum number of IPv4 (DNS record type A) endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
minChildEndpointsIPv6:
{
Description: The minimum number of IPv6 (DNS record type AAAA) endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
geoMapping:
{
Description: The list of countries/regions mapped to this endpoint when using the 'Geographic' traffic routing method. Please consult Traffic Manager Geographic documentation for a full list of accepted values. ,
Required: False ,
}
[
string ,
]
,
subnets:
{
Description: The list of subnets, IP addresses, and/or address ranges mapped to this endpoint when using the 'Subnet' traffic routing method. An empty list will match all ranges not covered by other endpoints. ,
Required: False ,
}
[
{
first:
{
Description: First address in the subnet. ,
Required: False ,
}
string ,
last:
{
Description: Last address in the subnet. ,
Required: False ,
}
string ,
scope:
{
Description: Block size (number of leading bits in the subnet mask). ,
Required: False ,
}
integer ,
}
,
]
,
customHeaders:
{
Description: List of custom headers. ,
Required: False ,
}
[
{
name:
{
Description: Header name. ,
Required: False ,
}
string ,
value:
{
Description: Header value. ,
Required: False ,
}
string ,
}
,
]
,
alwaysServe:
{
Description: If Always Serve is enabled, probing for endpoint health will be disabled and endpoints will be included in the traffic routing method. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
trafficViewEnrollmentStatus:
{
Description: Indicates whether Traffic View is 'Enabled' or 'Disabled' for the Traffic Manager profile. Null, indicates 'Disabled'. Enabling this feature will increase the cost of the Traffic Manage profile. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
allowedEndpointRecordTypes:
{
Description: The list of allowed endpoint record types. ,
Required: False ,
}
[
string ,
]
,
maxReturn:
{
Description: Maximum number of endpoints to be returned for MultiValue routing type. ,
Format: int64 ,
Required: False ,
}
integer ,
recordType:
{
Description: When record type is set, a traffic manager profile will allow only endpoints that match this type. ,
Enum:
{
A: No description available. ,
AAAA: No description available. ,
CNAME: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Description: The content of the error. ,
Required: False ,
}
{
code:
{
Description: Error code ,
Required: False ,
}
string ,
message:
{
Description: Error message ,
Required: False ,
}
string ,
target:
{
Description: Error target ,
Required: False ,
}
string ,
details:
{
Description: Error details ,
Required: False ,
}
[
string ,
]
,
}
,
}
Profiles_ListBySubscription (new)
Description :  Lists all Traffic Manager profiles within a subscription.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.Network/trafficmanagerprofiles
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Gets the list of Traffic manager profiles. ,
Required: False ,
}
[
{
properties:
{
Description: The properties of the Traffic Manager profile. ,
Required: False ,
}
{
profileStatus:
{
Description: The status of the Traffic Manager profile. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
trafficRoutingMethod:
{
Description: The traffic routing method of the Traffic Manager profile. ,
Enum:
{
Performance: No description available. ,
Priority: No description available. ,
Weighted: No description available. ,
Geographic: No description available. ,
MultiValue: No description available. ,
Subnet: No description available. ,
}
,
Required: False ,
}
enum ,
dnsConfig:
{
Description: The DNS settings of the Traffic Manager profile. ,
Required: False ,
}
{
relativeName:
{
Description: The relative DNS name provided by this Traffic Manager profile. This value is combined with the DNS domain name used by Azure Traffic Manager to form the fully-qualified domain name (FQDN) of the profile. ,
Required: False ,
}
string ,
fqdn:
{
Description: The fully-qualified domain name (FQDN) of the Traffic Manager profile. This is formed from the concatenation of the RelativeName with the DNS domain used by Azure Traffic Manager. ,
Required: False ,
}
string ,
ttl:
{
Description: The DNS Time-To-Live (TTL), in seconds. This informs the local DNS resolvers and DNS clients how long to cache DNS responses provided by this Traffic Manager profile. ,
Format: int64 ,
Required: False ,
}
integer ,
}
,
monitorConfig:
{
Description: The endpoint monitoring settings of the Traffic Manager profile. ,
Required: False ,
}
{
profileMonitorStatus:
{
Description: The profile-level monitoring status of the Traffic Manager profile. ,
Enum:
{
CheckingEndpoints: No description available. ,
Online: No description available. ,
Degraded: No description available. ,
Disabled: No description available. ,
Inactive: No description available. ,
}
,
Required: False ,
}
enum ,
protocol:
{
Description: The protocol (HTTP, HTTPS or TCP) used to probe for endpoint health. ,
Enum:
{
HTTP: No description available. ,
HTTPS: No description available. ,
TCP: No description available. ,
}
,
Required: False ,
}
enum ,
port:
{
Description: The TCP port used to probe for endpoint health. ,
Format: int64 ,
Required: False ,
}
integer ,
path:
{
Description: The path relative to the endpoint domain name used to probe for endpoint health. ,
Required: False ,
}
string ,
intervalInSeconds:
{
Description: The monitor interval for endpoints in this profile. This is the interval at which Traffic Manager will check the health of each endpoint in this profile. ,
Format: int64 ,
Required: False ,
}
integer ,
timeoutInSeconds:
{
Description: The monitor timeout for endpoints in this profile. This is the time that Traffic Manager allows endpoints in this profile to response to the health check. ,
Format: int64 ,
Required: False ,
}
integer ,
toleratedNumberOfFailures:
{
Description: The number of consecutive failed health check that Traffic Manager tolerates before declaring an endpoint in this profile Degraded after the next failed health check. ,
Format: int64 ,
Required: False ,
}
integer ,
customHeaders:
{
Description: List of custom headers. ,
Required: False ,
}
[
{
name:
{
Description: Header name. ,
Required: False ,
}
string ,
value:
{
Description: Header value. ,
Required: False ,
}
string ,
}
,
]
,
expectedStatusCodeRanges:
{
Description: List of expected status code ranges. ,
Required: False ,
}
[
{
min:
{
Description: Min status code. ,
Required: False ,
}
integer ,
max:
{
Description: Max status code. ,
Required: False ,
}
integer ,
}
,
]
,
}
,
endpoints:
{
Description: The list of endpoints in the Traffic Manager profile. ,
Required: False ,
}
[
{
properties:
{
Description: The properties of the Traffic Manager endpoint. ,
Required: False ,
}
{
targetResourceId:
{
Description: The Azure Resource URI of the of the endpoint. Not applicable to endpoints of type 'ExternalEndpoints'. ,
Required: False ,
}
string ,
target:
{
Description: The fully-qualified DNS name or IP address of the endpoint. Traffic Manager returns this value in DNS responses to direct traffic to this endpoint. ,
Required: False ,
}
string ,
endpointStatus:
{
Description: The status of the endpoint. If the endpoint is Enabled, it is probed for endpoint health and is included in the traffic routing method. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
weight:
{
Description: The weight of this endpoint when using the 'Weighted' traffic routing method. Possible values are from 1 to 1000. ,
Format: int64 ,
Required: False ,
}
integer ,
priority:
{
Description: The priority of this endpoint when using the 'Priority' traffic routing method. Possible values are from 1 to 1000, lower values represent higher priority. This is an optional parameter. If specified, it must be specified on all endpoints, and no two endpoints can share the same priority value. ,
Format: int64 ,
Required: False ,
}
integer ,
endpointLocation:
{
Description: Specifies the location of the external or nested endpoints when using the 'Performance' traffic routing method. ,
Required: False ,
}
string ,
endpointMonitorStatus:
{
Description: The monitoring status of the endpoint. ,
Enum:
{
CheckingEndpoint: No description available. ,
Online: No description available. ,
Degraded: No description available. ,
Disabled: No description available. ,
Inactive: No description available. ,
Stopped: No description available. ,
Unmonitored: No description available. ,
}
,
Required: False ,
}
enum ,
minChildEndpoints:
{
Description: The minimum number of endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
minChildEndpointsIPv4:
{
Description: The minimum number of IPv4 (DNS record type A) endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
minChildEndpointsIPv6:
{
Description: The minimum number of IPv6 (DNS record type AAAA) endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
geoMapping:
{
Description: The list of countries/regions mapped to this endpoint when using the 'Geographic' traffic routing method. Please consult Traffic Manager Geographic documentation for a full list of accepted values. ,
Required: False ,
}
[
string ,
]
,
subnets:
{
Description: The list of subnets, IP addresses, and/or address ranges mapped to this endpoint when using the 'Subnet' traffic routing method. An empty list will match all ranges not covered by other endpoints. ,
Required: False ,
}
[
{
first:
{
Description: First address in the subnet. ,
Required: False ,
}
string ,
last:
{
Description: Last address in the subnet. ,
Required: False ,
}
string ,
scope:
{
Description: Block size (number of leading bits in the subnet mask). ,
Required: False ,
}
integer ,
}
,
]
,
customHeaders:
{
Description: List of custom headers. ,
Required: False ,
}
[
{
name:
{
Description: Header name. ,
Required: False ,
}
string ,
value:
{
Description: Header value. ,
Required: False ,
}
string ,
}
,
]
,
alwaysServe:
{
Description: If Always Serve is enabled, probing for endpoint health will be disabled and endpoints will be included in the traffic routing method. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
trafficViewEnrollmentStatus:
{
Description: Indicates whether Traffic View is 'Enabled' or 'Disabled' for the Traffic Manager profile. Null, indicates 'Disabled'. Enabling this feature will increase the cost of the Traffic Manage profile. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
allowedEndpointRecordTypes:
{
Description: The list of allowed endpoint record types. ,
Required: False ,
}
[
string ,
]
,
maxReturn:
{
Description: Maximum number of endpoints to be returned for MultiValue routing type. ,
Format: int64 ,
Required: False ,
}
integer ,
recordType:
{
Description: When record type is set, a traffic manager profile will allow only endpoints that match this type. ,
Enum:
{
A: No description available. ,
AAAA: No description available. ,
CNAME: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Description: The content of the error. ,
Required: False ,
}
{
code:
{
Description: Error code ,
Required: False ,
}
string ,
message:
{
Description: Error message ,
Required: False ,
}
string ,
target:
{
Description: Error target ,
Required: False ,
}
string ,
details:
{
Description: Error details ,
Required: False ,
}
[
string ,
]
,
}
,
}
Profiles_Get (new)
Description :  Gets a Traffic Manager profile.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficmanagerprofiles/{profileName}
{
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
profileName:
{
Description: The name of the Traffic Manager profile. ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The properties of the Traffic Manager profile. ,
Required: False ,
}
{
profileStatus:
{
Description: The status of the Traffic Manager profile. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
trafficRoutingMethod:
{
Description: The traffic routing method of the Traffic Manager profile. ,
Enum:
{
Performance: No description available. ,
Priority: No description available. ,
Weighted: No description available. ,
Geographic: No description available. ,
MultiValue: No description available. ,
Subnet: No description available. ,
}
,
Required: False ,
}
enum ,
dnsConfig:
{
Description: The DNS settings of the Traffic Manager profile. ,
Required: False ,
}
{
relativeName:
{
Description: The relative DNS name provided by this Traffic Manager profile. This value is combined with the DNS domain name used by Azure Traffic Manager to form the fully-qualified domain name (FQDN) of the profile. ,
Required: False ,
}
string ,
fqdn:
{
Description: The fully-qualified domain name (FQDN) of the Traffic Manager profile. This is formed from the concatenation of the RelativeName with the DNS domain used by Azure Traffic Manager. ,
Required: False ,
}
string ,
ttl:
{
Description: The DNS Time-To-Live (TTL), in seconds. This informs the local DNS resolvers and DNS clients how long to cache DNS responses provided by this Traffic Manager profile. ,
Format: int64 ,
Required: False ,
}
integer ,
}
,
monitorConfig:
{
Description: The endpoint monitoring settings of the Traffic Manager profile. ,
Required: False ,
}
{
profileMonitorStatus:
{
Description: The profile-level monitoring status of the Traffic Manager profile. ,
Enum:
{
CheckingEndpoints: No description available. ,
Online: No description available. ,
Degraded: No description available. ,
Disabled: No description available. ,
Inactive: No description available. ,
}
,
Required: False ,
}
enum ,
protocol:
{
Description: The protocol (HTTP, HTTPS or TCP) used to probe for endpoint health. ,
Enum:
{
HTTP: No description available. ,
HTTPS: No description available. ,
TCP: No description available. ,
}
,
Required: False ,
}
enum ,
port:
{
Description: The TCP port used to probe for endpoint health. ,
Format: int64 ,
Required: False ,
}
integer ,
path:
{
Description: The path relative to the endpoint domain name used to probe for endpoint health. ,
Required: False ,
}
string ,
intervalInSeconds:
{
Description: The monitor interval for endpoints in this profile. This is the interval at which Traffic Manager will check the health of each endpoint in this profile. ,
Format: int64 ,
Required: False ,
}
integer ,
timeoutInSeconds:
{
Description: The monitor timeout for endpoints in this profile. This is the time that Traffic Manager allows endpoints in this profile to response to the health check. ,
Format: int64 ,
Required: False ,
}
integer ,
toleratedNumberOfFailures:
{
Description: The number of consecutive failed health check that Traffic Manager tolerates before declaring an endpoint in this profile Degraded after the next failed health check. ,
Format: int64 ,
Required: False ,
}
integer ,
customHeaders:
{
Description: List of custom headers. ,
Required: False ,
}
[
{
name:
{
Description: Header name. ,
Required: False ,
}
string ,
value:
{
Description: Header value. ,
Required: False ,
}
string ,
}
,
]
,
expectedStatusCodeRanges:
{
Description: List of expected status code ranges. ,
Required: False ,
}
[
{
min:
{
Description: Min status code. ,
Required: False ,
}
integer ,
max:
{
Description: Max status code. ,
Required: False ,
}
integer ,
}
,
]
,
}
,
endpoints:
{
Description: The list of endpoints in the Traffic Manager profile. ,
Required: False ,
}
[
{
properties:
{
Description: The properties of the Traffic Manager endpoint. ,
Required: False ,
}
{
targetResourceId:
{
Description: The Azure Resource URI of the of the endpoint. Not applicable to endpoints of type 'ExternalEndpoints'. ,
Required: False ,
}
string ,
target:
{
Description: The fully-qualified DNS name or IP address of the endpoint. Traffic Manager returns this value in DNS responses to direct traffic to this endpoint. ,
Required: False ,
}
string ,
endpointStatus:
{
Description: The status of the endpoint. If the endpoint is Enabled, it is probed for endpoint health and is included in the traffic routing method. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
weight:
{
Description: The weight of this endpoint when using the 'Weighted' traffic routing method. Possible values are from 1 to 1000. ,
Format: int64 ,
Required: False ,
}
integer ,
priority:
{
Description: The priority of this endpoint when using the 'Priority' traffic routing method. Possible values are from 1 to 1000, lower values represent higher priority. This is an optional parameter. If specified, it must be specified on all endpoints, and no two endpoints can share the same priority value. ,
Format: int64 ,
Required: False ,
}
integer ,
endpointLocation:
{
Description: Specifies the location of the external or nested endpoints when using the 'Performance' traffic routing method. ,
Required: False ,
}
string ,
endpointMonitorStatus:
{
Description: The monitoring status of the endpoint. ,
Enum:
{
CheckingEndpoint: No description available. ,
Online: No description available. ,
Degraded: No description available. ,
Disabled: No description available. ,
Inactive: No description available. ,
Stopped: No description available. ,
Unmonitored: No description available. ,
}
,
Required: False ,
}
enum ,
minChildEndpoints:
{
Description: The minimum number of endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
minChildEndpointsIPv4:
{
Description: The minimum number of IPv4 (DNS record type A) endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
minChildEndpointsIPv6:
{
Description: The minimum number of IPv6 (DNS record type AAAA) endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
geoMapping:
{
Description: The list of countries/regions mapped to this endpoint when using the 'Geographic' traffic routing method. Please consult Traffic Manager Geographic documentation for a full list of accepted values. ,
Required: False ,
}
[
string ,
]
,
subnets:
{
Description: The list of subnets, IP addresses, and/or address ranges mapped to this endpoint when using the 'Subnet' traffic routing method. An empty list will match all ranges not covered by other endpoints. ,
Required: False ,
}
[
{
first:
{
Description: First address in the subnet. ,
Required: False ,
}
string ,
last:
{
Description: Last address in the subnet. ,
Required: False ,
}
string ,
scope:
{
Description: Block size (number of leading bits in the subnet mask). ,
Required: False ,
}
integer ,
}
,
]
,
customHeaders:
{
Description: List of custom headers. ,
Required: False ,
}
[
{
name:
{
Description: Header name. ,
Required: False ,
}
string ,
value:
{
Description: Header value. ,
Required: False ,
}
string ,
}
,
]
,
alwaysServe:
{
Description: If Always Serve is enabled, probing for endpoint health will be disabled and endpoints will be included in the traffic routing method. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
trafficViewEnrollmentStatus:
{
Description: Indicates whether Traffic View is 'Enabled' or 'Disabled' for the Traffic Manager profile. Null, indicates 'Disabled'. Enabling this feature will increase the cost of the Traffic Manage profile. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
allowedEndpointRecordTypes:
{
Description: The list of allowed endpoint record types. ,
Required: False ,
}
[
string ,
]
,
maxReturn:
{
Description: Maximum number of endpoints to be returned for MultiValue routing type. ,
Format: int64 ,
Required: False ,
}
integer ,
recordType:
{
Description: When record type is set, a traffic manager profile will allow only endpoints that match this type. ,
Enum:
{
A: No description available. ,
AAAA: No description available. ,
CNAME: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The content of the error. ,
Required: False ,
}
{
code:
{
Description: Error code ,
Required: False ,
}
string ,
message:
{
Description: Error message ,
Required: False ,
}
string ,
target:
{
Description: Error target ,
Required: False ,
}
string ,
details:
{
Description: Error details ,
Required: False ,
}
[
string ,
]
,
}
,
}
Profiles_CreateOrUpdate (new)
Description :  Create or update a Traffic Manager profile.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficmanagerprofiles/{profileName}
{
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
profileName:
{
Description: The name of the Traffic Manager profile. ,
Required: True ,
}
string ,
parameters:
{
Description: The Traffic Manager profile parameters supplied to the CreateOrUpdate operation. ,
Required: True ,
}
{
properties:
{
Description: The properties of the Traffic Manager profile. ,
Required: False ,
}
{
profileStatus:
{
Description: The status of the Traffic Manager profile. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
trafficRoutingMethod:
{
Description: The traffic routing method of the Traffic Manager profile. ,
Enum:
{
Performance: No description available. ,
Priority: No description available. ,
Weighted: No description available. ,
Geographic: No description available. ,
MultiValue: No description available. ,
Subnet: No description available. ,
}
,
Required: False ,
}
enum ,
dnsConfig:
{
Description: The DNS settings of the Traffic Manager profile. ,
Required: False ,
}
{
relativeName:
{
Description: The relative DNS name provided by this Traffic Manager profile. This value is combined with the DNS domain name used by Azure Traffic Manager to form the fully-qualified domain name (FQDN) of the profile. ,
Required: False ,
}
string ,
fqdn:
{
Description: The fully-qualified domain name (FQDN) of the Traffic Manager profile. This is formed from the concatenation of the RelativeName with the DNS domain used by Azure Traffic Manager. ,
Required: False ,
}
string ,
ttl:
{
Description: The DNS Time-To-Live (TTL), in seconds. This informs the local DNS resolvers and DNS clients how long to cache DNS responses provided by this Traffic Manager profile. ,
Format: int64 ,
Required: False ,
}
integer ,
}
,
monitorConfig:
{
Description: The endpoint monitoring settings of the Traffic Manager profile. ,
Required: False ,
}
{
profileMonitorStatus:
{
Description: The profile-level monitoring status of the Traffic Manager profile. ,
Enum:
{
CheckingEndpoints: No description available. ,
Online: No description available. ,
Degraded: No description available. ,
Disabled: No description available. ,
Inactive: No description available. ,
}
,
Required: False ,
}
enum ,
protocol:
{
Description: The protocol (HTTP, HTTPS or TCP) used to probe for endpoint health. ,
Enum:
{
HTTP: No description available. ,
HTTPS: No description available. ,
TCP: No description available. ,
}
,
Required: False ,
}
enum ,
port:
{
Description: The TCP port used to probe for endpoint health. ,
Format: int64 ,
Required: False ,
}
integer ,
path:
{
Description: The path relative to the endpoint domain name used to probe for endpoint health. ,
Required: False ,
}
string ,
intervalInSeconds:
{
Description: The monitor interval for endpoints in this profile. This is the interval at which Traffic Manager will check the health of each endpoint in this profile. ,
Format: int64 ,
Required: False ,
}
integer ,
timeoutInSeconds:
{
Description: The monitor timeout for endpoints in this profile. This is the time that Traffic Manager allows endpoints in this profile to response to the health check. ,
Format: int64 ,
Required: False ,
}
integer ,
toleratedNumberOfFailures:
{
Description: The number of consecutive failed health check that Traffic Manager tolerates before declaring an endpoint in this profile Degraded after the next failed health check. ,
Format: int64 ,
Required: False ,
}
integer ,
customHeaders:
{
Description: List of custom headers. ,
Required: False ,
}
[
{
name:
{
Description: Header name. ,
Required: False ,
}
string ,
value:
{
Description: Header value. ,
Required: False ,
}
string ,
}
,
]
,
expectedStatusCodeRanges:
{
Description: List of expected status code ranges. ,
Required: False ,
}
[
{
min:
{
Description: Min status code. ,
Required: False ,
}
integer ,
max:
{
Description: Max status code. ,
Required: False ,
}
integer ,
}
,
]
,
}
,
endpoints:
{
Description: The list of endpoints in the Traffic Manager profile. ,
Required: False ,
}
[
{
properties:
{
Description: The properties of the Traffic Manager endpoint. ,
Required: False ,
}
{
targetResourceId:
{
Description: The Azure Resource URI of the of the endpoint. Not applicable to endpoints of type 'ExternalEndpoints'. ,
Required: False ,
}
string ,
target:
{
Description: The fully-qualified DNS name or IP address of the endpoint. Traffic Manager returns this value in DNS responses to direct traffic to this endpoint. ,
Required: False ,
}
string ,
endpointStatus:
{
Description: The status of the endpoint. If the endpoint is Enabled, it is probed for endpoint health and is included in the traffic routing method. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
weight:
{
Description: The weight of this endpoint when using the 'Weighted' traffic routing method. Possible values are from 1 to 1000. ,
Format: int64 ,
Required: False ,
}
integer ,
priority:
{
Description: The priority of this endpoint when using the 'Priority' traffic routing method. Possible values are from 1 to 1000, lower values represent higher priority. This is an optional parameter. If specified, it must be specified on all endpoints, and no two endpoints can share the same priority value. ,
Format: int64 ,
Required: False ,
}
integer ,
endpointLocation:
{
Description: Specifies the location of the external or nested endpoints when using the 'Performance' traffic routing method. ,
Required: False ,
}
string ,
endpointMonitorStatus:
{
Description: The monitoring status of the endpoint. ,
Enum:
{
CheckingEndpoint: No description available. ,
Online: No description available. ,
Degraded: No description available. ,
Disabled: No description available. ,
Inactive: No description available. ,
Stopped: No description available. ,
Unmonitored: No description available. ,
}
,
Required: False ,
}
enum ,
minChildEndpoints:
{
Description: The minimum number of endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
minChildEndpointsIPv4:
{
Description: The minimum number of IPv4 (DNS record type A) endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
minChildEndpointsIPv6:
{
Description: The minimum number of IPv6 (DNS record type AAAA) endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
geoMapping:
{
Description: The list of countries/regions mapped to this endpoint when using the 'Geographic' traffic routing method. Please consult Traffic Manager Geographic documentation for a full list of accepted values. ,
Required: False ,
}
[
string ,
]
,
subnets:
{
Description: The list of subnets, IP addresses, and/or address ranges mapped to this endpoint when using the 'Subnet' traffic routing method. An empty list will match all ranges not covered by other endpoints. ,
Required: False ,
}
[
{
first:
{
Description: First address in the subnet. ,
Required: False ,
}
string ,
last:
{
Description: Last address in the subnet. ,
Required: False ,
}
string ,
scope:
{
Description: Block size (number of leading bits in the subnet mask). ,
Required: False ,
}
integer ,
}
,
]
,
customHeaders:
{
Description: List of custom headers. ,
Required: False ,
}
[
{
name:
{
Description: Header name. ,
Required: False ,
}
string ,
value:
{
Description: Header value. ,
Required: False ,
}
string ,
}
,
]
,
alwaysServe:
{
Description: If Always Serve is enabled, probing for endpoint health will be disabled and endpoints will be included in the traffic routing method. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
trafficViewEnrollmentStatus:
{
Description: Indicates whether Traffic View is 'Enabled' or 'Disabled' for the Traffic Manager profile. Null, indicates 'Disabled'. Enabling this feature will increase the cost of the Traffic Manage profile. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
allowedEndpointRecordTypes:
{
Description: The list of allowed endpoint record types. ,
Required: False ,
}
[
string ,
]
,
maxReturn:
{
Description: Maximum number of endpoints to be returned for MultiValue routing type. ,
Format: int64 ,
Required: False ,
}
integer ,
recordType:
{
Description: When record type is set, a traffic manager profile will allow only endpoints that match this type. ,
Enum:
{
A: No description available. ,
AAAA: No description available. ,
CNAME: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The properties of the Traffic Manager profile. ,
Required: False ,
}
{
profileStatus:
{
Description: The status of the Traffic Manager profile. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
trafficRoutingMethod:
{
Description: The traffic routing method of the Traffic Manager profile. ,
Enum:
{
Performance: No description available. ,
Priority: No description available. ,
Weighted: No description available. ,
Geographic: No description available. ,
MultiValue: No description available. ,
Subnet: No description available. ,
}
,
Required: False ,
}
enum ,
dnsConfig:
{
Description: The DNS settings of the Traffic Manager profile. ,
Required: False ,
}
{
relativeName:
{
Description: The relative DNS name provided by this Traffic Manager profile. This value is combined with the DNS domain name used by Azure Traffic Manager to form the fully-qualified domain name (FQDN) of the profile. ,
Required: False ,
}
string ,
fqdn:
{
Description: The fully-qualified domain name (FQDN) of the Traffic Manager profile. This is formed from the concatenation of the RelativeName with the DNS domain used by Azure Traffic Manager. ,
Required: False ,
}
string ,
ttl:
{
Description: The DNS Time-To-Live (TTL), in seconds. This informs the local DNS resolvers and DNS clients how long to cache DNS responses provided by this Traffic Manager profile. ,
Format: int64 ,
Required: False ,
}
integer ,
}
,
monitorConfig:
{
Description: The endpoint monitoring settings of the Traffic Manager profile. ,
Required: False ,
}
{
profileMonitorStatus:
{
Description: The profile-level monitoring status of the Traffic Manager profile. ,
Enum:
{
CheckingEndpoints: No description available. ,
Online: No description available. ,
Degraded: No description available. ,
Disabled: No description available. ,
Inactive: No description available. ,
}
,
Required: False ,
}
enum ,
protocol:
{
Description: The protocol (HTTP, HTTPS or TCP) used to probe for endpoint health. ,
Enum:
{
HTTP: No description available. ,
HTTPS: No description available. ,
TCP: No description available. ,
}
,
Required: False ,
}
enum ,
port:
{
Description: The TCP port used to probe for endpoint health. ,
Format: int64 ,
Required: False ,
}
integer ,
path:
{
Description: The path relative to the endpoint domain name used to probe for endpoint health. ,
Required: False ,
}
string ,
intervalInSeconds:
{
Description: The monitor interval for endpoints in this profile. This is the interval at which Traffic Manager will check the health of each endpoint in this profile. ,
Format: int64 ,
Required: False ,
}
integer ,
timeoutInSeconds:
{
Description: The monitor timeout for endpoints in this profile. This is the time that Traffic Manager allows endpoints in this profile to response to the health check. ,
Format: int64 ,
Required: False ,
}
integer ,
toleratedNumberOfFailures:
{
Description: The number of consecutive failed health check that Traffic Manager tolerates before declaring an endpoint in this profile Degraded after the next failed health check. ,
Format: int64 ,
Required: False ,
}
integer ,
customHeaders:
{
Description: List of custom headers. ,
Required: False ,
}
[
{
name:
{
Description: Header name. ,
Required: False ,
}
string ,
value:
{
Description: Header value. ,
Required: False ,
}
string ,
}
,
]
,
expectedStatusCodeRanges:
{
Description: List of expected status code ranges. ,
Required: False ,
}
[
{
min:
{
Description: Min status code. ,
Required: False ,
}
integer ,
max:
{
Description: Max status code. ,
Required: False ,
}
integer ,
}
,
]
,
}
,
endpoints:
{
Description: The list of endpoints in the Traffic Manager profile. ,
Required: False ,
}
[
{
properties:
{
Description: The properties of the Traffic Manager endpoint. ,
Required: False ,
}
{
targetResourceId:
{
Description: The Azure Resource URI of the of the endpoint. Not applicable to endpoints of type 'ExternalEndpoints'. ,
Required: False ,
}
string ,
target:
{
Description: The fully-qualified DNS name or IP address of the endpoint. Traffic Manager returns this value in DNS responses to direct traffic to this endpoint. ,
Required: False ,
}
string ,
endpointStatus:
{
Description: The status of the endpoint. If the endpoint is Enabled, it is probed for endpoint health and is included in the traffic routing method. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
weight:
{
Description: The weight of this endpoint when using the 'Weighted' traffic routing method. Possible values are from 1 to 1000. ,
Format: int64 ,
Required: False ,
}
integer ,
priority:
{
Description: The priority of this endpoint when using the 'Priority' traffic routing method. Possible values are from 1 to 1000, lower values represent higher priority. This is an optional parameter. If specified, it must be specified on all endpoints, and no two endpoints can share the same priority value. ,
Format: int64 ,
Required: False ,
}
integer ,
endpointLocation:
{
Description: Specifies the location of the external or nested endpoints when using the 'Performance' traffic routing method. ,
Required: False ,
}
string ,
endpointMonitorStatus:
{
Description: The monitoring status of the endpoint. ,
Enum:
{
CheckingEndpoint: No description available. ,
Online: No description available. ,
Degraded: No description available. ,
Disabled: No description available. ,
Inactive: No description available. ,
Stopped: No description available. ,
Unmonitored: No description available. ,
}
,
Required: False ,
}
enum ,
minChildEndpoints:
{
Description: The minimum number of endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
minChildEndpointsIPv4:
{
Description: The minimum number of IPv4 (DNS record type A) endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
minChildEndpointsIPv6:
{
Description: The minimum number of IPv6 (DNS record type AAAA) endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
geoMapping:
{
Description: The list of countries/regions mapped to this endpoint when using the 'Geographic' traffic routing method. Please consult Traffic Manager Geographic documentation for a full list of accepted values. ,
Required: False ,
}
[
string ,
]
,
subnets:
{
Description: The list of subnets, IP addresses, and/or address ranges mapped to this endpoint when using the 'Subnet' traffic routing method. An empty list will match all ranges not covered by other endpoints. ,
Required: False ,
}
[
{
first:
{
Description: First address in the subnet. ,
Required: False ,
}
string ,
last:
{
Description: Last address in the subnet. ,
Required: False ,
}
string ,
scope:
{
Description: Block size (number of leading bits in the subnet mask). ,
Required: False ,
}
integer ,
}
,
]
,
customHeaders:
{
Description: List of custom headers. ,
Required: False ,
}
[
{
name:
{
Description: Header name. ,
Required: False ,
}
string ,
value:
{
Description: Header value. ,
Required: False ,
}
string ,
}
,
]
,
alwaysServe:
{
Description: If Always Serve is enabled, probing for endpoint health will be disabled and endpoints will be included in the traffic routing method. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
trafficViewEnrollmentStatus:
{
Description: Indicates whether Traffic View is 'Enabled' or 'Disabled' for the Traffic Manager profile. Null, indicates 'Disabled'. Enabling this feature will increase the cost of the Traffic Manage profile. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
allowedEndpointRecordTypes:
{
Description: The list of allowed endpoint record types. ,
Required: False ,
}
[
string ,
]
,
maxReturn:
{
Description: Maximum number of endpoints to be returned for MultiValue routing type. ,
Format: int64 ,
Required: False ,
}
integer ,
recordType:
{
Description: When record type is set, a traffic manager profile will allow only endpoints that match this type. ,
Enum:
{
A: No description available. ,
AAAA: No description available. ,
CNAME: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (201)

{
properties:
{
Description: The properties of the Traffic Manager profile. ,
Required: False ,
}
{
profileStatus:
{
Description: The status of the Traffic Manager profile. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
trafficRoutingMethod:
{
Description: The traffic routing method of the Traffic Manager profile. ,
Enum:
{
Performance: No description available. ,
Priority: No description available. ,
Weighted: No description available. ,
Geographic: No description available. ,
MultiValue: No description available. ,
Subnet: No description available. ,
}
,
Required: False ,
}
enum ,
dnsConfig:
{
Description: The DNS settings of the Traffic Manager profile. ,
Required: False ,
}
{
relativeName:
{
Description: The relative DNS name provided by this Traffic Manager profile. This value is combined with the DNS domain name used by Azure Traffic Manager to form the fully-qualified domain name (FQDN) of the profile. ,
Required: False ,
}
string ,
fqdn:
{
Description: The fully-qualified domain name (FQDN) of the Traffic Manager profile. This is formed from the concatenation of the RelativeName with the DNS domain used by Azure Traffic Manager. ,
Required: False ,
}
string ,
ttl:
{
Description: The DNS Time-To-Live (TTL), in seconds. This informs the local DNS resolvers and DNS clients how long to cache DNS responses provided by this Traffic Manager profile. ,
Format: int64 ,
Required: False ,
}
integer ,
}
,
monitorConfig:
{
Description: The endpoint monitoring settings of the Traffic Manager profile. ,
Required: False ,
}
{
profileMonitorStatus:
{
Description: The profile-level monitoring status of the Traffic Manager profile. ,
Enum:
{
CheckingEndpoints: No description available. ,
Online: No description available. ,
Degraded: No description available. ,
Disabled: No description available. ,
Inactive: No description available. ,
}
,
Required: False ,
}
enum ,
protocol:
{
Description: The protocol (HTTP, HTTPS or TCP) used to probe for endpoint health. ,
Enum:
{
HTTP: No description available. ,
HTTPS: No description available. ,
TCP: No description available. ,
}
,
Required: False ,
}
enum ,
port:
{
Description: The TCP port used to probe for endpoint health. ,
Format: int64 ,
Required: False ,
}
integer ,
path:
{
Description: The path relative to the endpoint domain name used to probe for endpoint health. ,
Required: False ,
}
string ,
intervalInSeconds:
{
Description: The monitor interval for endpoints in this profile. This is the interval at which Traffic Manager will check the health of each endpoint in this profile. ,
Format: int64 ,
Required: False ,
}
integer ,
timeoutInSeconds:
{
Description: The monitor timeout for endpoints in this profile. This is the time that Traffic Manager allows endpoints in this profile to response to the health check. ,
Format: int64 ,
Required: False ,
}
integer ,
toleratedNumberOfFailures:
{
Description: The number of consecutive failed health check that Traffic Manager tolerates before declaring an endpoint in this profile Degraded after the next failed health check. ,
Format: int64 ,
Required: False ,
}
integer ,
customHeaders:
{
Description: List of custom headers. ,
Required: False ,
}
[
{
name:
{
Description: Header name. ,
Required: False ,
}
string ,
value:
{
Description: Header value. ,
Required: False ,
}
string ,
}
,
]
,
expectedStatusCodeRanges:
{
Description: List of expected status code ranges. ,
Required: False ,
}
[
{
min:
{
Description: Min status code. ,
Required: False ,
}
integer ,
max:
{
Description: Max status code. ,
Required: False ,
}
integer ,
}
,
]
,
}
,
endpoints:
{
Description: The list of endpoints in the Traffic Manager profile. ,
Required: False ,
}
[
{
properties:
{
Description: The properties of the Traffic Manager endpoint. ,
Required: False ,
}
{
targetResourceId:
{
Description: The Azure Resource URI of the of the endpoint. Not applicable to endpoints of type 'ExternalEndpoints'. ,
Required: False ,
}
string ,
target:
{
Description: The fully-qualified DNS name or IP address of the endpoint. Traffic Manager returns this value in DNS responses to direct traffic to this endpoint. ,
Required: False ,
}
string ,
endpointStatus:
{
Description: The status of the endpoint. If the endpoint is Enabled, it is probed for endpoint health and is included in the traffic routing method. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
weight:
{
Description: The weight of this endpoint when using the 'Weighted' traffic routing method. Possible values are from 1 to 1000. ,
Format: int64 ,
Required: False ,
}
integer ,
priority:
{
Description: The priority of this endpoint when using the 'Priority' traffic routing method. Possible values are from 1 to 1000, lower values represent higher priority. This is an optional parameter. If specified, it must be specified on all endpoints, and no two endpoints can share the same priority value. ,
Format: int64 ,
Required: False ,
}
integer ,
endpointLocation:
{
Description: Specifies the location of the external or nested endpoints when using the 'Performance' traffic routing method. ,
Required: False ,
}
string ,
endpointMonitorStatus:
{
Description: The monitoring status of the endpoint. ,
Enum:
{
CheckingEndpoint: No description available. ,
Online: No description available. ,
Degraded: No description available. ,
Disabled: No description available. ,
Inactive: No description available. ,
Stopped: No description available. ,
Unmonitored: No description available. ,
}
,
Required: False ,
}
enum ,
minChildEndpoints:
{
Description: The minimum number of endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
minChildEndpointsIPv4:
{
Description: The minimum number of IPv4 (DNS record type A) endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
minChildEndpointsIPv6:
{
Description: The minimum number of IPv6 (DNS record type AAAA) endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
geoMapping:
{
Description: The list of countries/regions mapped to this endpoint when using the 'Geographic' traffic routing method. Please consult Traffic Manager Geographic documentation for a full list of accepted values. ,
Required: False ,
}
[
string ,
]
,
subnets:
{
Description: The list of subnets, IP addresses, and/or address ranges mapped to this endpoint when using the 'Subnet' traffic routing method. An empty list will match all ranges not covered by other endpoints. ,
Required: False ,
}
[
{
first:
{
Description: First address in the subnet. ,
Required: False ,
}
string ,
last:
{
Description: Last address in the subnet. ,
Required: False ,
}
string ,
scope:
{
Description: Block size (number of leading bits in the subnet mask). ,
Required: False ,
}
integer ,
}
,
]
,
customHeaders:
{
Description: List of custom headers. ,
Required: False ,
}
[
{
name:
{
Description: Header name. ,
Required: False ,
}
string ,
value:
{
Description: Header value. ,
Required: False ,
}
string ,
}
,
]
,
alwaysServe:
{
Description: If Always Serve is enabled, probing for endpoint health will be disabled and endpoints will be included in the traffic routing method. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
trafficViewEnrollmentStatus:
{
Description: Indicates whether Traffic View is 'Enabled' or 'Disabled' for the Traffic Manager profile. Null, indicates 'Disabled'. Enabling this feature will increase the cost of the Traffic Manage profile. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
allowedEndpointRecordTypes:
{
Description: The list of allowed endpoint record types. ,
Required: False ,
}
[
string ,
]
,
maxReturn:
{
Description: Maximum number of endpoints to be returned for MultiValue routing type. ,
Format: int64 ,
Required: False ,
}
integer ,
recordType:
{
Description: When record type is set, a traffic manager profile will allow only endpoints that match this type. ,
Enum:
{
A: No description available. ,
AAAA: No description available. ,
CNAME: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The content of the error. ,
Required: False ,
}
{
code:
{
Description: Error code ,
Required: False ,
}
string ,
message:
{
Description: Error message ,
Required: False ,
}
string ,
target:
{
Description: Error target ,
Required: False ,
}
string ,
details:
{
Description: Error details ,
Required: False ,
}
[
string ,
]
,
}
,
}
Profiles_Delete (new)
Description :  Deletes a Traffic Manager profile.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficmanagerprofiles/{profileName}
{
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
profileName:
{
Description: The name of the Traffic Manager profile to be deleted. ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
boolean:
{
Description: The result of the operation or request. ,
Required: False ,
}
boolean ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The content of the error. ,
Required: False ,
}
{
code:
{
Description: Error code ,
Required: False ,
}
string ,
message:
{
Description: Error message ,
Required: False ,
}
string ,
target:
{
Description: Error target ,
Required: False ,
}
string ,
details:
{
Description: Error details ,
Required: False ,
}
[
string ,
]
,
}
,
}
Profiles_Update (new)
Description :  Update a Traffic Manager profile.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficmanagerprofiles/{profileName}
{
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
profileName:
{
Description: The name of the Traffic Manager profile. ,
Required: True ,
}
string ,
parameters:
{
Description: The Traffic Manager profile parameters supplied to the Update operation. ,
Required: True ,
}
{
properties:
{
Description: The properties of the Traffic Manager profile. ,
Required: False ,
}
{
profileStatus:
{
Description: The status of the Traffic Manager profile. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
trafficRoutingMethod:
{
Description: The traffic routing method of the Traffic Manager profile. ,
Enum:
{
Performance: No description available. ,
Priority: No description available. ,
Weighted: No description available. ,
Geographic: No description available. ,
MultiValue: No description available. ,
Subnet: No description available. ,
}
,
Required: False ,
}
enum ,
dnsConfig:
{
Description: The DNS settings of the Traffic Manager profile. ,
Required: False ,
}
{
relativeName:
{
Description: The relative DNS name provided by this Traffic Manager profile. This value is combined with the DNS domain name used by Azure Traffic Manager to form the fully-qualified domain name (FQDN) of the profile. ,
Required: False ,
}
string ,
fqdn:
{
Description: The fully-qualified domain name (FQDN) of the Traffic Manager profile. This is formed from the concatenation of the RelativeName with the DNS domain used by Azure Traffic Manager. ,
Required: False ,
}
string ,
ttl:
{
Description: The DNS Time-To-Live (TTL), in seconds. This informs the local DNS resolvers and DNS clients how long to cache DNS responses provided by this Traffic Manager profile. ,
Format: int64 ,
Required: False ,
}
integer ,
}
,
monitorConfig:
{
Description: The endpoint monitoring settings of the Traffic Manager profile. ,
Required: False ,
}
{
profileMonitorStatus:
{
Description: The profile-level monitoring status of the Traffic Manager profile. ,
Enum:
{
CheckingEndpoints: No description available. ,
Online: No description available. ,
Degraded: No description available. ,
Disabled: No description available. ,
Inactive: No description available. ,
}
,
Required: False ,
}
enum ,
protocol:
{
Description: The protocol (HTTP, HTTPS or TCP) used to probe for endpoint health. ,
Enum:
{
HTTP: No description available. ,
HTTPS: No description available. ,
TCP: No description available. ,
}
,
Required: False ,
}
enum ,
port:
{
Description: The TCP port used to probe for endpoint health. ,
Format: int64 ,
Required: False ,
}
integer ,
path:
{
Description: The path relative to the endpoint domain name used to probe for endpoint health. ,
Required: False ,
}
string ,
intervalInSeconds:
{
Description: The monitor interval for endpoints in this profile. This is the interval at which Traffic Manager will check the health of each endpoint in this profile. ,
Format: int64 ,
Required: False ,
}
integer ,
timeoutInSeconds:
{
Description: The monitor timeout for endpoints in this profile. This is the time that Traffic Manager allows endpoints in this profile to response to the health check. ,
Format: int64 ,
Required: False ,
}
integer ,
toleratedNumberOfFailures:
{
Description: The number of consecutive failed health check that Traffic Manager tolerates before declaring an endpoint in this profile Degraded after the next failed health check. ,
Format: int64 ,
Required: False ,
}
integer ,
customHeaders:
{
Description: List of custom headers. ,
Required: False ,
}
[
{
name:
{
Description: Header name. ,
Required: False ,
}
string ,
value:
{
Description: Header value. ,
Required: False ,
}
string ,
}
,
]
,
expectedStatusCodeRanges:
{
Description: List of expected status code ranges. ,
Required: False ,
}
[
{
min:
{
Description: Min status code. ,
Required: False ,
}
integer ,
max:
{
Description: Max status code. ,
Required: False ,
}
integer ,
}
,
]
,
}
,
endpoints:
{
Description: The list of endpoints in the Traffic Manager profile. ,
Required: False ,
}
[
{
properties:
{
Description: The properties of the Traffic Manager endpoint. ,
Required: False ,
}
{
targetResourceId:
{
Description: The Azure Resource URI of the of the endpoint. Not applicable to endpoints of type 'ExternalEndpoints'. ,
Required: False ,
}
string ,
target:
{
Description: The fully-qualified DNS name or IP address of the endpoint. Traffic Manager returns this value in DNS responses to direct traffic to this endpoint. ,
Required: False ,
}
string ,
endpointStatus:
{
Description: The status of the endpoint. If the endpoint is Enabled, it is probed for endpoint health and is included in the traffic routing method. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
weight:
{
Description: The weight of this endpoint when using the 'Weighted' traffic routing method. Possible values are from 1 to 1000. ,
Format: int64 ,
Required: False ,
}
integer ,
priority:
{
Description: The priority of this endpoint when using the 'Priority' traffic routing method. Possible values are from 1 to 1000, lower values represent higher priority. This is an optional parameter. If specified, it must be specified on all endpoints, and no two endpoints can share the same priority value. ,
Format: int64 ,
Required: False ,
}
integer ,
endpointLocation:
{
Description: Specifies the location of the external or nested endpoints when using the 'Performance' traffic routing method. ,
Required: False ,
}
string ,
endpointMonitorStatus:
{
Description: The monitoring status of the endpoint. ,
Enum:
{
CheckingEndpoint: No description available. ,
Online: No description available. ,
Degraded: No description available. ,
Disabled: No description available. ,
Inactive: No description available. ,
Stopped: No description available. ,
Unmonitored: No description available. ,
}
,
Required: False ,
}
enum ,
minChildEndpoints:
{
Description: The minimum number of endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
minChildEndpointsIPv4:
{
Description: The minimum number of IPv4 (DNS record type A) endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
minChildEndpointsIPv6:
{
Description: The minimum number of IPv6 (DNS record type AAAA) endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
geoMapping:
{
Description: The list of countries/regions mapped to this endpoint when using the 'Geographic' traffic routing method. Please consult Traffic Manager Geographic documentation for a full list of accepted values. ,
Required: False ,
}
[
string ,
]
,
subnets:
{
Description: The list of subnets, IP addresses, and/or address ranges mapped to this endpoint when using the 'Subnet' traffic routing method. An empty list will match all ranges not covered by other endpoints. ,
Required: False ,
}
[
{
first:
{
Description: First address in the subnet. ,
Required: False ,
}
string ,
last:
{
Description: Last address in the subnet. ,
Required: False ,
}
string ,
scope:
{
Description: Block size (number of leading bits in the subnet mask). ,
Required: False ,
}
integer ,
}
,
]
,
customHeaders:
{
Description: List of custom headers. ,
Required: False ,
}
[
{
name:
{
Description: Header name. ,
Required: False ,
}
string ,
value:
{
Description: Header value. ,
Required: False ,
}
string ,
}
,
]
,
alwaysServe:
{
Description: If Always Serve is enabled, probing for endpoint health will be disabled and endpoints will be included in the traffic routing method. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
trafficViewEnrollmentStatus:
{
Description: Indicates whether Traffic View is 'Enabled' or 'Disabled' for the Traffic Manager profile. Null, indicates 'Disabled'. Enabling this feature will increase the cost of the Traffic Manage profile. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
allowedEndpointRecordTypes:
{
Description: The list of allowed endpoint record types. ,
Required: False ,
}
[
string ,
]
,
maxReturn:
{
Description: Maximum number of endpoints to be returned for MultiValue routing type. ,
Format: int64 ,
Required: False ,
}
integer ,
recordType:
{
Description: When record type is set, a traffic manager profile will allow only endpoints that match this type. ,
Enum:
{
A: No description available. ,
AAAA: No description available. ,
CNAME: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The properties of the Traffic Manager profile. ,
Required: False ,
}
{
profileStatus:
{
Description: The status of the Traffic Manager profile. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
trafficRoutingMethod:
{
Description: The traffic routing method of the Traffic Manager profile. ,
Enum:
{
Performance: No description available. ,
Priority: No description available. ,
Weighted: No description available. ,
Geographic: No description available. ,
MultiValue: No description available. ,
Subnet: No description available. ,
}
,
Required: False ,
}
enum ,
dnsConfig:
{
Description: The DNS settings of the Traffic Manager profile. ,
Required: False ,
}
{
relativeName:
{
Description: The relative DNS name provided by this Traffic Manager profile. This value is combined with the DNS domain name used by Azure Traffic Manager to form the fully-qualified domain name (FQDN) of the profile. ,
Required: False ,
}
string ,
fqdn:
{
Description: The fully-qualified domain name (FQDN) of the Traffic Manager profile. This is formed from the concatenation of the RelativeName with the DNS domain used by Azure Traffic Manager. ,
Required: False ,
}
string ,
ttl:
{
Description: The DNS Time-To-Live (TTL), in seconds. This informs the local DNS resolvers and DNS clients how long to cache DNS responses provided by this Traffic Manager profile. ,
Format: int64 ,
Required: False ,
}
integer ,
}
,
monitorConfig:
{
Description: The endpoint monitoring settings of the Traffic Manager profile. ,
Required: False ,
}
{
profileMonitorStatus:
{
Description: The profile-level monitoring status of the Traffic Manager profile. ,
Enum:
{
CheckingEndpoints: No description available. ,
Online: No description available. ,
Degraded: No description available. ,
Disabled: No description available. ,
Inactive: No description available. ,
}
,
Required: False ,
}
enum ,
protocol:
{
Description: The protocol (HTTP, HTTPS or TCP) used to probe for endpoint health. ,
Enum:
{
HTTP: No description available. ,
HTTPS: No description available. ,
TCP: No description available. ,
}
,
Required: False ,
}
enum ,
port:
{
Description: The TCP port used to probe for endpoint health. ,
Format: int64 ,
Required: False ,
}
integer ,
path:
{
Description: The path relative to the endpoint domain name used to probe for endpoint health. ,
Required: False ,
}
string ,
intervalInSeconds:
{
Description: The monitor interval for endpoints in this profile. This is the interval at which Traffic Manager will check the health of each endpoint in this profile. ,
Format: int64 ,
Required: False ,
}
integer ,
timeoutInSeconds:
{
Description: The monitor timeout for endpoints in this profile. This is the time that Traffic Manager allows endpoints in this profile to response to the health check. ,
Format: int64 ,
Required: False ,
}
integer ,
toleratedNumberOfFailures:
{
Description: The number of consecutive failed health check that Traffic Manager tolerates before declaring an endpoint in this profile Degraded after the next failed health check. ,
Format: int64 ,
Required: False ,
}
integer ,
customHeaders:
{
Description: List of custom headers. ,
Required: False ,
}
[
{
name:
{
Description: Header name. ,
Required: False ,
}
string ,
value:
{
Description: Header value. ,
Required: False ,
}
string ,
}
,
]
,
expectedStatusCodeRanges:
{
Description: List of expected status code ranges. ,
Required: False ,
}
[
{
min:
{
Description: Min status code. ,
Required: False ,
}
integer ,
max:
{
Description: Max status code. ,
Required: False ,
}
integer ,
}
,
]
,
}
,
endpoints:
{
Description: The list of endpoints in the Traffic Manager profile. ,
Required: False ,
}
[
{
properties:
{
Description: The properties of the Traffic Manager endpoint. ,
Required: False ,
}
{
targetResourceId:
{
Description: The Azure Resource URI of the of the endpoint. Not applicable to endpoints of type 'ExternalEndpoints'. ,
Required: False ,
}
string ,
target:
{
Description: The fully-qualified DNS name or IP address of the endpoint. Traffic Manager returns this value in DNS responses to direct traffic to this endpoint. ,
Required: False ,
}
string ,
endpointStatus:
{
Description: The status of the endpoint. If the endpoint is Enabled, it is probed for endpoint health and is included in the traffic routing method. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
weight:
{
Description: The weight of this endpoint when using the 'Weighted' traffic routing method. Possible values are from 1 to 1000. ,
Format: int64 ,
Required: False ,
}
integer ,
priority:
{
Description: The priority of this endpoint when using the 'Priority' traffic routing method. Possible values are from 1 to 1000, lower values represent higher priority. This is an optional parameter. If specified, it must be specified on all endpoints, and no two endpoints can share the same priority value. ,
Format: int64 ,
Required: False ,
}
integer ,
endpointLocation:
{
Description: Specifies the location of the external or nested endpoints when using the 'Performance' traffic routing method. ,
Required: False ,
}
string ,
endpointMonitorStatus:
{
Description: The monitoring status of the endpoint. ,
Enum:
{
CheckingEndpoint: No description available. ,
Online: No description available. ,
Degraded: No description available. ,
Disabled: No description available. ,
Inactive: No description available. ,
Stopped: No description available. ,
Unmonitored: No description available. ,
}
,
Required: False ,
}
enum ,
minChildEndpoints:
{
Description: The minimum number of endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
minChildEndpointsIPv4:
{
Description: The minimum number of IPv4 (DNS record type A) endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
minChildEndpointsIPv6:
{
Description: The minimum number of IPv6 (DNS record type AAAA) endpoints that must be available in the child profile in order for the parent profile to be considered available. Only applicable to endpoint of type 'NestedEndpoints'. ,
Format: int64 ,
Required: False ,
}
integer ,
geoMapping:
{
Description: The list of countries/regions mapped to this endpoint when using the 'Geographic' traffic routing method. Please consult Traffic Manager Geographic documentation for a full list of accepted values. ,
Required: False ,
}
[
string ,
]
,
subnets:
{
Description: The list of subnets, IP addresses, and/or address ranges mapped to this endpoint when using the 'Subnet' traffic routing method. An empty list will match all ranges not covered by other endpoints. ,
Required: False ,
}
[
{
first:
{
Description: First address in the subnet. ,
Required: False ,
}
string ,
last:
{
Description: Last address in the subnet. ,
Required: False ,
}
string ,
scope:
{
Description: Block size (number of leading bits in the subnet mask). ,
Required: False ,
}
integer ,
}
,
]
,
customHeaders:
{
Description: List of custom headers. ,
Required: False ,
}
[
{
name:
{
Description: Header name. ,
Required: False ,
}
string ,
value:
{
Description: Header value. ,
Required: False ,
}
string ,
}
,
]
,
alwaysServe:
{
Description: If Always Serve is enabled, probing for endpoint health will be disabled and endpoints will be included in the traffic routing method. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
trafficViewEnrollmentStatus:
{
Description: Indicates whether Traffic View is 'Enabled' or 'Disabled' for the Traffic Manager profile. Null, indicates 'Disabled'. Enabling this feature will increase the cost of the Traffic Manage profile. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
allowedEndpointRecordTypes:
{
Description: The list of allowed endpoint record types. ,
Required: False ,
}
[
string ,
]
,
maxReturn:
{
Description: Maximum number of endpoints to be returned for MultiValue routing type. ,
Format: int64 ,
Required: False ,
}
integer ,
recordType:
{
Description: When record type is set, a traffic manager profile will allow only endpoints that match this type. ,
Enum:
{
A: No description available. ,
AAAA: No description available. ,
CNAME: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The content of the error. ,
Required: False ,
}
{
code:
{
Description: Error code ,
Required: False ,
}
string ,
message:
{
Description: Error message ,
Required: False ,
}
string ,
target:
{
Description: Error target ,
Required: False ,
}
string ,
details:
{
Description: Error details ,
Required: False ,
}
[
string ,
]
,
}
,
}
GeographicHierarchies_GetDefault (new)
Description :  Gets the default Geographic Hierarchy used by the Geographic traffic routing method.
Reference :  Link ¶

⚼ Request

GET:  /providers/Microsoft.Network/trafficManagerGeographicHierarchies/default
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The properties of the Geographic Hierarchy resource. ,
Required: False ,
}
{
geographicHierarchy:
{
Description: The region at the root of the hierarchy from all the regions in the hierarchy can be retrieved. ,
Required: False ,
}
{
code:
{
Description: The code of the region ,
Required: False ,
}
string ,
name:
{
Description: The name of the region ,
Required: False ,
}
string ,
regions:
{
Description: The list of Regions grouped under this Region in the Geographic Hierarchy. ,
Required: False ,
}
[
string ,
]
,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The content of the error. ,
Required: False ,
}
{
code:
{
Description: Error code ,
Required: False ,
}
string ,
message:
{
Description: Error message ,
Required: False ,
}
string ,
target:
{
Description: Error target ,
Required: False ,
}
string ,
details:
{
Description: Error details ,
Required: False ,
}
[
string ,
]
,
}
,
}
HeatMap_Get (new)
Description :  Gets latest heatmap for Traffic Manager profile.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficmanagerprofiles/{profileName}/heatMaps/{heatMapType}
{
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
profileName:
{
Description: The name of the Traffic Manager profile. ,
Required: True ,
}
string ,
heatMapType:
{
Description: The type of HeatMap for the Traffic Manager profile. ,
Required: True ,
}
string ,
topLeft:
{
Description: The top left latitude,longitude pair of the rectangular viewport to query for. ,
Required: False ,
}
array ,
botRight:
{
Description: The bottom right latitude,longitude pair of the rectangular viewport to query for. ,
Required: False ,
}
array ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The properties of the Traffic Manager HeatMap. ,
Required: False ,
}
{
startTime:
{
Description: The beginning of the time window for this HeatMap, inclusive. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: The ending of the time window for this HeatMap, exclusive. ,
Format: date-time ,
Required: False ,
}
string ,
endpoints:
{
Description: The endpoints used in this HeatMap calculation. ,
Required: False ,
}
[
{
resourceId:
{
Description: The ARM Resource ID of this Traffic Manager endpoint. ,
Required: False ,
}
string ,
endpointId:
{
Description: A number uniquely identifying this endpoint in query experiences. ,
Required: False ,
}
integer ,
}
,
]
,
trafficFlows:
{
Description: The traffic flows produced in this HeatMap calculation. ,
Required: False ,
}
[
{
sourceIp:
{
Description: The IP address that this query experience originated from. ,
Required: False ,
}
string ,
latitude:
{
Description: The approximate latitude that these queries originated from. ,
Format: double ,
Required: False ,
}
number ,
longitude:
{
Description: The approximate longitude that these queries originated from. ,
Format: double ,
Required: False ,
}
number ,
queryExperiences:
{
Description: The query experiences produced in this HeatMap calculation. ,
Required: False ,
}
[
{
endpointId:
{
Description: The id of the endpoint from the 'endpoints' array which these queries were routed to. ,
Required: True ,
}
integer ,
queryCount:
{
Description: The number of queries originating from this location. ,
Required: True ,
}
integer ,
latency:
{
Description: The latency experienced by queries originating from this location. ,
Format: double ,
Required: False ,
}
number ,
}
,
]
,
}
,
]
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The content of the error. ,
Required: False ,
}
{
code:
{
Description: Error code ,
Required: False ,
}
string ,
message:
{
Description: Error message ,
Required: False ,
}
string ,
target:
{
Description: Error target ,
Required: False ,
}
string ,
details:
{
Description: Error details ,
Required: False ,
}
[
string ,
]
,
}
,
}
TrafficManagerUserMetricsKeys_Get (new)
Description :  Get the subscription-level key used for Real User Metrics collection.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.Network/trafficManagerUserMetricsKeys/default
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The properties of the Traffic Manager User Metrics. ,
Required: False ,
}
{
key:
{
Description: The key returned by the User Metrics operation. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The content of the error. ,
Required: False ,
}
{
code:
{
Description: Error code ,
Required: False ,
}
string ,
message:
{
Description: Error message ,
Required: False ,
}
string ,
target:
{
Description: Error target ,
Required: False ,
}
string ,
details:
{
Description: Error details ,
Required: False ,
}
[
string ,
]
,
}
,
}
TrafficManagerUserMetricsKeys_CreateOrUpdate (new)
Description :  Create or update a subscription-level key used for Real User Metrics collection.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/providers/Microsoft.Network/trafficManagerUserMetricsKeys/default
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: The properties of the Traffic Manager User Metrics. ,
Required: False ,
}
{
key:
{
Description: The key returned by the User Metrics operation. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The content of the error. ,
Required: False ,
}
{
code:
{
Description: Error code ,
Required: False ,
}
string ,
message:
{
Description: Error message ,
Required: False ,
}
string ,
target:
{
Description: Error target ,
Required: False ,
}
string ,
details:
{
Description: Error details ,
Required: False ,
}
[
string ,
]
,
}
,
}
TrafficManagerUserMetricsKeys_Delete (new)
Description :  Delete a subscription-level key used for Real User Metrics collection.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/providers/Microsoft.Network/trafficManagerUserMetricsKeys/default
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
boolean:
{
Description: The result of the operation or request. ,
Required: False ,
}
boolean ,
}

⚐ Response (default)

{
error:
{
Description: The content of the error. ,
Required: False ,
}
{
code:
{
Description: Error code ,
Required: False ,
}
string ,
message:
{
Description: Error message ,
Required: False ,
}
string ,
target:
{
Description: Error target ,
Required: False ,
}
string ,
details:
{
Description: Error details ,
Required: False ,
}
[
string ,
]
,
}
,
}