Compartilhar via

az blueprint artifact template

  • Alteração interruptiva

Note

Essa referência faz parte da extensão de blueprint para a CLI do Azure (versão 2.50.0 ou superior). A extensão instalará automaticamente na primeira vez que você executar um comando az blueprint artifact template. Saiba mais sobre extensões.

Esse grupo de comandos foi substituído implicitamente porque o grupo de comandos 'az blueprint' foi preterido e será removido em uma versão futura. Blueprints e comandos associados serão preteridos já em julho de 2026. Os clientes são incentivados a fazer a transição para Especificações de Modelo e Pilhas de Implementação para oferecer suporte a seus cenários além dessa data. A documentação de migração está disponível em https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint.

Comandos para gerenciar o artefato de modelo do ARM de blueprint.

Comandos

Nome Description Tipo Status
az blueprint artifact template create

Criar artefato de braço de blueprint.

 Extension GA
az blueprint artifact template update

Atualizar o artefato do braço de blueprint.

 Extension GA

az blueprint artifact template create

Alteração interruptiva

Esse comando foi substituído implicitamente porque o grupo de comandos 'az blueprint' foi preterido e será removido em uma versão futura. Blueprints e comandos associados serão preteridos já em julho de 2026. Os clientes são incentivados a fazer a transição para Especificações de Modelo e Pilhas de Implementação para oferecer suporte a seus cenários além dessa data. A documentação de migração está disponível em https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint.

Criar artefato de braço de blueprint.

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

Exemplos

Criar um artefato de braço

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

Parâmetros Exigidos

--artifact-name

Nome do artefato de blueprint.

--blueprint-name

Nome da definição do blueprint.

--template -t

Modelo arm na cadeia de caracteres JSON ou caminho para o arquivo JSON.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--depends-on

Artefatos que precisam ser implantados antes do artefato especificado.

--description

Descrição do artefato de blueprint.

--display-name

DisplayName deste artefato.

--management-group -m

Use o grupo de gerenciamento para o escopo do blueprint.

Propriedade Valor
Grupo de parâmetros: Resource_scope Arguments
--parameters -p

Parâmetros para o artefato de modelo do ARM. Pode ser uma cadeia de caracteres JSON ou um caminho de arquivo JSON.

--resource-group-art

Nome do artefato do grupo de recursos ao qual a política será atribuída.

--subscription -s

Use a assinatura para o escopo do blueprint. Se --management-group não for especificado, --subscription value or the default subscription will be used as the scope.

Propriedade Valor
Grupo de parâmetros: Resource_scope Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az blueprint artifact template update

Alteração interruptiva

Esse comando foi substituído implicitamente porque o grupo de comandos 'az blueprint' foi preterido e será removido em uma versão futura. Blueprints e comandos associados serão preteridos já em julho de 2026. Os clientes são incentivados a fazer a transição para Especificações de Modelo e Pilhas de Implementação para oferecer suporte a seus cenários além dessa data. A documentação de migração está disponível em https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint.

Atualizar o artefato do braço de blueprint.

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

Exemplos

Atualizar um artefato de braço

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

Parâmetros Exigidos

--artifact-name

Nome do artefato de blueprint.

--blueprint-name

Nome da definição do blueprint.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--depends-on

Artefatos que precisam ser implantados antes do artefato especificado. Use '--depends-on' sem valores para remover dependências.

--description

Descrição do artefato de blueprint.

--display-name

DisplayName deste artefato.

--management-group -m

Use o grupo de gerenciamento para o escopo do blueprint.

Propriedade Valor
Grupo de parâmetros: Resource_scope Arguments
--parameters -p

Parâmetros para o artefato de modelo do ARM. Pode ser uma cadeia de caracteres JSON ou um caminho de arquivo JSON.

--resource-group-art

Nome do artefato do grupo de recursos ao qual a política será atribuída.

--subscription -s

Use a assinatura para o escopo do blueprint. Se --management-group não for especificado, --subscription value or the default subscription will be used as the scope.

Propriedade Valor
Grupo de parâmetros: Resource_scope Arguments
--template -t

Modelo arm na cadeia de caracteres JSON ou caminho para o arquivo JSON.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False