Questa pagina è riservata ai clienti esistenti del servizio S3 Glacier che utilizzano Vaults e l'API REST originale del 2012.
Se stai cercando soluzioni di archiviazione, ti consigliamo di utilizzare le classi di storage S3 Glacier in Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval e S3 Glacier Deep Archive. Per ulteriori informazioni su queste opzioni di storage, consulta le classi di storage S3 Glacier e lo storage dei dati a lungo termine con le classi
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Risposte agli errori
In caso di errore, l'API restituisce una delle seguenti eccezioni:
Codice | Descrizione | Codice di stato HTTP | Tipo |
---|---|---|---|
AccessDeniedException |
Restituito se si è verificato un tentativo di accesso a una risorsa non consentito da una policy AWS Identity and Access Management (IAM) o se è stato utilizzato un Account AWS ID errato nell'URI della richiesta. Per ulteriori informazioni, consulta Identity and Access Management per Amazon S3 Glacier. | 403 Forbidden |
Client |
BadRequest |
Restituita se la richiesta non può essere elaborata. | 400 Bad Request |
Client |
ExpiredTokenException |
Restituita se il token di sicurezza utilizzato nella richiesta è scaduto. | 403 Forbidden |
Client |
InsufficientCapacityException |
Restituita se la capacità non è sufficiente per elaborare la richiesta di tipo Expedited. Questo errore è relativo solo ai recuperi di tipo Expedited e non a quelli di tipo Standard o Bulk. | 503 Service Unavailable |
Server |
InvalidParameterValueException |
Restituita se un parametro della richiesta non è stato specificato correttamente. | 400 Bad Request |
Client |
InvalidSignatureException |
Restituita se la firma della richiesta non è valida. | 403 Forbidden |
Client |
LimitExceededException |
Restituita se la richiesta supera uno dei seguenti limiti: limite di vault, limite di tag o limite di capacità con provisioning. | 400 Bad Request |
Client |
MissingAuthenticationTokenException |
Restituita se non vengono trovati dati di autenticazione della richiesta. | 400 Bad Request |
Client |
MissingParameterValueException |
Restituita se un'intestazione o un parametro necessario non è nella richiesta. | 400 Bad Request |
Client |
PolicyEnforcedException |
Restituita se un processo di recupero supera il limite per il tasso di recupero della policy di recupero dati corrente. Per ulteriori informazioni sulle policy di recupero dati, consulta Policy sul recupero dati di S3 Glacier. | 400 Bad Request |
Client |
ResourceNotFoundException |
Restituita se la risorsa specificata, ad esempio un vault, un ID di caricamento o un job ID non esiste. | 404 Not Found |
Client |
RequestTimeoutException |
Eccezione restituita in caso di timeout di Amazon S3 Glacier (S3 Glacier) durante il caricamento di un archivio. | 408 Request Timeout |
Client |
SerializationException |
Restituita se il corpo della richiesta non è valido. Se è incluso un payload JSON, verifica se il formato è corretto. | 400 Bad Request |
Client |
ServiceUnavailableException |
Restituita se il servizio non può completare la richiesta. | 500 Internal Server Error |
Server |
ThrottlingException |
Eccezione restituita se è necessario ridurre il numero di richieste a S3 Glacier. | 400 Bad Request |
Client |
UnrecognizedClientException |
Restituita se l'ID chiave di accesso o il token di sicurezza non è valido. | 400 Bad Request |
Client |
Diversi S3 Glacier APIs restituiscono la stessa eccezione, ma con messaggi di eccezione diversi per aiutarti a risolvere lo specifico errore riscontrato.
S3 Glacier restituisce informazioni sull'errore nel corpo della risposta. I seguenti esempi mostrano alcune delle risposte agli errori.
Esempio 1: richiesta Describe Job con un job ID inesistente
Supponiamo che invii una richiesta Describe Job (GET JobID) per un processo che non esiste, ovvero che specifichi un job ID inesistente.
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
In risposta, S3 Glacier restituisce la risposta di errore seguente.
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" }
Dove:
- Codice
-
Una delle eccezioni generali.
Tipo: Stringa
- Message
-
Una descrizione generica della condizione di errore specifica dell'API che restituisce l'errore.
Tipo: Stringa
- Tipo
-
L'origine dell'errore. Il campo può essere uno dei seguenti valori:
Client
,Server
oUnknown
.Tipo: stringa.
Nota quanto segue in relazione alla risposta precedente:
-
Nella risposta di errore, S3 Glacier restituisce i valori di codice di stato
4xx
e5xx
. In questo esempio, il codice di stato è404 Not Found
. -
Il valore
Content-Type
dell'intestazioneapplication/json
indica JSON nel corpo. -
Il codice JSON nel corpo fornisce le informazioni sull'errore.
Nella richiesta precedente, anziché un job ID non valido, supponiamo di specificare un vault inesistente. La risposta restituisce un messaggio differente.
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" }
Esempio 2: richiesta List Jobs con un valore non valido per il parametro di richiesta
In questo esempio, invii una richiesta List Jobs (GET jobs) per recuperare processi di vault con uno specifico statuscode
e per statuscode
fornisci il valore non valido finished
anziché i valori accettabili InProgress
, Succeeded
o 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
S3 Glacier restituisce InvalidParameterValueException
con un messaggio appropriato.
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" }