Partilhar via


Usando a instrução

A using instrução em arquivos de parâmetros Bicep vincula o arquivo a um arquivo Bicep, um modelo JSON Azure Resource Manager (modelo ARM), um módulo Bicep ou uma especificação de modelo. Uma using declaração deve estar presente em todos os arquivos 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 posterior, na CLI do Azure versão 2.47.0 ou posterior e no Azure PowerShell versão 9.7.1 ou posterior.

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 arquivos Bicep:

    using '<path>/<file-name>.bicep'
    
  • Para usar modelos 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 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óximos passos