Membuat permintaan menggunakan REST API - Amazon Simple Storage Service

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Membuat permintaan menggunakan REST API

Bagian ini berisi informasi tentang cara membuat permintaan ke titik akhir Amazon S3 dengan menggunakan. REST API Untuk daftar titik akhir Amazon S3, lihat Wilayah dan Titik Akhir di Referensi Umum AWS.

Membangun nama host S3 untuk permintaan REST API

Titik akhir Amazon S3 mengikuti struktur yang ditunjukkan di bawah ini:

s3.Region.amazonaws.com

Titik akhir titik akses Amazon S3 dan titik akhir tumpukan ganda juga mengikuti struktur standar:

  • Titik akses Amazon S3s3-accesspoint.Region.amazonaws.com

  • Tumpukan gandas3.dualstack.Region.amazonaws.com

Untuk daftar lengkap titik akhir dan Wilayah Amazon S3, lihat Titik akhir dan kuota Amazon S3 di Referensi Umum Amazon Web Services.

Permintaan gaya jalur dan gaya hosting virtual

Saat membuat permintaan menggunakan RESTAPI, Anda dapat menggunakan gaya host virtual atau gaya jalur untuk titik akhir Amazon S3URIs. Untuk informasi selengkapnya, lihat Bucket dengan hosting virtual.

contoh Permintaan gaya hosting virtual

Berikut ini adalah contoh permintaan gaya hosting virtual untuk menghapus file puppy.jpg dari bucket bernama examplebucket di Wilayah AS Barat (Oregon). Untuk informasi selengkapnya tentang permintaan cara hosting virtual, lihat Permintaan cara hosting virtual.

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
contoh Permintaan gaya jalur

Berikut ini adalah contoh versi gaya jalur dari permintaan yang sama.

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

Saat ini, Amazon S3 mendukung akses gaya host virtual dan gaya jalur secara keseluruhan. URL Wilayah AWS Namun, gaya jalur URLs akan dihentikan di masa depan. Untuk informasi selengkapnya, lihat catatan Penting berikut ini.

Untuk informasi selengkapnya tentang permintaan gaya jalur, lihat Permintaan Cara Jalur.

penting

Pembaruan (23 September 2020) - Untuk memastikan bahwa pelanggan memiliki waktu yang mereka butuhkan untuk beralih ke gaya host virtualURLs, kami telah memutuskan untuk menunda penghentian gaya jalur. URLs Untuk informasi lebih lanjut, lihat Rencana Penghentian Jalur Amazon S3-Cerita Seluruhnya di Blog Berita AWS .

Membuat permintaan ke titik akhir tumpukan ganda dengan menggunakan REST API

Saat menggunakan RESTAPI, Anda dapat langsung mengakses titik akhir dual-stack dengan menggunakan gaya host virtual atau nama titik akhir gaya jalur (). URI Semua nama titik akhir tumpukan ganda Amazon S3 mencakup wilayah dalam nama tersebut. Berbeda dengan titik akhir IPv4 -only standar, baik titik akhir gaya host virtual dan gaya jalur menggunakan nama titik akhir khusus wilayah.

contoh Permintaan titik akhir tumpukan ganda gaya hosting virtual

Anda dapat menggunakan titik akhir bergaya host virtual dalam REST permintaan Anda seperti yang ditunjukkan pada contoh berikut yang mengambil puppy.jpg objek dari bucket yang diberi nama examplebucket di Wilayah AS Barat (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
contoh Permintaan titik akhir tumpukan ganda gaya jalur

Atau Anda dapat menggunakan titik akhir gaya jalur dalam permintaan Anda seperti ditunjukkan dalam contoh berikut.

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

Untuk informasi selengkapnya tentang titik akhir tumpukan ganda, lihat Menggunakan titik akhir tumpukan ganda Amazon S3.

Untuk informasi selengkapnya tentang membuat permintaan menggunakan RESTAPI, lihat topik berikut.