Compartilhar via

Instrução using

  • Artigo

A instrução using nos arquivos de parâmetros do Bicep vincula o arquivo a um arquivo Bicep, um modelo do Azure Resource Manager (modelo do ARM) JSON, um módulo do Bicep ou uma especificação de modelo. Uma declaração using deve estar presente em todos os arquivos de parâmetros do Bicep.

Observação

O arquivo de parâmetros do Bicep só tem suporte com a versão 0.18.4 ou posterior da CLI do Bicep, a versão 2.47.0 ou posterior da CLI do Azure e a versão 9.7.1 ou posterior do Azure PowerShell.

Para usar a instrução com modelos do ARM JSON, módulos do 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 os arquivos Bicep:

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

  • Para usar os modelos do ARM JSON:

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

  • Para usar módulos públicos:

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

    Por exemplo:

    using 'br/public:avm/res/storage/storage-account:0.9.0' 

param name = 'mystorage'

  • Para usar módulos privados:

    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 um arquivo bicepconfig.json:

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

    Por exemplo:

    using 'br/storageModule:storage:v1'

  • Para usar especificações 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 um arquivo bicepconfig.json:

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

    Por exemplo:

    using 'ts/myStorage:storageSpec:1.0'

Próximas etapas