Typowe kody błędów interfejsu API REST
Operacja na dowolnej z usług Azure Storage może zwrócić następujące kody błędów:
| Kod błędu | Kod stanu HTTP | Komunikat użytkownika |
|---|---|---|
| NoAuthenticationInformation | 401 Brak autoryzacji | serwer nie może uwierzytelnić żądania. Zapoznaj się z informacjami w nagłówku www-authenticate. |
| InvalidAuthenticationInfo | 401 Brak autoryzacji | serwer nie może uwierzytelnić żądania. Zapoznaj się z informacjami w nagłówku www-authenticate. |
| AccountAlreadyExists | Konflikt (409) | Określone konto już istnieje. |
| AccountBeingCreated | Konflikt (409) | Określone konto jest w trakcie tworzenia. |
| AccountIsDisabled | Zabronione (403) | Określone konto jest wyłączone. |
| AccountProtectedFromDeletion | Konflikt (409) | Kontenery <containerName> kont <accountName> mają .<have legal hold\locked immutability policy> |
| AuthenticationFailed | Zabronione (403) | serwer nie może uwierzytelnić żądania. Upewnij się, że wartość nagłówka Authorization jest poprawnie sformułowana wraz z podpisem. |
| ConditionHeadersNotSupported | BadRequest (400) | Nagłówki warunku nie są obsługiwane. |
| ConditionNotMet | Nie zmodyfikowano (304) | Warunek określony w nagłówkach warunkowych nie został spełniony dla operacji odczytu. |
| ConditionNotMet | Warunek wstępny nie powiódł się (412) | Warunek określony w nagłówkach warunkowych nie został spełniony dla operacji zapisu. |
| EmptyMetadataKey | Nieprawidłowe żądanie (400) | Klucz jednej z par klucz-wartość metadanych jest pusty. |
| InsufficientAccountPermissions | Zabronione (403) | Operacje odczytu są obecnie wyłączone. |
| InsufficientAccountPermissions | Zabronione (403) | Operacje zapisu nie są dozwolone. |
| InsufficientAccountPermissions | Zabronione (403) | Dostęp do konta nie ma wystarczających uprawnień do wykonania tej operacji. |
| InternalError | Wewnętrzny błąd serwera (500) | Serwer napotkał błąd wewnętrzny. Ponów próbę żądania. |
| InvalidAuthenticationInfo | Nieprawidłowe żądanie (400) | Informacje o uwierzytelnianiu nie zostały podane w poprawnym formacie. Sprawdź wartość nagłówka Authorization . |
| InvalidHeaderValue | Nieprawidłowe żądanie (400) | Wartość podana dla jednego z nagłówków HTTP nie ma poprawnego formatu. |
| InvalidHttpVerb | Nieprawidłowe żądanie (400) | Określony czasownik HTTP nie został rozpoznany przez serwer. |
| InvalidInput | Nieprawidłowe żądanie (400) | Jedno z danych wejściowych żądania jest nieprawidłowe. |
| InvalidMd5 | Nieprawidłowe żądanie (400) | Wartość MD5 określona w żądaniu jest nieprawidłowa. Wartość MD5 musi być 128 bitów i zakodowana w formacie Base64. |
| InvalidMetadata | Nieprawidłowe żądanie (400) | Określone metadane są nieprawidłowe. Zawiera ona znaki, które nie są dozwolone. |
| InvalidQueryParameterValue | Nieprawidłowe żądanie (400) | Określono nieprawidłową wartość dla jednego z parametrów zapytania w identyfikatorze URI żądania. |
| InvalidRange | Żądany zakres niesyfikowalny (416) | Określony zakres jest nieprawidłowy dla bieżącego rozmiaru zasobu. |
| InvalidResourceName | Nieprawidłowe żądanie (400) | Określona nazwa zasobu zawiera nieprawidłowe znaki. |
| InvalidUri | Nieprawidłowe żądanie (400) | Żądany identyfikator URI nie reprezentuje żadnego zasobu na serwerze. |
| InvalidXmlDocument | Nieprawidłowe żądanie (400) | Określony kod XML nie jest prawidłowy składniowo. |
| InvalidXmlNodeValue | Nieprawidłowe żądanie (400) | Wartość podana dla jednego z węzłów XML w treści żądania nie ma poprawnego formatu. |
| KeyVaultAccessTokenCannotBeAcquired | Zabronione (403) | Nie można uzyskać tokenu dostępu dla magazynu kluczy z Microsoft Entra przy użyciu tożsamości tego zasobu. |
| KeyVaultEncryptionKeyNotFound | Zabronione (403) | Nie można odpakować klucza szyfrowania klucza magazynu kluczy. |
| KeyVaultVaultNotFound | Zabronione (403) | Nie można odnaleźć magazynu kluczy. |
| Md5Mismatch | Nieprawidłowe żądanie (400) | Wartość MD5 określona w żądaniu nie jest zgodna z wartością MD5 obliczoną przez serwer. |
| MetadataTooLarge | Nieprawidłowe żądanie (400) | Rozmiar określonych metadanych przekracza dozwolony maksymalny rozmiar. |
| MissingContentLengthHeader | Wymagana długość (411) | Nie określono nagłówka Content-Length . |
| MissingRequiredQueryParameter | Nieprawidłowe żądanie (400) | Dla tego żądania nie określono wymaganego parametru zapytania. |
| MissingRequiredHeader | Nieprawidłowe żądanie (400) | Nie określono wymaganego nagłówka HTTP. |
| MissingRequiredXmlNode | Nieprawidłowe żądanie (400) | Wymagany węzeł XML nie został określony w treści żądania. |
| MultipleConditionHeadersNotSupported | Nieprawidłowe żądanie (400) | Wiele nagłówków warunku nie jest obsługiwanych. |
| OperationTimedOut | Wewnętrzny błąd serwera (500) | Nie można ukończyć operacji w dozwolonym czasie. Operacja może lub nie powiodła się po stronie serwera. Przed ponowieniu próby wykonania operacji wykonaj zapytanie o stan serwera. |
| OutOfRangeInput | Nieprawidłowe żądanie (400) | Jeden z danych wejściowych żądania jest poza zakresem. |
| OutOfRangeQueryParameterValue | Nieprawidłowe żądanie (400) | Parametr zapytania określony w identyfikatorze URI żądania znajduje się poza dopuszczalnym zakresem. |
| RequestBodyTooLarge | Zbyt duża jednostka żądania (413) | Rozmiar treści żądania przekracza dozwolony maksymalny rozmiar. |
| ResourceTypeMismatch | Konflikt (409) | Określony typ zasobu nie jest zgodny z typem istniejącego zasobu. |
| RequestUrlFailedToParse | Nieprawidłowe żądanie (400) | Nie można przeanalizować adresu URL w żądaniu. |
| ResourceAlreadyExists | Konflikt (409) | Określony zasób już istnieje. |
| ResourceNotFound | Nie znaleziono (404) | Określony zasób nie istnieje. |
| ServerBusy | Usługa niedostępna (503) | Serwer nie może obecnie odbierać żądań. Ponów próbę żądania. |
| ServerBusy | Usługa niedostępna (503) | Ruch przychodzący przekracza limit konta. |
| ServerBusy | Usługa niedostępna (503) | Ruch wychodzący przekracza limit konta. |
| ServerBusy | Usługa niedostępna (503) | Operacje na sekundę przekracza limit konta. |
| Nieobsługiwaneheader | Nieprawidłowe żądanie (400) | Jeden z nagłówków HTTP określonych w żądaniu nie jest obsługiwany. |
| Nieobsługiwany węzełXmlNode | Nieprawidłowe żądanie (400) | Jeden z węzłów XML określonych w treści żądania nie jest obsługiwany. |
| NieobsługiwanequeryParameter | Nieprawidłowe żądanie (400) | Jeden z parametrów zapytania określonych w identyfikatorze URI żądania nie jest obsługiwany. |
| NieobsługiwaneHttpVerb | Niedozwolona metoda (405) | Zasób nie obsługuje określonego czasownika HTTP. |
Zobacz też
Kody błędów usługi Blob Storage
Kody błędów usługi Queue Storage
Kody błędów usługi Table Storage
kody błędów Azure Files
Rozwiązywanie problemów z operacjami interfejsu API
HttpStatusCode, wyliczenie
Dokumentacja interfejsu API REST usługi Azure Storage