Řešení chyb kvůli nenalezení prostředku

Tento článek popisuje chybu, která se zobrazí, když během operace nejde najít prostředek. Tato chyba se obvykle zobrazuje při nasazování prostředků pomocí souboru Bicep nebo šablony Azure Resource Manager (šablony ARM). Tato chyba se také zobrazí při provádění úloh správy a Azure Resource Manager nemůže najít požadovaný prostředek. Pokud se například pokusíte přidat značky k prostředku, který neexistuje, zobrazí se tato chyba.

Příznaky

Existují dva kódy chyb, které značí, že prostředek nejde najít. Chyba NotFound vrátí výsledek podobný následujícímu:

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

Chyba ResourceNotFound vrátí výsledek podobný následujícímu:

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

Příčina

Resource Manager potřebuje načíst vlastnosti prostředku, ale nemůže najít prostředek ve vašem předplatném.

Řešení 1: Kontrola vlastností prostředku

Pokud se při provádění úloh správy zobrazí tato chyba, zkontrolujte hodnoty, které jste pro prostředek zadali. Měli byste zkontrolovat tyto 3 hodnoty:

• Název prostředku
• Název skupiny prostředků
• Předplatné

Pokud používáte PowerShell nebo Azure CLI, zkontrolujte, že spouštíte příkazy v předplatném, které obsahuje daný prostředek. Předplatné můžete změnit pomocí rutiny Set-AzContext nebo az account set. Řada příkazů nabízí parametr předplatného, který umožňuje zadat jiné předplatné, než je aktuální kontext.

Pokud vlastnosti nemůžete ověřit, přihlaste se k Azure Portal Microsoft. Vyhledejte prostředek, který se pokoušíte použít, a prozkoumejte název prostředku, skupinu prostředků a předplatné.

Řešení 2: Nastavení závislostí

Pokud se při nasazování šablony zobrazí tato chyba, možná budete muset přidat závislost. Resource Manager optimalizuje nasazení paralelním vytvářením prostředků, pokud je to možné.

Když například nasadíte webovou aplikaci, musí existovat plán App Service. Pokud jste neurčili, že webová aplikace závisí na plánu App Service, Resource Manager vytvoří oba prostředky současně. Webová aplikace selže s chybou, že prostředek App Service plánu nejde najít, protože ještě neexistuje. Této chybě zabráníte nastavením závislosti ve webové aplikaci.

Bicep

Místo funkce resourceId použijte implicitní závislost. Závislost se vytvoří pomocí symbolického názvu a vlastnosti ID prostředku.

Například vlastnost webové aplikace serverFarmId používá servicePlan.id k vytvoření závislosti na plánu App Service.

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

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

U většiny nasazení není nutné k vytvoření explicitní závislosti použít .dependsOn

Vyhněte se nastavování závislostí, které nejsou potřeba. Nepotřebné závislosti prodlužují dobu trvání nasazení, protože prostředky se nenasazují paralelně. Můžete také vytvořit cyklické závislosti, které blokují nasazení.

JSON

Pokud musí být prostředek nasazený po jiném prostředku, použijte v šabloně element dependsOn .

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

Vyhněte se nastavování závislostí, které nejsou potřeba. Nepotřebné závislosti prodlužují dobu trvání nasazení, protože prostředky se nenasazují paralelně. Můžete také vytvořit cyklické závislosti, které blokují nasazení.

Funkce odkazu a seznamu* vytvoří implicitní závislost na odkazovaném prostředku, pokud je tento prostředek nasazený ve stejné šabloně a odkazuje na ho jeho název (ne ID prostředku). Proto můžete mít více závislostí než závislosti zadané ve dependsOn vlastnosti .

Funkce resourceId nevytáčí implicitní závislost ani neověřuje, jestli prostředek existuje. Funkce reference a funkce list* nevytvoří implicitní závislost, pokud na prostředek odkazuje jeho ID prostředku. Pokud chcete vytvořit implicitní závislost, předejte název prostředku, který je nasazený ve stejné šabloně.

Pořadí nasazení

Když se zobrazí problémy se závislostmi, potřebujete získat přehled o pořadí nasazení prostředků. K zobrazení pořadí operací nasazení můžete použít portál:

1. Přihlaste se k portálu.

2. V přehledu skupiny prostředků vyberte odkaz na historii nasazení.

   

3. U názvu nasazení , který chcete zkontrolovat, vyberte Související události.

   

