Stavové kódy HTTP pro službu Azure Cosmos DB

  • Článek

Tento článek obsahuje stavové kódy HTTP, které vrací operace REST.

Kód Popis
200 OK Jedna z následujících operací REST byla úspěšná:

- GET u prostředku.
- PUT u prostředku.
- POST u prostředku.
- POST na prostředek uložené procedury, aby se spustila uložená procedura.
201 Vytvořeno Operace POST pro vytvoření prostředku je úspěšná.
204 Žádný obsah Operace DELETE byla úspěšná.
400 – Chybný požadavek Kód JSON, SQL nebo JavaScript v textu požadavku je neplatný.

Kromě toho může být vrácena hodnota 400 také v případě, že požadované vlastnosti prostředku nejsou k dispozici nebo nejsou nastaveny v těle post nebo PUT prostředku.

Hodnota 400 se vrátí také v případě, že konzistentní úroveň pro operaci GET je přepsána silnější konzistencí z úrovně nastavené pro účet.

Chyba 400 se také vrátí, pokud požadavek, který vyžaduje klíč x-ms-documentdb-partitionkey, neobsahuje.
401 – Neautorizováno Kód 401 se vrátí, pokud Authorization je hlavička pro požadovaný prostředek neplatná.
403 – Zakázáno Platnost autorizačního tokenu vypršela.

Kód 403 se vrátí také během POST operace vytvoření prostředku při dosažení kvóty prostředků. Příkladem tohoto scénáře je pokus o přidání dokumentů do kolekce, která dosáhla svého zřízeného úložiště.

Chyba 403 se může vrátit také v případě, že uložená procedura, trigger nebo funkce definovaná uživatelem mají příznak vysokého využití prostředků a jejich spuštění se zablokuje.

Chyba 403 – Zakázáno se vrátí v případě, že pravidla brány firewall nakonfigurovaná pro váš účet služby Azure Cosmos DB zablokují váš požadavek. Na všechny požadavky pocházející z počítačů, které nejsou na seznamu povolených, se vrátí odpověď 403.

403.3 – Tento stavový kód se vrátí pro požadavky na zápis během operace ručního převzetí služeb při selhání. Tento stavový kód používají ovladače jako kód přesměrování k předávání žádostí o zápis do nové oblasti zápisu. Aby přímý klient REST mohl zjistit aktuální oblast zápisu a směrovat do tohoto koncového bodu požadavky na zápis, musí provést operaci GET pro databázový účet.
404 – Nenalezeno Operace se pokouší jednat s prostředkem, který už neexistuje. Prostředek už může být například odstraněný.
408 – Vypršení časového limitu požadavku Operace se nedokončila v přiděleném čase. Tento kód se vrátí, když uložená procedura, trigger nebo funkce definovaná uživatelem (v rámci dotazu) nedokončí spuštění v maximální době provádění.
409 – Konflikt ID zadané pro prostředek v operaci PUT nebo POST už používá jiný existující prostředek. Pokud chcete tento problém vyřešit, použijte pro prostředek jiné ID. U dělených kolekcí musí být ID jedinečné mezi všemi dokumenty se stejnou hodnotou klíče oddílu.
412 Selhání předběžné podmínky Operace určila eTag, která se liší od verze dostupné na serveru, tj. chybu optimistické souběžnosti. Po načtení nejnovější verze prostředku a aktualizaci značky ETag v požadavku zkuste požadavek zopakovat.
413 Entita je moc velká Velikost dokumentu v žádosti překročila povolenou velikost pro žádost. Maximální povolená velikost dokumentu je 2 MB.
423 Uzamčeno Operaci škálování propustnosti nelze provést, protože probíhá jiná operace škálování.
424 Selhání závislosti Pokud operace s dokumentem selže v rámci transakčního oboru operace TransactionalBatch, všechny ostatní operace v rámci dávky se považují za závislosti, které selhaly. Tento stavový kód indikuje, že aktuální operace byla považována za neúspěšnou z důvodu jiného selhání ve stejném transakčním oboru.
429 – Příliš mnoho požadavků Kolekce překročila limit zřízené propustnosti. Zkuste požadavek zopakovat po uplynutí období pro opakování zadaného pro server. Další informace najdete v tématu Jednotky žádostí.
449 – Opakování Při operaci došlo k přechodné chybě. Tento kód se vyskytuje pouze u operací zápisu. Operaci můžete bezpečně opakovat.
500 Vnitřní chyba serveru Operace selhala kvůli neočekávané chybě služby. Obraťte se na podporu. Viz Problém s podpora Azure.
503 – Nedostupná služba Operaci nebylo možné dokončit, protože služba byla nedostupná. K této situaci může dojít kvůli problémům s připojením k síti nebo dostupností služby. Operaci můžete bezpečně opakovat. Pokud problém přetrvává, obraťte se na podporu.

Kódy dílčích statistik HTTP

Pokud při použití klíčů Customer-Managed (CMK) ve službě Azure Cosmos DB dojde k nějakým chybám, vrátí Azure Cosmos DB v odpovědi podrobnosti o chybě spolu s dílčím stavovým kódem HTTP. Tento dílčí stavový kód můžete použít k ladění původní příčiny problému. V současné době Azure Cosmos DB podporuje následující kódy dílčích statistik:

Kódy dílčího stavu pro problémy na straně serveru

Azure Cosmos DB podporuje následující dílčí kódy statistik pro problémy na straně serveru:

