Todos os produtos
Search
Central de documentação

Object Storage Service:GetBucketVersioning

Última atualização: Sep 22, 2026

Use esta operação para consultar o estado de versionamento de um bucket.

Sintaxe da requisição

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

Cabeçalhos da requisição

O DescribeRegions usa apenas cabeçalhos de requisição comuns. Para mais informações, consulte Common request headers.

Cabeçalhos da resposta

A resposta contém apenas cabeçalhos de resposta comuns. Para mais informações, consulte Common response headers.

Elementos da resposta

Elemento

Tipo

Exemplo

Descrição

VersioningConfiguration

Contêiner

N/D

Contêiner que armazena o estado de versionamento do bucket.

Nó filho: Status

Nó pai: nenhum

Status

String

Enabled

O estado de versionamento do bucket.

Nó pai: VersioningConfiguration

Valores válidos:

  • Enabled: indica que o versionamento está ativado para o bucket.

  • Suspended: indica que o versionamento está suspenso para o bucket.

Nota

Se o versionamento não estiver ativado para um bucket, a resposta não incluirá o elemento Status.

Exemplos

Exemplo de requisição

GET /?versioning HTTP/1.1
Host: bucket-versioning.oss-cn-hangzhou.aliyuncs.com
Date: Tue, 09 Apr 2019 02:28:18 GMT
Authorization: OSS qn6q**************:77Dv****************

Exemplos de resposta

  • Exemplo de resposta para um bucket com versionamento ativado

    HTTP/1.1 200 OK
    x-oss-request-id: 5CAC0342B7AEADE01700****
    Date: Tue, 09 Apr 2019 02:28:18 GMT 
    Content-Length: 121
    Content-Type: application/xml
    Connection: keep-alive
    Server: AliyunOSS
    <? xml version="1.0" encoding="UTF-8"? >
    <VersioningConfiguration>
        <Status>Enabled</Status>
    </VersioningConfiguration>
  • Exemplo de resposta para um bucket com versionamento desativado

    Se o versionamento estiver desativado para o bucket solicitado, o corpo XML da resposta não incluirá o estado de versionamento do bucket.

    HTTP/1.1 200 OK
    x-oss-request-id: 5CAC015CB7AEADE01700****
    Date: Tue, 09 Apr 2019 02:20:12 GMT 
    Content-Length: 74
    Content-Type: application/xml
    Connection: keep-alive
    Server: AliyunOSS
    <VersioningConfiguration xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com"/>

SDKs do OSS

Use os SDKs do OSS nas seguintes linguagens de programação para chamar a operação GetBucketVersioning:

ossutil

Para obter informações sobre o comando do ossutil correspondente à operação GetBucketVersioning, consulte get-bucket-versioning.

Códigos de erro

Código de erro

Código de status HTTP

Descrição

AccessDenied

403

Erro retornado porque você não tem permissão para consultar o estado de versionamento do bucket.

Somente o proprietário do bucket ou usuários do ram com a permissão GetBucketVersioning podem consultar o estado de versionamento de um bucket.

NoSuchBucket

404

Erro retornado porque o bucket especificado não existe.