すべてのプロダクト
Search

このプロダクト

    Object Storage Service:GetBucketReferer

    ドキュメントセンター

    Object Storage Service:GetBucketReferer

    最終更新日:Feb 23, 2024

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

    リクエスト構文

    GET /? リファラーHTTP/1.1
ホスト: BucketName.oss.aliyuncs.com
日付: GMT日付
権限付与: SignatureValue

    リクエストヘッダー

    このリクエストには、共通リクエストヘッダーのみが含まれます。 詳細については、「共通HTTPヘッダー」をご参照ください。

    レスポンス要素

    要素

    データ型

    例

    説明

    RefererConfiguration

    Container

    N/A

    リファラー設定を格納するコンテナー。

    親ノード: なし

    子ノード: 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

    Container

    N/A

    リファラーホワイトリストを格納するコンテナー。

    親ノード: RefererConfiguration

    子ノード: Referer

    RefererBlacklist

    Container

    N/A

    リファラーブラックリストを格納するコンテナー。

    親ノード: RefererConfiguration

    子ノード: Referer

    リファラー

    String

    http://www.aliyun.com

    リファラーホワイトリストまたはブラックリストのアドレス。

    親ノード: RefererListまたはRefererBlacklist

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

    例

    リクエストの例

    Get /?referer HTTP/1.1
ホスト: oss-example.oss.aliyuncs.com
日付: 9月13日木曜日2012 07:51:28 GMT
承認: OSS qn6qrrqxo2oawuk53otf ****: BuG4rRK + zNhH1AcF51NNHD39 ****

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

    • RefererホワイトリストまたはRefererブラックリストを含まないサンプル応答

      説明

      バケットにRefererホワイトリストまたはRefererブラックリストがない場合、Object Storage Service (OSS) はAllowEmptyRefererのデフォルト値と空のRefererListを返します。 

      HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906 ****
日付: 9月13日木曜日2012 07:56:46 GMT
接続: キープアライブ
コンテンツ-長さ: ***
サーバー: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<RefererConfiguration>
  <AllowEmptyReferer>true</AllowEmptyReferer>
  <RefererList />
</RefererConfiguration>

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

      HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906 ****
日付: 9月13日木曜日2012 07:51:28 GMT
接続: キープアライブ
コンテンツ-長さ: 218
サーバー: 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>
    <リファラー> http:// www.*.com</リファラー>
    <リファラー> https:// www.?.aliyuncs.com</リファラー>
  </RefererList>
</RefererConfiguration>

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

      HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906 ****
日付: 9月13日木曜日2012 07:51:28 GMT
接続: キープアライブ
コンテンツ-長さ: ***
サーバー: 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>
    <リファラー> http:// www.*.com</リファラー>
    <リファラー> https:// www.?.aliyuncs.com</リファラー>
  </RefererList>
  <RefererBlacklist>
    <Referer>http://www.refuse.com</Referer>
    <リファラー> https:// * .hack.com</リファラー>
    <リファラー> http:// ban.*.com</リファラー>
    <リファラー> https:// www.?.deny.com</リファラー>
  </RefererBlacklist>
</RefererConfiguration>

    SDK

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

    エラーコード

    エラーコード

    HTTPステータスコード

    説明

    NoSuchBucket

    404

    バケットが存在しない場合に返されるエラーメッセージ。

    AccessDenied

    403

    バケットのリファラー設定を照会する権限がありません。 バケットのReferer設定を照会できるのは、バケット所有者だけです。