Kód dílčího stavu Popis
4000 (Nepodařilo se získat token Azure AD nebo získat přístup k němu) K této chybě dochází v případě, že služba Azure Cosmos DB nemůže získat přístupový token Azure Active Directory (Azure AD). Tento token je nutný pro přístup služby Azure Cosmos DB k Key Vault. K této chybě může dojít kvůli problému se sítí nebo problému s datovým centrem a uživatel nemůže provést nějakou akci. Pokud chcete problém vyřešit, vytvořte žádost o podporu a obraťte se na tým Azure Cosmos DB.
4001 (Azure AD služba není k dispozici) K této chybě dochází v případě, že je služba Azure AD mimo provoz nebo má problémy. Můžete zkontrolovat řídicí panel výpadků Azure a ověřit, jestli nedošlo k nějakému výpadku. Tyto výpadky se obvykle vyřeší během několika hodin. Nejlepší je kontaktovat tým Azure AD a dát mu vědět, jaký problém se vám zobrazuje. Pokud tým Azure AD zjistí, že nedochází k žádnému problému, vytvořte žádost o podporu, aby se s žádostí o řešení spojil s týmem Služby Azure Cosmos DB.
4004 (Key Vault služba není k dispozici) K této chybě dochází v případě, že se Azure Cosmos DB pokusí o přístup k Key Vault, ale služba není k dispozici. Příčinou může být problém se sítí, který se týká Key Vault, nebo může být mimo provoz samotná služba. Můžete zkontrolovat řídicí panel výpadků Azure a ověřit, jestli nedošlo k nějakému výpadku. Tyto výpadky se obvykle vyřeší během několika hodin. Nejlepší je kontaktovat tým Key Vault a dát mu vědět o problému, který se vám zobrazuje. Pokud Key Vault tým zjistí, že nedochází k žádnému problému, vytvořte žádost o podporu, aby se s žádostí o řešení spojil s týmem Azure Cosmos DB.
4007 (vnitřní chyba serveru) Jedná se o vnitřní chybu serveru, ke které dochází, pokud vstupní bajty nejsou ve formátu base64.
4008 (Key Vault vnitřní chyby služby) K této chybě dochází, pokud služba Azure Cosmos DB nemůže získat přístup k Key Vault. Příčinou může být problém se sítí nebo samotná služba Key Vault. Můžete zkontrolovat řídicí panel výpadků Azure a ověřit, jestli nedochází k nějakému výpadku. Tyto výpadky se obvykle vyřeší během několika hodin. Nejlepší je kontaktovat tým Key Vault a dát mu vědět, jaký problém se vám zobrazuje. Pokud Key Vault tým zjistí, že nedochází k žádnému problému, obraťte se na tým Azure Cosmos DB a požádejte o řešení.
1013 (probíhá operace vytvoření kolekce) Pokud při vytváření kolekce dojde k výjimce časového limitu, proveďte operaci čtení a ověřte, jestli se kolekce úspěšně vytvořila. Operace čtení vyvolá výjimku, dokud nebude operace vytvoření kolekce úspěšná. Pokud operace čtení vyvolá výjimku se stavovým kódem 404 a dílčím stavovým kódem 1013, znamená to, že operace vytvoření kolekce stále probíhá. Opakujte operaci čtení, dokud nedostanete stavové kódy 200 nebo 201. Tyto kódy vás upozorní, že kolekce byla úspěšně vytvořena.

Kódy dílčích stavů pro problémy koncových uživatelů

Azure Cosmos DB podporuje následující kódy dílčích statistik pro problémy způsobené koncovým uživatelem:

Kód dílčího stavu Popis
4002 (Key Vault neuděluje oprávnění Azure AD nebo je klíč zakázaný) K tomuto problému dochází, pokud jste odebrali identitu Služby Azure Cosmos DB ze zásad přístupu Key Vault nebo pokud jste klíč zakázali. Příčinou tohoto problému je obvykle koncový uživatel. Pokud dojde k této chybě, ujistěte se, že služba Azure Cosmos DB má přístup k Key Vault a že je klíč povolený.
4003 (klíč se nenašel) K tomuto problému dochází, pokud je klíč odstraněn z Key Vault. Příčinou tohoto problému je obvykle koncový uživatel. Jedním z předpokladů použití služby Azure Cosmos DB s klíči spravovanými zákazníkem je, že Key Vault má povolenou ochranu proti obnovitelnému odstranění a vymazání. To znamená, že odstraněný klíč můžete obnovit a obnovit přístup ke službě Azure Cosmos DB.
4005 (Klíč nejde zabalit nebo rozbalit) K této chybě dochází v případě, že Key Vault nemůže zabalit nebo rozbalit klíč. Příčinou tohoto problému je obvykle koncový uživatel. Jednou z možných příčin této chyby je, že se Key Vault nepodařilo dekódovat šifrovaný objekt blob pomocí nejnovějšího klíče, protože jste klíč obměněli. Pokud chcete tuto chybu vyřešit, povolte všechny nedávno zakázané klíče a tato chyba se vyřeší přibližně za hodinu. Pokud se problém nevyřeší ani po více než 2 hodinách, předejte ho službě Azure Cosmos DB.
4006 (adresa URL klíče je neplatná) K této chybě dochází během zřizování, pokud jste do adresy URL Key Vault zahrnuli verzi klíče. Tuto chybu často způsobuje koncový uživatel. Pokud chcete tuto chybu vyřešit, odeberte verzi a zkuste to znovu. Pokud jste například použili adresu URL ve formátu https://<KeyVaultName>.vault.azure.net/keys/<KeyName>/<KeyVersion>, aktualizujte ji na https://<KeyVaultName>.vault.azure.net/keys/<KeyName>/
4009 (Key Vault název DNS nejde přeložit) K této chybě dochází, pokud Key Vault název DNS nelze přeložit, protože jste použili nesprávný název Key Vault. Tuto chybu způsobuje koncový uživatel. Pokud chcete tento problém vyřešit, opravte název Key Vault a zkuste to znovu.

Viz také