Object Storage Service:PutBucketCors

Observações de uso

• Desativado por padrão

  O CORS está desativado por padrão. O sistema bloqueia todas as solicitações de origem cruzada.

• Mecanismo de substituição

  As novas regras de CORS configuradas pelo PutBucketCors substituem todas as regras existentes no bucket.

• Uso do CORS em aplicações

  Chame o PutBucketCors para configurar as regras de CORS antes de usar o recurso nas aplicações.

  Por exemplo, para permitir que example.com acesse o OSS pelo navegador via XMLHttpRequest, configure uma regra de CORS em XML com esta operação.

• Correspondência de regras de CORS

  Ao receber uma solicitação de origem cruzada ou OPTIONS para um bucket, o OSS verifica as regras de CORS configuradas sequencialmente e retorna os cabeçalhos da primeira correspondência. Se nenhuma regra corresponder, o OSS não incluirá cabeçalhos CORS na resposta.

  Uma solicitação corresponde a uma regra de CORS apenas quando atende a todas as condições a seguir:

  • A origem da solicitação corresponde a um valor AllowedOrigin na regra.

  • O método da solicitação ou o valor do cabeçalho Access-Control-Request-Method corresponde a um valor AllowedMethod.

  • Cada cabeçalho em Access-Control-Request-Headers corresponde a um valor AllowedHeader.

Permissões

Por padrão, uma conta Alibaba Cloud tem permissões totais. Usuários RAM ou funções RAM vinculados a uma conta Alibaba Cloud não têm permissões por padrão. A conta Alibaba Cloud ou o administrador da conta deve conceder as permissões de operação por meio de RAM policies ou Bucket Policy.

Sintaxe da solicitação

PUT /?cors HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue
<?xml version="1.0" encoding="UTF-8"?>
<CORSConfiguration>
    <CORSRule>
      <AllowedOrigin>the origin you want allow CORS request from</AllowedOrigin>
      <AllowedOrigin>…</AllowedOrigin>
      <AllowedMethod>HTTP method</AllowedMethod>
      <AllowedMethod>…</AllowedMethod>
        <AllowedHeader> headers that allowed browser to send</AllowedHeader>
          <AllowedHeader>…</AllowedHeader>
          <ExposeHeader> headers in response that can access from client app</ExposeHeader>
          <ExposeHeader>…</ExposeHeader>
          <MaxAgeSeconds>time to cache pre-fight response</MaxAgeSeconds>
    </CORSRule>
    <CORSRule>
      ...
    </CORSRule>
...
</CORSConfiguration >

Elementos da solicitação

Esta operação também usa Common HTTP headers.

Cabeçalhos de resposta

As respostas do PutBucketCors contêm apenas Common HTTP headers.

Exemplos

• Exemplo de solicitação

  PUT /?cors HTTP/1.1
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  Content-Length: 186
  Date: Fri, 04 May 2012 03:21:12 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  <?xml version="1.0" encoding="UTF-8"?>
  <CORSConfiguration>
      <CORSRule>
        <AllowedOrigin>*</AllowedOrigin>
        <AllowedMethod>PUT</AllowedMethod>
        <AllowedMethod>GET</AllowedMethod>
        <AllowedHeader>Authorization</AllowedHeader>
      </CORSRule>
      <CORSRule>
        <AllowedOrigin>http://example.com</AllowedOrigin>
        <AllowedOrigin>http://example.net</AllowedOrigin>
        <AllowedMethod>GET</AllowedMethod>
        <AllowedHeader> Authorization</AllowedHeader>
        <ExposeHeader>x-oss-test</ExposeHeader>
        <ExposeHeader>x-oss-test1</ExposeHeader>
        <MaxAgeSeconds>100</MaxAgeSeconds>
      </CORSRule>
      <ResponseVary>false</ResponseVary>
  </CORSConfiguration >

• Exemplo de resposta

  HTTP/1.1 200 OK
  x-oss-request-id: 50519080C4689A033D0*****
  Date: Fri, 04 May 2012 03:21:12 GMT
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS
  x-oss-server-time: 94

SDK

Os seguintes SDKs do OSS oferecem suporte ao PutBucketCors:

• Java

• Python V2

• PHP V2

• Go V2

• C++

• C

• .NET

• Node.js

• Ruby

ossutil

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

Códigos de erro