A nem található erőforrás hibáinak elhárítása

Cikk
06/01/2023

Ez a cikk azt a hibát ismerteti, amely akkor jelenik meg, ha egy erőforrás nem található egy művelet során. Ez a hiba általában akkor jelenik meg, ha bicep-fájllal vagy Azure Resource Manager-sablonnal (ARM-sablonnal) helyez üzembe erőforrásokat. Ez a hiba akkor is megjelenik, ha felügyeleti feladatokat végez, és az Azure Resource Manager nem találja a szükséges erőforrást. Ha például nem létező erőforráshoz próbál címkéket hozzáadni, ez a hibaüzenet jelenik meg.

Hibajelenségek

Két hibakód jelzi, hogy az erőforrás nem található. A NotFound hiba a következőhöz hasonló eredményt ad vissza:

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

A ResourceNotFound hiba a következőhöz hasonló eredményt ad vissza:

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

Ok

Resource Manager le kell kérnie egy erőforrás tulajdonságait, de nem találja az erőforrást az előfizetésében.

1. megoldás: Erőforrás tulajdonságainak ellenőrzése

Ha egy felügyeleti feladat végrehajtása közben kapja ezt a hibát, ellenőrizze, milyen értékeket adott meg az erőforráshoz. A három ellenőrizendő érték a következő:

Erőforrás neve
Erőforráscsoport neve
Előfizetés

Ha PowerShellt vagy Azure CLI-t használ, ellenőrizze, hogy az erőforrást tartalmazó előfizetésben futtat-e parancsokat. Az előfizetést a Set-AzContext vagy az az account set paranccsal módosíthatja. Számos parancsnál megadható egy előfizetési paraméter, amellyel az aktuális környezettől eltérő előfizetést is megadhat.

Ha nem tudja ellenőrizni a tulajdonságokat, jelentkezzen be a Microsoft Azure Portal. Keresse meg a használni kívánt erőforrást, és vizsgálja meg az erőforrás nevét, az erőforráscsoportot és az előfizetést.

2. megoldás: Függőségek beállítása

Ha ez a hiba egy sablon üzembe helyezésekor jelenik meg, előfordulhat, hogy hozzá kell adnia egy függőséget. Resource Manager optimalizálja az üzemelő példányokat az erőforrások párhuzamos létrehozásával, ha lehetséges.

Webalkalmazás üzembe helyezésekor például léteznie kell a App Service csomagnak. Ha még nem adta meg, hogy a webalkalmazás a App Service-csomagtól függ, Resource Manager egyidejűleg mindkét erőforrást létrehozza. A webalkalmazás hibaüzenettel meghiúsul, amely szerint a App Service-csomag erőforrása nem található, mert még nem létezik. Ezt a hibát úgy előzheti meg, hogy beállít egy függőséget a webalkalmazásban.

Bicep
JSON

Használjon implicit függőséget a resourceId függvény helyett. A függőség egy erőforrás szimbolikus nevének és AZONOSÍTÓ tulajdonságának használatával jön létre.

A webalkalmazás tulajdonsága serverFarmId például a App Service csomag függőségének létrehozására használjaservicePlan.id.

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

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

A legtöbb üzembe helyezéshez nem szükséges dependsOnexplicit függőséget létrehozni.

Kerülje a nem szükséges függőségek beállítását. A szükségtelen függőségek meghosszabbítják az üzembe helyezés időtartamát, mivel az erőforrások nincsenek párhuzamosan üzembe helyezve. Emellett létrehozhat körkörös függőségeket is, amelyek blokkolják az üzembe helyezést.

Ha egy erőforrást egy másik erőforrás után kell üzembe helyezni, használja a sablon dependsOn elemét.

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

A hivatkozási és listázási* függvény implicit függőséget hoz létre a hivatkozott erőforrástól, ha az erőforrás ugyanabban a sablonban van üzembe helyezve, és a neve hivatkozik rá (nem az erőforrás-azonosítóra). Ezért előfordulhat, hogy több függősége van, mint a tulajdonságban dependsOn megadott függőségeknek.

A resourceId függvény nem hoz létre implicit függőséget, és nem ellenőrzi, hogy létezik-e az erőforrás. A referenciafüggvény és a list* függvény nem hoz létre implicit függőséget, ha az erőforrás-azonosító hivatkozik rá. Implicit függőség létrehozásához adja meg az ugyanabban a sablonban üzembe helyezett erőforrás nevét.

Üzembe helyezési sorrend

Ha függőségi problémákat tapasztal, betekintést kell nyernie az erőforrások üzembe helyezésének sorrendjébe. A portálon megtekintheti az üzembehelyezési műveletek sorrendjét:

Jelentkezzen be a portálra.
Az erőforráscsoport Áttekintés lapján válassza ki az üzembe helyezési előzmények hivatkozását.
A megtekinteni kívánt üzemelő példány neveként válassza a Kapcsolódó események lehetőséget.
Vizsgálja meg az egyes erőforrások eseménysorozatát. Figyeljen az egyes műveletek állapotára és az időbélyegre. Az alábbi képen például három, párhuzamosan üzembe helyezett tárfiók látható. Figyelje meg, hogy a három tárfiók üzembe helyezése egyszerre indult el.

