Del via

az providerhub custom-rollout

  • Reference

Note

This reference is part of the providerhub extension for the Azure CLI (version 2.15.0 or higher). The extension will automatically install the first time you run an az providerhub custom-rollout command. Learn more about extensions.

Manage custom rollout with providerhub.

Commands

Name Description Type Status
az providerhub custom-rollout create

Create the rollout details.

 Extension GA
az providerhub custom-rollout list

Gets the list of the custom rollouts for the given provider.

 Extension GA
az providerhub custom-rollout show

Gets the custom rollout details.

 Extension GA

az providerhub custom-rollout create

Create the rollout details.

az providerhub custom-rollout create --canary
                                     --provider-namespace
                                     --rollout-name

Examples

CustomRollouts_CreateOrUpdate

az providerhub custom-rollout create --canary regions="eastus2euap" regions="centraluseuap" --provider-namespace "Microsoft.Contoso" --rollout-name "eastus2euapShoeBoxTesting"

Required Parameters

--canary

The canary regions to apply the manifest.

Usage: --canary regions=XX

Multiple actions can be specified by using more than one regions=XX argument.

--provider-namespace

The name of the resource provider hosted within ProviderHub.

--rollout-name

The rollout 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 providerhub custom-rollout list

Gets the list of the custom rollouts for the given provider.

az providerhub custom-rollout list --provider-namespace

Examples

CustomRollouts_ListByProviderRegistration

az providerhub custom-rollout list --provider-namespace "Microsoft.Contoso"

Required Parameters

--provider-namespace

The name of the resource provider hosted within ProviderHub.

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 providerhub custom-rollout show

Gets the custom rollout details.

az providerhub custom-rollout show [--ids]
                                   [--provider-namespace]
                                   [--rollout-name]
                                   [--subscription]

Examples

CustomRollouts_Get

az providerhub custom-rollout show --provider-namespace "Microsoft.Contoso" --rollout-name "canaryTesting99"

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.

--provider-namespace

The name of the resource provider hosted within ProviderHub.

--rollout-name

The rollout 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.