HTTP-állapotkódok az Azure Cosmos DB-hez

  • Cikk

Ez a cikk a REST-műveletek által visszaadott HTTP-állapotkódokat tartalmazza.

Kód Leírás
200 OK Az alábbi REST-műveletek egyike sikeres volt:

- GET egy erőforráson.
- PUT egy erőforráson.
- POST egy erőforráson.
- POST tárolt eljárás erőforráson a tárolt eljárás végrehajtásához.
201 Létrehozva Az erőforrás létrehozásához szükséges POST művelet sikeres.
204 Nincs tartalom A DELETE művelet sikeres.
400 Hibás kérelem A kérelem törzsében található JSON, SQL vagy JavaScript érvénytelen.

Emellett 400-ás értéket is visszaadhat, ha egy erőforrás szükséges tulajdonságai nincsenek megadva vagy beállítva a POST vagy a PUT erőforrás törzsében.

A rendszer akkor is 400 értéket ad vissza, ha a GET művelet konzisztens szintjét felülírja a fiók egy készletének erősebb konzisztenciája.

A 400-at akkor is visszaadja a rendszer, ha egy x-ms-documentdb-partitionkey azonosítót igénylő kérés nem tartalmazza azt.
401 Nem engedélyezett A rendszer a 401-et adja vissza, ha a Authorization fejléc érvénytelen a kért erőforráshoz.
403 – Tiltott Az engedélyezési jogkivonat lejárt.

A 403-at a rendszer egy művelet során POST is visszaadja, hogy erőforrást hozzon létre az erőforráskvóta elérésekor. Erre a forgatókönyvre példa, ha olyan gyűjteményhez próbál dokumentumokat hozzáadni, amelyek elérték a kiépített tárterületet.

403-as hiba akkor is megjelenhet, ha egy tárolt eljárás, trigger vagy UDF meg lett jelölve nagymértékű erőforrás-használat miatt, és a rendszer blokkolja a végrehajtását.

403-as (Tiltott) hiba jelenik meg, ha az Azure Cosmos DB-fiókja esetében konfigurált tűzfalszabályok miatt a rendszer blokkolja a kérését. Az engedélyezési listán nem szereplő gépekről származó kérések esetében a rendszer 403-as hibát ad vissza.

403.3 – A manuális feladatátvételi művelet során a rendszer ezt az állapotkódot adja vissza írási kérésekhez. Ezt az állapotkódot az illesztőprogramok átirányítási kódként használják az írási kérelmek új írási régióba való továbbításához. A közvetlen REST-ügyfélnek GET művelet kell végrehajtania a DatabaseAccount fiókon az aktuális írási régió azonosításához és az írási kérés adott végponthoz való továbbításához.
404 Nem található A művelet egy már nem létező erőforrásra próbál reagálni. Előfordulhat például, hogy az erőforrás már törölve lett.
408 Kérelem időtúllépése A művelet nem fejeződött be a megadott időtartamon belül. Ez a kód akkor jelenik meg, ha egy tárolt eljárás, eseményindító vagy UDF (lekérdezésen belül) nem fejeződik be a végrehajtás a maximális végrehajtási időn belül.
409 Ütközés Egy PUT vagy POST műveletben érintett erőforráshoz megadott azonosítót egy meglévő erőforrás foglalt le. A probléma megoldásához használjon egy másik azonosítót az erőforráshoz. Particionált gyűjtemények esetén az azonosítónak minden azonos partíciókulcsú dokumentumban egyedinek kell lennie.
412 Előfeltételek hibája A művelet olyan eTaget adott meg, amely eltér a kiszolgálón elérhető verziótól, azaz optimista egyidejűségi hiba. Az erőforrás legfrissebb verziójának beolvasása és a kérés eTagjének frissítése után próbálkozzon újra a kéréssel.
413 Entity too large A dokumentum mérete a kérésben meghaladta a kéréshez megengedett dokumentumméretet. A legnagyobb megengedett dokumentumméret 2 MB.
423 Locked Az átvitelskálázási művelet nem hajtható végre, mert folyamatban van egy másik skálázási művelet.
424 Failed dependency Ha egy dokumentumművelet egy TransactionalBatch művelet tranzakciós hatókörben hiúsul meg, akkor a kötegen belüli összes művelet sikertelen függőségnek minősül. Ez az állapotkód azt jelzi, hogy az aktuális művelet a tranzakciós hatókörön belüli másik hiba miatt minősült sikertelennek.
429 Túl sok kérés A gyűjtemény meghaladta a számára megadott átvitelisebesség-korlátot. Ismételje meg a kérést, miután letelt a kiszolgáló által meghatározott újrapróbálkozási időköz. További információ: Kérelemegységek.
449 Újrapróbálkozás A művelet átmeneti hibát észlelt. Ez a kód csak írási műveleteknél fordul elő. A művelet újrapróbálkozása biztonságos.
500 Belső kiszolgálóhiba A művelet váratlan szolgáltatáshiba miatt meghiúsult. Vegye fel a kapcsolatot az ügyfélszolgálattal. Lásd: Azure-támogatás probléma bejelentése.
503 A szolgáltatás nem érhető el A művelet nem hajtható végre, mert a szolgáltatás nem érhető el. Ez a helyzet a hálózati kapcsolat vagy a szolgáltatás rendelkezésre állásával kapcsolatos problémák miatt fordulhat elő. A művelet újrapróbálkozása biztonságos. Ha a probléma továbbra is fennáll, forduljon a támogatási szolgálathoz.

