Udostępnij za pośrednictwem


Usuwanie typowych błędów wdrażania na platformie Azure

W tym artykule opisano sposób rozwiązywania typowych błędów wdrażania platformy Azure i zawiera informacje o rozwiązaniach. Zasoby platformy Azure można wdrażać przy użyciu plików języka Bicep lub szablonów usługi Azure Resource Manager (szablonów usługi ARM). Jeśli nie możesz znaleźć kodu błędu wdrażania, zobacz Znajdowanie kodu błędu.

Jeśli kod błędu nie znajduje się na liście, prześlij zgłoszenie Problem z serwisem GitHub. Po prawej stronie wybierz pozycję Opinia. W dolnej części strony w obszarze Opinia wybierz pozycję Ta strona. Prześlij opinię na temat dokumentacji, ale nie dołączaj informacji poufnych, ponieważ problemy z usługą GitHub są publiczne.

Kody błędów

Kod błędu Czynności zapobiegawcze Więcej informacji
AccountNameInvalid Postępuj zgodnie z wytycznymi dotyczącymi nazewnictwa kont magazynu. Usuwanie błędów nazw kont magazynu
AccountPropertyCannotBeSet Sprawdź dostępne właściwości konta magazynu. storageAccounts
AllocationFailed Klaster lub region nie ma dostępnych zasobów lub nie może obsługiwać żądanego rozmiaru maszyny wirtualnej. Spróbuj ponownie wysłać żądanie później lub zażądaj innego rozmiaru maszyny wirtualnej. Problemy z aprowizowaniem i alokacją w systemie Linux

Problemy z aprowizowaniem i alokacją w systemie Windows

Rozwiązywanie problemów z błędami alokacji
AnotherOperationInProgress Poczekaj na ukończenie operacji współbieżnych.
AuthorizationFailed Twoje konto lub jednostka usługi nie ma wystarczającego dostępu do ukończenia wdrożenia. Sprawdź, czy rola, do którego należy Twoje konto, i jego dostęp do zakresu wdrożenia.

Ten błąd może wystąpić, gdy wymagany dostawca zasobów nie jest zarejestrowany.
Kontrola dostępu oparta na rolach platformy Azure (Azure RBAC)

Rozwiązywanie problemów z rejestracją
BadRequest Wysłano wartości wdrożenia, które nie są zgodne z oczekiwaniami usługi Resource Manager. Sprawdź wewnętrzny komunikat o stanie, aby uzyskać pomoc dotyczącą rozwiązywania problemów.

Zweryfikuj składnię szablonu, aby usunąć błędy wdrażania podczas korzystania z szablonu wyeksportowanego z istniejącego zasobu platformy Azure.
Dokumentacja szablonu

Lokalizacja zasobu w szablonie usługi ARM

Lokalizacja zasobu w pliku Bicep

Rozwiązywanie problemów z nieprawidłowym szablonem
Konflikt Żądasz operacji, która nie jest dozwolona w bieżącym stanie zasobu. Na przykład zmiana rozmiaru dysku jest dozwolona tylko w przypadku tworzenia maszyny wirtualnej lub cofnięcia przydziału maszyny wirtualnej.
DeploymentActiveAndUneditable Poczekaj na ukończenie współbieżnego wdrożenia do tej grupy zasobów.
DeploymentFailedCleanUp Po wdrożeniu w trybie pełnym wszystkie zasoby, które nie znajdują się w szablonie, zostaną usunięte. Ten błąd występuje, gdy nie masz odpowiednich uprawnień, aby usunąć wszystkie zasoby, które nie są w szablonie. Aby uniknąć błędu, zmień tryb wdrażania na przyrostowy. Tryby wdrażania usługi Azure Resource Manager
DeploymentNameInvalidCharacters Nazwa wdrożenia może zawierać tylko litery, cyfry, łącznik (-), kropkę (.) lub podkreślenie (_).
DeploymentNameLengthLimitExceeded Nazwy wdrożenia są ograniczone do 64 znaków.
WdrożenieFailed Błąd DeploymentFailed jest ogólnym błędem, który nie zawiera szczegółów potrzebnych do rozwiązania błędu. Sprawdź szczegóły błędu, aby uzyskać kod błędu, który zawiera więcej informacji. Znajdowanie kodu błędu
DeploymentQuotaExceeded Jeśli osiągniesz limit 800 wdrożeń na grupę zasobów, usuń wdrożenia z historii, które nie są już potrzebne. Usuwanie błędu, gdy liczba wdrożeń przekracza 800
DeploymentJobSizeExceed Uprość szablon, aby zmniejszyć rozmiar. Rozwiązywanie problemów z błędami rozmiaru szablonu
DnsRecordInUse Nazwa rekordu DNS musi być unikatowa. Wprowadź inną nazwę.
ImageNotFound Sprawdź ustawienia obrazu maszyny wirtualnej.
Niedostępny obraz Wdrażanie usługi Azure Container Instance kończy się niepowodzeniem. Może być konieczne dołączenie tagu obrazu ze składnią registry/image:tag w celu wdrożenia kontenera. W przypadku rejestru prywatnego sprawdź, czy poświadczenia są poprawne. Znajdowanie kodu błędu
InternalServerError Spowodowane tymczasowym problemem. Ponów próbę wdrożenia.
InUseSubnetCannotBeDeleted Ten błąd może wystąpić podczas próby zaktualizowania zasobu, jeśli proces żądania usunie i utworzy zasób. Upewnij się, że określono wszystkie niezmienione wartości. Aktualizowanie zasobu
InvalidAuthenticationTokenTenant Uzyskaj token dostępu dla odpowiedniej dzierżawy. Token można uzyskać tylko z dzierżawy, do której należy Twoje konto.
InvalidContentLink Najprawdopodobniej podjęto próbę połączenia z zagnieżdżonym szablonem, który nie jest dostępny. Dokładnie sprawdź identyfikator URI podany dla szablonu zagnieżdżonego. Jeśli szablon istnieje na koncie magazynu, upewnij się, że identyfikator URI jest dostępny. Może być konieczne przekazanie tokenu SAS. Obecnie nie można połączyć się z szablonem, który znajduje się na koncie magazynu za zaporą usługi Azure Storage. Rozważ przeniesienie szablonu do innego repozytorium, takiego jak GitHub. Połączone i zagnieżdżone szablony usługi ARM

