az network cross-region-lb probe

Evaluate probe information and define routing rules.

Commands

az network cross-region-lb probe create

Create a probe.

az network cross-region-lb probe delete

Delete a probe.

az network cross-region-lb probe list

List probes.

az network cross-region-lb probe show

Get the details of a probe.

az network cross-region-lb probe update

Update a probe.

az network cross-region-lb probe create

Create a probe.

az network cross-region-lb probe create --lb-name
                                        --name
                                        --port
                                        --protocol {Http, Https, Tcp}
                                        --resource-group
                                        [--interval]
                                        [--path]
                                        [--threshold]

Examples

Create a probe on a load balancer over HTTP and port 80.

az network cross-region-lb probe create -g MyResourceGroup --lb-name MyLb -n MyProbe \
    --protocol http --port 80 --path /

Create a probe on a load balancer over TCP on port 443.

az network cross-region-lb probe create -g MyResourceGroup --lb-name MyLb -n MyProbe \
    --protocol tcp --port 443

Required Parameters

--lb-name

The load balancer name.

--name -n

The name of the probe.

--port

The port to interrogate.

--protocol

The protocol to probe.

accepted values: Http, Https, Tcp
--resource-group -g

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

Optional Parameters

--interval

Probing time interval in seconds.

--path

The endpoint to interrogate (http only).

--threshold

The number of consecutive probe failures before an instance is deemed unhealthy.

az network cross-region-lb probe delete

Delete a probe.

az network cross-region-lb probe delete --lb-name
                                        --name
                                        --resource-group

Examples

Delete a probe.

az network cross-region-lb probe delete -g MyResourceGroup --lb-name MyLb -n MyProbe

Required Parameters

--lb-name

The name of the load balancer.

--name -n

The name of the probe.

--resource-group -g

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

az network cross-region-lb probe list

List probes.

az network cross-region-lb probe list --lb-name
                                      --resource-group

Examples

List probes.

az network cross-region-lb probe list -g MyResourceGroup --lb-name MyLb -o table

Required Parameters

--lb-name

The name of the load balancer.

--resource-group -g

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

az network cross-region-lb probe show

Get the details of a probe.

az network cross-region-lb probe show --lb-name
                                      --name
                                      --resource-group

Examples

Get the details of a probe.

az network cross-region-lb probe show -g MyResourceGroup --lb-name MyLb -n MyProbe

Required Parameters

--lb-name

The name of the load balancer.

--name -n

The name of the probe.

--resource-group -g

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

az network cross-region-lb probe update

Update a probe.

az network cross-region-lb probe update [--add]
                                        [--force-string]
                                        [--ids]
                                        [--interval]
                                        [--lb-name]
                                        [--name]
                                        [--path]
                                        [--port]
                                        [--protocol {Http, Https, Tcp}]
                                        [--remove]
                                        [--resource-group]
                                        [--set]
                                        [--threshold]

Examples

Update a probe with a different port and interval.

az network cross-region-lb probe update -g MyResourceGroup --lb-name MyLb -n MyProbe --port 81 --interval 10

Optional Parameters

--add

Add an object to a list of objects by specifying a path and key value pairs. Example: --add property.listProperty <key=value, string or JSON string>.

--force-string

When using 'set' or 'add', preserve string literals instead of attempting to convert to JSON.

--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

Probing time interval in seconds.

--lb-name

The load balancer name.

--name -n

The name of the probe.

--path

The endpoint to interrogate (http only).

--port

The port to interrogate.

--protocol

The protocol to probe.

accepted values: Http, Https, Tcp
--remove

Remove a property or an element from a list. Example: --remove property.list OR --remove propertyToRemove.

--resource-group -g

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

--set

Update an object by specifying a property path and value to set. Example: --set property1.property2=.

--threshold

The number of consecutive probe failures before an instance is deemed unhealthy.