OPTIONS Object

バケットに対して PUT Bucket cors を使用してCross-Origin Resource Sharing(CORS)の設定を行っていた場合、指定のオリジンやメソッド、ヘッダーがリクエストできるか確認するプリフライトリクエストを受けることができます。

もし CORS が有効でない場合は 403 Forbidden レスポンスを返します。

リクエスト情報

シンタックス

OPTIONS /{bucket name}/{object key} HTTP/1.1
Host: s3api.iot.iij.jp
Origin: {origin}
Access-Control-Request-Method: {HTTP method}
Access-Control-Request-Headers: {HTTP request headers}

リクエストパラメータ

この操作ではリクエストパラメータは使用しません。

リクエストヘッダー

この操作では基本リクエストヘッダーに加え、以下のヘッダーを使用します。

表. OPTIONS Object リクエストヘッダー一覧

HTTPヘッダー	説明	必須
Origin	クロスサイトリクエストやプリフライトリクエストの生成元を示す識別子型:Stringデフォルト値:なし	○
Access-Control-Request-Method	実際にクロスサイトリクエストを行う時のHTTPメソッド型:Stringデフォルト値:なし	○
Access-Control-Request-Headers	実際にクロスサイトリクエストを行う時のHTTPヘッダー複数指定する場合はカンマ(,)区切りで列挙します。型:Stringデフォルト値:なし	×

リクエストエレメント

この操作ではリクエストエレメントは使用しません。

レスポンス情報

レスポンスヘッダー

この操作では基本レスポンスヘッダーに加え、以下のヘッダーを返します。

表. OPTIONS Object レスポンスヘッダー一覧

HTTPヘッダー	説明
Access-Control-Allow-Origin	リクエストで送付したオリジンもしリクエストで送付したオリジンが許可されていない場合は、レスポンスにこのヘッダー要素は含まれません。型:String
Access-Control-Max-Age	プリフライトリクエストの結果をキャッシュしてよい時間型:String
Access-Control-Allow-Methods	クロスサイトリクエストで許可されているメソッド複数ある場合はカンマ(,)区切りで列挙されています。リクエストで指定したメソッドが許可されていない場合は、このヘッダー要素に指定したメソッドは含まれていません。型:String
Access-Control-Allow-Headers	クロスサイトリクエストで許可されているヘッダー複数ある場合はカンマ(,)区切りで列挙されています。リクエストで指定したヘッダーが許可されていない場合は、このヘッダー要素に指定したヘッダーは含まれていないか、 Access-Control-ヘッダーがレスポンスに含まれていません。型:String
Access-Control-Expose-Headers	サーバから通知される複数ある場合はカンマ(,)区切りで列挙されています。リクエストで指定したヘッダーが許可されていない場合は、このヘッダー要素に指定したヘッダーは含まれていないか、 Access-Control-ヘッダーがレスポンスに含まれていません。型:String

レスポンスエレメント

この操作はレスポンスエレメントを返しません。

エラー情報

この操作は共通のエラーレスポンスを返します。詳しくはエラーコード一覧をご覧ください。

サンプル

http://www.example.com からPUTメソッドのクロスサイトリクエストのプリフライトをリクエストするサンプル

リクエスト

OPTIONS /mybucket/myobject HTTP/1.1
Host: s3api.iot.iij.jp
Date: Wed, 1 Oct 2014 00:00:00 GMT
Origin: http://www.example.com
Access-Control-Request-Method: PUT

レスポンス

HTTP/1.1 200 OK
x-iijgio-id-2: eftixk72aD6Ap51TnqcoF8eFidJG9Z/2mkiDFu8yU9AS1ed4OpIszj7UDNEHGran
x-iijgio-request-id: 318BC8BC148832E5
Date: Wed, 1 Oct 2014 00:00:00 GMT
Access-Control-Allow-Origin: http://www.example.com
Access-Control-Allow-Methods: PUT
Access-Control-Expose-Headers: x-iijgio-request-id
Content-Length: 0
Server: s3api.iot.iij.jp

公開
マニュアル一覧へ

ご契約者向け
マニュアル一覧へ