バケットの Cross-Origin Resource Sharing (CORS) ルールを照会します。
リクエストの構造
GET /? cors HTTP/1.1
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
日付: GMT日付
権限付与: SignatureValue リクエストヘッダー
このリクエストには、共通リクエストヘッダーのみが含まれます。 詳細については、「共通HTTPヘッダー」をご参照ください。
レスポンスヘッダー
このリクエストには、共通のレスポンスヘッダーのみが含まれます。 詳細については、「共通HTTPヘッダー」をご参照ください。
レスポンスパラメーター
| パラメーター | データ型 | 例 | 説明 |
| CORSRule | Container | N/A | CORSルールを格納するコンテナー。 バケットに最大10個のルールを設定できます。 親ノード: CORSConfiguration |
| AllowedOrigin | String | * | クロスオリジンリクエストが許可されるソース。 AllowedOriginがアスタリスク (*) に設定されている場合、すべてのソースからのクロスオリジンリクエストが許可されます。 親ノード: CORSRule |
| AllowedMethod | 列挙 (GET、PUT、DELETE、POST、およびHEAD) | GET | 許可されているクロスオリジン要求メソッド。 親ノード: CORSRule |
| AllowedHeader | String | * | OPTIONSプリフライト要求のAccess-Control-Request-headersで指定されたヘッダーが許可されているかどうかを示します。 Access-Control-Request-Headersによって指定される各ヘッダーは、AllowedHeader要素の値と一致する必要があります。 親ノード: CORSRule |
| ExposeHeader | String | x-oss-test | JavaScriptのXMLHttpRequestオブジェクトなど、アプリケーションからの許可されたアクセス要求のレスポンスヘッダー。 親ノード: CORSRule |
| MaxAgeSeconds | Integer | 100 | ブラウザが特定のリソースへのOPTIONSプリフライト要求の応答をキャッシュできる期間。 CORSルールには、MaxAgeSecondsパラメーターを1つだけ含めることができます。 単位：秒 親ノード: CORSRule |
| CORSConfiguration | Container | N/A | バケットのCORS設定を格納するコンテナー。 親ノード: なし |
| ResponseVary | Boolean | false | Vary: Originヘッダーが返されたかどうかを示します。 デフォルト値：false
親ノード: CORSConfiguration |
例
リクエストの例
Get /? cors HTTP/1.1
ホスト: oss-example.oss-cn-hangzhou.aliyuncs.com
日付: 9月13日木曜日2012 07:51:28 GMT
承認: OSS qn6qrrqxo2oawuk53otfjbyc: BuG4rRK + zNhH1AcF51NNHD39 **** レスポンスの例
HTTP/1.1 200
x-oss-request-id: 50519080C4689A033D00 ****
日付: 9月13日木曜日2012 07:51:28 GMT
接続: キープアライブ
コンテンツ-長さ: 218
サーバー: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<CORSConfiguration>
<CORSRule>
<AllowedOrigin>*</AllowedOrigin>
<AllowedMethod>GET</AllowedMethod>
<AllowedHeader>*</AllowedHeader>
<ExposeHeader>x-oss-test</ExposeHeader>
<MaxAgeSeconds>100</MaxAgeSeconds>
</CORSRule>
<ResponseVary>false</ResponseVary>
</CORSConfiguration> OSS SDK
次のプログラミング言語のOSS SDKを使用して、GetBucketCorsを呼び出すことができます。
エラーコード
| エラーコード | HTTPステータスコード | 説明 |
| NoSuchBucket | 404 | 指定されたバケットが存在しない場合に返されるエラーメッセージ。 |
| NoSuchCORSConfiguration | 404 | 指定されたCORSルールが存在しない場合に返されるエラーメッセージ。 |
| AccessDenied | 403 | 該当の操作を実行する権限がない場合に返されるエラーメッセージです。 バケットの所有者のみが、バケットに設定されたCORSルールを照会できます。 |