4. Prozkoumejte posloupnost událostí pro jednotlivé prostředky. Věnujte pozornost stavu každé operace a jejímu časovému razítku. Například na následujícím obrázku jsou tři paralelně nasazené účty úložiště. Všimněte si, že se ve stejnou dobu spustila tři nasazení účtu úložiště.

   

   Další obrázek ukazuje tři účty úložiště, které nejsou nasazené paralelně. Druhý účet úložiště závisí na prvním účtu úložiště a třetí účet úložiště závisí na druhém účtu úložiště. První účet úložiště má před spuštěním dalšího účtu označení Spuštěno, Přijato a Úspěšné .

   

Řešení 3: Získání externího prostředku

Bicep

Bicep používá symbolický název k vytvoření implicitní závislosti na jiném prostředku. Existující klíčové slovo odkazuje na nasazený prostředek. Pokud je existující prostředek v jiné skupině prostředků než prostředek, který chcete nasadit, zahrňte obor a použijte funkci resourceGroup .

V tomto příkladu se nasadí webová aplikace, která používá existující plán App Service z jiné skupiny prostředků.

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

Při nasazování šablony potřebujete získat prostředek, který existuje v jiném předplatném nebo jiné skupině prostředků, použijte funkci resourceId. Tato funkce vrátí plně kvalifikovaný název prostředku.

Parametry předplatného a skupiny prostředků ve resourceId funkci jsou volitelné. Pokud je nezadáte, nastaví se jako výchozí aktuální předplatné a skupina prostředků. Při práci s prostředkem v jiné skupině prostředků nebo předplatném nezapomeňte tyto hodnoty zadat.

Následující příklad získá ID prostředku, který existuje v jiné skupině prostředků.

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

Řešení 4: Získání spravované identity z prostředku

Bicep

Pokud nasazujete prostředek se spravovanou identitou, musíte před načtením hodnot pro spravovanou identitu počkat, až se tento prostředek nasadí. Pro prostředek, na který se identita použije, použijte implicitní závislost . Tento přístup zajistí, že prostředek a spravovaná identita se nasadí dřív, než Resource Manager závislost použije.

Můžete získat ID objektu zabezpečení a ID tenanta pro spravovanou identitu, která se použije na virtuální počítač. Pokud má například prostředek virtuálního počítače symbolický název vm, použijte následující syntaxi:

vm.identity.principalId

vm.identity.tenantId

JSON

Pokud nasazujete prostředek se spravovanou identitou, musíte před načtením hodnot pro spravovanou identitu počkat, až se tento prostředek nasadí. Pokud předáte název spravované identity referenční funkci, Resource Manager se pokusí přeložit odkaz před nasazením prostředku a identity. Místo toho předejte název prostředku, na který se identita použije. Tento přístup zajistí, že se prostředek a spravovaná identita nasadí před tím, než Resource Manager přeloží referenční funkci.

V referenční funkci použijte Full k získání všech vlastností, včetně spravované identity.

Vzor je následující:

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

Důležité

Nepoužívejte tento vzor:

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

Vaše šablona se nezdaří.

Pokud například chcete získat ID objektu zabezpečení pro spravovanou identitu, která se použije na virtuální počítač, použijte:

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

Nebo pokud chcete získat ID tenanta pro spravovanou identitu, která se použije na škálovací sadu virtuálních počítačů, použijte:

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

Řešení 5: Kontrola funkcí

Bicep

K získání hodnot z prostředku můžete použít symbolický název prostředku. Na účet úložiště ve stejné nebo jiné skupině prostředků můžete odkazovat pomocí symbolického názvu. Pokud chcete získat hodnotu z nasazeného prostředku, použijte existující klíčové slovo. Pokud je prostředek v jiné skupině prostředků, použijte scope funkci resourceGroup . Ve většině případů není referenční funkce potřeba.

Následující příklad odkazuje na existující účet úložiště v jiné skupině prostředků.

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

JSON

Při nasazování šablony vyhledejte výrazy, které používají funkce reference nebo listKeys . Zadané hodnoty se liší v závislosti na tom, jestli je prostředek ve stejné šabloně, skupině prostředků a předplatném. Zkontrolujte, že pro svůj scénář zadáte požadované hodnoty parametrů. Pokud je prostředek v jiné skupině prostředků, zadejte úplné ID prostředku. Pokud například chcete odkazovat na účet úložiště v jiné skupině prostředků, použijte:

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

Řešení 6: Po odstranění prostředku

Když prostředek odstraníte, může se na portálu zobrazit krátce, ale není dostupný. Pokud vyberete prostředek, zobrazí se chyba, že prostředek není nalezen.

Aktualizujte portál a odstraněný prostředek by se měl odebrat ze seznamu dostupných prostředků. Pokud se odstraněný prostředek zobrazuje jako dostupný déle než několik minut, kontaktujte podporu.