Fehlermeldungen - Amazon Glacier
Beispiel 1: Beschreiben einer Auftragsanfrage mit einer Auftrags-ID, die nicht existiertBeispiel 2: Anfrage zum Auflisten von Aufträgen mit einem ungültigen Wert für den Anfrageparameter

Diese Seite ist nur für Bestandskunden des Amazon Glacier-Service bestimmt, die Vaults und die ursprüngliche REST-API von 2012 verwenden.

Wenn Sie nach Archivspeicherlösungen suchen, empfehlen wir die Verwendung der Amazon Glacier-Speicherklassen in Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval und S3 Glacier Deep Archive. Weitere Informationen zu diesen Speicheroptionen finden Sie unter Amazon Glacier-Speicherklassen.

Amazon Glacier (ursprünglicher eigenständiger, vault-basierter Service) akzeptiert ab dem 15. Dezember 2025 keine Neukunden mehr, ohne dass dies Auswirkungen auf Bestandskunden hat. Amazon Glacier ist ein eigenständiger Service APIs , der Daten in Tresoren speichert und sich von den Speicherklassen Amazon S3 und Amazon S3 Glacier unterscheidet. Ihre vorhandenen Daten bleiben in Amazon Glacier auf unbestimmte Zeit sicher und zugänglich. Es ist keine Migration erforderlich. Für kostengünstige, langfristige Archivierungsspeicherung AWS empfiehlt sich die Amazon S3 Glacier-Speicherklasse, die mit S3-Bucket-Basis, voller AWS-Region Verfügbarkeit APIs, geringeren Kosten und AWS Serviceintegration ein hervorragendes Kundenerlebnis bieten. Wenn Sie erweiterte Funktionen wünschen, sollten Sie eine Migration zu Amazon S3 Glacier-Speicherklassen in Betracht ziehen, indem Sie unseren AWS Lösungsleitfaden für die Übertragung von Daten aus Amazon Glacier-Tresoren in Amazon S3 Glacier-Speicherklassen verwenden.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Fehlermeldungen

Im Falle eines Fehlers gibt die API eine der folgenden Ausnahmen zurück:

Code Beschreibung HTTP-Statuscode Typ
AccessDeniedException Wird zurückgegeben, wenn versucht wurde, auf eine Ressource zuzugreifen, die durch eine AWS Identity and Access Management (IAM-) Richtlinie nicht zulässig ist, oder wenn die falsche AWS-Konto ID in der Anforderungs-URI verwendet wurde. Weitere Informationen finden Sie unter Identity and Access Management für Amazon Glacier. 403 Forbidden -Client
BadRequest Wird zurückgegeben, wenn die Anfrage nicht verarbeitet werden kann. 400 Bad Request -Client
ExpiredTokenException Wird zurückgegeben, wenn das in der Anfrage verwendete Sicherheits-Token abgelaufen ist. 403 Forbidden -Client
InsufficientCapacityException Wird zurückgegeben, wenn nicht ausreichende Kapazität vorhanden ist, um die beschleunigte Anfrage zu verarbeiten. Dieser Fehler gilt nur für beschleunigte Abrufe und nicht für Standard- oder Massenabrufe. 503 Service Unavailable Server
InvalidParameterValueException Wird zurückgegeben, wenn ein Parameter der Anfrage falsch angegeben wurde. 400 Bad Request -Client
InvalidSignatureException Wird zurückgegeben, wenn die Anfragesignatur ungültig ist. 403 Forbidden -Client
LimitExceededException Wird zurückgegeben, wenn die Anfrage dazu führt, dass eines der folgenden Limits überschritten wird: ein Tresorlimit, ein Tags-Limit oder das Limit der bereitgestellten Kapazität. 400 Bad Request -Client
MissingAuthenticationTokenException Wird zurückgegeben, wenn keine Authentifizierungsdaten für die Anfrage gefunden werden. 400 Bad Request -Client
MissingParameterValueException Wird zurückgegeben, wenn ein erforderlicher Header oder Parameter in der Anfrage fehlt. 400 Bad Request -Client
PolicyEnforcedException Wird zurückgegeben, wenn ein Abrufauftrag das Limit der Abrufrate der aktuellen Datenrichtlinie überschreitet. Weitere Informationen zu Datenabrufrichtlinien finden Sie unter Amazon Glacier-Richtlinien für den Datenabruf. 400 Bad Request -Client
ResourceNotFoundException Wird zurückgegeben, wenn die angegebene Ressource, wie z. B. ein Tresor, Upload-ID oder Auftrags-ID nicht vorhanden ist. 404 Not Found -Client
RequestTimeoutException Wird zurückgegeben, wenn beim Hochladen eines Archivs ein Timeout bei Amazon Glacier (Amazon Glacier) beim Empfang des Uploads auftritt. 408 Request Timeout -Client
SerializationException Wird zurückgegeben, wenn der Text der Anfrage ungültig ist. Wenn eine JSON-Nutzlast eingeschlossen ist, prüfen Sie, ob sie ein gültiges Format hat. 400 Bad Request -Client
ServiceUnavailableException Wird zurückgegeben, wenn der Service die Anfrage nicht abschließen kann. 500 Internal Server Error Server
ThrottlingException Wird zurückgegeben, wenn Sie die Anzahl Ihrer Anfragen an Amazon Glacier reduzieren müssen. 400 Bad Request -Client
UnrecognizedClientException Wird zurückgegeben, wenn die Zugriffsschlüssel-ID oder der Sicherheitstoken ungültig ist. 400 Bad Request -Client

