Options Object
当用户的请求属于跨源请求时，需要在正式通信前，增加一次 HTTP 的查询请求，询问服务器当前所在的源，是否在服务器的白名单中，以及哪些 HTTP 动作，头信息是其可以使用的。
该 API 接口便是用于向山河对象存储的 Object 发起预检请求，以确定是否能向该跨源请求发出回应。
请求语法
OPTIONS /<object-name> HTTP/1.1
Host: <bucket-name>.jn2.is.shanhe.com
Date: <date>
Authorization: <authorization-string>
Origin: Origin
Access-Control-Request-Method: <http-method>
Access-Control-Request-Headers: <request-header>
请求参数
无。
请求消息头
该 API 接口支持如下消息头：
| 字段 | 类型 | 说明 | 是否必须 |
|---|---|---|---|
| Origin | String | 跨源请求的源。 | 是 |
| Access-Control-Request-Method | String | 跨源请求的 HTTP Method 。 | 是 |
| Access-Control-Request-Headers | String | 跨源请求中的 HTTP Headers (逗号分割的字符串)。 | 否 |
除以上请求头以外，此接口还需要包含 Host、Date 等公共请求头。详细内容可参见 公共请求头。
请求消息体
无。
响应头
使用该接口，山河对象存储会返回如下响应头：
| Header Name | Type | Description |
|---|---|---|
| Access-Control-Allow-Origin | String | 跨源请求所允许的源。如果跨源请求没有被允许，该头信息将不会存在于响应头中。 |
| Access-Control-Max-Age | String | 预检请求的结果被缓存的时间（单位为秒）。 |
| Access-Control-Allow-Methods | String | 跨源请求中的 HTTP Method 。如果跨源请求没有被允许，该头信息将不会存在于响应头中。 |
| Access-Control-Allow-Headers | String | 跨源请求中可以被允许发送的 HTTP Headers (逗号分割的字符串)。 |
| Access-Control-Expose-Headers | String | 跨源请求的响应中，客户端（如 JavaScript Client） 可以获取到的 HTTP Headers (逗号分割的字符串)。 |
其他公共响应头可参考：公共响应头。
错误码
失败的返回码参考 错误码列表。
SDK
此接口所对应的各语言 SDK 可参考 SDK 文档。