Hosting virtuale dei bucket

L'hosting virtuale è la pratica di servire più siti Web da un unico server Web. Un modo per differenziare i siti nelle richieste REST API di Amazon S3 consiste nell'utilizzare il nome host apparente dell'URI della richiesta anziché semplicemente la parte del nome del percorso dell'URI. Una richiesta REST Amazon S3 ordinaria specifica un bucket utilizzando il primo componente delimitato da barre del percorso dell'URI della richiesta. È possibile invece utilizzare l'hosting virtuale di Amazon S3 per un bucket in una chiamata di REST API utilizzando l'intestazione HTTP Host. In pratica, Amazon S3 interpreta Host come se la maggior parte dei bucket fosse accessibile immediatamente per alcuni tipi di richieste all'indirizzo https://bucket-name.s3.region-code.amazonaws.com. Per un elenco completo degli endpoint e delle Regioni Amazon S3, consulta la sezione relativa a endpoint e quote di Amazon S3 nella Riferimenti generali di Amazon Web Services.

L'hosting virtuale ha anche altri vantaggi. Assegnando al bucket il nome del dominio registrato e rendendo tale nome un alias DNS per Amazon S3, è possibile personalizzare completamente l'URL delle risorse Amazon S3, ad esempio, http://my.bucket-name.com/. Puoi anche pubblicare nella directory root del server virtuale del bucket. Questa possibilità può essere importante in quanto molte applicazioni esistenti cercano i file in questa ubicazione standard. Ad esempio, favicon.ico, robots.txt e crossdomain.xml dovrebbero trovarsi tutti nella directory root.

Richieste in stile percorso

Attualmente, Amazon S3 supporta sia gli URL in stile hosting virtuale che quelli in stile percorso in tutte le Regioni AWS. Tuttavia, path-style URLs verrà interrotto in futuro. Per ulteriori informazioni, consulta la seguente nota importante.

In Amazon S3, path-style URLs utilizza il seguente formato:

https://s3.region-code.amazonaws.com/bucket-name/key-name

Ad esempio, se hai creato un bucket denominato amzn-s3-demo-bucket1 nella regione Stati Uniti occidentali (Oregon) e vuoi accedere all'oggetto puppy.jpg in quel bucket, puoi utilizzare il seguente URL in stile percorso:

https://s3.us-west-2.amazonaws.com/amzn-s3-demo-bucket1/puppy.jpg

Richieste in stile hosting virtuale

In un URI in stile hosting virtuale, il nome del bucket fa parte del nome del dominio nell'URL.

Lo stile di hosting virtuale di Amazon S3 utilizza il seguente formato: URLs

https://bucket-name.s3.region-code.amazonaws.com/key-name

In questo esempio, amzn-s3-demo-bucket1 è il nome del bucket, Stati Uniti occidentali (Oregon) è la regione e puppy.png è il nome della chiave:

https://amzn-s3-demo-bucket1.s3.us-west-2.amazonaws.com/puppy.png

Specifica del bucket nell'intestazione HTTP Host

Purché la richiesta GET non utilizzi l'endpoint SSL, è possibile specificare il bucket per la richiesta utilizzando l'intestazione HTTP Host. L'intestazione Host in una richiesta REST viene interpretata come indicato di seguito:

Esempi

Questa sezione fornisce esempi e richieste. URLs

http://s3.us-east-1.amazonaws.com/example.com/homepage.html

GET /example.com/homepage.html HTTP/1.1
Host: s3.us-east-1.amazonaws.com

GET /example.com/homepage.html HTTP/1.0

Per informazioni sui nomi compatibili con DNS, consulta Limitazioni. Per ulteriori informazioni sulle chiavi, consultare Chiavi.

http://amzn-s3-demo-bucket1.s3.eu-west-1.amazonaws.com/homepage.html

GET /homepage.html HTTP/1.1
Host: amzn-s3-demo-bucket1.s3.eu-west-1.amazonaws.com

http://www.example.com/homepage.html

GET /homepage.html HTTP/1.1
Host: www.example.com

Personalizzazione di Amazon URLs S3 con record CNAME

A seconda delle esigenze, è possibile che non desideri che s3.region-code.amazonaws.com venga visualizzato sul tuo sito Web o sul tuo servizio. Se ad esempio ospiti le immagini del sito Web su Amazon S3, è possibile che tu preferisca http://images.example.com/ anziché http://images.example.com.s3.us-east-1.amazonaws.com/. È possibile fare riferimento a qualsiasi bucket con un nome compatibile con DNS come indicato di seguito: http://BucketName.s3.Region.amazonaws.com/[Filename], ad esempio, http://images.example.com.s3.us-east-1.amazonaws.com/mydog.jpg. Utilizzando CNAME, è possibile associare images.example.com a un nome host Amazon S3 in modo che l'URL precedente diventi http://images.example.com/mydog.jpg.

Il nome del bucket deve corrispondere esattamente al CNAME. Ad esempio, se crei un CNAME per associare images.example.com a images.example.com.s3.us-east-1.amazonaws.com, http://images.example.com/filename e http://images.example.com.s3.us-east-1.amazonaws.com/filename saranno identici.

Il record DNS di CNAME dovrebbe assegnare al nome del dominio il nome host in stile hosting virtuale appropriato come alias. Se ad esempio il nome del bucket e il nome del dominio sono images.example.com e il bucket si trova nella regione Stati Uniti orientali (Virginia settentrionale), il record CNAME dovrebbe assegnare l'alias a images.example.com.s3.us-east-1.amazonaws.com.

images.example.com CNAME 			images.example.com.s3.us-east-1.amazonaws.com.

