edit-icon download-icon

GetBucketcors

最終更新日: Aug 01, 2018

GetBucketcors 操作を使用すると、指定したバケットの現在の CORS ルールを取得できます。

リクエスト構文

  1. GET /?cors HTTP/1.1
  2. Host: BucketName.oss-cn-hangzhou.aliyuncs.com
  3. Date: GMT Date
  4. Authorization: SignatureValue

レスポンスの要素

名前  説明
CORSRule container CORS ルールのコンテナー。バケットごとに最大 10 のルールが許可されます。
親ノード: CORSConfiguration
AllowedOrigin string クロスドメインリクエストが許可されているオリジンを示します。複数の要素を使用して、許可されるオリジンを複数指定できます。 各ルールでワイルドカード “*“ を 1 つ使用できます。”*“ が指定されている場合、すべてのオリジンのクロスドメインリクエストが許可されます。
親ノード: CORSRule
AllowedMethod enumeration (GET、PUT、DELETE、POST、HEAD) クロスドメインリクエストで許可されるメソッドを指定します。
親ノード: CORSRule
AllowedHeader string OPTIONS プリフェッチコマンドの Access-Control-Request-Headers で指定されたヘッダーを許可するかどうかを制御します。Access-Control-Request-Headers で指定された各ヘッダーが AllowedHeader の値と一致している必要があります。各ルールでワイルドカード “*“ を 1 つ使用できます。
親ノード: CORSRule
ExposeHeader string 応答ヘッダーを指定して、ユーザーがアプリケーション (Javascript の XMLHttpRequest オブジェクトなど) からアクセスできるようにします。ワイルドカード “*“ は使用できません。
親ノード: CORSRule
MaxAgeSeconds integer 特定のリソースに対するブラウザープリフェッチ (OPTIONS) リクエストの結果のキャッシュ期間を指定します。単位は秒です。 CORSRule ごとに 1 つ指定できます。
親ノード: CORSRule
CORSConfiguration container バケットの CORS ルールのコンテナー。
親ノード: なし

詳細分析

  • バケットが存在しない場合は、エラー “404 no content” が返されます。エラーコードは NoSuchBucket です。
  • CORS ルールを取得できるのはバケットオーナーだけです。他のユーザーが表示しようとすると、エラー 403 Forbidden が返されます。エラーコードは AccessDenied です。
  • CORS ルールが存在しない場合は、”404 Not Found” エラーが返されます。エラーコードは NoSuchCORSConfiguration です。

リクエストの例:

  1. Get /?cors HTTP/1.1
  2. Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  3. Date: Thu, 13 Sep 2012 07:51:28 GMT
  4. Authorization: OSS qn6qrrqxo2oawuk53otfjbyc: BuG4rRK+zNhH1AcF51NNHD39zXw=

レスポンスの例 (CORS ルールが既に設定されている場合):

  1. HTTP/1.1 200
  2. x-oss-request-id: 50519080C4689A033D00235F
  3. Date: Thu, 13 Sep 2012 07:51:28 GMT
  4. Connection: keep-alive
  5. Content-Length: 218
  6. Server: AliyunOSS
  7. <?xml version="1.0" encoding="UTF-8"?>
  8. <CORSConfiguration>
  9. <CORSRule>
  10. <AllowedOrigin>*</AllowedOrigin>
  11. <AllowedMethod>GET</AllowedMethod>
  12. <AllowedHeader>*</AllowedHeader>
  13. <ExposeHeader>x-oss-test</ExposeHeader>
  14. <MaxAgeSeconds>100</MaxAgeSeconds>
  15. </CORSRule>
  16. </CORSConfiguration>