Moduły Bicep
InvalidDeploymentLocation Podczas wdrażania na poziomie subskrypcji podano inną lokalizację dla wcześniej używanej nazwy wdrożenia. Wdrażanie subskrypcji szablonu usługi ARM

Wdrożenie subskrypcji Bicep
InvalidParameter Jedna z wartości podanych dla zasobu nie jest zgodna z oczekiwaną wartością. Ten błąd może wynikać z wielu różnych warunków. Na przykład hasło może być niewystarczające lub nazwa obiektu blob może być niepoprawna. Komunikat o błędzie powinien wskazywać, która wartość musi zostać poprawiona. Parametry szablonu usługi ARM

Parametry Bicep
InvalidRequestContent Wartości wdrożenia zawierają wartości, które nie są rozpoznawane, lub brakuje wymaganych wartości. Potwierdź wartości typu zasobu. Dokumentacja szablonu
InvalidRequestFormat Włącz rejestrowanie debugowania podczas uruchamiania wdrożenia i sprawdź zawartość żądania. Rejestrowanie debugowania
InvalidResourceLocation Podaj unikatową nazwę konta magazynu. Usuwanie błędów nazw kont magazynu
InvalidResourceNamespace Sprawdź przestrzeń nazw zasobów określoną we właściwości type . Dokumentacja szablonu
InvalidResourceReference Zasób jeszcze nie istnieje lub jest niepoprawnie przywołyny. Sprawdź, czy musisz dodać zależność. Sprawdź, czy użycie funkcji referencyjnej zawiera wymagane parametry dla danego scenariusza. Rozwiązywanie problemów z zależnościami
InvalidResourceType Sprawdź typ zasobu określony we właściwości type . Dokumentacja szablonu
InvalidSubscriptionRegistrationState Zarejestruj subskrypcję u dostawcy zasobów. Rozwiązywanie problemów z rejestracją
InvalidTemplateDeployment
InvalidTemplate
Sprawdź składnię szablonu pod kątem błędów. Rozwiązywanie problemów z nieprawidłowym szablonem
InvalidTemplateCircularDependency Usuń niepotrzebne zależności. Rozwiązywanie problemów z zależnościami cyklicznymi
JobSizeExceeded Uprość szablon, aby zmniejszyć rozmiar. Rozwiązywanie problemów z błędami rozmiaru szablonu
LinkedAuthorizationFailed Sprawdź, czy twoje konto należy do tej samej dzierżawy co wdrażana grupa zasobów.
LinkedInvalidPropertyId Identyfikator zasobu zasobu nie został rozwiązany. Sprawdź, czy podano wszystkie wymagane wartości dla identyfikatora zasobu. Na przykład identyfikator subskrypcji, nazwa grupy zasobów, typ zasobu, nazwa zasobu nadrzędnego (w razie potrzeby) i nazwa zasobu. Usuwanie błędów dotyczących nazwy i typu zasobu
LokalizacjaWymagane Podaj lokalizację zasobu. Lokalizacja zasobu w szablonie usługi ARM