Amazon S3 utilizza il nome host per determinare il nome del bucket. Quindi il nome del bucket e CNAME devono essere gli stessi. Si supponga ad esempio di avere configurato www.example.com come CNAME per www.example.com.s3.us-east-1.amazonaws.com. Quando accedi a http://www.example.com, Amazon S3 riceve una richiesta simile alla seguente:

GET / HTTP/1.1
Host: www.example.com
Date: date
Authorization: signatureValue

Amazon S3 vede solo il nome host originale www.example.com e non rileva la mappatura CNAME usata per risolvere la richiesta.

È possibile utilizzare qualsiasi endpoint Amazon S3 in un alias CNAME. Ad esempio, s3.ap-southeast-1.amazonaws.com può essere utilizzato negli alias CNAME. Per ulteriori informazioni sugli endpoint, consulta Request endpoints in Amazon S3 API Reference. Per creare un sito Web statico utilizzando un dominio personalizzato, consulta Tutorial: Configurazione di un sito Web statico utilizzando un dominio personalizzato registrato con Route 53

Come associare un nome host a un bucket Amazon S3

Limitazioni

Il supporto di SOAP su HTTP non viene più utilizzato ma è ancora disponibile su HTTPS. Le nuove funzioni di Amazon S3 non sono supportate per SOAP. Invece di utilizzare SOAP, ti consigliamo di utilizzare l'API REST o la. AWS SDKs

Compatibilità con le versioni precedenti

Le sezioni seguenti trattano vari aspetti della compatibilità con le versioni precedenti di Amazon S3 relativi a richieste URL in stile percorso e in stile hosting virtuale.

Endpoint legacy

Alcune regioni supportano gli endpoint legacy. Potresti vedere questi endpoint nei log o AWS CloudTrail nei log di accesso al server. Per ulteriori informazioni, consulta le informazioni riportate di seguito. Per un elenco completo degli endpoint e delle regioni Amazon S3, consultare la sezione relativa a endpoint e quote di Amazon S3 nella Riferimenti generali di Amazon Web Services.

https://bucket-name.s3.region-code.amazonaws.com/key-name

https://s3.region-code.amazonaws.com/bucket-name/key-name

s3‐Regione

Alcune regioni Amazon S3 meno recenti supportano endpoint che contengono un trattino (-) tra s3 e il codice della regione (ad esempio, s3‐us-west-2) anziché un punto (ad esempio, s3.us-west-2). Se il tuo bucket si trova in una di queste regioni, potresti vedere il seguente formato di endpoint nei log o nei log di accesso al server: CloudTrail

https://bucket-name.s3-region-code.amazonaws.com

In questo esempio, il nome del bucket è amzn-s3-demo-bucket1 e la regione è Stati Uniti occidentali (Oregon):

https://amzn-s3-demo-bucket1.s3-us-west-2.amazonaws.com

Endpoint globale legacy

Per alcune regioni, è possibile utilizzare l'endpoint globale legacy per costruire richieste che non specificano un endpoint specifico della regione. L'endpoint globale legacy è il seguente:

bucket-name.s3.amazonaws.com

Nei log o CloudTrail nei log di accesso al server, potresti vedere richieste che utilizzano l'endpoint globale legacy. In questo esempio, il nome del bucket è amzn-s3-demo-bucket1 e l'endpoint globale legacy è:

https://amzn-s3-demo-bucket1.s3.amazonaws.com

Richieste virtuali in stile hosting virtuale per Stati Uniti orientali (Virginia settentrionale)

Le richieste effettuate con l'endpoint globale legacy sono instradate negli Stati Uniti orientali (Virginia settentrionale) per impostazione predefinita. Pertanto, l'endpoint globale legacy viene talvolta utilizzato al posto dell'endpoint regionale per Stati Uniti orientali (Virginia settentrionale). Se crei un bucket in Stati Uniti orientali (Virginia settentrionale) e utilizzi l'endpoint globale, Amazon S3 instrada la richiesta a questa regione per impostazione predefinita.

Richieste in stile hosting virtuale per altre regioni

L'endpoint globale legacy viene utilizzato anche per le richieste in stile hosting virtuale nelle altre regioni supportate. Se crei un bucket in una regione lanciata prima del 20 marzo 2019 e utilizzi l'endpoint globale legacy, Amazon S3 aggiorna il record DNS per reinstradare la richiesta alla posizione corretta. Questa operazione potrebbe richiedere del tempo. Nel frattempo, viene applicata la regola di default: la richiesta in stile hosting virtuale viene inviata alla regione Stati Uniti orientali (Virginia settentrionale). Amazon S3 quindi la reindirizza con un reindirizzamento HTTP 307 temporaneo alla regione corretta.

Per i bucket S3 nelle regioni lanciati dopo il 20 marzo 2019, il server DNS non indirizza la richiesta direttamente al luogo in cui si trova il bucket. Regione AWS Restituisce invece un errore HTTP 400 - Richiesta non valida. Per ulteriori informazioni, consulta Esecuzione di richieste nella documentazione di riferimento delle API Amazon S3.

Richieste in stile percorso

Per la regione Stati Uniti orientali (Virginia settentrionale), è possibile utilizzare l'endpoint globale legacy per le richieste in stile percorso.

Per tutte le altre regioni, la sintassi in stile percorso richiede l'utilizzo dell'endpoint specifico della regione quando si cerca di accedere al bucket. Se tenti di accedere a un bucket con l'endpoint globale legacy o un altro endpoint diverso da quello della regione in cui risiede il bucket, ricevi un codice di risposta HTTP 301 (errore di reindirizzamento permanente) e un messaggio che indica l'URI corretto per la tua risorsa. Ad esempio, se lo utilizzi https://s3.amazonaws.com/bucket-name per un bucket creato nella regione Stati Uniti occidentali (Oregon), riceverai un errore di reindirizzamento permanente HTTP 301.