Todos os produtos
Search
Central de documentação

Object Storage Service:Configure CORS rules

Última atualização: Sep 22, 2026

Configure as regras de compartilhamento de recursos de source cruzada (CORS) para um bucket.

Sintaxe do comando

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

Parâmetro

Tipo

Descrição

--bucket

string

O nome do bucket para o qual você deseja configure as regras de CORS.

--cors-configuration

string

O contêiner que armazena as regras de CORS do bucket.

Nota

O comando put-bucket-cors corresponde à operação PutBucketCors. Para obter mais informações sobre os parâmetros do comando, consulte PutBucketCors.

--cors-configuration

A opção --cors-configuration aceita os formatos XML e JSON:

  • Formato XML:

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

    ... indica que há suporte para vários nós.

  • Formato JSON:

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

    O formato JSON omite o nó raiz do XML.

Nota

Para obter mais informações, consulte Command-line options.

Exemplos

Nos exemplos a seguir, a source permitida para requisições de source cruzada é www.aliyun.com, os métodos de requisição permitidos são PUT e GET, e o tempo de cache da resposta é de 10.000 segundos.

  • Use o arquivo de configuração XML chamado 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 
  • Use o arquivo de configuração JSON chamado 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
  • Use os parâmetros de configuração JSON:

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