Freigeben über

Using statement (Using-Anweisung)

  • Artikel

Die using-Anweisung in Bicep-Parameterdateien bindet die Datei an eine Bicep-Datei, eine Azure Resource Manager-Vorlage (ARM-Vorlage) für JSON, ein Bicep-Modul oder eine Vorlagenspezifikation. Eine using-Deklaration muss in allen Bicep-Parameterdateien vorhanden sein.

Hinweis

Die Bicep-Parameterdatei wird nur in Bicep CLI ab Version 0.18.4, Azure CLI ab Version 2.47.0 und Azure PowerShell ab Version 9.7.1 unterstützt.

Um die Anweisung mit JSON-ARM-Vorlagen, Bicep-Modulen und Vorlagenspezifikationen zu verwenden, benötigen Sie Bicep CLI-Version 0.22.6 oder höher und Azure CLI-Version 2.53.0 oder höher.

Syntax

  • So verwenden Sie Bicep-Dateien:

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

  • So verwenden Sie JSON-ARM-Vorlagen:

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

  • So verwenden Sie öffentliche Module:

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

    Zum Beispiel:

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

param name = 'mystorage'

  • So verwenden Sie private Module:

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

    Zum Beispiel:

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

    So verwenden Sie ein privates Modul mit einem Alias, der in einer bicepconfig.json-Datei definiert ist:

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

    Zum Beispiel:

    using 'br/storageModule:storage:v1'

  • So verwenden Sie Vorlagenspezifikationen:

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

    Zum Beispiel:

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

    So verwenden Sie eine Vorlagenspezifikation mit einem Alias, der in einer bicepconfig.json-Datei definiert ist:

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

    Zum Beispiel:

    using 'ts/myStorage:storageSpec:1.0'

Nächste Schritte