All Products
Search

This Product

    Object Storage Service:GetBucketReferer

    Document Center

    Object Storage Service:GetBucketReferer

    Last Updated:Sep 10, 2026

    Mengambil konfigurasi Referer suatu bucket.

    Note

    Izin oss:GetBucketReferer diperlukan untuk mengambil konfigurasi Referer suatu bucket. Untuk informasi selengkapnya, lihat Grant a custom policy.

    Sintaksis permintaan

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

    Header permintaan

    Operasi ini hanya menggunakan header permintaan umum. Untuk informasi selengkapnya, lihat Common request headers.

    Elemen respons

    Element

    Type

    Example

    Description

    RefererConfiguration

    Kontainer

    N/A

    Kontainer yang menyimpan konfigurasi Referer.

    Node induk: tidak ada

    Node anak: AllowEmptyReferer, AllowTruncateQueryString, dan RefererList

    AllowEmptyReferer

    String terenumerasi

    false

    Menunjukkan apakah permintaan dengan bidang Referer kosong diizinkan. Nilai yang valid:

    • true

    • false

    Node induk: RefererConfiguration

    AllowTruncateQueryString

    String terenumerasi

    true

    Menunjukkan apakah string kueri dalam URL dipotong. Nilai yang valid:

    • true

    • false

    Node induk: RefererConfiguration

    TruncatePath

    String terenumerasi

    true

    Menunjukkan apakah path dan bagian setelah path dalam URL dipotong. Nilai yang valid:

    • true

    • false

    Node induk: RefererConfiguration

    RefererList

    Kontainer

    N/A

    Kontainer yang menyimpan daftar putih Referer.

    Node induk: RefererConfiguration

    Node anak: Referer

    RefererBlacklist

    Kontainer

    N/A

    Kontainer yang menyimpan blacklist Referer.

    Node induk: RefererConfiguration

    Node anak: Referer

    Referer

    String

    http://www.aliyun.com

    Alamat-alamat dalam daftar putih atau blacklist Referer.

    Node induk: RefererList atau RefererBlacklist

    Untuk informasi selengkapnya tentang header respons umum dalam operasi GetBucketReferer, seperti Date dan x-oss-request-id, lihat Common HTTP headers.

    Contoh

    Permintaan contoh

    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

    Respons sukses contoh

    • Respons contoh yang tidak berisi daftar putih Referer maupun blacklist Referer

      Catatan

      Jika bucket tidak memiliki daftar putih Referer maupun blacklist Referer, Object Storage Service (OSS) akan mengembalikan nilai default AllowEmptyReferer dan RefererList kosong.

      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>

    • Respons contoh yang hanya berisi daftar putih 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>

    • Respons contoh yang berisi daftar putih Referer dan blacklist 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 SDKs

    Anda dapat menggunakan OSS SDK untuk bahasa pemrograman berikut guna memanggil operasi GetBucketReferer:

    ossutil

    Untuk informasi tentang perintah ossutil yang sesuai dengan operasi GetBucketReferer, lihat get-bucket-referer.

    Kode kesalahan

    Kode kesalahan

    Kode status HTTP

    Deskripsi

    NoSuchBucket

    404

    Pesan kesalahan yang dikembalikan karena bucket tidak ada.

    AccessDenied

    403

    Anda tidak memiliki izin untuk menanyakan konfigurasi Referer bucket tersebut. Hanya pemilik bucket yang dapat menanyakan konfigurasi Referer bucket tersebut.