az blueprint artifact template

  • Reference

Note

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

Commands to manage blueprint ARM template artifact.

Commands

Name Description Type Status
az blueprint artifact template create

Create blueprint arm artifact.

 Extension GA
az blueprint artifact template update

Update blueprint arm artifact.

 Extension GA

az blueprint artifact template create

Create blueprint arm artifact.

az blueprint artifact template create --artifact-name
                                      --blueprint-name
                                      --template
                                      [--depends-on]
                                      [--description]
                                      [--display-name]
                                      [--management-group]
                                      [--parameters]
                                      [--resource-group-art]
                                      [--subscription]

Examples

Create an arm artifact

az blueprint artifact template create \
--blueprint-name MyBlueprint --artifact-name MyTemplate \
--parameters path/to/parameter/file --template path/to/template

Required Parameters

--artifact-name

Name of the blueprint artifact.

--blueprint-name

Name of the blueprint definition.

--template -t

ARM template in JSON string or path to JSON file.

Optional Parameters

--depends-on

Artifacts which need to be deployed before the specified artifact.

--description

Description of the blueprint artifact.

--display-name

DisplayName of this artifact.

--management-group -m

Use management group for the scope of the blueprint.

--parameters -p

Parameters for ARM template artifact. It can be a JSON string or JSON file path.

--resource-group-art

Name of the resource group artifact to which the policy will be assigned.

--subscription -s

Use subscription for the scope of the blueprint. If --management-group is not specified, --subscription value or the default subscription will be used as the scope.

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 blueprint artifact template update

Update blueprint arm artifact.

az blueprint artifact template update --artifact-name
                                      --blueprint-name
                                      [--depends-on]
                                      [--description]
                                      [--display-name]
                                      [--management-group]
                                      [--parameters]
                                      [--resource-group-art]
                                      [--subscription]
                                      [--template]

Examples

Update a arm artifact

az blueprint artifact template update \
--blueprint-name MyBlueprint --artifact-name MyTemplate --display-name "My Template"

Required Parameters

--artifact-name

Name of the blueprint artifact.

--blueprint-name

Name of the blueprint definition.

Optional Parameters

--depends-on

Artifacts which need to be deployed before the specified artifact. Use '--depends-on' with no values to remove dependencies.

--description

Description of the blueprint artifact.

--display-name

DisplayName of this artifact.

--management-group -m

Use management group for the scope of the blueprint.

--parameters -p

Parameters for ARM template artifact. It can be a JSON string or JSON file path.

--resource-group-art

Name of the resource group artifact to which the policy will be assigned.

--subscription -s

Use subscription for the scope of the blueprint. If --management-group is not specified, --subscription value or the default subscription will be used as the scope.

--template -t

ARM template in JSON string or path to JSON file.

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.