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à.
Esecuzione di richieste con l'utilizzo di API REST
Questa sezione contiene informazioni su come effettuare richieste agli endpoint Amazon S3 utilizzando l'API REST. Per un elenco di endpoint di Amazon S3, consultare la sezione relativa a regioni ed endpoint nella Riferimenti generali di AWS.
Costruzione di nomi host S3 per richieste API REST
Gli endpoint Amazon S3 seguono la struttura riportata di seguito:
s3.Region.amazonaws.com
Gli endpoint degli Punti di accesso Amazon S3 e gli endpoint dual-stack seguono la struttura standard:
-
Access point Amazon S ‐
s3-accesspoint.Region.amazonaws.com -
Dual-stack ‐
s3.dualstack.Region.amazonaws.com
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.
Richieste in stile hosting virtuale e in stile percorso
Quando si effettua una richiesta utilizzando l'API REST, è possibile utilizzare URI in stile hosting virtuale o in stile percorso per gli endpoint Amazon S3. Per ulteriori informazioni, consulta Hosting virtuale dei bucket.
Esempio Richiesta in stile hosting virtuale
Qui di seguito è riportato un esempio di richiesta in stile hosting virtuale per eliminare il file puppy.jpg dal bucket denominato examplebucket nella regione Stati Uniti occidentali (Oregon). Per ulteriori informazioni sulle richieste in stile hosting virtuale, consulta Richieste in stile hosting virtuale.
DELETE /puppy.jpg HTTP/1.1 Host: examplebucket.s3.us-west-2.amazonaws.com Date: Mon, 11 Apr 2016 12:00:00 GMT x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT Authorization:authorization string
Esempio Richiesta in stile percorso
Di seguito è riportato un esempio di una versione in stile percorso della stessa richiesta.
DELETE /examplebucket/puppy.jpg HTTP/1.1 Host: s3.us-west-2.amazonaws.com Date: Mon, 11 Apr 2016 12:00:00 GMT x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT Authorization:authorization string
Attualmente, Amazon S3 supporta sia gli URL in stile hosting virtuale che quelli in stile percorso in tutte le Regioni AWS. Tuttavia, gli URL in stile percorso non saranno più disponibili in futuro. Per ulteriori informazioni, consulta la seguente nota importante.
Per ulteriori informazioni sulle richieste in stile percorso, consulta Richieste in stile percorso.
Importante
Aggiornamento (23 settembre 2020): per assicurare che i clienti abbiano il tempo necessario per eseguire la transizione agli URL in stile hosting virtuale, abbiamo deciso di posticipare l'obsolescenza degli URL in stile percorso. Per ulteriori informazioni, consulta Piano di obsolescenza del percorso Amazon S3 - Il resto della storia
Esecuzione di richieste a endpoint Dual-Stack utilizzando l'API REST
Quando si utilizza l'API REST, è possibile accedere direttamente a un endpoint dual-stack utilizzando un nome di endpoint (URI) in stile hosting virtuale o in stile percorso. Tutti i nomi di endpoint dual-stack Amazon S3 includono la regione nel nome. A differenza degli endpoint solo IPv4 standard, sia gli endpoint in stile hosting virtuale sia quelli in stile percorso utilizzano nomi di endpoint specifici per regione.
Esempio Richiesta con endpoint dual-stack in stile hosting virtuale
È possibile utilizzare un endpoint in stile hosting virtuale nella richiesta REST come illustrato nell'esempio seguente che recupera l'oggetto puppy.jpg dal bucket denominato examplebucket nella regione Stati Uniti occidentali (Oregon).
GET /puppy.jpg HTTP/1.1 Host: examplebucket.s3.dualstack.us-west-2.amazonaws.com Date: Mon, 11 Apr 2016 12:00:00 GMT x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT Authorization:authorization string
Esempio Richiesta con endpoint dual-stack in stile percorso
Altrimenti, è possibile utilizzare un endpoint in stile percorso nella richiesta come illustrato nell'esempio seguente.
GET /examplebucket/puppy.jpg HTTP/1.1 Host: s3.dualstack.us-west-2.amazonaws.com Date: Mon, 11 Apr 2016 12:00:00 GMT x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT Authorization:authorization string
Per ulteriori informazioni sugli endpoint dual-stack, consulta Utilizzo degli endpoint dual-stack Amazon S3.
Per ulteriori informazioni su come effettuare richieste utilizzando l'API REST, consulta gli argomenti di seguito.
