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

# Lampiran: objek OPTIONS
<a name="RESTOPTIONSobject"></a>

## Deskripsi
<a name="RESTOPTIONSobject-description"></a>

Browser dapat mengirim permintaan preflight ini ke Amazon S3 untuk menentukan apakah dapat mengirim permintaan aktual dengan asal, metode HTTP, dan header tertentu. 

Amazon S3 mendukung cross-origin resource sharing (CORS) dengan memungkinkan Anda menambahkan `cors` subresource pada bucket. Saat browser mengirimkan permintaan preflight ini, Amazon S3 merespons dengan mengevaluasi aturan yang ditentukan dalam `cors` konfigurasi.

Jika tidak `cors` diaktifkan pada bucket, maka Amazon S3 mengembalikan `403 Forbidden` respons.

 Untuk informasi selengkapnya tentang CORS, buka Meng [ aktifkan Berbagi Cross-Origin Sumber Daya ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/cors.html) di Panduan * Pengguna Layanan Penyimpanan Sederhana * Amazon.

## Permintaan
<a name="RESTOPTIONSobject-requests"></a>

### Sintaksis
<a name="RESTOPTIONSobject-requests-syntax"></a>

```
1. OPTIONS /{{ObjectName}} HTTP/1.1
2. Host: {{BucketName}}.s3.amazonaws.com 
3. Origin: {{Origin}}
4. Access-Control-Request-Method: {{HTTPMethod}}
5. Access-Control-Request-Headers: {{RequestHeader}}
```

### Parameter Permintaan
<a name="RESTOPTIONSobject-requests-request-parameters"></a>

 Operasi ini tidak memperkenalkan parameter permintaan tertentu, tetapi mungkin berisi parameter permintaan apa pun yang diperlukan oleh permintaan aktual. 

### Header Permintaan
<a name="RESTOPTIONSobject-requests-request-headers"></a>


|  Nama  |  Deskripsi  |  Diperlukan  | 
| --- | --- | --- | 
| Origin | Mengidentifikasi asal permintaan lintas asal ke Amazon S3. Sebagai contoh, http://www.example.com..<br />Tipe: String <br />Default: Tidak Ada |  Ya  | 
| Access-Control-Request-Method | Mengidentifikasi metode HTTP apa yang akan digunakan dalam permintaan aktual.<br />Tipe: String <br />Default: Tidak Ada |  Ya  | 
| Access-Control-Request-Headers | Daftar header HTTP yang dipisahkan koma yang akan dikirim dalam permintaan aktual. <br />Misalnya, untuk menempatkan objek dengan enkripsi sisi server, permintaan preflight ini akan menentukan apakah itu dapat menyertakan `x-amz-server-side-encryption` header dengan permintaan.<br />Tipe: String <br />Default: Tidak Ada |  Tidak  | 

### Elemen permintaan
<a name="RESTOPTIONSobject-requests-request-elements"></a>

Implementasi operasi ini tidak menggunakan elemen permintaan.

## Respons
<a name="RESTOPTIONSobject-responses"></a>

### Header Respons
<a name="RESTOPTIONSobject-responses-response-headers"></a>


| Header | Deskripsi | 
| --- | --- | 
| Access-Control-Allow-Origin | Asal yang Anda kirim dalam permintaan Anda. Jika asal dalam permintaan Anda tidak diizinkan, Amazon S3 tidak akan menyertakan header ini dalam respons.<br />Tipe: String | 
| Access-Control-Max-Age | Berapa lama, dalam hitungan detik, hasil permintaan preflight dapat di-cache.<br />Tipe: String | 
| Access-Control-Allow-Methods  | Metode HTTP yang dikirim dalam permintaan asli. Jika metode dalam permintaan tidak diizinkan, Amazon S3 tidak akan menyertakan header ini dalam respons.<br />Tipe: String | 
| Access-Control-Allow-Headers  | Daftar header HTTP yang dibatasi koma yang dapat dikirim browser dalam permintaan yang sebenarnya. Jika salah satu header yang diminta tidak diizinkan, Amazon S3 tidak akan menyertakan header tersebut dalam respons, respon juga tidak akan berisi header dengan awalan`Access-Control`.<br />Tipe: String | 
| Access-Control-Expose-Headers  | Daftar header HTTP yang dipisahkan koma. Header ini menyediakan JavaScript klien dengan akses ke header ini dalam menanggapi permintaan yang sebenarnya.<br />Tipe: String | 

### Elemen Respons
<a name="RESTOPTIONSobject-responses-response-elements"></a>

Implementasi operasi ini tidak mengembalikan elemen respons.

## Contoh
<a name="RESTOPTIONSobject-examples"></a>

### Contoh: Mengirim permintaan opsi preflight ke bucket yang diaktifkan `cors`
<a name="RESTOPTIONSobject-examples-example-1-configure-cors---single-rule"></a>

 Browser dapat mengirim permintaan preflight ini ke Amazon S3 untuk menentukan apakah dapat mengirim permintaan PUT aktual dari http://www.example.com asal ke bucket Amazon S3 bernama`examplebucket`. 

#### Permintaan Sampel
<a name="RESTOPTIONSobject-examples-example-1-configure-cors---single-rule-sample-request"></a>

```
1. OPTIONS /exampleobject HTTP/1.1
2. Host: examplebucket.s3.amazonaws.com 
3. Origin: http://www.example.com
4. Access-Control-Request-Method: PUT
```

#### Contoh Respons
<a name="RESTOPTIONSobject-examples-example-1-configure-cors---single-rule-sample-response"></a>

```
 1. HTTP/1.1 200 OK
 2. x-amz-id-2: 6SvaESv3VULYPLik5LLl7lSPPtSnBvDdGmnklX1HfUl7uS2m1DF6td6KWKNjYMXZ
 3. x-amz-request-id: BDC4B83DF5096BBE
 4. Date: Wed, 21 Aug 2012 23:09:55 GMT
 5. Etag: "1f1a1af1f1111111111111c11aed1da1"
 6. Access-Control-Allow-Origin: http://www.example.com
 7. Access-Control-Allow-Methods: PUT
 8. Access-Control-Expose-Headers: x-amz-request-id
 9. Content-Length: 0
10. Server: AmazonS3
```

## Sumber Daya Terkait
<a name="RESTOPTIONSobject-related-resources"></a>
+  [GetBucketCors](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketCors.html) 
+  [DeleteBucketCors](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketCors.html) 
+  [PutBucketCors](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketCors.html)