HTTP-statuscodes voor Azure Cosmos DB

  • Artikel

Dit artikel bevat de HTTP-statuscodes die worden geretourneerd door de REST-bewerkingen.

Code Beschrijving
200 OK Een van de volgende REST-bewerkingen is geslaagd:

- GET op een resource.
- PUT op een resource.
- POST op een resource.
- POST op een opgeslagen procedureresource om de opgeslagen procedure uit te voeren.
201 Gemaakt Een POST-bewerking voor het maken van een resource is geslaagd.
204 Geen inhoud De DELETE-bewerking is geslaagd.
400 Ongeldige aanvraag De JSON, SQL of JavaScript in de aanvraagbody is ongeldig.

Bovendien kan een 400 ook worden geretourneerd wanneer de vereiste eigenschappen van een resource niet aanwezig zijn of zijn ingesteld in de hoofdtekst van de POST of PUT voor de resource.

400 wordt ook geretourneerd wanneer het consistente niveau voor een GET-bewerking wordt overschreven door een sterkere consistentie van de waarde die is ingesteld voor het account.

400 wordt ook geretourneerd wanneer een aanvraag waarvoor een x-ms-documentdb-partitionkey is vereist, deze niet bevat.
401 Onbevoegd 401 wordt geretourneerd wanneer de Authorization header ongeldig is voor de aangevraagde resource.
403 Verboden Het autorisatietoken is verlopen.

403-code wordt ook geretourneerd tijdens een POST bewerking om een resource te maken wanneer het resourcequotum is bereikt. Een voorbeeld van dit scenario is wanneer u documenten probeert toe te voegen aan een verzameling die de ingerichte opslag heeft bereikt.

403 kan ook worden geretourneerd wanneer een opgeslagen procedure, trigger of UDF is gemarkeerd voor intensief resourcegebruik en geblokkeerd voor uitvoering.

De fout 403 Verboden wordt geretourneerd wanneer de firewallregels die in uw Azure Cosmos DB-account zijn geconfigureerd, uw aanvraag blokkeren. Aanvragen die afkomstig zijn van computers die niet op de whitelist staan, krijgen een 403-fout.

403.3 : deze statuscode wordt geretourneerd voor schrijfaanvragen tijdens de handmatige failoverbewerking. Deze statuscode wordt door stuurprogramma's gebruikt als omleidingscode om de schrijfaanvragen door te sturen naar een nieuwe schrijfregio. Direct REST-client moet GET uitvoeren op DatabaseAccount om de huidige schrijfregio te identificeren en de schrijfaanvraag door te sturen naar dat eindpunt.
404 Niet gevonden De bewerking probeert actie te ondernemen op een resource die niet meer bestaat. De resource is bijvoorbeeld mogelijk al verwijderd.
408 Time-out van aanvraag De bewerking is niet binnen de toegewezen tijd voltooid. Deze code wordt geretourneerd wanneer een opgeslagen procedure, trigger of UDF (binnen een query) de uitvoering niet binnen de maximale uitvoeringstijd voltooit.
409 Conflict De opgegeven id voor een resource bij een PUT- of POST-bewerking wordt gebruikt voor een bestaande resource. Gebruik een andere id voor de resource om dit probleem op te lossen. Voor gepartitioneerde verzamelingen moet de id uniek zijn binnen alle documenten met dezelfde partitiesleutelwaarde.
412 Fout bij voorwaarde De bewerking heeft een eTag opgegeven die verschilt van de versie die beschikbaar is op de server, dat wil zeggen, een optimistische gelijktijdigheidsfout. Voer de aanvraag opnieuw uit nadat u de meest recente versie van de resource hebt gelezen en de eTag voor de aanvraag hebt bijgewerkt.
413 Entiteit is te groot De documentgrootte in de aanvraag is groter dan de toegestane documentgrootte voor een aanvraag. De maximaal toegestane documentgrootte is 2 MB.
423 Vergrendeld De doorvoerschaalbewerking kan niet worden uitgevoerd omdat er een andere schaalbewerking wordt uitgevoerd.
424 Mislukte afhankelijkheid Wanneer een documentbewerking mislukt binnen het transactionele bereik van een TransactionalBatch-bewerking, worden alle andere bewerkingen in de batch beschouwd als mislukte afhankelijkheden. Deze statuscode geeft aan dat de huidige bewerking als mislukt wordt beschouwd vanwege een andere fout binnen hetzelfde transactionele bereik.
429 Te veel aanvragen De verzameling heeft de limiet voor ingerichte doorvoer overschreden. Voer de aanvraag opnieuw uit nadat door de server een tijdsduur heet aangegeven waarna een nieuwe poging kan worden gedaan. Zie aanvraageenheden voor meer informatie.
449 opnieuw proberen met Er is een tijdelijke fout opgetreden tijdens de bewerking. Deze code vindt alleen plaats bij schrijfbewerkingen. Het is veilig om de bewerking opnieuw uit te voeren.
500 Interne serverfout De bewerking is mislukt vanwege een onverwachte servicefout. Neem contact op met ondersteuning. Zie Een probleem met ondersteuning voor Azure indienen.
503 Service niet beschikbaar De bewerking kan niet worden voltooid omdat de service niet beschikbaar is. Deze situatie kan optreden als gevolg van problemen met de netwerkverbinding of de beschikbaarheid van de service. Het is veilig om de bewerking opnieuw uit te voeren. Neem contact op met de ondersteuning als het probleem zich blijft voordoen.

