PutBucketHttpsConfig_对象存储(OSS)-阿里云帮助中心

调用PutBucketHttpsConfig接口为Bucket开启或关闭TLS版本设置。

注意事项

要为Bucket开启或关闭TLS版本设置，您必须有oss:PutBucketHttpsConfig权限。具体操作，请参见为RAM用户授权自定义的权限策略。
每个地域都有对应的访问域名（Endpoint）。关于地域与访问域名对应关系的更多信息，请参见访问域名和数据中心。

请求语法

PUT /?httpsConfig HTTP/1.1
Date: GMT Date
Authorization: SignatureValue
Host: BucketName.oss-cn-hangzhou.aliyuncs.com

<?xml version="1.0" encoding="UTF-8"?>
<HttpsConfiguration>  
  <TLS>
    <Enable>true</Enable>   
    <TLSVersion>TLSv1.2</TLSVersion>
    <TLSVersion>TLSv1.3</TLSVersion>
  </TLS>
</HttpsConfiguration>

请求头

此接口仅涉及公共请求头。更多信息，请参见公共请求头（Common Request Headers）。

请求元素

名称	类型	是否必选	示例值	描述
HttpsConfiguration	容器	是	不涉及	HTTPS配置的容器。
TLS	容器	是	不涉及	TLS版本配置的容器。
Enable	布尔型	是	true	是否为Bucket开启TLS版本设置。取值如下： true：开启TLS版本设置。 false：关闭TLS版本设置。
TLSVersion	字符串	否	TLSv1.2	TLS版本。仅当Enable取值为true时，需要设置TLS版本，取值如下： TLSv1.0 TLSv1.1 TLSv1.2 TLSv1.3 关于TLS版本的适用场景及说明，请参见TLS版本说明。

响应头

此接口仅涉及公共响应头。更多信息，请参见公共响应头（Common Response Headers）。

示例

请求示例

PUT /?httpsConfig HTTP/1.1
Date: Wed, 16 Aug 2023 15:56:37 GMT
Authorization: OSS qn6qrrqxo2oawuk53otf****:KU5h8YMUC78M30dXqf3JxrTZ****
Host: oss-example.oss-cn-hangzhou.aliyuncs.com

<?xml version="1.0" encoding="UTF-8"?>
<HttpsConfiguration>  
  <TLS>
    <Enable>true</Enable>   
    <TLSVersion>TLSv1.2</TLSVersion>
    <TLSVersion>TLSv1.3</TLSVersion>    
  </TLS>
</HttpsConfiguration>

返回示例

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Wed, 16 Aug 2023 15:56:37 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS