全部文档
当前文档
最近更新时间：2025-06-20 17:29:48
跨域资源共享CORS（Cross-Origin Resource Sharing）简称跨域访问，是HTML5提供的标准跨域解决方案，允许Web应用服务器进行跨域访问控制，确保跨域数据传输的安全性。本文介绍如何通过cors命令添加、修改、查询、删除桶（Bucket）的CORS配置。
以下示例均以Linux为例。
如果桶此前未添加过CORS配置，则使用该命令将为桶添加CORS配置。如果桶此前已添加CORS配置，则使用该命令将直接覆盖已有的CORS配置。
添加或修改CORS配置步骤如下：
1. 创建本地文件，并在文件中添加CORS规则。
2. KS3Util先从本地文件中读取CORS配置，然后将读取到CORS配置添加到指定的桶。
添加或修改CORS配置的命令格式及示例如下：
./ks3util cors --method put ks3://bucketname local_xml_file参数 | 说明 |
|---|---|
bucketname | 待添加或修改CORS配置的桶名称。 |
local_xml_file | 配置CORS规则的本地文件名称，例如 |
1. 除上述的功能参数，关于Util支持的通用选项参数，详情请参考通用选项&过滤规则文档。
2. 设置CORS规则需具备ks3:PutBucketCORS权限。
a. 在本地创建名为localfile.xml文件，并根据使用场景配置CORS规则。
示例：表示在CORS规则中指定允许的跨域请求来源为www.ksyun.com、允许的跨域请求方法为PUT以及浏览器对特定资源的预取（OPTIONS）请求返回结果的缓存时间为10000秒。
<?xml version="1.0" encoding="UTF-8"?>
<CORSConfiguration>
<CORSRule>
<AllowedOrigin>http://www.ksyun.com</AllowedOrigin>
<AllowedMethod>PUT</AllowedMethod>
<AllowedHeader>*</AllowedHeader>
<MaxAgeSeconds>10000</MaxAgeSeconds>
</CORSRule>
</CORSConfiguration>b. 添加CORS规则。
为samplebucket添加CORS规则。
./ks3util cors --method put ks3://samplebucket localfile.xml以下输出结果表明已成功添加CORS规则。
0.299514(s) elapsed./ks3util cors --method get ks3://bucketname [local_xml_file]参数 | 说明 |
|---|---|
bucketname | 获取CORS配置的目标桶名称。 |
local_xml_file | 用于存放CORS配置的本地文件名称，例如 |
1. 除上述的功能参数，关于Util支持的通用选项参数，详情请参考通用选项&过滤规则文档。
2. 获取CORS规则需具备ks3:GetBucketCORS权限。
获取目标桶samplebucket的CORS配置，并将配置结果写入本地文件localfile.xml。
./ks3util cors --method get ks3://samplebucket localfile.xml以下输出结果表明已成功获取日志转存配置。
0.299514(s) elapsed./ks3util cors --method delete ks3://bucketname参数 | 说明 |
|---|---|
bucketname | 要删除CORS配置的桶名称。 |
1. 除上述的功能参数，关于Util支持的通用选项参数，详情请参考通用选项&过滤规则文档。
2. 删除CORS规则需具备ks3:PutBucketCORS权限。
删除samplebucket的CORS配置。
./ks3util cors --method delete ks3://samplebucket以下输出结果表明已删除samplebucket的CORS配置。
0.299514(s) elapsed纯净模式