Fehler

Jeder Fehler ist ein JSON-Umschlag mit einem stabilen Maschinencode, einem optionalen Grund, der ihn präzisiert, einer Meldung für Menschen und der Anfrage-ID für den Support. Clients entscheiden anhand von Code und Grund, nie anhand des Meldungstexts.

{ "code": "conflict", "reason": "version_exists", "message": "…", "requestId": "…" }

Codes

Code	HTTP-Status	Bedeutung
invalid_input	400	Die Anfrage ist fehlerhaft oder ein Wert ist nicht zulässig; korrigieren Sie die Anfrage, bevor Sie sie erneut senden.
not_found	404	Das Objekt existiert nicht, oder der Aufrufer darf es nicht sehen.
conflict	409	Die Anfrage steht im Widerspruch zum aktuellen Zustand; lesen Sie den Zustand erneut und entscheiden Sie dann.
forbidden	403	Die Anmeldedaten sind gültig, aber es fehlt die Berechtigung für diese Aktion.
unauthorized	401	Keine gültigen Anmeldedaten: fehlend, falsch, abgelaufen oder widerrufen.
capacity_exceeded	507	Ein Kontingent, eine Kapazität oder ein Limit würde überschritten.
integrity_mismatch	422	Die Bytes stimmen nicht mit der angegebenen Größe oder dem angegebenen SHA-256 überein.
busy	503	Der Server hat seine Zulassungsgrenze erreicht; wiederholen Sie die Anfrage nach Retry-After.
unavailable	503	Eine Abhängigkeit ist derzeit nicht verfügbar; wiederholen Sie die Anfrage nach Retry-After.
rate_limited	429	Zu viele Versuche; warten Sie Retry-After ab.
read_only	405	Dieser Server oder dieses Gateway nimmt keine Änderungen an (Lese-Gateway oder Spiegel).
internal	500	Ein unerwarteter Serverfehler; die Anfrage-ID hilft dem Support, ihn zu finden. Nicht blind wiederholen.

Gründe

