Nejčastější dotazy k chybám rozhraní příkazového řádku pro vývojáře Azure

Tento článek obsahuje řešení běžných chyb, ke kterým může dojít při použití rozhraní příkazového řádku pro vývojáře Azure (azd).

Autorizace zápisu přiřazení role se nezdařila.

Zpráva o chybě:The template deployment failed with error: 'Authorization failed for template resource '<guid>' of type 'Microsoft.Authorization/roleAssignments'. The client '##Email##' with object id '<guid>' does not have permission to perform action 'Microsoft.Authorization/roleAssignments/write' at scope '<resourceId>'.'

Cause: Nemáte dostatečná oprávnění k přiřazování rolí v cílovém předplatném nebo skupině prostředků Azure. To je běžné, když má váš uživatelský účet přístup k Contributor, ale ne k Owner nebo User Access Administrator. Contributor umožňuje vytvářet prostředky, ale ne udělovat těmto prostředkům oprávnění (přiřazovat role).

Rozlišení: Ujistěte se, že váš účet má roli Vlastník nebo Správce uživatelských přístupů v předplatném nebo skupině prostředků, do které nasazujete. Pokud vám tyto role nemohou být přiděleny, požádejte správce, aby provedl počáteční nasazení nebo přiřazení rolí za vás. Další informace najdete v tématu Azure předdefinované role.

Existuje již přiřazení role.

Zpráva o chybě:The role assignment already exists.

Příčina: K této chybě dochází, když se nasazení pokusí vytvořit přiřazení role, které již existuje na prostředku. Zatímco nasazení Azure Resource Manager (ARM) jsou idempotentní, určité konfigurace nebo podmínky časování v šablonách můžou tuto chybu aktivovat při opětovném nasazení.

Řešení: Tato chyba je často sporadická nebo neškodná.

1. Zkuste nasazení zopakovat: Spusťte azd up nebo azd deploy znovu.
2. Zkontrolujte šablony Bicep: Pokud šablonu spravujete, ujistěte se, že přiřazení rolí používají platné vlastnosti name (často přísně deterministické GUIDy), aby byla zajištěna idempotence. K vygenerování deterministických názvů použijte funkci guid() Bicep.

ID tenanta, ID hlavního objektu nebo rozsah nelze aktualizovat.

Zpráva o chybě:Tenant ID, application ID, principal ID, and scope are not allowed to be updated.

Příčina: Pokoušíte se přepracovat přiřazení role s vlastnostmi, které se liší od stávajícího přiřazení. Přiřazení rolí jsou neměnná, takže NEMŮŽETE změnit ID objektu zabezpečení (uživatel nebo aplikace přijímající roli) ani oblast existujícího ID přiřazení.

Řešení:

1. Ověření parametrů: Ujistěte se, že nechtěně nepředáváte jiné ID objektu zabezpečení (například přepínání mezi uživatelem a služebním objektem) u stejného prostředku přiřazení role.
2. Pokud potřebujete změnit přiřazení, ručně odstraňte konfliktní přiřazení role na portálu Azure nebo pomocí příkazového rozhraní příkazem az role assignment delete a pak znovu nasaďte.

Nedostupná kapacita oblasti nebo skladová položka

Chybová zpráva:The region 'eastus2' currently does not have enough resources available to provision services with the SKU 'standard'. (nebo "základní")

Cause: Vybraná oblast Azure je dočasně mimo kapacitu požadované skladové položky služby. To je v současné době běžné se službami AI (například Azure OpenAI) v oblíbených oblastech, jako je eastus2.

Řešení:

1. Změnit umístění: Spusťte azd env set AZURE_LOCATION <new-region> přepnutí do oblasti s lepší dostupností (například swedencentral, westus3, francecentral).
2. Check availability: Použijte stránku Azure Products by Region nebo spusťte az account list-locations a zkontrolujte oblasti, ve kterých je služba a skladová položka k dispozici.

Překročení kvóty TPM pro modely AI

Zpráva o chybě:This operation require <amount> new capacity in quota Tokens Per Minute (thousands) - <model> - GlobalStandard, which is bigger than the current available capacity <available>.

Cause: Vaše předplatné dosáhlo limitu kvóty pro tokeny za minutu (TPM) pro zadaný model Azure OpenAI v cílové oblasti.

Řešení:

1. Požadovat kvótu: Požádat o navýšení kvóty prostřednictvím portálu Azure AI Studio nebo Azure. Další informace najdete v tématu Správa kvóty služby Azure OpenAI.
2. Změnit modely nebo oblast: Přejděte do oblasti, ve které máte nevyužitou kvótu, nebo použijte jinou verzi modelu, která odpovídá vašim limitům.

If-Match předběžná podmínka selhala

Zpráva o chybě:The specified precondition 'If-Match = ""<guid>""' failed.

Příčina: Tento problém obvykle značí konflikt souběžnosti. Dva procesy mohou zkusit aktualizovat stejný prostředek současně, nebo není váš místní stav synchronizován s cloudovým prostředkem kvůli zastaralé značce ETag.

Rozlišení: Zkuste operaci zopakovat. Pokud chyba přetrvává:

1. Ujistěte se, že žádná další nasazení (kanály CI/CD, další kolegové) nesměřují na stejné prostředí současně.
2. Pokud používáte Bicep, ověřte, že vaše šablona správně definuje závislosti (dependsOn), aby se zabránilo paralelním změnám stejného prostředku.

Účet služeb Cognitive Services ve stavu Přijato

Zpráva o chybě:Call to Microsoft.CognitiveServices/accounts failed. Error message: Account <resourceId> in state Accepted.

Cause: Tato chyba je problém s časováním, kdy se závislý prostředek pokusí interagovat s účtem Cognitive Services (Azure AI), než bude plně zřízený a aktivní. Můžete také přidat příkazový háček (například postprovision) ve vaší azure.yaml, abyste pozastavili nebo zkontrolovali připravenost prostředků, než budete pokračovat.

Platnost nastavení revize kontejnerové aplikace vypršela.

Zpráva o chybě:Failed to provision revision for container app <appName>. Error details: Operation expired.

Cause: Aplikaci kontejneru Azure se nepodařilo spustit během výchozího časového limitu. Mezi obecné důvody patří:

• Obraz kontejneru je příliš velký a stahování trvá příliš dlouho.
• Aplikace spadne při spuštění.
• Naslouchání nakonfigurovaným portům aplikace trvá příliš dlouho.

Řešení:

1. Check Logs: Zobrazte protokoly kontejneru na portálu Azure (Log Stream) nebo pomocí nástroje azd monitor a zjistěte, jestli se aplikace chybově ukončí.
2. Kontrola konfigurace: Ujistěte se targetPort , že konfigurace odpovídá portu, na který aplikace naslouchá. Další kroky pro řešení potíží najdete v tématu Troubleshooting Azure Container Apps
3. Check Logs: Zobrazte protokoly kontejneru na portálu Azure (Log Stream) nebo pomocí nástroje azd monitor a zjistěte, jestli se aplikace chybově ukončí.
4. Kontrola konfigurace: Ujistěte se targetPort , že konfigurace odpovídá portu, na který aplikace naslouchá.
5. Optimalizovat obrázek: Zmenšete velikost image kontejneru, abyste urychlili načítání.