All Products
Search
Document Center

Object Storage Service:GetBucketHttpsConfig

Last Updated:Nov 06, 2023

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 qn6qrrqxo2oawuk53otf****:kZoYNv66bsmc10+dcGKw5x2P****
  • 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>