az network traffic-manager profile

Manage Azure Traffic Manager profiles.

Commands

Name Description Type Status
az network traffic-manager profile check-dns

Check the availability of a relative DNS name.

Core GA
az network traffic-manager profile create

Create a traffic manager profile.

Core GA
az network traffic-manager profile delete

Delete a traffic manager profile.

Core GA
az network traffic-manager profile list

List traffic manager profiles.

Core GA
az network traffic-manager profile show

Get the details of a traffic manager profile.

Core GA
az network traffic-manager profile update

Update a traffic manager profile.

Core GA

az network traffic-manager profile check-dns

Check the availability of a relative DNS name.

az network traffic-manager profile check-dns [--name]
                                             [--type]

Examples

Check the availability of 'mywebapp.trafficmanager.net' in Azure.

az network traffic-manager profile check-dns -n mywebapp

Optional Parameters

--name -n

DNS prefix to verify availability for.

--type

The type of the resource.

Default value: Microsoft.Network/trafficManagerProfiles
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az network traffic-manager profile create

Create a traffic manager profile.

az network traffic-manager profile create --name
                                          --resource-group
                                          --routing-method {Geographic, Multivalue, Performance, Priority, Subnet, Weighted}
                                          --unique-dns-name
                                          [--custom-headers]
                                          [--interval]
                                          [--max-failures]
                                          [--max-return]
                                          [--path]
                                          [--port]
                                          [--protocol {HTTP, HTTPS, TCP}]
                                          [--status {Disabled, Enabled}]
                                          [--status-code-ranges]
                                          [--tags]
                                          [--timeout]
                                          [--ttl]

Examples

Create a traffic manager profile with performance routing.

az network traffic-manager profile create -g MyResourceGroup -n MyTmProfile --routing-method Performance \
    --unique-dns-name mywebapp --ttl 30 --protocol HTTP --port 80 --path "/"

Required Parameters

--name -n

Traffic manager profile name.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--routing-method

Routing method.

Accepted values: Geographic, Multivalue, Performance, Priority, Subnet, Weighted
--unique-dns-name

Relative DNS name for the traffic manager profile. Resulting FQDN will be <unique-dns-name>.trafficmanager.net and must be globally unique.

Optional Parameters

--custom-headers

Space-separated list of NAME=VALUE pairs.

--interval

The interval in seconds at which health checks are conducted.

--max-failures

The number of consecutive failed health checks tolerated before an endpoint is considered degraded.

--max-return

Maximum number of endpoints to be returned for MultiValue routing type.

--path

Path to monitor. Use ""('""' in PowerShell) for none.

--port

Port to monitor.

Default value: 80
--protocol

Monitor protocol.

Accepted values: HTTP, HTTPS, TCP
Default value: HTTP
--status

Status of the Traffic Manager profile.

Accepted values: Disabled, Enabled
Default value: Enabled
--status-code-ranges

Space-separated list of status codes in MIN-MAX or VAL format.

--tags

Space-separated tags: key[=value] [key[=value] ...]. Use "" to clear existing tags.

--timeout

The time in seconds allowed for endpoints to respond to a health check.

--ttl

DNS config time-to-live in seconds.

Default value: 30
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az network traffic-manager profile delete

Delete a traffic manager profile.

az network traffic-manager profile delete [--ids]
                                          [--name]
                                          [--resource-group]
                                          [--subscription]

Examples

Delete a traffic manager profile.

az network traffic-manager profile delete -g MyResourceGroup -n MyTmProfile

Delete a traffic manager profile. (autogenerated)

az network traffic-manager profile delete --name MyTmProfile --resource-group MyResourceGroup --subscription MySubscription

Optional Parameters

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--name -n

The name of the Traffic Manager profile to be deleted.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az network traffic-manager profile list

List traffic manager profiles.

az network traffic-manager profile list [--resource-group]

Examples

List traffic manager profiles.

az network traffic-manager profile list -g MyResourceGroup

Optional Parameters

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az network traffic-manager profile show

Get the details of a traffic manager profile.

az network traffic-manager profile show [--ids]
                                        [--name]
                                        [--resource-group]
                                        [--subscription]

Examples

Get the details of a traffic manager profile.

az network traffic-manager profile show -g MyResourceGroup -n MyTmProfile

Optional Parameters

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--name --profile-name -n

The name of the Traffic Manager profile.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az network traffic-manager profile update

Update a traffic manager profile.

az network traffic-manager profile update [--custom-headers]
                                          [--ids]
                                          [--interval]
                                          [--max-failures]
                                          [--max-return]
                                          [--name]
                                          [--path]
                                          [--port]
                                          [--protocol {HTTP, HTTPS, TCP}]
                                          [--resource-group]
                                          [--routing-method {Geographic, Multivalue, Performance, Priority, Subnet, Weighted}]
                                          [--status {Disabled, Enabled}]
                                          [--status-code-ranges]
                                          [--subscription]
                                          [--tags]
                                          [--timeout]
                                          [--ttl]

Examples

Update a traffic manager profile to change the TTL to 300.

az network traffic-manager profile update -g MyResourceGroup -n MyTmProfile --ttl 300

Update a traffic manager profile. (autogenerated)

az network traffic-manager profile update --name MyTmProfile --resource-group MyResourceGroup --status Enabled

Optional Parameters

--custom-headers

Space-separated list of NAME=VALUE pairs.

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--interval

The interval in seconds at which health checks are conducted.

--max-failures

The number of consecutive failed health checks tolerated before an endpoint is considered degraded.

--max-return

Maximum number of endpoints to be returned for MultiValue routing type.

--name -n

Traffic manager profile name.

--path

Path to monitor. Use ""('""' in PowerShell) for none.

--port

Port to monitor.

--protocol

Monitor protocol.

Accepted values: HTTP, HTTPS, TCP
--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--routing-method

Routing method.

Accepted values: Geographic, Multivalue, Performance, Priority, Subnet, Weighted
--status

Status of the Traffic Manager profile.

Accepted values: Disabled, Enabled
--status-code-ranges

Space-separated list of status codes in MIN-MAX or VAL format.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--tags

Space-separated tags: key[=value] [key[=value] ...]. Use "" to clear existing tags.

--timeout

The time in seconds allowed for endpoints to respond to a health check.

--ttl

DNS config time-to-live in seconds.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.