Todos os produtos
Search
Central de documentação

Object Storage Service:GetBucketHttpsConfig

Última atualização: Jul 03, 2026

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

Observações de uso

Sintaxe da solicitação

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

Cabeçalhos da solicitação

Esta solicitação usa apenas Cabeçalhos HTTP comuns.

Cabeçalhos da resposta

Esta resposta retorna apenas Cabeçalhos HTTP comuns.

Parâmetros da resposta

Cabeçalho

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 do TLS.

Ative

Boolean

true

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

  • true

  • false

TLSVersion

String

TLSv1.2

Versão do TLS. As versões compatíveis e seus cenários de uso estão descritos em Configurar a versão do TLS.

CipherSuite

Container

N/A

Contêiner da configuração do conjunto de cifras.

Ative

Boolean

true

Indica se a configuração do conjunto de cifras está ativada.

  • true: conjunto de cifras aprimorado ou personalizado.

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

StrongCipherSuite

Boolean

true

Indica se o conjunto de cifras aprimorado está em uso.

  • true: usar conjunto de cifras aprimorado.

  • false: usar conjunto de cifras personalizado.

CustomCipherSuite

String

ECDHE-ECDSA-AES128-SHA256

Conjuntos de cifras personalizados compatíveis com o TLS 1.2.

TLS13CustomCipherSuite

String

ECDHE-ECDSA-AES256-CCM8

Conjuntos de cifras personalizados compatíveis com o TLS 1.3.

Exemplos

  • Exemplo de solicitaçã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 do ossutil correspondente à operação GetBucketHttpsConfig, consulte get-bucket-https-config.