Query the CORS rules of a bucket by calling GetBucketCors - Object Storage Service: Central de Documentação do Alibaba Cloud

Estrutura da solicitação

GET /? cors HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Cabeçalhos da solicitação

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

Cabeçalhos da resposta

A resposta contém apenas cabeçalhos de resposta comuns. Para mais informações, consulte Common response headers.

Parâmetros da resposta

Parâmetro	Tipo	Exemplo	Descrição
CORSRule	Contêiner	N/A	O contêiner que armazena as regras de CORS. É possível configurar até 10 regras para um bucket. Nó pai: CORSConfiguration
AllowedOrigin	String	*	As origens permitidas para solicitações de origem cruzada. Caso defina AllowedOrigin como um asterisco (*), o sistema permitirá solicitações de origem cruzada de todas as origens. Nó pai: CORSRule
AllowedMethod	Enumeração (GET, PUT, exclua, POST e HEAD)	GET	Os métodos de solicitação de origem cruzada permitidos. Nó pai: CORSRule
AllowedHeader	String	*	Indica se os cabeçalhos especificados por Access-Control-Request-Headers na solicitação preflight OPTIONS são permitidos. Cada cabeçalho especificado por Access-Control-Request-Headers deve corresponder ao valor de um elemento AllowedHeader. Nó pai: CORSRule
ExposeHeader	String	x-oss-test	Os cabeçalhos de resposta para solicitações de acesso permitidas por aplicativos, como o objeto XMLHttpRequest em JavaScript. Nó pai: CORSRule
MaxAgeSeconds	Inteiro	100	O período durante o qual o navegador pode armazenar em cache a resposta para uma solicitação preflight OPTIONS para recursos específicos. Uma regra de CORS pode conter apenas um parâmetro MaxAgeSeconds. Unidade: segundos Nó pai: CORSRule
CORSConfiguration	Contêiner	N/A	O contêiner que armazena as configurações de CORS do bucket. Nó pai: nenhum
ResponseVary	Booleano	false	Indica se o cabeçalho Vary: Origin foi retornado. Valor padrão: false. true: O cabeçalho Vary: Origin é retornado independentemente de a solicitação ser de origem cruzada ou ter êxito. false: O cabeçalho Vary: Origin não é retornado. Nó pai: CORSConfiguration

Exemplos

Exemplo de solicitação

Get /? cors HTTP/1.1
Host: oss-example.oss-cn-hangzhou.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

Exemplo de resposta

HTTP/1.1 200
x-oss-request-id: 50519080C4689A033D00****
Date: Thu, 13 Sep 2012 07:51:28 GMT
Connection: keep-alive
Content-Length: 218  
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<CORSConfiguration>
    <CORSRule>
      <AllowedOrigin>*</AllowedOrigin>
      <AllowedMethod>GET</AllowedMethod>
      <AllowedHeader>*</AllowedHeader>
      <ExposeHeader>x-oss-test</ExposeHeader>
      <MaxAgeSeconds>100</MaxAgeSeconds>
    </CORSRule>
    <ResponseVary>false</ResponseVary>
</CORSConfiguration>

SDKs do OSS

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

ossutil

Para obter informações sobre o comando do ossutil correspondente à operação GetBucketCors, consulte get-bucket-cors.

Códigos de erro

Código de erro	Código de status HTTP	Descrição
NoSuchBucket	404	Mensagem de erro retornada quando o bucket especificado não existe.
NoSuchCORSConfiguration	404	Mensagem de erro retornada quando a regra de CORS especificada não existe.
AccessDenied	403	Mensagem de erro retornada quando você não tem autorização para executar esta operação. Somente o proprietário do bucket pode consultar as regras de CORS configuradas para o bucket.