GetBucketReferer - Object Storage Service - Centro de documentación de Alibaba Cloud

Consulta la configuración de Referer de un bucket.

Nota

El permiso oss:GetBucketReferer es obligatorio para consultar la configuración de Referer de un bucket. Para obtener más información, consulte Grant a custom policy.

Sintaxis de la solicitud

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

Encabezados de solicitud

DescribeRegions utiliza únicamente encabezados de solicitud comunes. Para obtener más información, consulte Common request headers.

Elementos de respuesta

Elemento	Tipo	Ejemplo	Descripción
RefererConfiguration	Contenedor	Ninguna	Contenedor que almacena la configuración de Referer. Nodos principales: ninguno Nodos secundarios: AllowEmptyReferer, AllowTruncateQueryString y RefererList
AllowEmptyReferer	Cadena enumerada	false	Indica si se permiten las solicitudes con campos Referer vacíos. Valores válidos: true false Nodos principales: RefererConfiguration
AllowTruncateQueryString	Cadena enumerada	true	Indica si se trunca la cadena de consulta en la URL. Valores válidos: true false Nodos principales: RefererConfiguration
TruncatePath	Cadena enumerada	true	Indica si se truncan la ruta y las partes posteriores a la ruta en la URL. Valores válidos: true false Nodos principales: RefererConfiguration
RefererList	Contenedor	Ninguna	Contenedor que almacena la lista de permitidos de Referer. Nodos principales: RefererConfiguration Nodos secundarios: Referer
RefererBlacklist	Contenedor	Ninguna	Contenedor que almacena la lista de bloqueados de Referer. Nodos principales: RefererConfiguration Nodos secundarios: Referer
Referer	Cadena	http://www.aliyun.com	Direcciones incluidas en la lista de permitidos o en la lista de bloqueados de Referer. Nodos principales: RefererList o RefererBlacklist

Para obtener más información sobre los encabezados de respuesta comunes en la operación GetBucketReferer, como Date y x-oss-request-id, consulte Common HTTP headers.

Ejemplos

Ejemplos de solicitud

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

Ejemplos de respuestas exitosas

Ejemplo de respuesta sin lista de permitidos ni lista de bloqueados de Referer

Nota

Si el bucket no tiene una lista de permitidos ni una lista de bloqueados de Referer, Object Storage Service (OSS) devuelve el valor predeterminado de AllowEmptyReferer y un elemento RefererList vacío.

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>

Ejemplo de respuesta solo con lista de permitidos de 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>

Ejemplo de respuesta con lista de permitidos y lista de bloqueados de 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 de OSS

Use los SDK de OSS de los siguientes lenguajes de programación para llamar a la operación GetBucketReferer:

ossutil

Para obtener información sobre el comando de ossutil correspondiente a la operación GetBucketReferer, consulte get-bucket-referer.

Códigos de error

Código de error	Código de estado HTTP	Descripción
NoSuchBucket	404	Error devuelto porque el bucket no existe.
AccessDenied	403	No cuenta con los permisos necesarios para consultar la configuración de Referer del bucket. Solo el propietario del bucket puede consultar dicha configuración.