GetBucketReferer - Object Storage Service - Centre de documentation Alibaba Cloud

Remarque

L’autorisation oss:GetBucketReferer est requise pour interroger la configuration Referer d’un bucket. Pour plus d’informations, consultez la section Accorder une stratégie personnalisée.

Syntaxe de la requête

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

En-têtes de requête

Cette opération utilise uniquement des en-têtes de requête communs. Pour plus d’informations, consultez la section En-têtes de requête communs.

Éléments de réponse

Élément	Type	Exemple	Description
RefererConfiguration	Container	N/A	Conteneur qui stocke la configuration Referer. Nœuds parents : aucun Nœuds enfants : AllowEmptyReferer, AllowTruncateQueryString et RefererList
AllowEmptyReferer	Enumerated string	false	Indique si les requêtes avec des champs Referer vides sont autorisées. Valeurs possibles : true false Nœuds parents : RefererConfiguration
AllowTruncateQueryString	Enumerated string	true	Indique si la chaîne de requête dans l’URL est tronquée. Valeurs possibles : true false Nœuds parents : RefererConfiguration
TruncatePath	Enumerated string	true	Indique si le chemin d’accès et les parties qui suivent le chemin d’accès dans l’URL sont tronqués. Valeurs possibles : true false Nœuds parents : RefererConfiguration
RefererList	Container	N/A	Conteneur qui stocke la liste d’autorisation Referer. Nœuds parents : RefererConfiguration Nœuds enfants : Referer
RefererBlacklist	Container	N/A	Conteneur qui stocke la liste de blocage Referer. Nœuds parents : RefererConfiguration Nœuds enfants : Referer
Referer	String	http://www.aliyun.com	Adresses figurant dans la liste d’autorisation ou la liste de blocage Referer. Nœuds parents : RefererList ou RefererBlacklist

Pour plus d’informations sur les en-têtes de réponse communs dans l’opération GetBucketReferer, tels que Date et x-oss-request-id, consultez la section En-têtes HTTP communs.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

Exemple de réponse ne contenant ni liste d’autorisation Referer ni liste de blocage Referer

Remarque

Si le bucket ne possède ni liste d’autorisation Referer ni liste de blocage Referer, Object Storage Service (OSS) renvoie la valeur par défaut de AllowEmptyReferer et une RefererList vide.

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>

Exemple de réponse contenant uniquement une liste d’autorisation 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>

Exemple de réponse contenant une liste d’autorisation Referer et une liste de blocage 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

Utilisez les SDK OSS pour les langages de programmation suivants afin d’appeler l’opération GetBucketReferer :

ossutil

Pour obtenir des informations sur la commande ossutil correspondant à l’opération GetBucketReferer, consultez la section get-bucket-referer.

Codes d’erreur

Code d’erreur

Code d’état HTTP

Description

NoSuchBucket

404

Le message d’erreur indique que le bucket n’existe pas.

AccessDenied

403

Vous ne disposez pas des autorisations nécessaires pour interroger la configuration Referer du bucket. Seul le propriétaire du bucket peut interroger la configuration Referer du bucket.