产品动态
产品公告
API | 操作名 | 操作描述 |
设置跨域配置 | 设置存储桶的跨域名访问权限 | |
查询跨域配置 | 查询存储桶的跨域名访问配置信息 | |
删除跨域配置 | 删除存储桶的跨域名访问配置信息 |
cos.putBucketCors({Bucket: 'examplebucket-1250000000', /* 必须 */Region: 'COS_REGION', /* 存储桶所在地域，必须字段 */CORSRules: [{"AllowedOrigin": ["*"],"AllowedMethod": ["GET", "POST", "PUT", "DELETE", "HEAD"],"AllowedHeader": ["*"],"ExposeHeader": ["ETag", "x-cos-acl", "x-cos-version-id", "x-cos-delete-marker", "x-cos-server-side-encryption"],"MaxAgeSeconds": "5"}]}, function(err, data) {console.log(err || data);});
参数名称 | 描述 | 类型 | 是否必填 |
Bucket | 设置跨域配置的存储桶，格式：BucketName-APPID | String | 是 |
Region | 存储桶所在地域，枚举值请参见 地域和访问域名 | String | 是 |
CORSRules | 说明跨域资源共享配置的所有信息列表 | ObjectArray | 否 |
- ID | 配置规则的 ID | String | 否 |
- AllowedMethods | 允许的 HTTP 操作，枚举值：GET、PUT、HEAD、POST、DELETE 等 | StringArray | 是 |
- AllowedOrigins | 允许的访问来源，支持通配符 *，格式为：协议://域名[:端口]，例如：http://www.qq.com | StringArray | 是 |
- AllowedHeaders | 在发送 OPTIONS 请求时告知服务端，接下来的请求可以使用哪些自定义的 HTTP 请求头部，支持通配符 * | StringArray | 否 |
- ExposeHeaders | 设置浏览器可以接收到的来自服务器端的自定义头部信息 | StringArray | 否 |
- MaxAgeSeconds | 设置 OPTIONS 请求得到结果的有效期 | String | 否 |
function(err, data) { ... }
参数名 | 参数描述 | 类型 |
err | Object | |
- statusCode | 请求返回的 HTTP 状态码，例如200、403、404等 | Number |
- headers | 请求返回的头部信息 | Object |
data | 请求成功时返回的对象，如果请求发生错误，则为空 | Object |
- statusCode | 请求返回的 HTTP 状态码，例如200、403、404等 | Number |
- headers | 请求返回的头部信息 | Object |
cos.getBucketCors({Bucket: 'examplebucket-1250000000', /* 必须 */Region: 'COS_REGION', /* 存储桶所在地域，必须字段 */}, function(err, data) {console.log(err || data);});
{"CORSRules": [{"MaxAgeSeconds": "5","AllowedOrigins": ["*"],"AllowedHeaders": ["*"],"AllowedMethods": ["GET", "POST", "PUT", "DELETE", "HEAD"],"ExposeHeaders": ["ETag", "Content-Length", "x-cos-acl", "x-cos-version-id", "x-cos-request-id", "x-cos-delete-marker", "x-cos-server-side-encryption"]}],"statusCode": 200,"headers": {}}
参数名 | 参数描述 | 类型 | 是否必填 |
Bucket | 查询跨域配置的存储桶，格式：BucketName-APPID | String | 是 |
Region | 存储桶所在地域，枚举值请参见 地域和访问域名 | String | 是 |
function(err, data) { ... }
参数名 | 参数描述 | 类型 |
err | Object | |
data | 请求成功时返回的对象，如果请求发生错误，则为空 | Object |
- CORSRules | 说明跨域资源共享配置的所有信息列表 | ObjectArray |
- - AllowedMethods | 允许的 HTTP 操作，枚举值：GET、PUT、HEAD、POST、DELETE | StringArray |
- - AllowedOrigins | 允许的访问来源，支持通配符 *，格式为：协议://域名[:端口]例如： http://www.qq.com | StringArray |
- - AllowedHeaders | 在发送 OPTIONS 请求时告知服务端，接下来的请求可以使用哪些自定义的 HTTP 请求头部，支持通配符 * | StringArray |
- - ExposeHeaders | 设置浏览器可以接收到的来自服务器端的自定义头部信息 | StringArray |
- - MaxAgeSeconds | 设置 OPTIONS 跨域信息缓存秒数 | String |
- - ID | 配置规则的 ID | String |
1. 删除当前存储桶的跨域访问配置信息，会导致所有请求跨域失败，请谨慎操作。2. 不推荐在浏览器端使用该方法。
cos.deleteBucketCors({Bucket: 'examplebucket-1250000000', /* 必须 */Region: 'COS_REGION', /* 存储桶所在地域，必须字段 */}, function(err, data) {console.log(err || data);});
参数名 | 参数描述 | 类型 | 是否必填 |
Bucket | 被删除跨域配置的存储桶，格式：BucketName-APPID | String | 是 |
Region | 存储桶所在地域，枚举值请参见 地域和访问域名 | String | 是 |
function(err, data) { ... }
参数名 | 参数描述 | 类型 |
err | Object | |
- statusCode | 请求返回的 HTTP 状态码，例如200、403、404等 | Number |
- headers | 请求返回的头部信息 | Object |
data | 请求成功时返回的对象，如果请求发生错误，则为空 | Object |
- statusCode | 请求返回的 HTTP 状态码，例如200、403、404等 | Number |
- headers | 请求返回的头部信息 | Object |
文档反馈