GetBucketReferer - Object Storage Service

Memeriksa konfigurasi Referer dari sebuah bucket.

Catatan

Izin oss:GetBucketReferer diperlukan untuk memeriksa konfigurasi Referer dari sebuah bucket. Untuk informasi lebih lanjut, lihat Lampirkan kebijakan kustom ke pengguna RAM.

Sintaks permintaan

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

Header permintaan

Semua header dalam permintaan DescribeRegions merupakan header permintaan umum. Untuk informasi lebih lanjut, lihat Header Permintaan Umum.

Elemen respons

Elemen	Tipe	Contoh	Deskripsi
RefererConfiguration	Kontainer	Tidak tersedia	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 valid: true false Node induk: RefererConfiguration
AllowTruncateQueryString	String terenumerasi	true	Menunjukkan apakah string query dalam URL dipotong. Nilai valid: true false Node induk: RefererConfiguration
TruncatePath	String terenumerasi	true	Menunjukkan apakah jalur dan bagian setelah jalur dalam URL dipotong. Nilai valid: true false Node induk: RefererConfiguration
RefererList	Kontainer	Tidak tersedia	Kontainer yang menyimpan daftar putih Referer. Node induk: RefererConfiguration Node anak: Referer
RefererBlacklist	Kontainer	Tidak tersedia	Kontainer yang menyimpan daftar hitam Referer. Node induk: RefererConfiguration Node anak: Referer
Referer	String	http://www.aliyun.com	Alamat dalam daftar putih atau daftar hitam Referer. Node induk: RefererList atau RefererBlacklist

Untuk informasi lebih lanjut tentang header respons umum dalam operasi GetBucketReferer, seperti Date dan x-oss-request-id, lihat Header HTTP Umum.

Contoh

Permintaan Contoh

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

Respons Sukses Contoh

Respons contoh yang tidak berisi daftar putih Referer atau daftar hitam Referer

Catatan

Jika bucket tidak memiliki daftar putih Referer atau daftar hitam Referer, Object Storage Service (OSS) 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 daftar hitam 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>

SDK OSS

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

Kode kesalahan

Kode kesalahan	Status HTTP	Deskripsi
NoSuchBucket	404	Pesan kesalahan dikembalikan karena bucket tidak ada.
AccessDenied	403	Anda tidak memiliki izin untuk memeriksa konfigurasi Referer bucket. Hanya pemilik bucket yang dapat memeriksa konfigurasi Referer bucket.