Resolver erros relacionados ao recurso não encontrado

Este artigo descreve o erro que você vê quando um recurso não pode ser encontrado durante uma operação. Normalmente, você vê esse erro ao implantar recursos com um arquivo Bicep ou modelo do Azure Resource Manager (modelo ARM). Você também vê esse erro ao executar tarefas de gerenciamento e o Azure Resource Manager não consegue encontrar o recurso necessário. Por exemplo, se tentar adicionar etiquetas a um recurso que não existe, receberá este erro.

Sintomas

Há dois códigos de erro que indicam que o recurso não pode ser encontrado. O NotFound erro retorna um resultado semelhante a:

Code=NotFound;
Message=Cannot find ServerFarm with name exampleplan.

O ResourceNotFound erro retorna um resultado semelhante a:

Code=ResourceNotFound;
Message=The Resource 'Microsoft.Storage/storageAccounts/{storage name}' under resource
group {resource group name} was not found.

Motivo

O Resource Manager precisa recuperar as propriedades de um recurso, mas não consegue encontrar o recurso em sua assinatura.

Solução 1: Verificar as propriedades do recurso

Quando receber este erro ao realizar uma tarefa de gestão, verifique os valores que forneceu para o recurso. Os três valores a verificar são:

Nome do recurso
Nome do grupo de recursos
Subscrição

Se você estiver usando o PowerShell ou a CLI do Azure, verifique se está executando comandos na assinatura que contém o recurso. Você pode alterar a assinatura usando Set-AzContext ou az account set. Muitos comandos fornecem um parâmetro de subscrição que lhe permite especificar uma subscrição diferente do contexto atual.

Se não conseguir verificar as propriedades, inicie sessão no portal do Microsoft Azure. Localize o recurso que está a tentar utilizar e examine o nome do recurso, o grupo de recursos e a subscrição.

Solução 2: Definir dependências

Se você receber esse erro ao implantar um modelo, talvez seja necessário adicionar uma dependência. O Resource Manager otimiza as implantações criando recursos em paralelo, quando possível.

Por exemplo, quando você implanta um aplicativo Web, o plano do Serviço de Aplicativo deve existir. Se você não especificou que o aplicativo Web depende do plano do Serviço de Aplicativo, o Gerenciador de Recursos criará os dois recursos ao mesmo tempo. O aplicativo Web falha com um erro de que o recurso do plano do Serviço de Aplicativo não pode ser encontrado porque ainda não existe. Você evita esse erro definindo uma dependência no aplicativo Web.

Bíceps
JSON

Use uma dependência implícita em vez da função resourceId . A dependência é criada usando o nome simbólico e a propriedade ID de um recurso.

Por exemplo, a propriedade da aplicação web serverFarmId usa servicePlan.id para criar uma dependência no plano do App Service.

resource webApp 'Microsoft.Web/sites@2022-03-01' = {
  properties: {
    serverFarmId: servicePlan.id
  }
}

