Często zadawane pytania o błędy Azure Developer CLI

Ten artykuł zawiera rozwiązania typowych błędów, które mogą wystąpić podczas korzystania z interfejsu wiersza polecenia dewelopera Azure (azd).

Autoryzacja nie powiodła się dla zapisu przypisania roli

Komunikat o błędzie:

Cause: Nie masz wystarczających uprawnień do przypisywania ról w docelowej subskrypcji Azure lub grupie zasobów. Jest to typowe, gdy konto użytkownika ma dostęp do pewnych zasobów, ale nie ma dostępu do innych lub wszystkich zasobów. umożliwia tworzenie zasobów, ale nie przyznawanie uprawnień (przypisywanie ról) do tych zasobów.

Rozwiązanie: Upewnij się, że twoje konto ma rolę Właściciel lub Administrator dostępu dla użytkowników w subskrypcji lub grupie zasobów, w której wdrażasz. Jeśli nie możesz uzyskać tych ról, poproś administratora o wykonanie początkowego wdrożenia lub przypisania ról. Aby uzyskać więcej informacji, zobacz role wbudowane Azure.

Przypisana rola już istnieje

Komunikat o błędzie:

Przyczyna: Ten błąd występuje, gdy wdrożenie próbuje utworzyć przypisanie roli, które już istnieje na zasobie. Chociaż wdrożenia Azure Resource Manager (ARM) są idempotentne, niektóre konkretne konfiguracje lub warunki wyścigu w szablonach mogą powodować ten błąd podczas ponownego wdrażania.

Rozwiązanie: Ten błąd jest często sporadyczny lub niegroźny.

1. Ponów próbę wdrożenia: Uruchom lub ponownie.
2. Sprawdź szablony Bicep: Jeśli zachowujesz szablon, upewnij się, że przypisania ról używają prawidłowych właściwości name (często ściśle deterministycznych identyfikatorów GUID) w celu zapewnienia idempotencji. Użyj funkcji guid() Bicep, aby wygenerować nazwy deterministyczne.

Nie można zaktualizować identyfikatora dzierżawy, identyfikatora głównego podmiotu lub zakresu

Komunikat o błędzie:

Przyczyna: Próbujesz zaktualizować przypisanie roli z właściwościami, które różnią się od istniejącego przypisania. Przypisania ról są niezmienne; nie można zmienić identyfikatora podmiotu (użytkownika lub aplikacji, które otrzymują rolę) ani zakresu istniejącego identyfikatora przypisania.

Rozwiązanie:

1. Sprawdź parametry: Upewnij się, że nie przekazujesz przypadkowo innego identyfikatora podmiotu głównego (na przykład przełączając się między użytkownikiem a jednostką usługi) dla tego samego zasobu przypisania roli.
2. Clean up: Jeśli musisz zmienić przypisanie, ręcznie usuń sprzeczne przypisanie roli w Azure portal lub za pomocą interfejsu linii poleceń przy użyciu az role assignment delete, a następnie ponownie wdróż.

Pojemność regionu lub jednostka SKU jest niedostępna

Komunikat o błędzie: (lub 'podstawowy')

Cause: Wybrany region Azure jest tymczasowo poza pojemnością dla żądanej jednostki SKU usługi. Jest to obecnie powszechne w przypadku usług sztucznej inteligencji (takich jak Azure OpenAI) w popularnych regionach, takich jak eastus2.

Rozwiązanie:

1. Zmień lokalizację: Uruchom polecenie, aby przełączyć się do regionu o lepszej dostępności (na przykład , , ).
2. Check availability: Użyj Azure Products by Region lub uruchom az account list-locations, aby sprawdzić regiony, w których są dostępne usługi i jednostki SKU.

Przekroczono kwotę TPM dla modeli sztucznej inteligencji

Komunikat o błędzie:

Cause: Twoja subskrypcja osiągnęła limit przydziału tokenów na minutę (TPM) dla określonego modelu Azure OpenAI w regionie docelowym.

Rozwiązanie:

1. Żądanie przydziału: Poproś o zwiększenie limitu przydziału za pośrednictwem Azure AI Studio lub portalu Azure. Aby uzyskać więcej informacji, zobacz Zarządzanie limitem przydziału Azure OpenAI Service.
2. Zmień modele/region: Przejdź do regionu, w którym masz nieużywany limit przydziału lub użyj innej wersji modelu, która mieści się w granicach limitów.

If-Match: przedwarunek nie został spełniony

Komunikat o błędzie:

Przyczyna: Ten problem zwykle wskazuje na konflikt równoczesności. Dwa procesy mogą próbować zaktualizować ten sam zasób jednocześnie lub stan lokalny nie jest zsynchronizowany z zasobem w chmurze (nieaktualny element ETag).

Rozwiązanie: Ponów próbę wykonania operacji. Jeśli błąd nadal występuje:

1. Upewnij się, że żadne inne wdrożenia (potoki ciągłej integracji/ciągłego wdrażania, inni współpracownicy) są przeznaczone dla tego samego środowiska jednocześnie.
2. Jeśli używasz Bicep, sprawdź, czy szablon poprawnie definiuje zależności (dependsOn), aby zapobiec modyfikacjom równoległym dla tego samego zasobu.

Konto „Cognitive Services” o statusie Zaakceptowane

Komunikat o błędzie:

Przyczyna: Ten błąd jest kwestią czasową, w której zasób zależny próbuje wchodzić w interakcję z kontem usług Cognitive Services (Azure AI), zanim konto to zostanie w pełni przygotowane i aktywne. Możesz również dodać hak polecenia (na przykład ), aby wstrzymać lub sprawdzić gotowość zasobów przed kontynuowaniem.

Termin rewizji aplikacji kontenera wygasł

Komunikat o błędzie:

Cause: Nie można uruchomić aplikacji kontenera Azure w domyślnym przedziale czasu. Typowe przyczyny:

• Obraz kontenera jest za duży i jego ściąganie trwa zbyt długo.
• Aplikacja ulega awarii podczas uruchamiania.
• Nasłuchiwanie skonfigurowanego portu przez aplikację trwa zbyt długo.

Rozwiązanie:

1. Check Logs: Wyświetl dzienniki kontenera w portalu Azure (strumień dzienników) lub użyj azd monitor, aby sprawdzić, czy aplikacja ulega awarii.
2. Przejrzyj konfigurację: Upewnij się, że ustawienie w Twojej konfiguracji jest zgodne z portem, na który nasłuchuje aplikacja. Aby uzyskać więcej kroków rozwiązywania problemów, zobacz Troubleshooting Azure Container Apps
3. Check Logs: Wyświetl dzienniki kontenera w portalu Azure (strumień dzienników) lub użyj azd monitor, aby sprawdzić, czy aplikacja ulega awarii.
4. Przejrzyj konfigurację: Upewnij się, że ustawienie w Twojej konfiguracji jest zgodne z portem, na który nasłuchuje aplikacja.
5. Optymalizowanie obrazu: Zmniejsz rozmiar obrazu kontenera, aby przyspieszyć ściąganie.