Object Storage Service:PutBucketCors

使用上の注意

• デフォルトで無効なデザイン

  デフォルトでは、バケットのCORSは無効になっています。 すべてのクロスオリジンリクエストは許可されていません。

• 上書きメカニズム

  PutBucketCors操作を呼び出して、既存のCORSルールが同じバケットに新しいCORSルールを設定すると、既存のルールが上書きされます。

• アプリケーションでのCORSの使用

  アプリケーションでCORSを使用する前に、PutBucketCors操作を呼び出してCORSルールを設定し、CORSを有効にする必要があります。

  たとえば、ブラウザのXMLHttpRequestを使用してOSSにアクセスしexample.com場合は、この操作を呼び出してXMLでCORSルールを設定する必要があります。

• CORSルールマッチング

  OSSがバケットを宛先とするクロスオリジンリクエストまたはOPTIONSリクエストを受信すると、OSSはバケットに設定されているCORSルールを読み取り、ルールを次々と照合しようとします。 最初の一致が見つかった場合、OSSは対応するヘッダーを返します。 リクエストがいずれかのCORSルールと一致しない場合、OSSはレスポンスにCORSヘッダーを含めません。

  OSSは、リクエストが次の条件を満たす場合にのみ、クロスオリジンリクエストまたはOPTIONSリクエストがCORSルールに一致すると見なします。

  • クロスオリジンリクエストの送信元のオリジンは、CORSルールの1つのAllowedOrigin要素の値と一致します。

  • 要求メソッド (GETまたはPUTなど) またはOPTIONS要求のAccess-Control-request-methodヘッダーに対応するメソッドは、1つのAllowedMethod項目と一致する必要があります。

  • OPTIONSリクエストのAccess-Control-Request-Headersに含まれる各ヘッダーは、CORSルールの1つのAllowedHeader要素の値と一致する必要があります。

リクエスト構文

PUT /?cors HTTP/1.1
日付: GMT日付
Content-Length: ContentLength
Content-Type: application/xml
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
権限付与: SignatureValue
<?xml version="1.0" encoding="UTF-8"?>
<CORSConfiguration>
    <CORSRule>
      <AllowedOrigin> CORSリクエストを許可するオリジン </AllowedOrigin>
      <AllowedOrigin>…</AllowedOrigin>
      <AllowedMethod>HTTPメソッド </AllowedMethod>
      <AllowedMethod>…</AllowedMethod>
        <AllowedHeader> ブラウザが送信できるヘッダー </AllowedHeader>
          <AllowedHeader>…</AllowedHeader>
          <ExposeHeader> クライアントアプリからアクセスできるレスポンスのヘッダー </ExposeHeader>
          <ExposeHeader>…</ExposeHeader>
          <MaxAgeSeconds> 対戦前の応答をキャッシュする時間 </MaxAgeSeconds>
    </CORSRule>
    <CORSRule>
      ...
    </CORSRule>
...
</CORSConfiguration > 

リクエスト要素

操作の一般的なリクエストヘッダーの詳細については、「一般的なHTTPヘッダー」をご参照ください。

レスポンスヘッダー

PutBucketCors要求に対する応答には、共通の応答ヘッダーのみが含まれます。 詳細については、「共通HTTPヘッダー」をご参照ください。

例

• リクエストの例

  PUT /?cors HTTP/1.1
  ホスト: oss-example.oss-cn-hangzhou.aliyuncs.com
  コンテンツ-長さ: 186
  日付: 5月4日金曜日2012 03:21:12 GMT
  権限付与: OSS qn6qrrqxo2oawuk53otf ****:KU5h8YMUC78M30dXqf3JxrT *****
  <?xml version="1.0" encoding="UTF-8"?>
  <CORSConfiguration>
      <CORSRule>
        <AllowedOrigin>*</AllowedOrigin>
        <AllowedMethod>PUT</AllowedMethod>
        <AllowedMethod>GET</AllowedMethod>
        <AllowedHeader> 権限付与 </AllowedHeader>
      </CORSRule>
      <CORSRule>
        <AllowedOrigin>http://example.com</AllowedOrigin>
        <AllowedOrigin>http://example.net</AllowedOrigin>
        <AllowedMethod>GET</AllowedMethod>
        <AllowedHeader> 権限付与 </AllowedHeader>
        <ExposeHeader>x-oss-test</ExposeHeader>
        <ExposeHeader>x-oss-test1</ExposeHeader>
        <MaxAgeSeconds>100</MaxAgeSeconds>
      </CORSRule>
      <ResponseVary>false</ResponseVary>
  </CORSConfiguration > 

• レスポンスの例

  HTTP/1.1 200 OK
  x-oss-request-id: 50519080C4689A033D0 *****
  日付: 5月4日金曜日2012 03:21:12 GMT
  コンテンツ長: 0
  接続: キープアライブ
  サーバー: AliyunOSS
  x-oss-server-time: 94 

SDK

次のプログラミング言語のOSS SDKを使用して、PutBucketCors操作を呼び出すことができます。

• Java

• Python

• PHP

• 行く

• C ++

• C

• . NET

• Node.js

• ルビー

エラーコード