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 oraz przedstawiono 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 | Ograniczanie ryzyka | Więcej informacji |
|---|---|---|
| AccountNameInvalid | Postępuj zgodnie z wytycznymi dotyczącymi nazewnictwa kont magazynu. | Usuwanie błędów dotyczących 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łużyć żądanego rozmiaru maszyny wirtualnej. Ponów próbę żądania w późniejszym czasie 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 zakoń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, oraz 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 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 dotycząca szablonów 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 podczas 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ń do usuwania wszystkich zasobów, 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 (_). |
|
| DeploymentNameLengthLimitExceed | Nazwy wdrożenia są ograniczone do 64 znaków. | |
| DeploymentFailed | Błąd DeploymentFailed to błąd ogólny, 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 |
| DeploymentJobSizeExceeded | Uprość szablon, aby zmniejszyć rozmiar. | Usuwanie błędów rozmiaru szablonu |
| DnsRecordInUse | Nazwa rekordu DNS musi być unikatowa. Wprowadź inną nazwę. | |
| ImageNotFound | Sprawdź ustawienia obrazu maszyny wirtualnej. | |
| Niedostępny obraz | Wdrożenie 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. Sprawdź dokładnie 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 jest niezgodna 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 Resource Manager 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 dotycząca szablonów |
| InvalidRequestFormat | Włącz rejestrowanie debugowania podczas uruchamiania wdrożenia i zweryfikuj zawartość żądania. | Rejestrowanie debugowania |
| InvalidResourceLocation | Podaj unikatową nazwę konta magazynu. | Usuwanie błędów dotyczących nazw kont magazynu |
| InvalidResourceNamespace | Sprawdź przestrzeń nazw zasobów określoną we właściwości type . | Dokumentacja dotycząca szablonów |
| 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 dotycząca szablonów |
| 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 zależności cyklicznego |
| JobSizeExceeded | Uprość szablon, aby zmniejszyć rozmiar. | Usuwanie błędów rozmiaru szablonu |
| LinkedAuthorizationFailed | Sprawdź, czy Twoje konto należy do tej samej dzierżawy co grupa zasobów, w której wdrażasz. | |
| 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ą |
| NotFound | 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 jednostce SKU spcecified. 2. Wdrożenie próbuje wykonać operację, która przekracza limit przydziału dla 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 należy ograniczyć 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 w celu zażądania 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ą dotyczący limitu przydziału dla dostępu w regionie. | |
| RequestDisallowedByPolicy | Twoja subskrypcja zawiera zasady zasobów, które uniemożliwiają akcję, którą próbujesz wykonać podczas wdrażania. Znajdź zasady, które blokują 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 twojej subskrypcji. Sprawdź kontekst subskrypcji. | Program PowerShellinterfejsu 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 dotyczących nazw kont magazynu |
| StorageAccountInAnotherResourceGroup | Podaj unikatową nazwę konta magazynu. | Usuwanie błędów dotyczących 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 maszyny wirtualnej z systemem Windows Wiele kart sieciowych maszyny wirtualnej 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 ma nieprawidłowy format. W przypadku używania wdrożeń zagnieżdżonych szablonu usługi ARM do 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 używasz szablonu usługi Azure Resource Manager do wdrożenia, dostawca zasobów jest automatycznie rejestrowany 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ż ograniczają żądania specyficzne 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 RequestsRetry-After do wartości, która określa liczbę sekund oczekiwania przed wysłaniem kolejnego żą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 Azure Kubernetes Service |
| TemplateResourceCircularDependency | Usuń niepotrzebne zależności. | Rozwiązywanie zależności cyklicznego |
| 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.