Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/ Object Storage Service/ Referência de API/ As API/ Hospedagem de site estático/ Obtenção da configuração CORS de um bucket
Atualizado em 2022-11-07 GMT+08:00
Ver PDF
Compartilhar

Obtenção da configuração CORS de um bucket

Funções

Você pode executar essa operação para obter informações de configuração CORS sobre um bucket especificado.

Para executar essa operação, você deve ter a permissão GetBucketCORS. Por padrão, somente o proprietário do bucket pode executar essa operação. O proprietário do bucket pode conceder a permissão a outros usuários configurando a política do bucket ou a política do usuário.

Sintaxe da solicitação

1
2
3
4
 
GET /?cors HTTP/1.1 
Host: bucketname.obs.region.myhuaweicloud.com 
Date: date
Authorization: authorization

Parâmetros de solicitação

Esta solicitação não contém nenhum parâmetro.

Cabeçalhos de solicitação

Essa solicitação usa cabeçalhos comuns. Para mais detalhes, consulte Tabela 3.

Elementos de solicitação

Este pedido não envolve elementos.

Sintaxe da resposta

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
 
HTTP/1.1 status_code
Content-Type:  application/xml 
Date: date
Content-Length: length

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
<CORSConfiguration xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/">
    <CORSRule> 
        ... 
    </CORSRule> 
</CORSConfiguration>

Cabeçalhos de resposta

A resposta à solicitação usa cabeçalhos comuns. Para mais detalhes, consulte Tabela 1.

Elementos de resposta

Essa resposta contém elementos para detalhar a configuração. Tabela 1 descreve os elementos.

Tabela 1 Elementos de configuração CORS

Elemento

Descrição

CORSConfiguration

Nó raiz de CORSRules e sua capacidade não pode exceder 64 KB.

Tipo: Container

Antepassado: nenhum

CORSRule

Regras do CORS. CORSConfiguration pode conter um máximo de 100 regras.

Tipo: Container

Antepassado: CORSConfiguration

ID

Identificador único de uma regra. O valor pode conter no máximo 255 caracteres.

Tipo: string

Antepassado: CORSRule

AllowedMethod

Método permitido por uma regra CORS.

Tipo: string

Os valores possíveis são GET, PUT, HEAD, POST e DELETE.

Antepassado: CORSRule

AllowedOrigin

Indica uma origem permitida por uma regra CORS. É uma cadeia de caracteres e pode conter um caractere curinga (*), e permite um caractere curinga (*) no máximo.

Tipo: string

Antepassado: CORSRule

AllowedHeader

Indica quais cabeçalhos são permitidos em uma solicitação PUT Bucket CORS por meio do cabeçalho Access-Control-Request-Headers. Se uma solicitação contiver cabeçalhos Access-Control-Request- Headers, apenas uma solicitação CORS que corresponda à configuração de AllowedHeader será considerada como uma solicitação válida. Cada AllowedHeader pode conter no máximo um curinga (*) e não pode conter espaços.

Tipo: string

Antepassado: CORSRule

MaxAgeSeconds

Tempo de resposta do CORS que pode ser armazenado em cache por um cliente. É expresso em segundos.

Cada CORSRule pode conter apenas um MaxAgeSeconds. Pode ser definido para um valor negativo.

Tipo: Integer

Antepassado: CORSRule

ExposeHeader

Indica um cabeçalho suplementado nas respostas do CORS. O cabeçalho fornece informações adicionais para os clientes. Não pode conter espaços.

Tipo: string

Antepassado: CORSRule

Respostas de erro

Tabela 2 descreve possíveis erros especiais na solicitação.

Tabela 2 Erro especial

Código de erro

Descrição

Código de status HTTP

NoSuchCORSConfiguration

Indica que a configuração CORS de buckets não existe.

404 Not Found

Para outros erros, veja Tabela 2.

Solicitação de exemplo

1
2
3
4
5
6
 
GET /?cors HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 03:54:36 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:WJGghTrPQQXRuCx5go1fHyE+Wwg=

Resposta de exemplo

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
 
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: BF2600000164363593F10738B80CACBE
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSpngvwC5TskcLGh7Fz5KRmCFIayuY8p
Content-Type: application/xml
Date: WED, 01 Jul 2015 03:54:36 GMT
Content-Length: 825

<?xml version="1.0" encoding="utf-8"?> 
<CORSConfiguration xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/">
  <CORSRule> 
    <ID>783fc6652cf246c096ea836694f71855</ID>  
    <AllowedMethod>POST</AllowedMethod>  
    <AllowedMethod>GET</AllowedMethod>  
    <AllowedMethod>HEAD</AllowedMethod>  
    <AllowedMethod>PUT</AllowedMethod>  
    <AllowedMethod>DELETE</AllowedMethod>  
 
    <AllowedOrigin>obs.ap-southeast-1.myhuaweicloud.com</AllowedOrigin> 
    <AllowedOrigin>obs.example.com</AllowedOrigin>  
    <AllowedOrigin>www.example.com</AllowedOrigin>  
    <AllowedHeader>AllowedHeader_1</AllowedHeader>  
    <AllowedHeader>AllowedHeader_2</AllowedHeader>  
    <MaxAgeSeconds>100</MaxAgeSeconds>  
    <ExposeHeader>ExposeHeader_1</ExposeHeader>  
    <ExposeHeader>ExposeHeader_2</ExposeHeader> 
  </CORSRule>
</CORSConfiguration>
Tópico principal: Hospedagem de site estático