HTTP-alállapotkódok

Ha Customer-Managed Kulcsokat (CMK) használ az Azure Cosmos DB-ben, hiba esetén az Azure Cosmos DB egy HTTP-alállapotkóddal együtt adja vissza a hiba részleteit a válaszban. Ezzel az alállapotkóddal hibakeresést végezhet a probléma kiváltó okán. Az Azure Cosmos DB jelenleg a következő alállapotkódokat támogatja:

Alállapotkódok kiszolgálóoldali problémákhoz

Az Azure Cosmos DB a következő alállapotkódokat támogatja kiszolgálóoldali problémák esetén:

Alállapotkód Leírás
4000 (Nem sikerült lekérni/elérni a Azure AD tokent) Ez a hiba akkor fordul elő, ha az Azure Cosmos DB nem tudja lekérni az Azure Active Directory (Azure AD) hozzáférési jogkivonatot. Ez a jogkivonat szükséges ahhoz, hogy az Azure Cosmos DB hozzáférjen a Key Vault. A hiba hálózati probléma vagy adatközpont-probléma miatt fordulhat elő, és a felhasználó nem tud műveletet végezni. Hozzon létre egy támogatási kérést az Azure Cosmos DB csapatához a probléma megoldásához.
4001 (Azure AD szolgáltatás nem érhető el) Ez a hiba akkor fordul elő, ha a Azure AD szolgáltatás leállt, vagy problémákat tapasztal. Az Azure szolgáltatáskimaradási irányítópulton ellenőrizheti, hogy van-e meglévő szolgáltatáskimaradás. Ezek a kimaradások általában néhány órán belül megoldódnak. A legjobb, ha kapcsolatba lép a Azure AD csapatával, és tudatja velük, hogy milyen problémát tapasztal. Ha a Azure AD csapat úgy találja, hogy nincs probléma, hozzon létre egy támogatási kérést az Azure Cosmos DB csapatának megoldásához.
4004 (Key Vault szolgáltatás nem érhető el) Ez a hiba akkor fordul elő, ha az Azure Cosmos DB megpróbál hozzáférni a Key Vault, de a szolgáltatás nem érhető el. Ennek oka lehet egy hálózati probléma, amely Key Vault érhető el, vagy maga a szolgáltatás leállhat. Az Azure szolgáltatáskimaradási irányítópulton ellenőrizheti, hogy van-e meglévő szolgáltatáskimaradás. Ezek a kimaradások általában néhány órán belül megoldódnak. A legjobb, ha kapcsolatba lép a Key Vault csapattal, és tudatja velük, hogy milyen problémát tapasztal. Ha a Key Vault csapat úgy találja, hogy nincs probléma, hozzon létre egy támogatási kérést az Azure Cosmos DB csapatának megoldásához.
4007 (belső kiszolgálóhiba) Ez egy belső kiszolgálóhiba, és akkor fordul elő, ha a bemeneti bájtok nem base64 formátumban vannak.
4008 (Key Vault belső szolgáltatáshibák) Ez a hiba akkor fordul elő, ha az Azure Cosmos DB nem tud hozzáférni a Key Vault. Ennek oka lehet egy hálózati probléma, vagy ha a Key Vault szolgáltatás leállt. Az Azure szolgáltatáskimaradási irányítópulton ellenőrizheti, hogy van-e meglévő szolgáltatáskimaradás. Ezek a kimaradások általában néhány órán belül megoldódnak. A legjobb, ha kapcsolatba lép a Key Vault csapattal, és tudatja velük, hogy milyen problémát tapasztal. Ha a Key Vault csapat úgy találja, hogy nincs probléma, forduljon az Azure Cosmos DB csapatához a megoldás érdekében.
1013 (A gyűjtemény létrehozási művelete folyamatban van) Ha időtúllépési kivételt tapasztal a gyűjtemény létrehozásakor, olvasási műveletet hajt végre annak ellenőrzéséhez, hogy a gyűjtemény sikeresen létrejött-e. Az olvasási művelet kivételt jelez, amíg a gyűjteménylétrehozási művelet sikeres nem lesz. Ha az olvasási művelet kivételt jelez a 404-s állapotkóddal és az 1013-at tartalmazó alállapotkóddal, az azt jelenti, hogy a gyűjteménylétrehozási művelet még folyamatban van. Próbálkozzon újra az olvasási művelettel, amíg 200 vagy 201 állapotkódot nem kap, ezek a kódok jelzik, hogy a gyűjtemény sikeresen létrejött.

