Usuwanie błędów dotyczących nieznalezionych zasobów

Artykuł
06/01/2023

W tym artykule opisano błąd, który występuje, gdy nie można odnaleźć zasobu podczas operacji. Zazwyczaj ten błąd występuje podczas wdrażania zasobów przy użyciu pliku Bicep lub szablonu usługi Azure Resource Manager (szablon usługi ARM). Ten błąd jest również wyświetlany podczas wykonywania zadań zarządzania, a usługa Azure Resource Manager nie może odnaleźć wymaganego zasobu. Jeśli na przykład spróbujesz dodać tagi do zasobu, który nie istnieje, zostanie wyświetlony ten błąd.

Objawy

Istnieją dwa kody błędów wskazujące, że nie można odnaleźć zasobu. Błąd NotFound zwraca wynik podobny do następującego:

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

Błąd ResourceNotFound zwraca wynik podobny do następującego:

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

Przyczyna

Resource Manager musi pobrać właściwości zasobu, ale nie może znaleźć zasobu w subskrypcji.

Rozwiązanie 1. Sprawdzanie właściwości zasobu

Po wystąpieniu tego błędu podczas wykonywania zadania zarządzania sprawdź wartości podane dla zasobu. Trzy wartości do sprawdzenia to:

Nazwa zasobu
Nazwa grupy zasobów
Subskrypcja

Jeśli używasz programu PowerShell lub interfejsu wiersza polecenia platformy Azure, sprawdź, czy używasz poleceń w subskrypcji zawierającej zasób. Subskrypcję można zmienić za pomocą polecenia Set-AzContext lub az account set. Wiele poleceń udostępnia parametr subskrypcji, który umożliwia określenie innej subskrypcji niż bieżący kontekst.

Jeśli nie możesz zweryfikować właściwości, zaloguj się do witryny Microsoft Azure Portal. Znajdź zasób, którego próbujesz użyć, i sprawdź nazwę zasobu, grupę zasobów oraz subskrypcję.

Rozwiązanie 2. Ustawianie zależności

Jeśli ten błąd występuje podczas wdrażania szablonu, może być konieczne dodanie zależności. Resource Manager optymalizuje wdrożenia, tworząc zasoby równolegle, gdy jest to możliwe.

Na przykład podczas wdrażania aplikacji internetowej musi istnieć plan App Service. Jeśli nie określono, że aplikacja internetowa zależy od planu App Service, Resource Manager tworzy oba zasoby w tym samym czasie. Aplikacja internetowa kończy się niepowodzeniem z powodu błędu, że nie można odnaleźć zasobu planu App Service, ponieważ jeszcze nie istnieje. Ten błąd można zapobiec, ustawiając zależność w aplikacji internetowej.

Bicep
JSON

Użyj niejawnej zależności , a nie funkcji resourceId . Zależność jest tworzona przy użyciu symbolicznej nazwy zasobu i właściwości ID.

Na przykład właściwość aplikacji internetowej używa servicePlan.id metody do utworzenia serverFarmId zależności od planu App Service.

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

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

W przypadku większości wdrożeń nie jest konieczne utworzenie dependsOnjawnej zależności.

Unikaj ustawiania zależności, które nie są potrzebne. Niepotrzebne zależności wydłużają czas trwania wdrożenia, ponieważ zasoby nie są wdrażane równolegle. Ponadto można tworzyć zależności cykliczne, które blokują wdrożenie.

Jeśli zasób musi zostać wdrożony po innym zasobie, użyj elementu dependsOn w szablonie.

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

Funkcje odwołania i listy* tworzą niejawną zależność od przywoływanego zasobu, gdy ten zasób jest wdrażany w tym samym szablonie i jest przywoływane przez jego nazwę (a nie identyfikator zasobu). W związku z tym może istnieć więcej zależności niż zależności określone we dependsOn właściwości .

Funkcja resourceId nie tworzy niejawnej zależności ani nie sprawdza, czy zasób istnieje. Funkcje funkcji referencyjnej i listy* nie tworzą niejawnej zależności, gdy zasób jest określany przez jego identyfikator zasobu. Aby utworzyć zależność niejawną, przekaż nazwę zasobu wdrożonego w tym samym szablonie.

Kolejność wdrażania

Gdy widzisz problemy z zależnościami, musisz uzyskać wgląd w kolejność wdrażania zasobów. Za pomocą portalu można wyświetlić kolejność operacji wdrażania:

Zaloguj się do portalu.
W obszarze Przegląd grupy zasobów wybierz link do historii wdrożenia.
W polu Nazwa wdrożenia , którą chcesz przejrzeć, wybierz pozycję Powiązane zdarzenia.
Przeanalizuj sekwencję zdarzeń dla każdego zasobu. Zwróć uwagę na stan każdej operacji i sygnaturę czasową. Na przykład na poniższej ilustracji przedstawiono trzy konta magazynu wdrożone równolegle. Zwróć uwagę, że trzy wdrożenia konta magazynu rozpoczęły się w tym samym czasie.

Następny obraz przedstawia trzy konta magazynu, które nie są wdrażane równolegle. Drugie konto magazynu zależy od pierwszego konta magazynu, a trzecie konto magazynu zależy od drugiego konta magazynu. Pierwsze konto magazynu ma etykietę Started (Uruchomione), Accepted (Zaakceptowane) i Succeeded (Powodzenie ) przed rozpoczęciem następnego.

