Kody stanu HTTP dla usługi Azure Cosmos DB

  • Artykuł

Ten artykuł zawiera kody stanu HTTP zwracane przez operacje REST.

Kod Opis
200 OK Jedna z następujących operacji REST zakończyła się pomyślnie:

- GET w zasobie.
- PUT w zasobie.
- POST w zasobie.
- POST w zasobie procedury składowanej do wykonania procedury składowanej.
Utworzono 201 Operacja POST tworzenia zasobu zakończyła się pomyślnie.
204 Brak zawartości Operacja DELETE zakończyła się pomyślnie.
400 Nieprawidłowe żądanie Kod JSON, SQL lub JavaScript w treści żądania jest nieprawidłowy.

Ponadto można również zwrócić wartość 400, gdy wymagane właściwości zasobu nie są obecne lub ustawione w treści zasobu POST lub PUT w zasobie.

Wartość 400 jest również zwracana, gdy poziom spójny dla operacji GET jest zastępowany przez silniejszą spójność z jednego zestawu dla konta.

Wartość 400 jest również zwracana, gdy żądanie wymagające klucza partycji x-ms-documentdb-nie zawiera go.
401 Brak autoryzacji 401 jest zwracany, gdy Authorization nagłówek jest nieprawidłowy dla żądanego zasobu.
403 Zabronione Wygasł token autoryzacji.

Kod 403 jest również zwracany podczas POST operacji w celu utworzenia zasobu po osiągnięciu limitu przydziału zasobów. Przykładem tego scenariusza jest próba dodania dokumentów do kolekcji, która osiągnęła aprowizowany magazyn.

Błąd 403 może także zostać zwrócony, gdy procedura składowana, wyzwalacz lub funkcja UDF została oflagowana z powodu dużego użycia zasobów i zablokowano jej wykonywanie.

Błąd 403 Zabronione jest zwracany, gdy reguły zapory skonfigurowane na koncie usługi Azure Cosmos DB blokują Twoje żądanie. Wszystkie żądania pochodzące z maszyn spoza listy dozwolonych otrzymają odpowiedź 403.

403.3 — ten kod stanu jest zwracany dla żądań zapisu podczas ręcznej operacji trybu failover. Ten kod stanu jest używany jako kod przekierowania przez sterowniki do przekazywania żądań zapisu do nowego regionu zapisu. Bezpośredni klient REST musi wykonać polecenie GET on DatabaseAccount, aby zidentyfikować bieżący region zapisu i przesłać dalej żądanie zapisu do tego punktu końcowego.
404 Nie znaleziono Operacja próbuje działać na zasobie, który już nie istnieje. Na przykład zasób mógł zostać już usunięty.
408 Limit czasu żądania Operacja nie została ukończona w przydzielonym czasie. Ten kod jest zwracany, gdy procedura składowana, wyzwalacz lub funkcja UDF (w ramach zapytania) nie kończy wykonywania w maksymalnym czasie wykonywania.
409 Konflikt Identyfikator podany dla zasobu w operacji PUT lub POST został zajęty przez istniejący zasób. Aby rozwiązać ten problem, użyj innego identyfikatora zasobu. W przypadku kolekcji partycjonowanych identyfikator musi być unikatowy we wszystkich dokumentach z taką samą wartością klucza partycji.
Niepowodzenie warunku wstępnego 412 Operacja określiła element eTag, który różni się od wersji dostępnej na serwerze, czyli optymistyczny błąd współbieżności. Ponów żądanie po odczytaniu najnowszej wersji zasobu i zaktualizowaniu elementu eTag dla żądania.
413 — Jednostka jest zbyt duża Rozmiar dokumentu w żądaniu przekroczył dozwolony rozmiar dokumentu dla żądania. Maksymalny dozwolony rozmiar dokumentu wynosi 2 MB.
423 — Blokada Nie można wykonać operacji skalowania przepływności, ponieważ trwa inna operacja skalowania.
424 — Zależność zakończona niepowodzeniem Gdy operacja związana z dokumentem kończy się niepowodzeniem w zakresie transakcyjnym operacji TransactionalBatch, wszystkie inne operacje w partii są uznawane za zależności, które zakończyły się niepowodzeniem. Ten kod stanu wskazuje, że bieżąca operacja została uznana za nieudaną z powodu innego błędu w tym samym zakresie transakcyjnym.
429 Zbyt wiele żądań Kolekcja przekroczyła aprowizowany limit przepływności. Ponów żądanie po upływie czasu ponowienia próby określonego przez serwer. Aby uzyskać więcej informacji, zobacz Jednostki żądania.
449 — ponów próbę przy użyciu Operacja napotkała błąd przejściowy. Ten kod występuje tylko w przypadku operacji zapisu. Można bezpiecznie ponowić próbę wykonania operacji.
500 Wewnętrzny błąd serwera Operacja nie powiodła się z powodu nieoczekiwanego błędu usługi. Skontaktuj się z pomocą techniczną. Zobacz Zgłaszanie problemu z pomoc techniczna platformy Azure.
503 Usługa niedostępna Nie można ukończyć operacji, ponieważ usługa była niedostępna. Taka sytuacja może wystąpić z powodu problemów z łącznością sieciową lub dostępnością usługi. Można bezpiecznie ponowić próbę wykonania operacji. Jeśli problem będzie nadal występować, skontaktuj się z działem pomocy technicznej.

