バケットのオリジン間リソース共有 (CORS) ルールをクエリします。
リクエスト構造
GET /? cors HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValueリクエストヘッダー
DescribeRegions リクエストのすべてのヘッダーは、共通のリクエストヘッダーです。 詳細については、「共通リクエストヘッダー」をご参照ください。
レスポンスヘッダー
DescribeRegions リクエストへのレスポンスのすべてのヘッダーは、共通レスポンスヘッダーです。 詳細については、「共通レスポンスヘッダー」をご参照ください。
レスポンスパラメーター
パラメーター | タイプ | 例 | 説明 |
CORSRule | コンテナー | N/A | CORS ルールを格納するコンテナー。 バケットには最大 10 個のルールを設定できます。 親ノード: CORSConfiguration |
AllowedOrigin | 文字列 | * | クロスオリジンリクエストが許可されるソース。 AllowedOrigin がアスタリスク (*) に設定されている場合、すべてのソースからのクロスオリジンリクエストが許可されます。 親ノード: CORSRule |
AllowedMethod | 列挙型 (GET、PUT、DELETE、POST、および HEAD) | GET | 許可されるクロスオリジンリクエストメソッド。 親ノード: CORSRule |
AllowedHeader | 文字列 | * | OPTIONS プリフライトリクエストの Access-Control-Request-Headers で指定されたヘッダーが許可されるかどうかを示します。 Access-Control-Request-Headers で指定された各ヘッダーは、AllowedHeader 要素の値と一致する必要があります。 親ノード: CORSRule |
ExposeHeader | 文字列 | x-oss-test | JavaScript の XMLHttpRequest オブジェクトなど、アプリケーションからの許可されたアクセスリクエストのレスポンスヘッダー。 親ノード: CORSRule |
MaxAgeSeconds | 整数 | 100 | ブラウザが特定のリソースへの OPTIONS プリフライトリクエストのレスポンスをキャッシュできる期間。 CORS ルールには、MaxAgeSeconds パラメーターを 1 つだけ含めることができます。 単位: 秒 親ノード: CORSRule |
CORSConfiguration | コンテナー | N/A | バケットの CORS 設定を格納するコンテナー。 親ノード: なし |
ResponseVary | ブール値 | false | Vary: Origin ヘッダーが返されたかどうかを示します。 デフォルト値: false。
親ノード: CORSConfiguration |
例
サンプルリクエスト
Get /? cors HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 17 Apr 2025 07:51:28 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218eサンプルレスポンス
HTTP/1.1 200
x-oss-request-id: 50519080C4689A033D00****
Date: Thu, 13 Sep 2012 07:51:28 GMT
Connection: keep-alive
Content-Length: 218
Server: 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 を呼び出すことができます。
ossutil
GetBucketCors 操作に対応する ossutil コマンドについては、「get-bucket-cors」をご参照ください。
エラーコード
エラーコード | HTTP ステータスコード | 説明 |
NoSuchBucket | 404 | 指定されたバケットが存在しないために返されたエラーメッセージ。 |
NoSuchCORSConfiguration | 404 | 指定された CORS ルールが存在しないために返されたエラーメッセージ。 |
AccessDenied | 403 | この操作を実行する権限がないために返されたエラーメッセージ。 バケットの所有者のみが、バケットに設定されている CORS ルールをクエリできます。 |