Share via

az fleet updatestrategy

  • Reference

Note

This reference is part of the fleet extension for the Azure CLI (version 2.61.0 or higher). The extension will automatically install the first time you run an az fleet updatestrategy command. Learn more about extensions.

Commands to manage update strategies.

Commands

Name Description Type Status
az fleet updatestrategy create

Creates or updates an update strategy.

 Extension GA
az fleet updatestrategy delete

Deletes a update strategy.

 Extension GA
az fleet updatestrategy list

Lists the fleet's update strategies.

 Extension GA
az fleet updatestrategy show

Shows an update strategy.

 Extension GA
az fleet updatestrategy wait

Wait for a update strategy resource to reach a desired state.

 Extension GA

az fleet updatestrategy create

Creates or updates an update strategy.

az fleet updatestrategy create --fleet-name
                               --name
                               --resource-group
                               --stages
                               [--no-wait]

Examples

Create an update strategy from a JSON file.

az fleet updatestrategy create -g MyFleetResourceGroup -f MyFleetName -n MyUpdateStrategy --stages MyUpdateStrategyFile.json

Required Parameters

--fleet-name -f

Specify the fleet name.

--name -n

Specify name for the fleet update strategy.

--resource-group -g

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

--stages

Path to a JSON file that defines the update strategy.

Optional Parameters

--no-wait

Do not wait for the long-running operation to finish.

Default value: False
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 fleet updatestrategy delete

Deletes a update strategy.

az fleet updatestrategy delete --fleet-name
                               --name
                               --resource-group
                               [--no-wait]
                               [--yes]

Examples

Delete an update strategy.

az fleet updatestrategy delete -g MyFleetResourceGroup -f MyFleetName -n MyUpdateStrategy

Required Parameters

--fleet-name -f

Specify the fleet name.

--name -n

Specify name for the fleet update strategy.

--resource-group -g

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

Optional Parameters

--no-wait

Do not wait for the long-running operation to finish.

Default value: False
--yes -y

Do not prompt for confirmation.

Default value: False
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 fleet updatestrategy list

Lists the fleet's update strategies.

az fleet updatestrategy list --fleet-name
                             --resource-group

Examples

List all update strategies for a given fleet.

az fleet updatestrategy list -g MyFleetResourceGroup -f MyFleetName

Required Parameters

--fleet-name -f

Specify the fleet name.

--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 fleet updatestrategy show

Shows an update strategy.

az fleet updatestrategy show --fleet-name
                             --name
                             --resource-group

Examples

Show the details of an update strategy.

az fleet updatestrategy show -g MyFleetResourceGroup -f MyFleetName -n MyUpdateStrategy

Required Parameters

--fleet-name -f

Specify the fleet name.

--name -n

Specify name for the fleet update strategy.

--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 fleet updatestrategy wait

Wait for a update strategy resource to reach a desired state.

If an operation on an update strategy was interrupted or was started with --no-wait, use this command to wait for it to complete.

az fleet updatestrategy wait --fleet-name
                             --resource-group
                             --update-strategy-name
                             [--created]
                             [--custom]
                             [--deleted]
                             [--exists]
                             [--interval]
                             [--timeout]
                             [--updated]

Required Parameters

--fleet-name -f

Specify the fleet name.

--resource-group -g

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

--update-strategy-name

The name of the UpdateStrategy resource. Required.

Optional Parameters

--created

Wait until created with 'provisioningState' at 'Succeeded'.

Default value: False
--custom

Wait until the condition satisfies a custom JMESPath query. E.g. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Wait until deleted.

Default value: False
--exists

Wait until the resource exists.

Default value: False
--interval

Polling interval in seconds.

Default value: 30
--timeout

Maximum wait in seconds.

Default value: 3600
--updated

Wait until updated with provisioningState at 'Succeeded'.

Default value: False
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.