Végfelhasználói problémák alállapotkódjai

Az Azure Cosmos DB a következő alállapotkódokat támogatja a végfelhasználó által okozott problémák esetén:

Alállapotkód Leírás
4002 (Key Vault nem ad engedélyt a Azure AD, vagy a kulcs le van tiltva) Ez a probléma akkor fordul elő, ha eltávolította az Azure Cosmos DB-identitást a Key Vault hozzáférési szabályzatokból, vagy ha letiltotta a kulcsot. Ezt a problémát általában a végfelhasználó okozza. Ha ez a hiba jelentkezik, győződjön meg arról, hogy az Azure Cosmos DB hozzáfér a Key Vault, és a kulcs engedélyezve van.
4003 (A kulcs nem található) Ez a probléma akkor fordul elő, ha a kulcsot törölték a Key Vault. Ezt a problémát általában a végfelhasználó okozza. Az Azure Cosmos DB ügyfél által felügyelt kulcsokkal való használatának egyik előfeltétele, hogy a Key Vault engedélyezve legyen a helyreállítható törlés és törlés elleni védelem. Ez azt jelenti, hogy helyreállíthatja a törölt kulcsot, és visszaállíthatja az Azure Cosmos DB-hez való hozzáférést.
4005 (A kulcs nem tördelhető vagy bontható ki) Ez a hiba akkor fordul elő, ha a Key Vault nem tudja tördelni vagy kicsomagolni a kulcsot. Ezt a problémát általában a végfelhasználó okozza. A hiba egyik lehetséges oka az, hogy a Key Vault nem tudta dekódolni a titkosított blobot a legújabb kulccsal, mert elforgatta a kulcsot. A hiba elhárításához engedélyezze a legutóbb letiltott kulcsokat, és körülbelül egy óra múlva megoldjuk. Ha a probléma több mint 2 óra elteltével nem oldódott meg, adja át a problémát az Azure Cosmos DB-nek.
4006 (A kulcs URL-címe érvénytelen) Ez a hiba akkor fordul elő a kiépítés során, ha a kulcsverziót a Key Vault URL-címbe foglalta. Ezt a hibát gyakran a végfelhasználó okozza. A hiba elhárításához távolítsa el a verziót, és próbálkozzon újra. Ha például az URL-címet a formátumban használta, frissítse a következőre https://<KeyVaultName>.vault.azure.net/keys/<KeyName>/<KeyVersion>: https://<KeyVaultName>.vault.azure.net/keys/<KeyName>/
4009 (Key Vault DNS-név nem oldható fel) Ez a hiba akkor fordul elő, ha a Key Vault DNS-név nem oldható fel, mert helytelen Key Vault nevet használt. Ezt a hibát a végfelhasználó okozza. A probléma megoldásához javítsa ki a Key Vault nevét, és próbálkozzon újra.

Lásd még