Partilhar via


Usando a instrução

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

Nota

O arquivo de parâmetros do Bicep só é suportado na CLI do Bicep versão 0.18.4 ou mais recente, 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 ARM, módulos Bicep e especificações de modelo, você precisa ter a CLI do Bicep versão 0.22.6 ou posterior e a CLI do Azure versão 2.53.0 ou posterior.

Sintaxe

  • Para usar o arquivo Bicep:

    using '<path>/<file-name>.bicep'
    
  • Para usar o modelo JSON ARM:

    using '<path>/<file-name>.json'
    
  • Para utilizar 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 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 do 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óximos passos

  • Para saber mais sobre os arquivos de parâmetros do Bicep, consulte Arquivo de parâmetros.
  • Para saber mais sobre como configurar aliases no bicepconfig.json, consulte Arquivo de configuração do Bicep.