Référencer les ressources existantes dans Bicep

Pour référencer une ressource existante qui n’est pas déployée dans votre fichier Bicep actuel, déclarez la ressource avec le existing mot clé. Utilisez le existing mot clé lorsque vous déployez une ressource qui doit obtenir une valeur à partir d’une ressource existante. Vous accédez aux propriétés de la ressource existante par le biais de son nom symbolique.

La ressource ne se déploie pas à nouveau lorsque le existing mot clé le référence.

Même étendue

L’exemple suivant montre l’obtention d’un compte de stockage existant dans le même groupe de ressources que le déploiement actuel. Notez que vous fournissez uniquement le nom de la ressource existante. Les propriétés sont disponibles via le nom symbolique.

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

output blobEndpoint string = stg.properties.primaryEndpoints.blob

Étendue différente

Définissez la scope propriété pour accéder à une ressource dans une autre étendue. L’exemple suivant référence un compte de stockage existant dans un autre groupe de ressources :

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

output blobEndpoint string = stg.properties.primaryEndpoints.blob

Pour plus d’informations sur la définition de l’étendue, consultez Fonctions d’étendue pour Bicep.

Résolution des problèmes

Si vous tentez de référencer une ressource qui n’existe pas, vous obtenez l’erreur NotFound et votre déploiement échoue. Vérifiez le nom et l’étendue de la ressource que vous essayez de référencer.

Étapes suivantes

Pour connaître la syntaxe de déploiement d’une ressource, consultez La déclaration de ressource dans Bicep.