Usuwanie błędów dotyczących nie odnalezionych zasobów

2025-05-04

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 występuje również 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

Usługa Resource Manager musi pobrać właściwości zasobu, ale nie może znaleźć zasobu w ramach 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 uruchamiasz polecenia w subskrypcji zawierającej zasób. Można zmienić subskrypcję, używając 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. Usługa Resource Manager optymalizuje wdrożenia, tworząc zasoby równolegle, gdy jest to możliwe.

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

Biceps
JSON

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

Na przykład właściwość aplikacji serverFarmId internetowej używa servicePlan.id do utworzenia zależności od planu usługi 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 większości przypadków przy wdrożeniach 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 utworzyć 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 referencja i lista tworzą niejawną zależność od odnoszonego zasobu, gdy ten zasób jest wdrażany w tym samym szablonie i jest odnoszony za pomocą jego nazwy (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 sprawdza, czy zasób istnieje. Funkcje reference i list* 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.
Aby przejrzeć Nazwę wdrożenia, wybierz Powiązane zdarzenia.
Sprawdź sekwencję zdarzeń dla każdego zasobu. Zwróć uwagę na stan każdej operacji i sygnaturę czasową. Na przykład, na poniższym obrazie przedstawiono trzy konta magazynowe wdrożone równolegle. Zwróć uwagę, że trzy wdrożenia konta przechowywania rozpoczęły się równocześnie.

Następny obraz przedstawia trzy kontenery magazynowe, 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 jest oznaczone jako Rozpoczęte, Zaakceptowane i Zakończone zanim zostanie uruchomione następne.

Rozwiązanie 3. Pobieranie zasobu zewnętrznego

Biceps
JSON

Bicep używa nazwy symbolicznej do tworzenia 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 usługi 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.

Przykład poniżej uzyskuje identyfikator dla zasobu, który znajduje się 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

Biceps
JSON

Jeśli wdrażasz zasób przy użyciu tożsamości zarządzanej, 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 zarządzana tożsamość są wdrożone, zanim Resource Manager użyje zależności.

Identyfikator główny i identyfikator dzierżawy można uzyskać dla tożsamości zarządzanej przypisanej 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 przy użyciu tożsamości zarządzanej, 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 , usługa 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 gwarantuje, że zasób i tożsamość zarządzana zostaną wdrożone, zanim usługa Resource Manager rozpozna funkcję referencyjną.

W funkcji reference 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 uzyskać wartości z zasobu. Możesz odwołać 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 funkcji scoperesourceGroup . 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

Istnieje krótki okres po usunięciu zasobu, gdy zasób jest nadal wyświetlany w portalu, ale nie jest dostępny. Jeśli wybierzesz zasób, zostanie wyświetlony błąd, że zasób nie zostanie znaleziony.

Zrzut ekranu witryny 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ą.