Kody podstatu HTTP

W przypadku korzystania z kluczy Customer-Managed (CMK) w usłudze Azure Cosmos DB, jeśli występują błędy, usługa Azure Cosmos DB zwraca szczegóły błędu wraz z kodem podstatu HTTP w odpowiedzi. Ten kod podstatu służy do debugowania głównej przyczyny problemu. Obecnie usługa Azure Cosmos DB obsługuje następujące kody podstatu:

Kody podstatu dla problemów po stronie serwera

Następujące kody podstatu są obsługiwane przez usługę Azure Cosmos DB w przypadku problemów po stronie serwera:

Kod podstatu Opis
4000 (Nie można uzyskać/uzyskać dostępu do tokenu Azure AD) Ten błąd występuje, jeśli usługa Azure Cosmos DB nie może uzyskać tokenu dostępu usługi Azure Active Directory (Azure AD). Ten token jest wymagany do uzyskania dostępu do Key Vault w usłudze Azure Cosmos DB. Błąd może wystąpić z powodu problemu z siecią lub problemu z centrum danych i nie jest to coś, co użytkownik może wykonać akcję. Utwórz wniosek o pomoc techniczną , aby skontaktować się z zespołem usługi Azure Cosmos DB w celu rozwiązania problemu.
4001 (usługa Azure AD jest niedostępna) Ten błąd występuje, jeśli usługa Azure AD nie działa lub ma problemy. Możesz sprawdzić pulpit nawigacyjny awarii platformy Azure , aby sprawdzić, czy istnieje istniejąca awaria. Te awarie są zwykle rozwiązywane w ciągu kilku godzin. Najlepiej jest skontaktować się z zespołem Azure AD i poinformować go o problemie, który widzisz. Jeśli zespół Azure AD stwierdzi, że nie ma problemu, utwórz wniosek o pomoc techniczną, aby skontaktować się z zespołem usługi Azure Cosmos DB w celu rozwiązania problemu.
4004 (usługa Key Vault jest niedostępna) Ten błąd występuje, jeśli usługa Azure Cosmos DB próbuje uzyskać dostęp do Key Vault, ale usługa nie jest dostępna. Może to być spowodowane problemem z siecią w celu osiągnięcia Key Vault lub sama usługa może być wyłączona. Możesz sprawdzić pulpit nawigacyjny awarii platformy Azure , aby sprawdzić, czy istnieje istniejąca awaria. Te awarie są zwykle rozwiązywane w ciągu kilku godzin. Najlepiej jest skontaktować się z zespołem Key Vault i poinformować go o problemie, który widzisz. Jeśli zespół Key Vault stwierdzi, że nie ma problemu, utwórz wniosek o pomoc techniczną, aby skontaktować się z zespołem usługi Azure Cosmos DB w celu rozwiązania problemu.
4007 (wewnętrzny błąd serwera) Jest to wewnętrzny błąd serwera i występuje, jeśli bajty wejściowe nie są w formacie base64.
4008 (błędy usługi wewnętrznej Key Vault) Ten błąd występuje, jeśli usługa Azure Cosmos DB nie może uzyskać dostępu do Key Vault. Może to być spowodowane problemem z siecią lub jeśli sama usługa Key Vault nie działa. Możesz sprawdzić pulpit nawigacyjny awarii platformy Azure , aby sprawdzić, czy wystąpiła awaria. Te awarie są zwykle rozwiązywane w ciągu kilku godzin. Najlepiej jest skontaktować się z zespołem Key Vault i poinformować ich o problemie, który widzisz. Jeśli zespół Key Vault stwierdzi, że nie ma problemu, skontaktuj się z zespołem usługi Azure Cosmos DB, aby rozwiązać ten problem.
1013 (Operacja tworzenia kolekcji jest w toku) Jeśli podczas tworzenia kolekcji wystąpi wyjątek przekroczenia limitu czasu, wykonaj operację odczytu, aby sprawdzić, czy kolekcja została pomyślnie utworzona. Operacja odczytu zgłasza wyjątek do momentu pomyślnego utworzenia kolekcji. Jeśli operacja odczytu zgłasza wyjątek z kodem stanu 404 i kodem stanu podrzędnego 1013, oznacza to, że operacja tworzenia kolekcji jest nadal w toku. Ponów próbę wykonania operacji odczytu do momentu uzyskania kodów stanu 200 lub 201. Te kody poinformują Cię o pomyślnym utworzeniu kolekcji.

