GetTLSVersion - Object Storage Service - Alibaba Cloud Documentation Center

Queries the Transport Layer Security (TLS) version configurations of a bucket.

Usage notes

To query the TLS version configurations of a bucket, you must have the oss:GetBucketHttpsConfig permission. For more information, see Common examples of RAM policies.
Each region has its own Object Storage Service (OSS) endpoints. For more information about regions and their endpoints, see Regions and endpoints.

Request syntax

GET /?httpsConfig HTTP/1.1
Host: BucketName.oss.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Request headers

All headers in a GetBucketHttpsConfig request are common request headers. For more information, see Common HTTP headers.

Response headers

All headers in the response to a GetBucketHttpsConfig request are common response headers. For more information about common response headers, see Common HTTP headers.

Header	Type	Example	Description
HttpsConfiguration	Container	N/A	The container that stores HTTPS configurations.
TLS	Container	N/A	The container that stores TLS version configurations.
Enable	Boolean	true	Indicates whether TLS version management is enabled for the bucket. Valid values: true false
TLSVersion	String	TLSv1.2	The TLS version. For more information about the scenarios and descriptions of TLS versions, see Configure the TLS version.

Examples

Sample request

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

Sample response

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Sat, 8 May 2021 07:51:28 GMT
Connection: keep-alive
Content-Length: 154
Server: AliyunOSS

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