全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

OPTIONS Object

最近更新时间:2022-12-30 15:48:02

描述

浏览器能够发送预检请求到KS3,来检测它是否能够发送一个包含指定的源,HTTP方法和请求头部的跨域资源共享请求。

通过用户为其某一空间配置 cors 规则,KS3能够支持跨域资源共享服务。当用户发送一个预检请求后,KS3会计算请求是否匹配设定的规则。

请求

请求语法

OPTIONS /{ObjectName} HTTP/1.1
Host: {BucketName}.{endpoint}
Origin: {Origin}
Access-Control-Request-Method: {HTTPMethod}
Access-Control-Request-Headers: {RequestHeader}

注意:

请求参数

该请求不使用请求参数。

请求头部

该接口可以使用所有常用请求头部。获取更多信息,请点击常用请求头部

名称 描述 是否必选
Origin 标识向KS3请求跨域资源共享的源,例如:http://www.example.com
类型: String
默认值: 无
Access-Control-Request-Method 标识实际发送跨域资源请求时所使用的HTTP方法。
类型: String
默认值: 无
Access-Control-Request-Headers 一个逗点分隔的列表,标识实际发送跨域资源请求时使用的头部。
类型: String
默认值: 无

请求内容

该接口不使用请求内容。

响应

响应头部

该接口可以使用所有常用响应头部。获取更多信息,请点击常用响应头部

名称 描述
Access-Control-Allow-Origin 实际请求时的源地址,如果该源不被允许,在响应中,KS3不会包含此头部。
类型: String
Access-Control-Max-Age 预检请求结果能被缓存的时间,以秒为单位。
类型: String
Access-Control-Allow-Methods 源地址请求时使用的HTTP方法,如果此方法不被允许,在响应中,KS3将不包含此头部。
类型: String
Access-Control-Allow-Headers 在一个实际请求中,浏览器能发送的以逗号分隔的HTTP头部列表。如果其中任一个头部不被允许,在响应中,KS3将不会包含那个头部,同时也将不包含任一个 Access-Control 前缀的头部。
类型: String
Access-Control-Expose-Headers 逗号分隔的HTTP头部列表。在响应一个实际请求中,允许JavaScript读取这些头部信息。
类型: String

响应内容

该接口不使用响应内容。

示例

请求示例

OPTIONS /my-image.jpg HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyun.com
Origin: http://www.example.com
Access-Control-Request-Method: PUT

响应示例

HTTP/1.1 200 OK
Date: Wed, 21 Aug 2012 23:09:55 GMT
Etag: "1f1a1af1f1111111111111c11aed1da1"
Access-Control-Allow-Origin: http://www.example.com
Access-Control-Allow-Methods: PUT
Access-Control-Expose-Headers: x-kss-request-id
Content-Length: 0
Server: KS3

错误码

错误码 HTTP状态码 描述
AccessDenied 403 Forbidden CORS功能未开启或请求内容与规则不匹配。
文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