Lokalizacja zasobu w pliku Bicep
NiezgodnośćresourceSegments Upewnij się, że zagnieżdżony zasób ma prawidłową liczbę segmentów w nazwie i typie. Rozwiązywanie problemów z segmentami zasobów
MissingRegistrationForLocation Sprawdź stan rejestracji dostawcy zasobów i obsługiwane lokalizacje. Rozwiązywanie problemów z rejestracją
MissingSubscriptionRegistration Zarejestruj subskrypcję u dostawcy zasobów. Rozwiązywanie problemów z rejestracją
NoRegisteredProviderFound Sprawdź stan rejestracji dostawcy zasobów. Rozwiązywanie problemów z rejestracją
Nie znaleziono Być może próbujesz wdrożyć zasób zależny równolegle z zasobem nadrzędnym. Sprawdź, czy musisz dodać zależność. Rozwiązywanie problemów z zależnościami
OperationNotAllowed Ten komunikat o błędzie może mieć kilka przyczyn.

1. Wdrożenie próbuje wykonać operację, która nie jest dozwolona w określonej jednostce SKU.

2. Wdrożenie próbuje wykonać operację, która przekracza limit przydziału subskrypcji, grupy zasobów lub regionu. Jeśli to możliwe, zrewiduj wdrożenie, aby pozostać w ramach limitów przydziału. W przeciwnym razie rozważ zażądanie zmiany limitów przydziału.
Rozwiązywanie limitów przydziału
OperationNotAllowedOnVMImageAsVMsBeingProvisioned Być może próbujesz usunąć obraz, który jest obecnie używany do aprowizacji maszyn wirtualnych. Nie można usunąć obrazu używanego przez dowolną maszynę wirtualną podczas procesu wdrażania. Spróbuj ponownie wykonać operację usuwania obrazu po zakończeniu wdrażania maszyny wirtualnej.
ParentResourceNotFound Przed utworzeniem zasobów podrzędnych upewnij się, że istnieje zasób nadrzędny. Rozwiązywanie problemu z zasobem nadrzędnym
PasswordTooLong Być może wybrano hasło z zbyt dużą liczbą znaków lub przekonwertowano wartość hasła na bezpieczny ciąg przed przekazaniem go jako parametru. Jeśli szablon zawiera parametr bezpiecznego ciągu , nie musisz konwertować wartości na bezpieczny ciąg. Podaj wartość hasła jako tekst.
PrivateIPAddressInReservedRange Określony adres IP zawiera zakres adresów wymagany przez platformę Azure. Zmień adres IP, aby uniknąć zarezerwowanego zakresu. Prywatne adresy IP
PrivateIPAddressNotInSubnet Określony adres IP znajduje się poza zakresem podsieci. Zmień adres IP, aby mieścił się w zakresie podsieci. Prywatne adresy IP
PropertyChangeNotAllowed Niektórych właściwości nie można zmienić w wdrożonym zasobie. Podczas aktualizowania zasobu ogranicz zmiany do dozwolonych właściwości. Aktualizowanie zasobu
PublicIPCountLimitReached Osiągnięto limit liczby uruchomionych publicznych adresów IP. Zamknij niepotrzebne zasoby lub skontaktuj się z pomoc techniczna platformy Azure, aby zażądać zwiększenia. Na przykład w usłudze Azure Databricks zobacz Nieoczekiwane zakończenie działania klastra i limit adresów IP uniemożliwia tworzenie klastra. Limity publicznych adresów IP
RegionDoesNotAllowProvisioning Wybierz inny region lub prześlij wniosek o pomoc techniczną dla regionu.
RequestDisallowedByPolicy Subskrypcja zawiera zasady zasobów, które uniemożliwiają wykonywanie akcji podczas wdrażania. Znajdź zasady blokujące akcję. Jeśli to możliwe, zmień wdrożenie, aby spełnić ograniczenia zasad. Rozwiązywanie problemów z zasadami
ReservedResourceName Podaj nazwę zasobu, która nie zawiera nazwy zarezerwowanej. Nazwy zasobów zarezerwowanych
ResourceGroupBeingDeleted Poczekaj na zakończenie usuwania.
ResourceGroupNotFound Sprawdź nazwę docelowej grupy zasobów dla wdrożenia. Docelowa grupa zasobów musi już istnieć w subskrypcji. Sprawdź kontekst subskrypcji. Program PowerShell interfejsu wiersza polecenia platformy Azure
ResourceNotFound Wdrożenie odwołuje się do zasobu, którego nie można rozpoznać. Sprawdź, czy użycie funkcji referencyjnej zawiera parametry wymagane dla danego scenariusza. Rozwiązywanie odwołań
ResourceQuotaExceeded Wdrożenie próbuje utworzyć zasoby, które przekraczają limit przydziału dla subskrypcji, grupy zasobów lub regionu. Jeśli to możliwe, popraw infrastrukturę, aby pozostać w ramach limitów przydziału. W przeciwnym razie rozważ zażądanie zmiany limitów przydziału. Rozwiązywanie limitów przydziału
SkuNotAvailable Wybierz jednostkę SKU (np. rozmiar maszyny wirtualnej), która jest dostępna dla wybranej lokalizacji. Rozwiązywanie problemów z jednostkami SKU
StorageAccountAlreadyTaken
StorageAccountAlreadyExists
Podaj unikatową nazwę konta magazynu. Usuwanie błędów nazw kont magazynu
StorageAccountInAnotherResourceGroup Podaj unikatową nazwę konta magazynu. Usuwanie błędów nazw kont magazynu
StorageAccountNotFound Sprawdź subskrypcję, grupę zasobów i nazwę konta magazynu, którego próbujesz użyć.
PodsieciNotInSameVnet Maszyna wirtualna może mieć tylko jedną sieć wirtualną. Podczas wdrażania kilku kart sieciowych upewnij się, że należą one do tej samej sieci wirtualnej. Wiele kart sieciowych maszyn wirtualnych z systemem Windows

