Instrução using

  • Artigo

A instrução using em Arquivos de parâmetro Bicep vincula o Arquivo de parâmetros Bicep a um Arquivo Bicep, um modelo JSON do ARM, um módulo Bicep ou uma especificação de modelo. Uma declaração using deve estar presente em qualquer arquivo de parâmetros Bicep.

Observação

O arquivo de parâmetros Bicep só tem suporte na CLI do Bicep versão 0.18.4 ou mais recente e na CLI do Azure versão 2.47.0 ou mais recente e no Azure PowerShell versão 9.7.1 ou mais recente.

Para usar a instrução com modelos JSON do ARM, módulos Bicep e especificações de modelo, você precisa ter a versão 0.22.6 ou posterior da CLI do Bicep e a versão 2.53.0 ou posterior da CLI do Azure.

Sintaxe

  • Para usar o arquivo Bicep:

    using '<path>/<file-name>.bicep'

  • Para usar o modelo JSON do ARM:

    using '<path>/<file-name>.json'

  • Para usar o módulo público:

    using 'br/public:<file-path>:<tag>'

    Por exemplo:

    using 'br/public:storage/storage-account:3.0.1'

param name = 'mystorage'

  • Para usar o módulo privado:

    using 'br:<acr-name>.azurecr.io/bicep/<file-path>:<tag>'

    Por exemplo:

    using 'br:myacr.azurecr.io/bicep/modules/storage:v1'

    Para usar um módulo privado com um alias definido em bicepconfig.json:

    using 'br/<alias>:<file>:<tag>'

    Por exemplo:

    using 'br/storageModule:storage:v1'

  • Para usar a especificação de modelo:

    using 'ts:<subscription-id>/<resource-group-name>/<template-spec-name>:<tag>

    Por exemplo:

    using 'ts:00000000-0000-0000-0000-000000000000/myResourceGroup/storageSpec:1.0'

    Para usar uma especificação de modelo com um alias definido em bicepconfig.json:

    using 'ts/<alias>:<template-spec-name>:<tag>'

    Por exemplo:

    using 'ts/myStorage:storageSpec:1.0'

Próximas etapas