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

バケットのリファラー設定を照会します。

注

バケットのReferer設定を照会するには、oss:GetBucketReferer権限が必要です。詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。

リクエスト構文

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

リクエストヘッダー

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

レスポンス要素

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

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

例

リクエストの例

Get /?referer HTTP/1.1
Host: oss-example.oss.aliyuncs.com  
Date: Thu, 13 Sep 2012 07:51:28 GMT
Authorization: OSS qn6q**************:77Dv****************

正常に処理された場合のレスポンス例

RefererホワイトリストまたはRefererブラックリストを含まないサンプル応答
説明
バケットにRefererホワイトリストまたはRefererブラックリストがない場合、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>
```

Refererホワイトリストのみを含むサンプル応答

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>

RefererホワイトリストとRefererブラックリストを含むサンプル応答

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操作を呼び出すことができます。

エラーコード

エラーコード	HTTPステータスコード	説明
NoSuchBucket	404	バケットが存在しない場合に返されるエラーメッセージ。
AccessDenied	403	バケットのリファラー設定を照会する権限がありません。バケットのReferer設定を照会できるのは、バケット所有者だけです。