Risposte agli errori - Amazon S3 Glacier
Esempio 1: richiesta Describe Job con un job ID inesistenteEsempio 2: richiesta List Jobs con un valore non valido per il parametro di richiesta

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 di storage S3 Glacier nella Amazon S3 User Guide. Queste classi di storage utilizzano l'API Amazon S3, sono disponibili in tutte le regioni e possono essere gestite all'interno della console Amazon S3. Offrono funzionalità come Storage Cost Analysis, Storage Lens, funzionalità di crittografia opzionali avanzate e altro ancora.

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 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"
}