Partilhar via


Resolver erros nos recursos pai

Este artigo descreve o ParentResourceNotFound erro que poderá surgir ao implantar um recurso que depende de um recurso pai. O erro ocorre quando você implanta recursos com um arquivo Bicep ou modelo do Azure Resource Manager (modelo ARM).

Sintoma

Quando se implanta um recurso que é filho de outro recurso, pode-se receber o seguinte erro:

Code=ParentResourceNotFound,
Message=Can not perform requested operation on nested resource. Parent resource 'exampleserver' not found."

Motivo

Quando um recurso é filho de outro, o recurso pai deve existir antes que o recurso filho seja criado. O nome do recurso filho define a conexão com o recurso pai. O nome do recurso filho está no formato <parent-resource-name>/<child-resource-name>. Por exemplo, um Banco de Dados SQL pode ser definido como:

resource sqlDatabase 'Microsoft.Sql/servers/databases@2022-02-01-preview' = {
  name: '${sqlServerName}/${databaseName}'
  ...
}

Para obter mais informações sobre recursos pai e filho do Bicep, consulte Definir nome e tipo para recursos filho no Bicep.

Se você implantar o servidor e o banco de dados no mesmo modelo, mas não especificar uma dependência no servidor, a implantação do banco de dados poderá começar antes da implantação do servidor. Isso faz com que a implantação do banco de dados falhe com o erro ParentResourceNotFound.

Se o recurso pai já existir e não for implantado no mesmo modelo, você receberá o ParentResourceNotFound erro quando o Gerenciador de Recursos não puder associar o recurso filho a um pai. Este erro pode acontecer quando o sub-recurso não está no formato correto. Ou se o recurso filho for implantado em um grupo de recursos diferente do grupo de recursos do recurso pai.

Solução 1: Implantado no mesmo modelo

Para resolver esse erro quando os recursos pai e filho são implantados no mesmo modelo, use uma dependência.

Este exemplo usa um recurso filho aninhado dentro do recurso pai e que cria a dependência. A criança obtém o tipo de recurso e a versão da API a partir do recurso pai.

resource sqlServer 'Microsoft.Sql/servers@2022-02-01-preview' = {
  name: sqlServerName
  properties: {
    ...
  }
  resource sqlDatabase 'databases' = {
    name: databaseName
    ...
  }
}

Para obter mais informações sobre dependências, consulte Declaração de recurso no Bicep.

Solução 2: Implantado em modelos diferentes

Para resolver esse erro quando o recurso pai foi implantado em um modelo diferente, não defina uma dependência. Em vez disso, implemente o filho no mesmo grupo de recursos e forneça o nome do recurso pai.

Este exemplo usa a palavra-chave existing para referenciar um elemento pai que foi implementado num ficheiro separado. O recurso filho usa o parent elemento e o nome simbólico do recurso pai.

param location string = resourceGroup().location
param sqlServerName string
param databaseName string

resource sqlServer 'Microsoft.Sql/servers@2022-02-01-preview' existing = {
  name: sqlServerName
}

resource sqlDatabase 'Microsoft.Sql/servers/databases@2022-02-01-preview' = {
  parent: sqlServer
  name: databaseName
  location: location
}