GetBucketReferer - Object Storage Service - Alibaba Cloud Dokümantasyon Merkezi

Not

Bir paketin Referer yapılandırmalarını sorgulamak için oss:GetBucketReferer iznine sahip olmanız gerekir. Daha fazla bilgi için bkz. Özel bir ilke atayın.

İstek sözdizimi

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

İstek üstbilgileri

DescribeRegions yalnızca ortak istek üstbilgilerini kullanır. Daha fazla bilgi için bkz. Ortak istek üstbilgileri.

Yanıt öğeleri

Öğe	Tür	Örnek	Açıklama
RefererConfiguration	Konteyner	Yok	Referer yapılandırmalarını depolayan konteyner. Üst düğümler: yok Alt düğümler: AllowEmptyReferer, AllowTruncateQueryString ve RefererList
AllowEmptyReferer	Sabitlenmiş dize	false	Boş Referer alanlarına sahip isteklere izin verilip verilmeyeceğini belirtir. Geçerli değerler: true false Üst düğümler: RefererConfiguration
AllowTruncateQueryString	Sabitlenmiş dize	true	URL'deki sorgu dizgesinin kesilip kesilmeyeceğini belirtir. Geçerli değerler: true false Üst düğümler: RefererConfiguration
TruncatePath	Sabitlenmiş dize	true	URL'deki yolun ve yoldan sonraki bölümlerin kesilip kesilmeyeceğini belirtir. Geçerli değerler: true false Üst düğümler: RefererConfiguration
RefererList	Konteyner	Yok	Referer izin listesini depolayan konteyner. Üst düğümler: RefererConfiguration Alt düğümler: Referer
RefererBlacklist	Konteyner	Yok	Referer engelleme listesini depolayan konteyner. Üst düğümler: RefererConfiguration Alt düğümler: Referer
Referer	Dize	http://www.aliyun.com	Referer izin listesindeki veya engelleme listesindeki adresler. Üst düğümler: RefererList veya RefererBlacklist

GetBucketReferer işlemindeki Date ve x-oss-request-id gibi ortak yanıt üstbilgileri hakkında daha fazla bilgi için bkz. Ortak HTTP üstbilgileri.

Örnekler

Örnek istekler

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

Örnek başarılı yanıtlar

Referer izin listesi veya Referer engelleme listesi içermeyen örnek yanıt

Not

Paketin bir Referer izin listesi veya Referer engelleme listesi yoksa Object Storage Service (OSS), AllowEmptyReferer için varsayılan değeri ve boş bir RefererList döndürür.

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>

Yalnızca Referer izin listesi içeren örnek yanıt

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 izin listesi ve Referer engelleme listesi içeren örnek yanıt

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'ları

GetBucketReferer işlemini çağırmak için aşağıdaki programlama dillerine yönelik OSS SDK'larını kullanabilirsiniz:

ossutil

GetBucketReferer işlemine karşılık gelen ossutil komutu hakkında bilgi için bkz. get-bucket-referer.

Hata kodları

Hata kodu	HTTP durum kodu	Açıklama
NoSuchBucket	404	Paket mevcut olmadığı için hata iletisi döndürülür.
AccessDenied	403	Paketin Referer yapılandırmalarını sorgulama izniniz yok. Paketin Referer yapılandırmalarını yalnızca paket sahibi sorgulayabilir.