Kody podstatu dla problemów użytkowników końcowych

Następujące kody podstatu są obsługiwane przez usługę Azure Cosmos DB w przypadku problemów spowodowanych przez użytkownika końcowego:

Kod podstanu Opis
4002 (Key Vault nie udziela uprawnień do Azure AD lub klucz jest wyłączony) Ten problem występuje, jeśli usunięto tożsamość usługi Azure Cosmos DB z zasad dostępu Key Vault lub jeśli klucz został wyłączony. Ten problem jest zwykle spowodowany przez użytkownika końcowego. Jeśli ten błąd wystąpi, upewnij się, że usługa Azure Cosmos DB ma dostęp do Key Vault i że klucz jest włączony.
4003 (Nie znaleziono klucza) Ten problem występuje, jeśli klucz zostanie usunięty z Key Vault. Ten problem jest zwykle spowodowany przez użytkownika końcowego. Jednym z wymagań wstępnych w celu korzystania z usługi Azure Cosmos DB z kluczami zarządzanymi przez klienta jest to, że Key Vault ma włączoną ochronę przed usuwaniem nietrwałym i przeczyszczaniem. Oznacza to, że można odzyskać usunięty klucz i przywrócić dostęp do usługi Azure Cosmos DB.
4005 (Nie można zawinąć lub odpakować klucza) Ten błąd występuje, jeśli Key Vault nie może opakowować lub odpakować klucza. Ten problem jest zwykle spowodowany przez użytkownika końcowego. Jedną z możliwych przyczyn tego błędu jest to, że Key Vault nie można zdekodować zaszyfrowanego obiektu blob przy użyciu najnowszego klucza, ponieważ został obrócony klucz. Aby rozwiązać ten błąd, włącz wszystkie ostatnio wyłączone klucze i zostanie on rozwiązany w ciągu około godziny. Jeśli problem nie zostanie rozwiązany po upływie ponad 2 godzin, przekaż problem do usługi Azure Cosmos DB.
4006 (Adres URL klucza jest nieprawidłowy) Ten błąd występuje podczas aprowizacji, jeśli w adresie URL Key Vault dołączono wersję klucza. Ten błąd jest często spowodowany przez użytkownika końcowego. Aby rozwiązać ten błąd, usuń wersję i spróbuj ponownie. Jeśli na przykład użyto adresu URL w formacie https://<KeyVaultName>.vault.azure.net/keys/<KeyName>/<KeyVersion>, zaktualizuj go do https://<KeyVaultName>.vault.azure.net/keys/<KeyName>/
4009 (nie można rozpoznać nazwy DNS Key Vault) Ten błąd występuje, jeśli nie można rozpoznać nazwy DNS Key Vault, ponieważ użyto nieprawidłowej nazwy Key Vault. Ten błąd jest spowodowany przez użytkownika końcowego. Aby rozwiązać ten problem, popraw nazwę Key Vault i spróbuj ponownie.

Zobacz też