GetBucketReferer - Object Storage Service - Alibaba Cloud ドキュメントセンター

注意事項

バケットのリファラー設定を照会するには、oss:GetBucketReferer 権限が必要です。詳細については、「カスタムポリシーの付与」をご参照ください。

リクエスト構文

GET /?referer HTTP/1.1
Host: BucketName.oss.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

リクエストヘッダー

DescribeRegions リクエストのすべてのヘッダーは、共通のリクエストヘッダーです。詳細については、「共通のリクエストヘッダー」をご参照ください。

レスポンス要素

要素	タイプ	例	説明
RefererConfiguration	コンテナー	N/A	リファラー設定を格納するコンテナーです。親ノード：なし子ノード：AllowEmptyReferer、AllowTruncateQueryString、TruncatePath、RefererList、RefererBlacklist
AllowEmptyReferer	列挙文字列	false	空のリファラーフィールドを持つリクエストを許可するかどうかを示します。有効値： true false 親ノード：RefererConfiguration
AllowTruncateQueryString	列挙文字列	true	URL 内のクエリ文字列を切り捨てるかどうかを示します。有効値： true false 親ノード：RefererConfiguration
TruncatePath	列挙文字列	true	URL 内のパスとそれに続く部分を切り捨てるかどうかを示します。有効値： true false 親ノード：RefererConfiguration
RefererList	コンテナー	N/A	リファラーホワイトリストを格納するコンテナーです。親ノード：RefererConfiguration 子ノード：Referer
RefererBlacklist	コンテナー	N/A	リファラーブラックリストを格納するコンテナーです。親ノード：RefererConfiguration 子ノード：Referer
Referer	String	http://www.aliyun.com	リファラーホワイトリストまたはリファラーブラックリスト内のアドレスです。親ノード：RefererList または RefererBlacklist

GetBucketReferer API の共通レスポンスヘッダー (Date や x-oss-request-id など) の詳細については、「共通 HTTP ヘッダー」をご参照ください。

例

リクエストの例

Get /?referer HTTP/1.1
Host: oss-example.oss.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

正常なレスポンスの例

リファラーホワイトリストまたはリファラーブラックリストを含まないレスポンスの例

説明
バケットにリファラーホワイトリストまたはリファラーブラックリストがない場合、Object Storage Service (OSS) は AllowEmptyReferer のデフォルト値と空の RefererList を返します。
```
HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906****
Date: Thu, 13 Sep 2012 07:56:46 GMT
Connection: keep-alive
Content-Length: ***  
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<RefererConfiguration>
  <AllowEmptyReferer>true</AllowEmptyReferer>
  < RefererList />
</RefererConfiguration>
```

リファラーホワイトリストのみを含むレスポンスの例

HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906****
Date: Thu, 13 Sep 2012 07:51:28 GMT
Connection: keep-alive
Content-Length: 218  
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<RefererConfiguration>
  <AllowEmptyReferer>true</AllowEmptyReferer>
  <AllowTruncateQueryString>true</AllowTruncateQueryString>
  <TruncatePath>true</TruncatePath>
  <RefererList>
    <Referer>http://www.aliyun.com</Referer>
    <Referer>https://www.aliyun.com</Referer>
    <Referer>http://www.*.com</Referer>
    <Referer>https://www.?.aliyuncs.com</Referer>
  </RefererList>
</RefererConfiguration>

リファラーホワイトリストとリファラーブラックリストを含むレスポンスの例

HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906****
Date: Thu, 13 Sep 2012 07:51:28 GMT
Connection: keep-alive
Content-Length: ***
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<RefererConfiguration>
  <AllowEmptyReferer>false</AllowEmptyReferer>
  <AllowTruncateQueryString>true</AllowTruncateQueryString>
  <TruncatePath>true</TruncatePath>
  <RefererList>
    <Referer>http://www.aliyun.com</Referer>
    <Referer>https://www.aliyun.com</Referer>
    <Referer>http://www.*.com</Referer>
    <Referer>https://www.?.aliyuncs.com</Referer>
  </RefererList>
  <RefererBlacklist>
    <Referer>http://www.refuse.com</Referer>
    <Referer>https://*.hack.com</Referer>
    <Referer>http://ban.*.com</Referer>
    <Referer>https://www.?.deny.com</Referer>
  </RefererBlacklist>
</RefererConfiguration>

OSS SDK

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

ossutil

GetBucketReferer API に対応する ossutil コマンドの詳細については、「get-bucket-referer」をご参照ください。

エラーコード

エラーコード	HTTP ステータスコード	説明
NoSuchBucket	404	指定されたバケットが存在しない場合に返されます。
AccessDenied	403	バケットのリファラー設定を照会する権限がないことを示します。バケットのリファラー設定を照会できるのは、バケットの所有者のみです。