Verweisen auf vorhandene Ressourcen in Bicep

Um auf eine vorhandene Ressource zu verweisen, die nicht in Ihrer aktuellen Bicep-Datei bereitgestellt wird, deklarieren Sie die Ressource mit dem existing Schlüsselwort. Verwenden Sie das existing Schlüsselwort, wenn Sie eine Ressource bereitstellen, die einen Wert aus einer vorhandenen Ressource abrufen muss. Sie greifen über den symbolischen Namen auf die Eigenschaften der vorhandenen Ressource zu.

Die Ressource wird nicht erneut bereitgestellt, wenn das existing Schlüsselwort darauf verweist.

Gleicher Geltungsbereich

Im folgenden Beispiel wird ein vorhandenes Speicherkonto in derselben Ressourcengruppe wie die aktuelle Bereitstellung angezeigt. Beachten Sie, dass Sie nur den Namen der vorhandenen Ressource angeben. Die Eigenschaften sind über den symbolischen Namen verfügbar.

resource stg 'Microsoft.Storage/storageAccounts@2025-06-01' existing = {
  name: 'examplestorage'
}

output blobEndpoint string = stg.properties.primaryEndpoints.blob

Unterschiedlicher Bereich

Legen Sie die scope Eigenschaft fest, um auf eine Ressource in einem anderen Bereich zuzugreifen. Im folgenden Beispiel wird auf ein vorhandenes Speicherkonto in einer anderen Ressourcengruppe verwiesen:

resource stg 'Microsoft.Storage/storageAccounts@2025-06-01' existing = {
  name: 'examplestorage'
  scope: resourceGroup(exampleRG)
}

output blobEndpoint string = stg.properties.primaryEndpoints.blob

Weitere Informationen zum Festlegen des Bereichs finden Sie unter Bereichsfunktionen für Bicep.

Problembehandlung

Wenn Sie versuchen, auf eine Ressource zu verweisen, die nicht vorhanden ist, wird der NotFound Fehler angezeigt, und die Bereitstellung schlägt fehl. Überprüfen Sie den Namen und den Umfang der Ressource, auf die Sie verweisen möchten.

Nächste Schritte

Informationen zur Syntax zum Bereitstellen einer Ressource finden Sie unter "Ressourcendeklaration" in Bicep.