Wiele kart sieciowych maszyn wirtualnych z systemem Linux
SubnetIsFull W podsieci nie ma wystarczającej liczby dostępnych adresów, aby wdrożyć zasoby. Adresy można zwolnić z podsieci, użyć innej podsieci lub utworzyć nową podsieć. Zarządzanie podsieciami i siecią wirtualną — często zadawane pytania

Prywatne adresy IP
SubscriptionNotFound Nie można uzyskać dostępu do określonej subskrypcji wdrożenia. Może to być nieprawidłowy identyfikator subskrypcji, użytkownik wdrażający szablon nie ma odpowiednich uprawnień do wdrożenia w subskrypcji lub identyfikator subskrypcji jest w niewłaściwym formacie. W przypadku używania wdrożeń zagnieżdżonych szablonu usługi ARM w celu wdrożenia w różnych zakresach podaj identyfikator GUID subskrypcji. Wdrażanie szablonu usługi ARM w różnych zakresach

Wdrażanie pliku Bicep w różnych zakresach
SubscriptionNotRegistered Po wdrożeniu zasobu dostawca zasobów musi być zarejestrowany dla subskrypcji. Jeśli do wdrożenia używasz szablonu usługi Azure Resource Manager, dostawca zasobów jest automatycznie zarejestrowany w subskrypcji. Czasami automatyczna rejestracja nie kończy się w czasie. Aby uniknąć tego sporadycznie błędu, zarejestruj dostawcę zasobów przed wdrożeniem. Rozwiązywanie problemów z rejestracją
SubscriptionRequestsThrottled Usługa Azure Resource Manager ogranicza żądania na poziomie subskrypcji lub dzierżawy. Dostawcy zasobów, tacy jak Microsoft.Compute również ograniczanie żądań specyficznych dla jego operacji.

Po osiągnięciu limitu zostanie wyświetlony komunikat i wartość z czasem oczekiwania przed wysłaniem nowego żądania. Na przykład: Number of requests for subscription '<subscription-id-guid>' and operation '<resource provider>' exceeded the backend storage limit. Please try again after '6' seconds..

Odpowiedź HTTP zwraca komunikat podobny HTTP status code 429 Too Many Requests Retry-After do wartości, która określa liczbę sekund oczekiwania przed wysłaniem innego żądania.
Ograniczanie przepływności żądań usługi Resource Manager

Rozwiązywanie problemów z błędami ograniczania przepustowości interfejsu API — maszyny wirtualne

Ograniczanie przepustowości usługi Azure Kubernetes Service
TemplateResourceCircularDependency Usuń niepotrzebne zależności. Rozwiązywanie problemów z zależnościami cyklicznymi
TooManyTargetResourceGroups Zmniejsz liczbę grup zasobów dla pojedynczego wdrożenia. Wdrażanie szablonu usługi ARM w różnych zakresach

Wdrażanie pliku Bicep w różnych zakresach

Następne kroki

  • Aby uzyskać informacje o błędach walidacji lub wdrażania, zobacz Znajdowanie kodów błędów.
  • Aby uzyskać więcej informacji na temat rozwiązywania problemów z wdrożeniem, zobacz Włączanie rejestrowania debugowania.
  • Aby wyizolować przyczynę błędu wdrożenia, zobacz Tworzenie szablonu rozwiązywania problemów.