Resolver erros para 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 ARM (modelo do Azure Resource Manager). 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 você tentar adicionar tags a um recurso que não existe, receberá esse 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 você receber esse erro durante uma tarefa de gerenciamento, verifique os valores fornecidos para o recurso. Os três valores a serem verificados 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 com Set-AzContext ou az account set. Muitos comandos fornecem um parâmetro de assinatura que permite especificar uma assinatura diferente do contexto atual.

Se você não puder verificar as propriedades, entre no portal do Microsoft Azure. Localize o recurso que você está tentando usar e examine o nome do recurso, o grupo de recursos e a assinatura.

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 tiver especificado que o aplicativo Web depende do plano do Serviço de Aplicativo, o Resource Manager 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 ele ainda não existe. Você evita esse erro definindo uma dependência no aplicativo Web.

Bíceps

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 do serverFarmId aplicativo Web é usada servicePlan.id para criar uma dependência no plano do Serviço de Aplicativo.

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.

JSON

Se um recurso precisar ser implantado após outro recurso, use o elemento dependsOn em seu modelo.

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

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.

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 pela 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 se o recurso existe. A função de referência e as funções list* não criam uma dependência implícita quando o recurso é referenciado por sua 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 do recurso. Você pode usar o portal para exibir a ordem das operações de implantação:

1. Entre no portal.

2. Na Visão geral do grupo de recursos, selecione o link para o histórico de implantação.

   

3. Para o Nome da implantação que você deseja revisar, selecione Eventos relacionados.

   

4. Examine a sequência de eventos para cada recurso. Preste atenção ao status de cada operação e seu 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 foram iniciadas ao mesmo tempo.

   

   A imagem a seguir 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 Bem-sucedida antes que a próxima seja iniciada.

   

Solução 3: Obter recursos externos

Bíceps

O 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 do Serviço de Aplicativo existente 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
  }
}

JSON

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. Essa 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. Se você não fornecê-los, eles serão padronizados para a assinatura e o grupo de recursos atuais. 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 de recurso de 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

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 Resource Manager use a dependência.

Você pode obter a ID da entidade de segurança 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

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. Se você passar o nome da identidade gerenciada para a função de referência , o Resource Manager 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 Resource Manager 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 para 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 de locatário para uma identidade gerenciada aplicada a um conjunto de dimensionamento de máquinas virtuais, use:

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

Solução 5: verifique as funções

Bíceps

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 . Para a 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)
}

JSON

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: após excluir o recurso

Quando você exclui um recurso, pode haver um curto período de tempo em que 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.

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