Referenciar recursos já existentes no Bicep

Para fazer referência a um recurso existente que não está implantado no seu arquivo Bicep atual, declare o recurso com a palavra-chave existing. Use a existing palavra-chave ao implantar um recurso que precisa obter um valor de um recurso existente. Você acessa as propriedades do recurso existente por meio de seu nome simbólico.

O recurso não é implantado novamente quando a palavra-chave faz referência a ele existing.

Mesmo escopo

O exemplo a seguir obtém uma conta de armazenamento existente no mesmo grupo de recursos que a implantação atual. Observe que você fornece apenas o nome do recurso existente. As propriedades estão disponíveis por meio do nome simbólico.

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

output blobEndpoint string = stg.properties.primaryEndpoints.blob

Escopo diferente

Defina a scope propriedade para acessar um recurso em um escopo diferente. O exemplo a seguir faz referência a uma conta de armazenamento existente em um grupo de recursos diferente:

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

output blobEndpoint string = stg.properties.primaryEndpoints.blob

Para obter mais informações sobre como definir o escopo, consulte Funções de escopo para Bicep.

Resolução de problemas

Se você tentar fazer referência a um recurso que não existe, você receberá o NotFound erro e sua implantação falhará. Verifique o nome e o escopo do recurso que você está tentando referenciar.

Próximas etapas

Para obter a sintaxe para implantar um recurso, consulte a declaração de recurso no Bicep.