Rozwiązanie 3. Pobieranie zasobu zewnętrznego

Bicep
JSON

Bicep używa nazwy symbolicznej do utworzenia niejawnej zależności od innego zasobu. Istniejące słowo kluczowe odwołuje się do wdrożonego zasobu. Jeśli istniejący zasób znajduje się w innej grupie zasobów niż zasób, który chcesz wdrożyć, dołącz zakres i użyj funkcji resourceGroup .

W tym przykładzie wdrożono aplikację internetową, która korzysta z istniejącego planu App Service z innej grupy zasobów.

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
  }
}

Podczas wdrażania szablonu i musisz uzyskać zasób, który istnieje w innej subskrypcji lub grupie zasobów, użyj funkcji resourceId. Ta funkcja zwraca w pełni kwalifikowaną nazwę zasobu.

Parametry subskrypcji i grupy zasobów w resourceId funkcji są opcjonalne. Jeśli ich nie podasz, są one domyślne dla bieżącej subskrypcji i grupy zasobów. Podczas pracy z zasobem w innej grupie zasobów lub subskrypcji upewnij się, że podajesz te wartości.

Poniższy przykład pobiera identyfikator zasobu dla zasobu, który istnieje w innej grupie zasobów.

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

Rozwiązanie 4. Uzyskiwanie tożsamości zarządzanej z zasobu

Bicep
JSON

Jeśli wdrażasz zasób z tożsamością zarządzaną, musisz poczekać, aż ten zasób zostanie wdrożony przed pobraniem wartości w tożsamości zarządzanej. Użyj niejawnej zależności dla zasobu, do którego jest stosowana tożsamość. Takie podejście zapewnia, że zasób i tożsamość zarządzana są wdrażane przed Resource Manager używa zależności.

Możesz uzyskać identyfikator podmiotu zabezpieczeń i identyfikator dzierżawy dla tożsamości zarządzanej zastosowanej do maszyny wirtualnej. Jeśli na przykład zasób maszyny wirtualnej ma symboliczną nazwę vm, użyj następującej składni:

vm.identity.principalId

vm.identity.tenantId

Jeśli wdrażasz zasób z tożsamością zarządzaną, musisz poczekać, aż ten zasób zostanie wdrożony przed pobraniem wartości w tożsamości zarządzanej. Jeśli przekażesz nazwę tożsamości zarządzanej do funkcji referencyjnej, Resource Manager spróbuje rozpoznać odwołanie przed wdrożeniem zasobu i tożsamości. Zamiast tego przekaż nazwę zasobu, do którego jest stosowana tożsamość. Takie podejście zapewnia, że zasób i tożsamość zarządzana są wdrażane przed Resource Manager rozwiąże funkcję referencyjną.

W funkcji referencyjnej użyj polecenia Full , aby pobrać wszystkie właściwości, w tym tożsamość zarządzaną.

Wzorzec to:

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

Ważne

Nie używaj wzorca:

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

Szablon zakończy się niepowodzeniem.

Aby na przykład uzyskać identyfikator podmiotu zabezpieczeń dla tożsamości zarządzanej, która jest stosowana do maszyny wirtualnej, użyj:

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

Aby uzyskać identyfikator dzierżawy dla tożsamości zarządzanej, która jest stosowana do zestawu skalowania maszyn wirtualnych, użyj:

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

Możesz użyć symbolicznej nazwy zasobu, aby pobrać wartości z zasobu. Możesz odwoływać się do konta magazynu w tej samej grupie zasobów lub innej grupie zasobów przy użyciu nazwy symbolicznej. Aby uzyskać wartość z wdrożonego zasobu, użyj istniejącego słowa kluczowego. Jeśli zasób znajduje się w innej grupie zasobów, użyj jej scope z funkcją resourceGroup . W większości przypadków funkcja referencyjna nie jest potrzebna.

Poniższy przykład odwołuje się do istniejącego konta magazynu w innej grupie zasobów.

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

Podczas wdrażania szablonu poszukaj wyrażeń, które używają funkcji reference lub listKeys . Podane wartości różnią się w zależności od tego, czy zasób znajduje się w tym samym szablonie, grupie zasobów i subskrypcji. Sprawdź, czy podajesz wymagane wartości parametrów dla danego scenariusza. Jeśli zasób znajduje się w innej grupie zasobów, podaj pełny identyfikator zasobu. Aby na przykład odwołać się do konta magazynu w innej grupie zasobów, użyj:

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

Rozwiązanie 6. Po usunięciu zasobu

Po usunięciu zasobu może wystąpić krótki czas wyświetlania zasobu w portalu, ale nie jest dostępny. Jeśli wybierzesz zasób, zostanie wyświetlony komunikat o błędzie, że zasób nie został znaleziony.

Zrzut ekranu przedstawiający Azure Portal przedstawiający usunięty zasób z komunikatem o błędzie

Odśwież portal i usunięty zasób powinien zostać usunięty z listy dostępnych zasobów. Jeśli usunięty zasób będzie nadal wyświetlany jako dostępny przez więcej niż kilka minut, skontaktuj się z pomocą techniczną.