Lampiran: objek OPTIONS

Deskripsi

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 di Panduan Pengguna Layanan Penyimpanan Sederhana Amazon.

Permintaan

Sintaksis

OPTIONS /ObjectName HTTP/1.1
Host: BucketName.s3.amazonaws.com 
Origin: Origin
Access-Control-Request-Method: HTTPMethod
Access-Control-Request-Headers: RequestHeader

Parameter Permintaan

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

Header Permintaan

Nama	Deskripsi	Diperlukan
Origin	Mengidentifikasi asal permintaan lintas asal ke Amazon S3. Sebagai contoh, http://www.example.com.. Tipe: String Default: Tidak Ada	Ya
Access-Control-Request-Method	Mengidentifikasi metode HTTP apa yang akan digunakan dalam permintaan aktual. Tipe: String Default: Tidak Ada	Ya
Access-Control-Request-Headers	Daftar header HTTP yang dipisahkan koma yang akan dikirim dalam permintaan aktual. 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. Tipe: String Default: Tidak Ada	Tidak

Elemen permintaan

Implementasi operasi ini tidak menggunakan elemen permintaan.

Respons

Header Respons

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. Tipe: String
Access-Control-Max-Age	Berapa lama, dalam hitungan detik, hasil permintaan preflight dapat di-cache. 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. 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 awalanAccess-Control. 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. Tipe: String

Elemen Respons

Implementasi operasi ini tidak mengembalikan elemen respons.

Contoh

Contoh: Mengirim permintaan opsi preflight ke bucket yang diaktifkan cors

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 bernamaexamplebucket.

Permintaan Sampel

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

Contoh Respons

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

Sumber Daya Terkait

• GetBucketCors

• DeleteBucketCors

• PutBucketCors