az network lb address-pool
Manage address pools of a load balancer.
Commands
Name | Description | Type | Status |
---|---|---|---|
az network lb address-pool address |
Manage backend addresses of the cross-region load balance backend address pool. |
Core | GA |
az network lb address-pool address add |
Add one backend address into the load balance backend address pool. |
Core | GA |
az network lb address-pool address list |
List all backend addresses of the load balance backend address pool. |
Core | GA |
az network lb address-pool address remove |
Remove one backend address from the load balance backend address pool. |
Core | GA |
az network lb address-pool address show |
Show the backend address from the load balance backend address pool. |
Core | GA |
az network lb address-pool address update |
Update the backend address into the load balance backend address pool. |
Core | GA |
az network lb address-pool address wait |
Place the CLI in a waiting state until a condition is met. |
Core | GA |
az network lb address-pool create |
Create load balancer backend address pool. |
Core | GA |
az network lb address-pool delete |
Delete the specified load balancer backend address pool. |
Core | GA |
az network lb address-pool list |
List address pools. |
Core | GA |
az network lb address-pool show |
Get the details of an address pool. |
Core | GA |
az network lb address-pool tunnel-interface |
Manage tunnel interfaces of a load balancer. |
Core | Preview |
az network lb address-pool tunnel-interface add |
Add one tunnel interface into the load balance tunnel interface pool. |
Core | Preview |
az network lb address-pool tunnel-interface list |
List all tunnel interfacees of the load balance tunnel interface pool. |
Core | Preview |
az network lb address-pool tunnel-interface remove |
Remove one tunnel interface from the load balance tunnel interface pool. |
Core | Preview |
az network lb address-pool tunnel-interface show |
Get one tunnel interface of load balance tunnel interface pool. |
Core | Preview |
az network lb address-pool tunnel-interface update |
Update one tunnel interface of load balance tunnel interface pool. |
Core | Preview |
az network lb address-pool tunnel-interface wait |
Place the CLI in a waiting state until a condition is met. |
Core | Preview |
az network lb address-pool update |
Update an address pool. |
Core | GA |
az network lb address-pool wait |
Place the CLI in a waiting state until a condition is met. |
Core | GA |
az network lb address-pool create
Create load balancer backend address pool.
az network lb address-pool create --address-pool-name --name
--lb-name
--resource-group
[--admin-state {Down, None, Up}]
[--backend-address --backend-addresses]
[--drain-period --drain-period-in-seconds]
[--location]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--sync-mode {Automatic, Manual}]
[--tunnel-interfaces]
[--vnet]
Examples
Create an address pool.
az network lb address-pool create -g MyResourceGroup --lb-name MyLb -n MyAddressPool
Create an address pool with several backend addresses using shorthand syntax arguments.
az network lb address-pool create -g MyResourceGroup --lb-name MyLb -n MyAddressPool --vnet MyVnetResource --backend-addresses "[{name:addr1,ip-address:10.0.0.1},{name:addr2,ip-address:10.0.0.2,subnet:subnetName}]"
Create an address pool with several backend addresses using config file
az network lb address-pool create -g MyResourceGroup --lb-name MyLb -n MyAddressPool --backend-addresses config_file.json
Create an address pool with one backend address using key-value arguments.
az network lb address-pool create -g MyResourceGroup --lb-name MyLb -n MyAddressPool --backend-address name=addr1 ip-address=10.0.0.1 subnet=/subscriptions/000/resourceGroups/MyRg/providers/Microsoft.Network/virtualNetworks/vnet/subnets/subnet1
Required Parameters
The name of the backend address pool.
The load balancer name.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Optional Parameters
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Default administrative state to backend addresses in --backend-addresses
.
Property | Value |
---|---|
Parameter group: | Properties Arguments |
Accepted values: | Down, None, Up |
An array of backend addresses. Support shorthand-syntax, json-file and yaml-file. Try "??" to show more. Singular flags: --backend-address
.
Property | Value |
---|---|
Parameter group: | Properties Arguments |
Amount of seconds Load Balancer waits for before sending RESET to client and backend address.
Property | Value |
---|---|
Parameter group: | Properties Arguments |
The location of the backend address pool.
Property | Value |
---|---|
Parameter group: | Properties Arguments |
Do not wait for the long-running operation to finish.
Property | Value |
---|---|
Accepted values: | 0, 1, f, false, n, no, t, true, y, yes |
Backend address synchronous mode for the backend pool.
Property | Value |
---|---|
Parameter group: | Properties Arguments |
Accepted values: | Automatic, Manual |
An array of gateway load balancer tunnel interfaces. Support shorthand-syntax, json-file and yaml-file. Try "??" to show more.
Property | Value |
---|---|
Parameter group: | Properties Arguments |
Name or Id of the default virtual network applied to backend addresses in --backend-addresses
.
Property | Value |
---|---|
Parameter group: | Properties Arguments |
Global Parameters
Increase logging verbosity to show all debug logs.
Property | Value |
---|---|
Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
Property | Value |
---|---|
Default value: | False |
Output format.
Property | Value |
---|---|
Default value: | json |
Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
Property | Value |
---|---|
Default value: | False |
az network lb address-pool delete
Delete the specified load balancer backend address pool.
az network lb address-pool delete --address-pool-name --name
--lb-name
--resource-group
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
Examples
Delete an address pool.
az network lb address-pool delete -g MyResourceGroup --lb-name MyLb -n MyAddressPool
Required Parameters
The name of the backend address pool.
The load balancer name.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Optional Parameters
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Do not wait for the long-running operation to finish.
Property | Value |
---|---|
Accepted values: | 0, 1, f, false, n, no, t, true, y, yes |
Global Parameters
Increase logging verbosity to show all debug logs.
Property | Value |
---|---|
Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
Property | Value |
---|---|
Default value: | False |
Output format.
Property | Value |
---|---|
Default value: | json |
Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
Property | Value |
---|---|
Default value: | False |
az network lb address-pool list
List address pools.
az network lb address-pool list --lb-name
--resource-group
[--max-items]
[--next-token]
Examples
List address pools.
az network lb address-pool list -g MyResourceGroup --lb-name MyLb -o table
Required Parameters
The name of the load balancer.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Optional Parameters
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Total number of items to return in the command's output. If the total number of items available is more than the value specified, a token is provided in the command's output. To resume pagination, provide the token value in --next-token
argument of a subsequent command.
Property | Value |
---|---|
Parameter group: | Pagination Arguments |
Token to specify where to start paginating. This is the token value from a previously truncated response.
Property | Value |
---|---|
Parameter group: | Pagination Arguments |
Global Parameters
Increase logging verbosity to show all debug logs.
Property | Value |
---|---|
Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
Property | Value |
---|---|
Default value: | False |
Output format.
Property | Value |
---|---|
Default value: | json |
Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
Property | Value |
---|---|
Default value: | False |
az network lb address-pool show
Get the details of an address pool.
az network lb address-pool show [--address-pool-name --name]
[--ids]
[--lb-name]
[--resource-group]
[--subscription]
Examples
Get the details of an address pool.
az network lb address-pool show -g MyResourceGroup --lb-name MyLb -n MyAddressPool
Optional Parameters
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
The name of the backend address pool.
Property | Value |
---|---|
Parameter group: | Resource Id Arguments |
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.
Property | Value |
---|---|
Parameter group: | Resource Id Arguments |
The name of the load balancer.
Property | Value |
---|---|
Parameter group: | Resource Id Arguments |
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Property | Value |
---|---|
Parameter group: | Resource Id Arguments |
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Property | Value |
---|---|
Parameter group: | Resource Id Arguments |
Global Parameters
Increase logging verbosity to show all debug logs.
Property | Value |
---|---|
Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
Property | Value |
---|---|
Default value: | False |
Output format.
Property | Value |
---|---|
Default value: | json |
Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Increase logging verbosity. Use --debug for full debug logs.
Property | Value |
---|---|
Default value: | False |
az network lb address-pool update
Update an address pool.
az network lb address-pool update [--add]
[--address-pool-name --name]
[--admin-state {Down, None, Up}]
[--backend-address --backend-addresses]
[--drain-period --drain-period-in-seconds]
[--force-string {0, 1, f, false, n, no, t, true, y, yes}]
[--ids]
[--lb-name]
[--location]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--remove]
[--resource-group]
[--set]
[--subscription]
[--sync-mode {Automatic, Manual}]
[--tunnel-interfaces]
[--vnet]
Examples
Update all backend addresses in the address pool using shorthand syntax
az network lb address-pool update -g MyResourceGroup --lb-name MyLb -n MyAddressPool --vnet MyVnetResource --backend-addresses "[{name:addr1,ip-address:10.0.0.1},{name:addr2,ip-address:10.0.0.2,subnet:subnetName}]"
Update the subnet of the first backend address in the address pool using shorthand syntax
az network lb address-pool update -g MyResourceGroup --lb-name MyLb -n MyAddressPool --backend-addresses [0].subnet=/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyRg/providers/Microsoft.Network/virtualNetworks/vnet/subnets/subnet1
Remove the first backend address in the address pool using shorthand syntax
az network lb address-pool update -g MyResourceGroup --lb-name MyLb -n MyAddressPool --backend-addresses [0]=null
Remove all the backend addresses in the address pool
az network lb address-pool update -g MyResourceGroup --lb-name MyLb -n MyAddressPool --backend-addresses null
Optional Parameters
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
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>
.
Property | Value |
---|---|
Parameter group: | Generic Update Arguments |
The name of the backend address pool.
Property | Value |
---|---|
Parameter group: | Resource Id Arguments |
Default administrative state to backend addresses in --backend-addresses
.
Property | Value |
---|---|
Parameter group: | Properties Arguments |
Accepted values: | Down, None, Up |
An array of backend addresses. Support shorthand-syntax, json-file and yaml-file. Try "??" to show more. Singular flags: --backend-address
.
Property | Value |
---|---|
Parameter group: | Properties Arguments |
Amount of seconds Load Balancer waits for before sending RESET to client and backend address.
Property | Value |
---|---|
Parameter group: | Properties Arguments |
When using 'set' or 'add', preserve string literals instead of attempting to convert to JSON.
Property | Value |
---|---|
Parameter group: | Generic Update Arguments |
Accepted values: | 0, 1, f, false, n, no, t, true, y, yes |
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.
Property | Value |
---|---|
Parameter group: | Resource Id Arguments |
The name of the load balancer.
Property | Value |
---|---|
Parameter group: | Resource Id Arguments |
The location of the backend address pool.
Property | Value |
---|---|
Parameter group: | Properties Arguments |
Do not wait for the long-running operation to finish.
Property | Value |
---|---|
Accepted values: | 0, 1, f, false, n, no, t, true, y, yes |
Remove a property or an element from a list. Example: --remove property.list <indexToRemove>
OR --remove propertyToRemove
.
Property | Value |
---|---|
Parameter group: | Generic Update Arguments |
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Property | Value |
---|---|
Parameter group: | Resource Id Arguments |
Update an object by specifying a property path and value to set. Example: --set property1.property2=<value>
.
Property | Value |
---|---|
Parameter group: | Generic Update Arguments |
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Property | Value |
---|---|
Parameter group: | Resource Id Arguments |
Backend address synchronous mode for the backend pool.
Property | Value |
---|---|
Parameter group: | Properties Arguments |
Accepted values: | Automatic, Manual |
An array of gateway load balancer tunnel interfaces. Support shorthand-syntax, json-file and yaml-file. Try "??" to show more.
Property | Value |
---|---|
Parameter group: | Properties Arguments |
Name or Id of the default virtual network applied to backend addresses in --backend-addresses
.
Property | Value |
---|---|
Parameter group: | Properties Arguments |
Global Parameters
Increase logging verbosity to show all debug logs.
Property | Value |
---|---|
Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
Property | Value |
---|---|
Default value: | False |
Output format.
Property | Value |
---|---|
Default value: | json |
Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Increase logging verbosity. Use --debug for full debug logs.
Property | Value |
---|---|
Default value: | False |
az network lb address-pool wait
Place the CLI in a waiting state until a condition is met.
az network lb address-pool wait [--address-pool-name --name]
[--created]
[--custom]
[--deleted]
[--exists]
[--ids]
[--interval]
[--lb-name]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
Optional Parameters
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
The name of the backend address pool.
Property | Value |
---|---|
Parameter group: | Resource Id Arguments |
Wait until created with 'provisioningState' at 'Succeeded'.
Property | Value |
---|---|
Parameter group: | Wait Condition Arguments |
Default value: | False |
Wait until the condition satisfies a custom JMESPath query. E.g. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Property | Value |
---|---|
Parameter group: | Wait Condition Arguments |
Wait until deleted.
Property | Value |
---|---|
Parameter group: | Wait Condition Arguments |
Default value: | False |
Wait until the resource exists.
Property | Value |
---|---|
Parameter group: | Wait Condition Arguments |
Default value: | False |
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.
Property | Value |
---|---|
Parameter group: | Resource Id Arguments |
Polling interval in seconds.
Property | Value |
---|---|
Parameter group: | Wait Condition Arguments |
Default value: | 30 |
The name of the load balancer.
Property | Value |
---|---|
Parameter group: | Resource Id Arguments |
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Property | Value |
---|---|
Parameter group: | Resource Id Arguments |
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Property | Value |
---|---|
Parameter group: | Resource Id Arguments |
Maximum wait in seconds.
Property | Value |
---|---|
Parameter group: | Wait Condition Arguments |
Default value: | 3600 |
Wait until updated with provisioningState at 'Succeeded'.
Property | Value |
---|---|
Parameter group: | Wait Condition Arguments |
Default value: | False |
Global Parameters
Increase logging verbosity to show all debug logs.
Property | Value |
---|---|
Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
Property | Value |
---|---|
Default value: | False |
Output format.
Property | Value |
---|---|
Default value: | json |
Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Increase logging verbosity. Use --debug for full debug logs.
Property | Value |
---|---|
Default value: | False |