帮你快速理解、总结文档立即下载
文档中心>对象存储>高性能存储>API 文档>存储桶操作>CreateSession

CreateSession

最近更新时间：2026-10-21 18:34:04
本文档已由 AI 辅助审校
我的收藏

本页目录：

CreateSession 接口请求用于为高性能桶创建访问会话，返回可用于后续数据面请求的临时凭证三元组。客户端使用返回的临时 SecretId、SecretKey 和 Token 对高性能桶对象接口发起签名请求。

请求

请求语法

GET /?session HTTP/1.1
Host: <BucketName>-x--<APPID>.cosrapid.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
x-cos-create-session-mode: <SessionMode>
说明：
Authorization 字段的具体格式见 公共请求头部。

请求参数

名称
描述
类型
是否必选
session
标识本次请求为创建访问会话请求。该参数仅作为子资源标识，无需填写参数值
string
是

请求头部

除 公共请求头部 外，本接口还支持以下私有请求头部：
名称
描述
类型
是否必选
x-cos-create-session-mode
创建会话的权限模式，取值如下：
- ReadOnly：只读会话，允许 GetObject、HeadObject、GetBucket、ListMultipartUploads、ListParts 等读类操作。
- ReadWrite：读写会话，允许只读会话的全部操作，并额外允许 PutObject、DeleteObject、DeleteMultipleObjects、InitiateMultipartUpload、UploadPart、CompleteMultipartUpload、AbortMultipartUpload、PutObjectCopy、UploadPartCopy、RenameObject 等写类操作。
不携带该请求头时，服务端按最大权限模式申请会话，等价于申请 ReadWrite。若桶策略或 CAM 策略通过 cos:SessionMode 条件限制了会话模式，本请求头取值必须与策略条件匹配，否则将返回 AccessDenied。
Enum
否

请求体

该请求的请求体为空。

响应

响应头部

此接口仅返回公共响应头部，无私有响应头部。

响应体

请求成功时，响应体为 XML 格式，包含临时凭证信息：
节点名称
父节点
描述
类型
CreateSessionResult
无
响应体根节点
Container
Credentials
CreateSessionResult
临时凭证信息
Container
AccessKeyId
Credentials
临时凭证 AccessKeyId（对应临时 SecretId）
string
SecretAccessKey
Credentials
临时凭证 SecretAccessKey（对应临时 SecretKey）
string
SessionToken
Credentials
临时凭证 Token。后续使用临时凭证访问高性能桶对象接口时，需要通过 x-cos-security-token 携带该 Token
string
Expiration
Credentials
临时凭证过期时间，ISO 8601 UTC 时间格式
string
响应体示例：
<?xml version="1.0" encoding="UTF-8"?>
<CreateSessionResult>
    <Credentials>
        <AccessKeyId>SKIDEXAMPLE</AccessKeyId>
        <SecretAccessKey>TMPSECRETKEYEXAMPLE</SecretAccessKey>
        <SessionToken>TOKENEXAMPLE</SessionToken>
        <Expiration>2026-07-24T12:00:00Z</Expiration>
    </Credentials>
</CreateSessionResult>

错误码

本接口遵循统一的错误响应和错误码，详情请参见 错误码 文档。

实际案例

请求

GET /?session HTTP/1.1
Host: examplebucket-x--1250000000.cosrapid.ap-guangzhou.myqcloud.com
Date: Fri, 24 Jul 2026 09:13:10 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKIDXXXXXXXX&q-sign-time=1784813288;32557709288&q-key-time=1784813288;32557709288&q-header-list=date;host;x-cos-create-session-mode&q-url-param-list=session&q-signature=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
x-cos-create-session-mode: ReadOnly

响应

HTTP/1.1 200 OK
Content-Type: application/xml; charset=UTF-8
Date: Fri, 24 Jul 2026 09:13:10 GMT
x-cos-request-id: NjUwMDAwMDAwMDAwMDAwMDAw

<?xml version="1.0" encoding="UTF-8"?>
<CreateSessionResult>
    <Credentials>
        <AccessKeyId>SKIDEXAMPLE</AccessKeyId>
        <SecretAccessKey>TMPSECRETKEYEXAMPLE</SecretAccessKey>
        <SessionToken>TOKENEXAMPLE</SessionToken>
        <Expiration>2026-07-24T12:00:00Z</Expiration>
    </Credentials>
</CreateSessionResult>

中国站