Risposte agli errori

In caso di errore, l'API restituisce una delle seguenti eccezioni:

Codice	Descrizione	Codice di stato HTTP	Tipo
AccessDeniedException	Restituito se una policy (IAM) AWS Identity and Access Management tenta di accedere a una risorsa non consentita oppure se un ID Account AWS non corretto è utilizzato 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 sul 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

Varie API di S3 Glacier restituiscono la stessa eccezione, ma con diversi messaggi di eccezione per consentirti di risolvere il problema 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 o Unknown.

Tipo: stringa.

Nota quanto segue in relazione alla risposta precedente:

• Nella risposta di errore, S3 Glacier restituisce i valori di codice di stato 4xx e 5xx. In questo esempio, il codice di stato è 404 Not Found.

• Il valore Content-Type dell'intestazione application/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"
}