GetBucketReferer - Object Storage Service: Central de Documentação do Alibaba Cloud

Nota

A permissão oss:GetBucketReferer é necessária para consultar as configurações de Referer de um bucket. Para mais informações, consulte Grant a custom policy.

Sintaxe da solicitação

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

Cabeçalhos da solicitação

O DescribeRegions utiliza apenas cabeçalhos de solicitação comuns. Para mais informações, consulte Common request headers.

Elementos da resposta

Elemento	Tipo	Exemplo	Descrição
RefererConfiguration	Contêiner	N/A	Contêiner que armazena as configurações de Referer. Nós pai: nenhum Nós filho: AllowEmptyReferer, AllowTruncateQueryString e RefererList
AllowEmptyReferer	String enumerada	false	Indica se solicitações com campos Referer vazios são permitidas. Valores válidos: true false Nó pai: RefererConfiguration
AllowTruncateQueryString	String enumerada	true	Define se a string de consulta na URL é truncada. Valores válidos: true false Nó pai: RefererConfiguration
TruncatePath	String enumerada	true	Especifica se o caminho e as partes subsequentes na URL são truncados. Valores válidos: true false Nó pai: RefererConfiguration
RefererList	Contêiner	N/A	Contêiner que armazena a lista de permissões de Referer. Nó pai: RefererConfiguration Nó filho: Referer
RefererBlacklist	Contêiner	N/A	Contêiner que armazena a lista de bloqueios de Referer. Nó pai: RefererConfiguration Nó filho: Referer
Referer	String	http://www.aliyun.com	Endereços presentes na lista de permissões ou na lista de bloqueios de Referer. Nó pai: RefererList ou RefererBlacklist

Para mais informações sobre cabeçalhos de resposta comuns na operação GetBucketReferer, como Date e x-oss-request-id, consulte Common HTTP headers.

Exemplos

Exemplos de solicitação

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

Exemplos de respostas de sucesso

Resposta de exemplo sem lista de permissões ou lista de bloqueios de Referer

Nota

Se o bucket não tiver uma lista de permissões ou uma lista de bloqueios de Referer, o Object Storage Service (OSS) retornará o valor padrão de AllowEmptyReferer e uma RefererList vazia.

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>

Resposta de exemplo contendo apenas uma lista de permissões 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>

Resposta de exemplo contendo uma lista de permissões e uma lista de bloqueios 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>

SDKs do OSS

Use os SDKs do OSS nas linguagens de programação a seguir para chamar a operação GetBucketReferer:

ossutil

Para obter detalhes sobre o comando do ossutil correspondente à operação GetBucketReferer, consulte get-bucket-referer.

Códigos de erro

Código de erro	Código de status HTTP	Descrição
NoSuchBucket	404	O bucket não existe.
AccessDenied	403	Você não tem permissão para consultar as configurações de Referer do bucket. Somente o proprietário do bucket pode consultar essas configurações.