Code	Grund	HTTP-Status	Bedeutung
invalid_input	validation	400	Ein Feld fehlt oder hat einen Wert außerhalb seiner Regeln; details nennt das Feld.
invalid_input	malformed_json	400	Der Body ist kein gültiges JSON.
invalid_input	body_too_large	413	Der Body ist größer, als diese Operation akzeptiert.
invalid_input	unsupported_media_type	415	Der Content-Type wird von dieser Operation nicht akzeptiert.
invalid_input	method_not_allowed	405	Der Pfad existiert, aber nicht mit dieser Methode.
invalid_input	range_not_satisfiable	416	Der angeforderte Byte-Bereich liegt außerhalb des Inhalts.
not_found	route_not_found	404	Diese Route gibt es nicht.
conflict	upload_expired	409	Die Upload-Sitzung ist abgelaufen, bevor sie abgeschlossen wurde.
conflict	upload_state	409	Der Upload befindet sich nicht in einem Zustand, der diesen Schritt erlaubt.
conflict	revision_mismatch	409	Die erwartete Revision ist nicht die aktuelle (eine andere Änderung kam zuerst).
conflict	version_exists	409	Diese Version wurde bereits mit anderem Inhalt veröffentlicht.
conflict	part_mismatch	409	Ein Teil stimmt nicht mit seiner angegebenen Größe oder seinem SHA-256 überein.
conflict	parts_incomplete	409	Es sind noch nicht alle Teile des Uploads eingetroffen.
conflict	idempotency_mismatch	409	Der Idempotency-Key wurde bereits mit einer anderen Anfrage verwendet.
conflict	already_exists	409	Ein Objekt mit diesem Namen oder Pfad existiert bereits.
conflict	stage_limit	409	Das Artefakt hat die maximale Anzahl von Stufen.
conflict	state_conflict	409	Das Objekt befindet sich in einem Zustand, der diese Änderung nicht erlaubt.
conflict	mirror_read_only	409	Das Repository ist ein Spiegel; es ändert sich nur durch Synchronisierung.
forbidden	permission_missing	403	Den Anmeldedaten fehlt die Aktion, die diese Operation benötigt.
forbidden	read_only_token	403	Ein schreibgeschütztes persönliches Token kann nichts ändern.
forbidden	credential_revoked	403	Der Schlüssel oder das Token wurde widerrufen.
forbidden	session_required	403	Nur die Sitzung eines angemeldeten Kontos darf dies tun, kein Schlüssel.
forbidden	administrator_required	403	Nur ein Administrator darf dies tun.
forbidden	registration_disabled	403	Die Selbstregistrierung ist auf diesem Server abgeschaltet.
forbidden	origin_not_allowed	403	Der Browser-Origin steht nicht in ARKVORY_CORS_ORIGINS.
unauthorized	invalid_credentials	401	Der Kontoname oder das Passwort ist falsch.
unauthorized	current_password_invalid	401	Das aktuelle Passwort ist falsch.
unauthorized	credential_missing	401	Die Anfrage enthält keine Anmeldedaten.
unauthorized	credential_invalid	401	Die Anmeldedaten sind weder ein gültiger Schlüssel noch ein gültiges Token noch eine gültige Sitzung.
unauthorized	session_expired	401	Die Sitzung ist abgelaufen; melden Sie sich erneut an.
unauthorized	token_expired	401	Das persönliche Token ist abgelaufen.
capacity_exceeded	storage_quota	507	Das Kontingent des Repositorys würde überschritten.
capacity_exceeded	storage_full	507	Der Datenträger des Servers hält seine Reserve an freiem Speicherplatz frei; für mehr ist kein Platz.
capacity_exceeded	account_limit	507	Die Anzahl der Konten hat ihr Limit erreicht.
capacity_exceeded	group_limit	507	Die Anzahl der Gruppen hat ihr Limit erreicht.
capacity_exceeded	membership_limit	507	Die Anzahl der Gruppenmitglieder hat ihr Limit erreicht.
capacity_exceeded	grant_limit	507	Die Anzahl der Zuweisungen hat ihr Limit erreicht.
capacity_exceeded	key_limit	507	Die Anzahl der Schlüssel hat ihr Limit erreicht.
capacity_exceeded	token_limit	507	Die Anzahl der persönlichen Token hat ihr Limit erreicht.
capacity_exceeded	delegation_limit	507	Die Anzahl der Delegierungen hat ihr Limit erreicht.
capacity_exceeded	catalog_limit	507	Die Katalogkapazität der Installation würde überschritten.
capacity_exceeded	queue_full	507	Die Transfer-Warteschlange ist voll.
capacity_exceeded	transfer_limit	507	Der Aufrufer hat so viele Transfers, wie erlaubt sind.
busy	request_limit	503	Der Server bearbeitet so viele Anfragen, wie er zulässt.
busy	download_queued	503	Der Download wartet in der Warteschlange; nach Retry-After erneut anfragen. Arkvory-Queue-Position und Arkvory-Starts-At nennen Platz und erwarteten Beginn.
unavailable	feedback_disabled	503	Feedback ist auf diesem Server abgeschaltet.
unavailable	hub_unreachable	503	Der Update-Hub ist nicht erreichbar.
unavailable	replication_degraded	503	Ein HA-Cluster hat weniger vollständige Kopien, als ein Schreibvorgang braucht; die Änderung wurde nicht bestätigt. Nach Retry-After wiederholen. Downloads funktionieren weiter.
rate_limited	login_attempts	429	Zu viele Anmeldeversuche; warten Sie.
rate_limited	registration_attempts	429	Zu viele Registrierungsversuche; warten Sie.
rate_limited	password_attempts	429	Zu viele Passwortversuche; warten Sie.
rate_limited	feedback_attempts	429	Zu viele Feedback-Meldungen; warten Sie.