HTTP-substatuscodes

Wanneer u cmk (Customer-Managed keys) gebruikt in Azure Cosmos DB en er fouten zijn, retourneert Azure Cosmos DB de foutdetails samen met een HTTP-substatuscode in het antwoord. U kunt deze substatuscode gebruiken om fouten op te sporen in de hoofdoorzaak van het probleem. Momenteel ondersteunt Azure Cosmos DB de volgende substatuscodes:

Substatuscodes voor problemen aan de serverzijde

De volgende substatuscodes worden ondersteund door Azure Cosmos DB voor problemen aan de serverzijde:

Substatuscode Beschrijving
4000 (Kan het Azure AD-token niet ophalen/openen) Deze fout treedt op als Azure Cosmos DB het Toegangstoken van Azure Active Directory (Azure AD) niet kan ophalen. Dit token is vereist voor Azure Cosmos DB om toegang te krijgen tot de Key Vault. De fout kan optreden als gevolg van een netwerkprobleem of een probleem met een datacentrum en de gebruiker kan geen actie ondernemen. Maak een ondersteuningsaanvraag om het Azure Cosmos DB-team te bereiken om het probleem op te lossen.
4001 (Azure AD service is niet beschikbaar) Deze fout treedt op als de Azure AD-service niet beschikbaar is of problemen heeft. U kunt het Azure-storingsdashboard controleren om te controleren of er een bestaande storing is. Deze storingen worden doorgaans binnen een paar uur opgelost. U kunt het beste contact opnemen met het Azure AD-team en hen laten weten welk probleem u ondervindt. Als het Azure AD-team vaststelt dat er geen probleem is, maakt u een ondersteuningsaanvraag om het Azure Cosmos DB-team te bereiken voor oplossing.
4004 (Key Vault service is niet beschikbaar) Deze fout treedt op als Azure Cosmos DB toegang probeert te krijgen tot de Key Vault, maar de service niet beschikbaar is. Dit kan worden veroorzaakt door een netwerkprobleem dat Key Vault bereikt of dat de service zelf niet beschikbaar is. U kunt het Azure-storingsdashboard controleren om te controleren of er een bestaande storing is. Deze storingen worden doorgaans binnen een paar uur opgelost. U kunt het beste contact opnemen met het Key Vault team en hen op de hoogte stellen van het probleem dat u ziet. Als het Key Vault-team vaststelt dat er geen probleem is, maakt u een ondersteuningsaanvraag om het Azure Cosmos DB-team te bereiken voor oplossing.
4007 (interne serverfout) Dit is een interne serverfout en deze treedt op als de invoerbytes niet de base64-indeling hebben.
4008 (Key Vault interne servicefouten) Deze fout treedt op als Azure Cosmos DB geen toegang heeft tot de Key Vault. Dit kan worden veroorzaakt door een netwerkprobleem of als de Key Vault service zelf niet beschikbaar is. U kunt het Azure-storingsdashboard controleren om te controleren of er een bestaande storing is. Deze storingen worden doorgaans binnen een paar uur opgelost. U kunt het beste contact opnemen met het Key Vault team en hen op de hoogte stellen van het probleem dat u ondervindt. Als het Key Vault team constateert dat er geen probleem is, neemt u contact op met het Azure Cosmos DB-team voor een oplossing.
1013 (bewerking voor het maken van een verzameling wordt uitgevoerd) Als er een time-outuitzondering optreedt bij het maken van een verzameling, voert u een leesbewerking uit om te controleren of de verzameling is gemaakt. De leesbewerking genereert een uitzondering totdat de bewerking voor het maken van de verzameling is geslaagd. Als de leesbewerking een uitzondering genereert met statuscode 404 en substatuscode 1013, betekent dit dat de bewerking voor het maken van de verzameling nog steeds wordt uitgevoerd. Voer de leesbewerking opnieuw uit totdat u de statuscodes 200 of 201 krijgt. Deze codes laten u weten dat de verzameling is gemaakt.

