全部產品
Search
文件中心

Object Storage Service:設定跨域資源共用規則

更新時間:Aug 01, 2024

您可以通過API級命令設定跨域資源共用規則。

命令格式

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

參數

類型

說明

--bucket

string

Bucket名稱。

--cors-configuration

string

Bucket的CORS規則容器。

說明

put-bucket-cors命令對應API介面PutBucketCors。關於API中的具體參數含義,請參見PutBucketCors

--cors-configuration

--cors-configuration配置選項既支援XML文法也支援JSON文法:

  • XML文法:

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

    ...表示前面的節點支援多個。

  • JSON文法:

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

    JSON標記法時,會去掉XML的根節點。

說明

關於支援的全域命令列選項,請參見支援的全域命令列選項

使用樣本

指定允許的跨域請求來源為www.aliyun.com、允許的跨域要求方法為PUT和GET,請求返回結果的緩衝時間為10000秒。

  • 使用XML設定檔,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 
  • 使用JSON設定檔,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
  • 使用JSON配置參數:

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