金山云-文档中心-GET HTTP2 Configuration

对象存储(KS3)

查看更多结果

未找到含当前关键字的文档标题

页面目录

全部展开全部收起

产品更新动态

未找到含该关键词的产品

文档中心

对象存储(KS3)

API文档

Bucket相关

HTTP/2动态启用(HTTP/2 Configuration)

GET HTTP2 Configuration

最近更新时间：2026-07-28 15:54:26



该接口用于查询指定存储桶的HTTP/2协议配置状态。使用此接口的用户必须是该Bucket的所有者，或具有执行 ks3:GetHTTP2Configuration 权限。

请求语法

GET /?http2 HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}

请求参数

该接口不使用请求参数。

请求头

仅使用公共请求头，无需 Content-MD5。获取更多信息，请点击常用请求头部。

请求内容

该接口不使用请求内容。

响应

响应头

该接口仅返回公共响应头。

响应体

响应体为一段包含当前配置状态的XML，成功时返回。

<Http2Configuration>
    <Status>Enabled</Status>
</Http2Configuration>

响应体元素说明：

名称	描述
Http2Configuration	HTTP/2配置的容器。
Status	HTTP/2协议的当前开启状态。有效值：`Enabled`：已开启、`Disabled`：已关闭。

示例

请求示例

GET /?http2 HTTP/1.1
Host: my-bucket.ks3-cn-beijing.ksyun.com
Date: Thu, 09 Nov 2023 03:10:00 GMT
Authorization: authorization string

响应示例：已开启

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 140
Date: Thu, 09 Nov 2023 03:10:01 GMT
x-kss-request-id: 8b69ceca39bc4e6e91de369add542f9g
Server: KS3

<?xml version="1.0" encoding="UTF-8"?>
<Http2Configuration>
    <Status>Enabled</Status>
</Http2Configuration>

响应示例：已关闭或未配置

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 140
Date: Thu, 09 Nov 2023 03:10:01 GMT
x-kss-request-id: 9c70dfda4acd4e6e91de369add542g0h
Server: KS3

<?xml version="1.0" encoding="UTF-8"?>
<Http2Configuration>
    <Status>Disabled</Status>
</Http2Configuration>

错误码

错误码	HTTP状态码	描述
AccessDenied	403	没有操作权限。发起请求的用户不是该 Bucket 的所有者，或没有执行 `ks3:GetHTTP2Configuration` 的权限。
NoSuchBucket	404	指定的存储桶不存在。请求路径中指定的 Bucket 名称不存在或已被删除。
NoSuchBucketHttp2Config	404	该桶的HTTP/2配置不存在。
InternalError	500	服务器内部错误。服务端处理请求时发生未知意外，请稍后重试。

文档导读

上一篇：PUT HTTP2 Configuration

下一篇：Object相关

纯净模式常规模式

纯净模式

点击可全屏预览文档内容