Substatuscodes voor problemen met eindgebruikers

De volgende substatuscodes worden ondersteund door Azure Cosmos DB voor problemen die worden veroorzaakt door de eindgebruiker:

Substatuscode Beschrijving
4002 (Key Vault verleent geen machtiging aan de Azure AD of de sleutel is uitgeschakeld) Dit probleem treedt op als u de Azure Cosmos DB-identiteit hebt verwijderd uit het Key Vault toegangsbeleid of als u de sleutel hebt uitgeschakeld. Dit probleem wordt meestal veroorzaakt door de eindgebruiker. Als deze fout optreedt, moet u ervoor zorgen dat azure Cosmos DB toegang heeft tot de Key Vault en dat de sleutel is ingeschakeld.
4003 (sleutel is niet gevonden) Dit probleem treedt op als de sleutel wordt verwijderd uit de Key Vault. Dit probleem wordt meestal veroorzaakt door de eindgebruiker. Een van de vereisten voor het gebruik van Azure Cosmos DB met door de klant beheerde sleutels is dat voor de Key Vault beveiliging voor voorlopig verwijderen en opschonen is ingeschakeld. Dit betekent dat u de verwijderde sleutel kunt herstellen en de toegang tot Azure Cosmos DB kunt herstellen.
4005 (kan de sleutel niet verpakken of uitpakken) Deze fout treedt op als de Key Vault de sleutel niet kan verpakken of uitpakken. Dit probleem wordt meestal veroorzaakt door de eindgebruiker. Een van de mogelijke oorzaken voor deze fout is dat de Key Vault de versleutelde blob niet kon decoderen met behulp van de meest recente sleutel omdat u de sleutel hebt geroteerd. Als u deze fout wilt oplossen, schakelt u onlangs uitgeschakelde sleutels in. Dit wordt over ongeveer een uur opgelost. Als het probleem na meer dan 2 uur nog niet is opgelost, geeft u het probleem door aan Azure Cosmos DB.
4006 (sleutel-URL is ongeldig) Deze fout treedt op tijdens het inrichten als u de sleutelversie hebt opgenomen in de URL van Key Vault. Deze fout wordt vaak veroorzaakt door de eindgebruiker. U kunt deze fout oplossen door de versie te verwijderen en het opnieuw te proberen. Als u bijvoorbeeld de URL in de indeling https://<KeyVaultName>.vault.azure.net/keys/<KeyName>/<KeyVersion>hebt gebruikt, werkt u deze bij naar https://<KeyVaultName>.vault.azure.net/keys/<KeyName>/
4009 (Key Vault DNS-naam kan niet worden omgezet) Deze fout treedt op als de Key Vault DNS-naam niet kan worden omgezet, omdat u de onjuiste Key Vault naam hebt gebruikt. Deze fout wordt veroorzaakt door de eindgebruiker. U kunt dit oplossen door de naam van de Key Vault te corrigeren en het opnieuw te proberen.

Zie ook