Partilhar via


Recursos existentes no Bicep

Para referenciar um recurso existente que não está implementado no ficheiro Bicep atual, declare o recurso com a existing palavra-chave. Utilize a existing palavra-chave quando estiver a implementar um recurso que precisa de obter um valor a partir de um recurso existente. Pode aceder às propriedades do recurso existente através do respetivo nome simbólico.

O recurso não é reimplementado quando referenciado com a existing palavra-chave.

Mesmo âmbito

O exemplo seguinte obtém uma conta de armazenamento existente no mesmo grupo de recursos que a implementação atual. Repare que fornece apenas o nome do recurso existente. As propriedades estão disponíveis através do nome simbólico.

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

output blobEndpoint string = stg.properties.primaryEndpoints.blob

Âmbito diferente

Defina a scope propriedade para aceder a um recurso num âmbito diferente. O exemplo seguinte faz referência a uma conta de armazenamento existente num grupo de recursos diferente.

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

output blobEndpoint string = stg.properties.primaryEndpoints.blob

Para obter mais informações sobre como definir o âmbito, veja Funções de âmbito do Bicep.

Resolução de problemas

Se tentar referenciar um recurso que não existe, obtém o erro e a NotFound implementação falha. Verifique o nome e o âmbito do recurso que está a tentar referenciar.

Passos seguintes

Para que a sintaxe implemente um recurso, veja Declaração de recursos no Bicep.