resource servicePlan 'Microsoft.Web/serverfarms@2022-03-01' = {
  name: hostingPlanName
  ...

Para a maioria das implantações, não é necessário usar dependsOn para criar uma dependência explícita.

Evite definir dependências que não são necessárias. Dependências desnecessárias prolongam a duração da implantação porque os recursos não são implantados em paralelo. Além disso, você pode criar dependências circulares que bloqueiam a implantação.

Se um recurso precisar ser implantado depois de outro recurso, use o elemento dependsOn em seu modelo.

{
  "type": "Microsoft.Web/sites",
  "apiVersion": "2022-03-01",
  "dependsOn": [
    "[variables('hostingPlanName')]"
  ],
  ...
}

As funções reference e list* criam uma dependência implícita no recurso referenciado, quando esse recurso é implantado no mesmo modelo e é referenciado por seu nome (não ID do recurso). Portanto, você pode ter mais dependências do que as dependências especificadas na dependsOn propriedade.

A função resourceId não cria uma dependência implícita nem valida a existência do recurso. As funções de referência e lista* não criam uma dependência implícita quando o recurso é referido pelo seu ID de recurso. Para criar uma dependência implícita, passe o nome do recurso implantado no mesmo modelo.

Ordem de implantação

Quando você vê problemas de dependência, precisa obter informações sobre a ordem de implantação de recursos. Você pode usar o portal para exibir a ordem das operações de implantação:

Inicie sessão no portal.
Na Visão geral do grupo de recursos, selecione o link para o histórico de implantação.
Para o Nome da implantação que você deseja revisar, selecione Eventos relacionados.
Examine a sequência de eventos para cada recurso. Preste atenção ao estado de cada operação e ao respetivo carimbo de data/hora. Por exemplo, a imagem a seguir mostra três contas de armazenamento implantadas em paralelo. Observe que as três implantações de conta de armazenamento começaram ao mesmo tempo.

A próxima imagem mostra três contas de armazenamento que não são implantadas em paralelo. A segunda conta de armazenamento depende da primeira conta de armazenamento e a terceira conta de armazenamento depende da segunda conta de armazenamento. A primeira conta de armazenamento é rotulada como Iniciada, Aceita e Sucedida antes que a próxima seja iniciada.

Bicep usa o nome simbólico para criar uma dependência implícita em outro recurso. A palavra-chave existente faz referência a um recurso implantado. Se um recurso existente estiver em um grupo de recursos diferente do recurso que você deseja implantar, inclua o escopo e use a função resourceGroup .

Neste exemplo, é implantado um aplicativo Web que usa um plano existente do Serviço de Aplicativo de outro grupo de recursos.

resource servicePlan 'Microsoft.Web/serverfarms@2022-03-01' existing = {
  name: hostingPlanName
  scope: resourceGroup(rgname)
}

resource webApp 'Microsoft.Web/sites@2022-03-01' = {
  name: siteName
  properties: {
    serverFarmId: servicePlan.id
  }
}

Ao implantar um modelo e você precisar obter um recurso que existe em uma assinatura ou grupo de recursos diferente, use a função resourceId. Esta função retorna o nome totalmente qualificado do recurso.

Os parâmetros de assinatura e grupo de recursos na resourceId função são opcionais. Caso não os forneças, eles terão como padrão a assinatura atual e o grupo de recursos. Ao trabalhar com um recurso em um grupo de recursos ou assinatura diferente, certifique-se de fornecer esses valores.

O exemplo a seguir obtém a ID do recurso para um recurso que existe em um grupo de recursos diferente.

"properties": {
  "name": "[parameters('siteName')]",
  "serverFarmId": "[resourceId('plangroup', 'Microsoft.Web/serverfarms', parameters('hostingPlanName'))]"
}

Solução 4: Obter identidade gerenciada do recurso

Bíceps
JSON

Se você estiver implantando um recurso com uma identidade gerenciada, deverá aguardar até que esse recurso seja implantado antes de recuperar valores na identidade gerenciada. Use uma dependência implícita para o recurso ao qual a identidade é aplicada. Essa abordagem garante que o recurso e a identidade gerenciada sejam implantados antes que o Gerenciador de Recursos use a dependência.

Você pode obter a ID principal e a ID do locatário para uma identidade gerenciada aplicada a uma máquina virtual. Por exemplo, se um recurso de máquina virtual tiver um nome simbólico de vm, use a seguinte sintaxe:

vm.identity.principalId

vm.identity.tenantId

Se você estiver implantando um recurso com uma identidade gerenciada, deverá aguardar até que esse recurso seja implantado antes de recuperar valores na identidade gerenciada. Se você passar o nome da identidade gerenciada para a função de referência , o Gerenciador de Recursos tentará resolver a referência antes que o recurso e a identidade sejam implantados. Em vez disso, passe o nome do recurso ao qual a identidade é aplicada. Essa abordagem garante que o recurso e a identidade gerenciada sejam implantados antes que o Gerenciador de Recursos resolva a função de referência.

Na função de referência, use Full para obter todas as propriedades, incluindo a identidade gerenciada.

O padrão é:

"[reference(resourceId(<resource-provider-namespace>, <resource-name>), <API-version>, 'Full').Identity.propertyName]"

Importante

Não use o padrão:

"[reference(concat(resourceId(<resource-provider-namespace>, <resource-name>),'/providers/Microsoft.ManagedIdentity/Identities/default'),<API-version>).principalId]"

Seu modelo falhará.

Por exemplo, para obter a ID principal de uma identidade gerenciada aplicada a uma máquina virtual, use:

"[reference(resourceId('Microsoft.Compute/virtualMachines', variables('vmName')), '2022-03-01', 'Full').identity.principalId]",

Ou, para obter a ID do locatário para uma identidade gerenciada que é aplicada a um conjunto de escala de máquina virtual, use:

"[reference(resourceId('Microsoft.Compute/virtualMachineScaleSets',  variables('vmNodeType0Name')), '2022-03-01', 'Full').Identity.tenantId]"

Solução 5: Verificar funções

Bíceps
JSON

Você pode usar o nome simbólico de um recurso para obter valores de um recurso. Você pode fazer referência a uma conta de armazenamento no mesmo grupo de recursos ou em outro grupo de recursos usando um nome simbólico. Para obter um valor de um recurso implantado, use a palavra-chave existente . Se um recurso estiver em um grupo de recursos diferente, use scope com a função resourceGroup . Na maioria dos casos, a função de referência não é necessária.

O exemplo a seguir faz referência a uma conta de armazenamento existente em um grupo de recursos diferente.

resource stgAcct 'Microsoft.Storage/storageAccounts@2022-05-01' existing = {
  name: stgname
  scope: resourceGroup(rgname)
}

Ao implantar um modelo, procure expressões que usem as funções reference ou listKeys . Os valores fornecidos variam de acordo com o fato de o recurso estar no mesmo modelo, grupo de recursos e assinatura. Verifique se você está fornecendo os valores de parâmetro necessários para seu cenário. Se o recurso estiver em um grupo de recursos diferente, forneça a ID completa do recurso. Por exemplo, para fazer referência a uma conta de armazenamento em outro grupo de recursos, use:

"[reference(resourceId('exampleResourceGroup', 'Microsoft.Storage/storageAccounts', 'myStorage'), '2022-05-01')]"

Solução 6: Depois de excluir o recurso

Quando você exclui um recurso, pode haver um curto período de tempo quando o recurso aparece no portal, mas não está disponível. Se você selecionar o recurso, receberá um erro informando que o recurso não foi encontrado.

Captura de ecrã do portal do Azure a mostrar um recurso eliminado com uma mensagem de erro 'Não encontrado' na secção Descrição Geral do recurso.

Atualize o portal e o recurso excluído deve ser removido da sua lista de recursos disponíveis. Se um recurso excluído continuar a ser mostrado como disponível por mais do que alguns minutos, entre em contato com o suporte.

Feedback

Esta página foi útil?

Last updated on 2025-04-30