Object Storage Service:PutBucketCors

Remarques d'utilisation

• Désactivation par défaut

  Le CORS est désactivé par défaut. Toutes les requêtes inter-origines sont interdites.

• Écrasement des règles existantes

  Les nouvelles règles CORS configurées via PutBucketCors écrasent toutes les règles CORS existantes du compartiment.

• Utilisation du CORS dans les applications

  Appelez PutBucketCors pour configurer les règles CORS avant d'utiliser le CORS dans vos applications.

  Par exemple, pour autoriser example.com à accéder à OSS via le navigateur en utilisant XMLHttpRequest, configurez une règle CORS au format XML à l'aide de cette opération.

• Correspondance des règles CORS

  Lorsque OSS reçoit une requête inter-origines ou une requête OPTIONS pour un compartiment, il vérifie séquentiellement les règles CORS configurées et renvoie les en-têtes correspondants pour la première correspondance trouvée. Si aucune règle ne correspond, OSS n'inclut pas d'en-têtes CORS dans la réponse.

  Une requête correspond à une règle CORS uniquement si toutes les conditions suivantes sont remplies :

  • L'origine de la requête correspond à une valeur AllowedOrigin définie dans la règle.

  • La méthode de la requête ou la valeur de l'en-tête Access-Control-Request-Method correspond à une valeur AllowedMethod.

  • Chaque en-tête présent dans Access-Control-Request-Headers correspond à une valeur AllowedHeader.

Permissions

Par défaut, un compte Alibaba Cloud dispose de toutes les autorisations. Les utilisateurs RAM ou les rôles RAM associés à un compte Alibaba Cloud ne disposent d'aucune autorisation par défaut. Le compte Alibaba Cloud ou l'administrateur du compte doit accorder les autorisations d'opération via des politiques RAM ou une Bucket Policy.

Syntaxe de la requête

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 >

Éléments de la requête

Cette opération utilise également des en-têtes HTTP communs.

En-têtes de réponse

Les réponses PutBucketCors contiennent uniquement des en-têtes HTTP communs.

Exemples

• Exemple de requête

  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 >

• Exemple de réponse

  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

Les SDK OSS suivants prennent en charge PutBucketCors :

• Java

• Python V2

• PHP V2

• Go V2

• C++

• C

• .NET

• Node.js

• Ruby

ossutil

Pour plus d'informations sur la commande ossutil correspondant à l'opération PutBucketCors, consultez put-bucket-cors.

Codes d'erreur