Referencie recursos já existentes no Bicep

Para fazer referência a um recurso existente que não está implantado no arquivo Bicep atual, declare o recurso com a existing keyword. Use a existing palavra-chave quando estiver implantando 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 quando a palavra-chave existing faz referência a ele novamente.

O mesmo âmbito de aplicação

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 através do nome simbólico.

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

output blobEndpoint string = stg.properties.primaryEndpoints.blob

Âmbito de aplicação 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.

Solução de problemas

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

Próximos passos

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