Tous les produits
Search
Centre de documentation

Object Storage Service:Configure CORS rules

Dernière mise à jour :Aug 18, 2026

Configurez les règles de partage des ressources cross-origin (CORS) pour un bucket.

Syntaxe de la commande

ossutil api put-bucket-cors --bucket value --cors-configuration value [flags]

Paramètre

Type

Description

--bucket

string

Nom du bucket pour lequel vous souhaitez configurer les règles CORS.

--cors-configuration

string

Conteneur stockant les règles CORS du bucket.

Remarque

La commande put-bucket-cors correspond à l'opération PutBucketCors. Pour plus d'informations sur les paramètres de la commande, consultez PutBucketCors.

--cors-configuration

L'option --cors-configuration prend en charge les formats XML et JSON :

  • Format XML :

    <CORSConfiguration>
      <CORSRule>
        <AllowedOrigin>string</AllowedOrigin>
        ...
        <AllowedMethod>string</AllowedMethod>
        ...
        <AllowedHeader>string</AllowedHeader>
        <ExposeHeader>string</ExposeHeader>
        ...
        <MaxAgeSeconds>integer</MaxAgeSeconds>
      </CORSRule>
      ...
      <ResponseVary>boolean</ResponseVary>
    </CORSConfiguration>
    Remarque

    ... indique que plusieurs nœuds sont pris en charge.

  • Format JSON :

    {
      "CORSRule": [
        {
          "AllowedOrigin": ["string", ...],
          "AllowedMethod": ["string", ...],
          "AllowedHeader": "string",
          "ExposeHeader": ["string", ...],
          "MaxAgeSeconds": integer
        },
        ...
      ],
      "ResponseVary": boolean
    }
    Remarque

    Le nœud racine du format XML est supprimé dans le format JSON.

Remarque

Pour plus d'informations, consultez Options de ligne de commande.

Exemples

Dans les exemples suivants, la source de requête cross-origin autorisée est www.aliyun.com, les méthodes de requête cross-origin autorisées sont PUT et GET, et la durée de mise en cache de la réponse est de 10 000 secondes.

  • Utilisez le fichier de configuration XML nommé cors-configuration.xml :

    <CORSConfiguration>
      <CORSRule>
        <AllowedOrigin>www.aliyun.com</AllowedOrigin>
        <AllowedMethod>PUT</AllowedMethod>
        <AllowedMethod>GET</AllowedMethod>
        <MaxAgeSeconds>10000</MaxAgeSeconds>
      </CORSRule>
    </CORSConfiguration>
    ossutil api put-bucket-cors --bucket examplebucket --cors-configuration file://cors-configuration.xml 
  • Utilisez le fichier de configuration JSON nommé cors-configuration.json :

    {
      "CORSRule": {
        "AllowedOrigin": ["www.aliyun.com"],
        "AllowedMethod": ["PUT","GET"],
        "MaxAgeSeconds": 10000
      }
    }
    ossutil api put-bucket-cors --bucket examplebucket --cors-configuration file://cors-configuration.json
  • Utilisez les paramètres de configuration JSON :

    ossutil api put-bucket-cors --bucket examplebucket --cors-configuration  "{\"CORSRule\":{\"AllowedOrigin\":[\"www.aliyun.com\"],\"AllowedMethod\":[\"PUT\",\"GET\"],\"MaxAgeSeconds\":10000}}"