Verschiedene Amazon Glacier APIs geben dieselbe Ausnahme zurück, jedoch mit unterschiedlichen Ausnahmemeldungen, um Ihnen bei der Behebung des jeweiligen aufgetretenen Fehlers zu helfen.

Amazon Glacier gibt Fehlerinformationen im Antworttext zurück. Die folgenden Beispiele zeigen einige der Antworten auf Fehler.

Beispiel 1: Beschreiben einer Auftragsanfrage mit einer Auftrags-ID, die nicht existiert

Angenommen, Sie senden eine Describe Job (GET JobID)-Anfrage für einen Auftrags, der nicht existiert. Das heißt, Sie geben eine Auftrags-ID an, die nicht existiert. 

GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVEXAMPLEbadJobID HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2

Als Antwort gibt Amazon Glacier die folgende Fehlerantwort zurück. 

HTTP/1.1 404 Not Found
x-amzn-RequestId: AAABaZ9N92Iiyv4N7sru3ABEpSQkuFtmH3NP6aAC51ixfjg
Content-Type: application/json
Content-Length: 185
Date: Wed, 10 Feb 2017 12:00:00 GMT
{
  "code": "ResourceNotFoundException",
  "message": "The job ID was not found: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVEXAMPLEbadJobID",
  "type": "Client"
  }

Wobei gilt:

Code

Eine der allgemeinen Ausnahmen.

Typ: Zeichenfolge

Fehlermeldung

Eine generische Beschreibung der Fehlerbedingung, die für die API spezifisch ist, die den Fehler zurückgibt.

Typ: Zeichenfolge

Typ

Die Quelle des Fehlers. Das Feld kann einen der folgenden Werte haben: Client, Server oder Unknown

Typ: Zeichenfolge.

Beachten Sie Folgendes in der vorherigen Antwort:

  • Für die Fehlerantwort gibt Amazon Glacier die Statuscodewerte 4xx und zurück5xx. In diesem Beispiel ist der Statuscode 404 Not Found.

  • Der Wert des Content-Type-Headers application/json zeigt JSON im Text an

  • Das JSON im Text liefert die Information zum Fehler.

Angenommen, Sie geben in der vorherigen Anfrage anstatt einer falschen Auftrags-ID einen Tresor an, der nicht existiert. Die Antwort gibt eine andere Nachricht zurück.

HTTP/1.1 404 Not Found
x-amzn-RequestId: AAABBeC9Zw0rp_5D0L8VfB3FA_WlTupqTKAUehMcPhdgni0
Content-Type: application/json
Content-Length: 154
Date: Wed, 10 Feb 2017 12:00:00 GMT
{
  "code": "ResourceNotFoundException",
  "message": "Vault not found for ARN: arn:aws:glacier:us-west-2:012345678901:vaults/examplevault",
  "type": "Client"
}

Beispiel 2: Anfrage zum Auflisten von Aufträgen mit einem ungültigen Wert für den Anfrageparameter

In diesem Beispiel senden Sie eine Aufträge auflisten (GET jobs)-Anfrage zum Abrufen von Tresoraufträgen mit einem bestimmten statuscode und Sie geben einen falschen statuscode-Wert finished an, anstatt der zulässigen Werte InProgress, Succeeded oder Failed. 

GET /-/vaults/examplevault/jobs?statuscode=finished HTTP/1.1 
Host: glacier.us-west-2.amazonaws.com 
Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2

Amazon Glacier gibt das InvalidParameterValueException mit einer entsprechenden Nachricht zurück.

HTTP/1.1 400 Bad Request
x-amzn-RequestId: AAABaZ9N92Iiyv4N7sru3ABEpSQkuFtmH3NP6aAC51ixfjg
Content-Type: application/json
Content-Length: 141
Date: Wed, 10 Feb 2017 12:00:00 GMT
{
  "code": "InvalidParameterValueException",
  "message": "The job status code is not valid: finished",
  "type: "Client"
}