Todos os produtos
Search
Central de documentação

Object Storage Service:GetBucketHttpsConfig

Última atualização: Sep 22, 2026

Consulta a configuração de versão TLS e do conjunto de cifras (cipher suite) de um bucket.

Notas de uso

Sintaxe da requisição

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

Cabeçalhos da requisição

Esta requisição usa apenas Common HTTP headers.

Cabeçalhos da resposta

Esta resposta retorna apenas Common HTTP headers.

Parâmetros da resposta

Parâmetro

Tipo

Exemplo

Descrição

HttpsConfiguration

Container

N/A

Contêiner das configurações HTTPS.

TLS

Container

N/A

Contêiner das configurações de versão TLS.

Enable

Boolean

true

Indica se o gerenciamento de versão TLS está ativado. Valores válidos:

  • true

  • false

TLSVersion

String

TLSv1.2

A versão TLS. As versões compatíveis e os cenários de uso estão descritos em Configure the TLS version.

CipherSuite

Container

N/A

Contêiner da configuração do conjunto de cifras (cipher suite).

Enable

Boolean

true

Indica se a configuração do conjunto de cifras (cipher suite) está ativada.

  • true: conjunto de cifras (cipher suite) aprimorado ou personalizado.

  • false: todos os conjuntos de cifras (cipher suites) (padrão).

StrongCipherSuite

Boolean

true

Indica se o conjunto de cifras (cipher suite) aprimorado está em uso.

  • true: usa o conjunto de cifras (cipher suite) aprimorado.

  • false: usa o conjunto de cifras (cipher suite) personalizado.

CustomCipherSuite

String

ECDHE-ECDSA-AES128-SHA256

Conjuntos de cifras (cipher suites) personalizados compatíveis com TLS 1.2.

TLS13CustomCipherSuite

String

ECDHE-ECDSA-AES256-CCM8

Conjuntos de cifras (cipher suites) personalizados compatíveis com TLS 1.3.

Exemplos

  • Exemplo de requisição

    GET /?httpsConfig HTTP/1.1
    Host: oss-example.oss-cn-hangzhou.aliyuncs.com 
    Date: Thu, 17 Apr 2025 08:40:17 GMT
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  • Exemplo de resposta

    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>
      <CipherSuite>
        <Enable>true/false</Enable>
        <StrongCipherSuite>true/false</StrongCipherSuite>
        <CustomCipherSuite>ECDHE-ECDSA-AES128-SHA256</CustomCipherSuite>
        <CustomCipherSuite>ECDHE-RSA-AES128-GCM-SHA256</CustomCipherSuite>
        <CustomCipherSuite>ECDHE-ECDSA-AES256-CCM8</CustomCipherSuite>
        <TLS13CustomCipherSuite>ECDHE-ECDSA-AES256-CCM8</CustomCipherSuite>
        <TLS13CustomCipherSuite>ECDHE-ECDSA-AES256-CCM8</CustomCipherSuite>
        <TLS13CustomCipherSuite>ECDHE-ECDSA-AES256-CCM8</CustomCipherSuite>
      </CipherSuite>
    </HttpsConfiguration>

ossutil

Para obter informações sobre o comando ossutil correspondente à operação GetBucketHttpsConfig, consulte get-bucket-https-config.