Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Membuat permintaan menggunakan API REST
Bagian ini berisi informasi tentang cara membuat permintaan ke titik akhir Amazon S3 dengan menggunakan API REST. Untuk daftar titik akhir Amazon S3, lihat Wilayah dan Titik Akhir di Referensi Umum AWS.
Membangun nama host S3 untuk permintaan API REST
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 S3 ‐
s3-accesspoint.Region.amazonaws.com -
Dual-stack ‐
s3.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 dengan menggunakan API REST, Anda dapat menggunakan gaya jalur atau URI gaya hosting virtual untuk titik akhir Amazon S3. Untuk informasi selengkapnya, lihat Path-style permintaan.
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 gaya host virtual, lihat Path-style permintaan.
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 Path-style permintaan
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 URL dengan gaya hosting virtual dan gaya jalur di seluruh Wilayah AWS. Namun, URL cara jalur akan dihentikan di masa depan. Untuk informasi selengkapnya, lihat catatan Penting berikut ini.
Untuk informasi selengkapnya tentang permintaan gaya jalur, lihat Path-style permintaan.
penting
Pembaruan (23 September 2020)–Untuk memastikan bahwa pelanggan memiliki waktu yang dibutuhkan untuk melakukan transisi ke URL dengan cara hosting virtual, kami telah memutuskan untuk menunda penghentian penggunaan URL dengan cara jalur. Untuk informasi lebih lanjut, lihat Rencana Penghentian Jalur Amazon S3-Cerita Seluruhnya
Membuat permintaan ke titik akhir tumpukan ganda menggunakan API REST
Saat menggunakan API REST, Anda dapat mengakses langsung titik akhir tumpukan ganda dengan menggunakan nama titik akhir (URI) gaya hosting virtual dan gaya jalur. Semua nama titik akhir tumpukan ganda Amazon S3 mencakup wilayah dalam nama tersebut. Tidak seperti titik akhir IPv4-only standar, titik akhir gaya host virtual dan jalur gaya menggunakan nama titik akhir khusus wilayah.
contoh Permintaan titik akhir tumpukan ganda gaya hosting virtual
Anda dapat menggunakan titik akhir gaya hosting virtual dalam permintaan REST seperti yang ditunjukkan dalam contoh berikut yang mengambil objek puppy.jpg dari bucket yang bernama 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 Path-style permintaan titik akhir tumpukan ganda
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 REST API, lihat topik berikut.
