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
<a name="RESTAPI"></a>

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](https://docs.aws.amazon.com/general/latest/gr/s3.html) di *Referensi Umum AWS*.

## Membangun nama host S3 untuk permintaan API REST
<a name="constructing-hostname-rest-api-requests"></a>

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](https://docs.aws.amazon.com/general/latest/gr/s3.html) di *Referensi Umum Amazon Web Services*.

## Permintaan gaya jalur dan gaya hosting virtual
<a name="virtual-hosted-path-style-requests"></a>

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](https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html#path-style-access).

**Example 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. ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html#virtual-hosted-style-access)   

```
1. DELETE /puppy.jpg HTTP/1.1
2. Host: examplebucket.s3.us-west-2.amazonaws.com
3. Date: Mon, 11 Apr 2016 12:00:00 GMT
4. x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT
5. Authorization: {{authorization string}}
```

**Example Path-style permintaan**  
Berikut ini adalah contoh versi gaya jalur dari permintaan yang sama.  

```
1. DELETE /examplebucket/puppy.jpg HTTP/1.1
2. Host: s3.us-west-2.amazonaws.com
3. Date: Mon, 11 Apr 2016 12:00:00 GMT
4. x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT
5. 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. ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html#path-style-access)  
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](https://aws.amazon.com/blogs/aws/amazon-s3-path-deprecation-plan-the-rest-of-the-story/) di *Blog Berita AWS .*

## Membuat permintaan ke titik akhir tumpukan ganda menggunakan API REST
<a name="rest-api-dual-stack"></a>

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. 

**Example 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).   

```
1. GET /puppy.jpg HTTP/1.1
2. Host: examplebucket.s3.dualstack.us-west-2.amazonaws.com
3. Date: Mon, 11 Apr 2016 12:00:00 GMT
4. x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT
5. Authorization: {{authorization string}}
```

**Example Path-style permintaan titik akhir tumpukan ganda**  
Atau Anda dapat menggunakan titik akhir gaya jalur dalam permintaan Anda seperti ditunjukkan dalam contoh berikut.   

```
1. GET /examplebucket/puppy.jpg HTTP/1.1
2. Host: s3.dualstack.us-west-2.amazonaws.com
3. Date: Mon, 11 Apr 2016 12:00:00 GMT
4. x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT
5. Authorization: {{authorization string}}
```

Untuk informasi selengkapnya tentang titik akhir tumpukan ganda, lihat [Menggunakan titik akhir tumpukan ganda Amazon S3](dual-stack-endpoints.md). 

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

**Topics**
+ [Membangun nama host S3 untuk permintaan API REST](#constructing-hostname-rest-api-requests)
+ [Permintaan gaya jalur dan gaya hosting virtual](#virtual-hosted-path-style-requests)
+ [Membuat permintaan ke titik akhir tumpukan ganda menggunakan API REST](#rest-api-dual-stack)
+ [Meminta pengalihan dan API REST](RESTRedirect.md)
+ [Meminta perutean](UsingRouting.md)