A következő képen három tárfiók látható, amelyek nincsenek párhuzamosan üzembe helyezve. A második tárfiók az első tárfióktól, a harmadik pedig a második tárfióktól függ. Az első tárfiók a következő kezdés előtt Elindítva, Elfogadva és Sikeres címkével van ellátva.

A Bicep a szimbolikus névvel implicit függőséget hoz létre egy másik erőforráshoz. A meglévő kulcsszó egy üzembe helyezett erőforrásra hivatkozik. Ha egy meglévő erőforrás más erőforráscsoportban található, mint az üzembe helyezni kívánt erőforrás, adja meg a hatókört , és használja a resourceGroup függvényt.

Ebben a példában egy webalkalmazást helyezünk üzembe, amely egy másik erőforráscsoportból származó meglévő App Service csomagot használ.

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

Sablon üzembe helyezésekor és egy másik előfizetésben vagy erőforráscsoportban található erőforrást kell beszereznie, használja a resourceId függvényt. Ez a függvény az erőforrás teljes nevét adja vissza.

A függvény előfizetési és erőforráscsoport-paraméterei resourceId nem kötelezőek. Ha nem adja meg őket, azok alapértelmezés szerint az aktuális előfizetésre és erőforráscsoportra vannak beszedve. Ha egy másik erőforráscsoportban vagy előfizetésben lévő erőforrással dolgozik, győződjön meg arról, hogy ezeket az értékeket adja meg.

Az alábbi példa lekéri egy másik erőforráscsoportban található erőforrás erőforrás-azonosítóját.

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

4. megoldás: Felügyelt identitás lekérése erőforrásból

Bicep
JSON

Ha felügyelt identitással helyez üzembe egy erőforrást, meg kell várnia az erőforrás üzembe helyezését, mielőtt értékeket kér le a felügyelt identitáson. Használjon implicit függőséget ahhoz az erőforráshoz, amelyre az identitás vonatkozik. Ez a megközelítés biztosítja, hogy az erőforrás és a felügyelt identitás üzembe legyen helyezve, mielőtt Resource Manager használni a függőséget.

Lekérheti egy virtuális gépre alkalmazott felügyelt identitás egyszerű azonosítóját és bérlőazonosítóját. Ha például egy virtuálisgép-erőforrásnak szimbolikus neve vmvan, használja a következő szintaxist:

vm.identity.principalId

vm.identity.tenantId

Ha felügyelt identitással helyez üzembe egy erőforrást, meg kell várnia az erőforrás üzembe helyezését, mielőtt értékeket kér le a felügyelt identitáson. Ha átadja a felügyelt identitás nevét a referenciafüggvénynek, Resource Manager megpróbálja feloldani a hivatkozást az erőforrás és az identitás üzembe helyezése előtt. Ehelyett adja meg annak az erőforrásnak a nevét, amellyel az identitást alkalmazza. Ez a megközelítés biztosítja, hogy az erőforrás és a felügyelt identitás üzembe legyen helyezve, mielőtt Resource Manager feloldja a referenciafüggvényt.

A referenciafüggvényben a használatával Full lekérheti az összes tulajdonságot, beleértve a felügyelt identitást is.

A minta a következő:

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

Fontos

Ne használja a mintát:

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

A sablon sikertelen lesz.

Ha például egy virtuális gépre alkalmazott felügyelt identitás egyszerű azonosítóját szeretné lekérni, használja a következőt:

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

Egy virtuálisgép-méretezési csoportra alkalmazott felügyelt identitás bérlőazonosítójának lekéréséhez használja a következőt:

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

5. megoldás: Függvények ellenőrzése

Bicep
JSON

Az erőforrások szimbolikus nevével értékeket kérhet le egy erőforrásból. Szimbolikus névvel hivatkozhat egy tárfiókra ugyanabban az erőforráscsoportban vagy egy másik erőforráscsoportban. Ha egy üzembe helyezett erőforrásból szeretne értéket lekérni, használja a meglévő kulcsszót. Ha egy erőforrás egy másik erőforráscsoportban található, használja scope a resourceGroup függvényt. A legtöbb esetben nincs szükség a referenciafüggvényre.

Az alábbi példa egy másik erőforráscsoportban lévő meglévő tárfiókra hivatkozik.

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

Sablon üzembe helyezésekor keressen olyan kifejezéseket, amelyek a referenciát vagy a listKeys függvényt használják . A megadott értékek attól függően változnak, hogy az erőforrás ugyanabban a sablonban, erőforráscsoportban és előfizetésben található-e. Ellenőrizze, hogy megadja-e a forgatókönyvhöz szükséges paraméterértékeket. Ha az erőforrás egy másik erőforráscsoportban található, adja meg a teljes erőforrás-azonosítót. Ha például egy másik erőforráscsoportban lévő tárfiókra szeretne hivatkozni, használja a következőt:

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

6. megoldás: Erőforrás törlése után

Ha töröl egy erőforrást, előfordulhat, hogy az erőforrás rövid ideig jelenik meg a portálon, de nem érhető el. Ha kiválasztja az erőforrást, hibaüzenet jelenik meg, amely szerint az erőforrás nem található.

Képernyőkép Azure Portal az erőforrás Áttekintés szakaszában található

Frissítse a portált, és a törölt erőforrást el kell távolítani az elérhető erőforrások listájából. Ha egy törölt erőforrás továbbra is elérhetőként jelenik meg néhány percnél tovább, forduljon az ügyfélszolgálathoz.