全部文档
当前文档
最近更新时间：2026-07-28 15:54:26
该接口用于开启或关闭指定 Bucket 的HTTP/2 协议。开启后，访问该 Bucket 且满足规则的请求将通过 HTTP/2 协议进行传输；关闭后，请求将降级为 HTTP/1.1 协议。使用该接口的用户必须是该 Bucket 的所有者，或具有执行 ks3:PutHTTP2Configuration 权限。
PUT /?http2 HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}
Content-Length: {length}
Content-MD5: {md5}该接口不使用请求参数。
该接口只使用常用请求头部。获取更多信息，请点击常用响应头部。
<Http2Configuration>
<Status>Enabled</Status>
</Http2Configuration>请求体元素说明：
名称 | 描述 | 是否必填 |
Http2Configuration | HTTP/2配置的容器。 | 是 |
Status | HTTP/2协议的开启状态。 有效值： | 是 |
该接口仅返回公共响应头。
该接口不返回响应体。
PUT /?http2 HTTP/1.1
Host: my-bucket.ks3-cn-beijing.ksyun.com
Date: Thu, 09 Nov 2023 03:00:00 GMT
Content-MD5: 4gJE4sAsgTpgAmY8PhC****
Authorization: authorization string
Content-Length: 120
Content-type: application/xml
<Http2Configuration>
<Status>Enabled</Status>
</Http2Configuration>PUT /?http2 HTTP/1.1
Host: my-bucket.ks3-cn-beijing.ksyun.com
Date: Thu, 09 Nov 2023 03:00:00 GMT
Content-MD5: 4gJE4sAsgTpgAmY8PhC****
Authorization: authorization string
Content-Length: 120
Content-type: application/xml
<Http2Configuration>
<Status>Disabled</Status>
</Http2Configuration>HTTP/1.1 200 OK
Content-Length: 0
Date: Thu, 09 Nov 2023 03:00:01 GMT
x-kss-request-id: 7a58bdca28ac4e6e91de369add542e8f
Server: KS3当请求失败时，返回的 XML 错误体中包含具体的错误码和信息。
错误码 | HTTP状态码 | 描述 |
MalformedXML | 400 | 请求体 XML 格式不合法。请求体为空、缺少必要的 |
InvalidArgument | 400 | 参数 Status 值无效。请求体中的 |
AccessDenied | 403 | 没有操作权限。没有执行 |
NoSuchBucket | 404 | 指定的存储桶不存在。请求路径中指定的 Bucket 名称不存在或已被删除。 |
InternalError | 500 | 服务器内部错误。服务端处理请求时发生未知意外，请稍后重试。 |
纯净模式