Configurazione di un documento di errore personalizzato - Amazon Simple Storage Service
Codici di risposta HTTP di Amazon S3Configurazione di un documento di errore personalizzato

Configurazione di un documento di errore personalizzato

Dopo aver configurato il bucket come sito web statico, quando si verifica un errore, Amazon S3 restituisce un documento di errore HTML. È possibile configurare il bucket con un documento di errore personalizzato in modo che Amazon S3 restituisca tale documento quando si verifica un errore.

Nota

In caso di errore, alcuni browser visualizzano il loro messaggio di errore, ignorando il documento di errore che restituisce Amazon S3. Ad esempio, quando si verifica un errore HTTP 404 Non trovato, Google Chrome potrebbe ignorare il documento di errore che Amazon S3 restituisce e visualizzare il suo errore.

Codici di risposta HTTP di Amazon S3

La seguente tabella elenca il sottoinsieme dei codici di risposta HTTP che Amazon S3 restituisce in caso di errore.

Codice di errore HTTP Descrizione
301 Moved Permanently (301 Spostato definitivamente) Quando un utente invia una richiesta direttamente agli endpoint del sito web Amazon S3 (http://s3-website.Region.amazonaws.com/), Amazon S3 restituisce una risposta 301 Moved Permanently (301 Spostato definitivamente) e reindirizza tali richieste a https://aws.amazon.com/s3/.
302 Found (302 Trovato)

Quando Amazon S3 riceve una richiesta per una chiave x, http://bucket-name.s3-website.Region.amazonaws.com/x, senza barra finale, cerca innanzitutto l'oggetto con nome della chiave x. Se l'oggetto non viene trovato, Amazon S3 stabilisce che la richiesta è per la sottocartella x, la reindirizza aggiungendo una barra finale e restituisce 302 Found (302 Trovato).

304 Not Modified (304 Non modificato)

Gli utenti Amazon S3 richiedono intestazioni If-Modified-Since, If-Unmodified-Since, If-Match e/o If-None-Match per stabilire se l'oggetto richiesto coincide con la copia memorizzata nella cache del client. Se l'oggetto coincide, l'endpoint del sito Web restituisce una risposta 304 Not Modified (304 Non modificato).
400 Malformed Request (400 Richiesta non corretta)

L'endpoint del sito Web restituisce una risposta 400 Malformed Request (400 Richiesta non corretta) quando un utente cerca di accedere a un bucket attraverso l'endpoint regionale sbagliato.

403 Forbidden (403 Non consentito)

L'endpoint del sito Web restituisce una risposta 403 Forbidden (403 Non consentito) quando la richiesta di un utente viene trasferita a un oggetto che non è pubblicamente leggibile. Il proprietario dell'oggetto deve rendere l'oggetto pubblicamente leggibile mediante una policy del bucket o un'ACL.

404 Not Found (404 Non trovato)

L'endpoint del sito Web restituisce una risposta 404 Not Found (404 Non trovato) per i motivi seguenti:

  • Amazon S3 stabilisce che l'URL del sito web fa riferimento alla chiave di un oggetto che non esiste.

  • Amazon S3 deduce che la richiesta riguarda un documento di indice che non esiste.

  • Il bucket specificato nell'URL non esiste.

  • Il bucket specificato nell'URL esiste, ma non è configurato come sito Web.

È possibile creare un documento personalizzato che viene restituito per 404 Not Found (404 Non trovato). Assicurarsi che il documento sia caricato nel bucket configurato come sito Web e che la configurazione di hosting del sito Web preveda l'utilizzo del documento.

Per informazioni su come Amazon S3 interpreta l'URL come richiesta di un oggetto o di un documento di indice, consulta Configurazione di un documento indice.

500 Service Error (500 Errore servizio)

L'endpoint del sito Web restituisce una risposta 500 Service Error (500 Errore servizio) in caso di errore del server interno.
503 Service Unavailable (503 Servizio non disponibile)

L'endpoint del sito web restituisce una risposta 503 Service Unavailable (503 Servizio non disponibile) quando Amazon S3 stabilisce che occorre ridurre il tasso di richiesta.

Per ciascuno di questi errori, Amazon S3 restituisce un messaggio HTML predefinito. Di seguito è riportato un esempio di messaggio HTML che viene restituito per una risposta 403 Forbidden (403 Non consentito).

Esempio messaggio di errore 403 Forbidden (403 Non consentito)

Configurazione di un documento di errore personalizzato

Quando configuri il bucket come sito Web statico, puoi fornire un documento di errore personalizzato contenente un messaggio di errore intuitivo e una guida aggiuntiva. Amazon S3 restituisce il documento di errore personalizzato solo per la classe dei codici di errore HTTP 4XX.

Per configurare un documento di errore personalizzato utilizzando la console S3, attenersi alla procedura riportata di seguito. Puoi configurare anche un documento di errore utilizzando REST API, gli SDK AWS, la AWS CLI o AWS CloudFormation. Per ulteriori informazioni, consulta gli argomenti seguenti:

Quando abiliti l'hosting di siti Web statici per il tuo bucket, specifichi il nome del documento di errore (ad esempio, 404.html). Dopo avere abilitato l'hosting di siti Web statici per il bucket, carichi un file HTML con il nome del documento di errore nel bucket.

Per configurare un documento di errore

  1. Crea un documento di errore, ad esempio 404.html.

  2. Salva il file del documento di errore in locale.

    Il nome del documento di errore fa distinzione tra maiuscole e minuscole e deve corrispondere esattamente al nome immesso quando hai attivato l'hosting statico di siti Web. Ad esempio, se specifichi 404.html per il nome del documento di errore nella finestra di dialogo Hosting sito Web statico, anche il nome file del documento di errore dovrà essere 404.html.

  3. Accedi alla AWS Management Console e apri la console di Amazon S3 all'indirizzo https://console.aws.amazon.com/s3/.

  4. Nell'elenco S3 buckets (Bucket S3), scegliere il nome del bucket che si desidera utilizzare per ospitare un sito Web statico.

  5. Abilita l'hosting di siti Web statici per il bucket e inserisci il nome esatto del documento di errore (ad esempio, 404.html). Per ulteriori informazioni, consulta Abilitazione dell'hosting di siti Web e Configurazione di un documento di errore personalizzato.

    Dopo aver abilitato l'hosting di siti Web statici, procedere alla fase 6.

  6. Per caricare il documento di errore nel bucket, completa una delle operazioni riportate di seguito:

    • Trascina e rilascia il file del documento di errore nell'elenco dei bucket della console.

    • Scegliere Upload (Carica) e seguire le istruzioni per scegliere e caricare il file di indice.

    Per istruzioni dettagliate, consulta Caricamento di oggetti.