GetBucketVersioning - Object Storage Service: Central de Documentação do Alibaba Cloud

Chame 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 de requisição

A operação DescribeRegions utiliza apenas cabeçalhos de requisição comuns. Para obter mais informações, consulte Cabeçalhos de requisição comuns.

Cabeçalhos de resposta

A resposta contém apenas cabeçalhos de resposta comuns. Para obter mais informações, consulte Cabeçalhos de resposta comuns.

Elementos de resposta

Elemento

Tipo

Exemplo

Descrição

VersioningConfiguration

Container

N/A

Contêiner que armazena o estado de versionamento do bucket. Nó filho: Status Nó pai: nenhum

Nós filhos: Status

Nós pais: nenhum

Status

String

Enabled

Estado de versionamento do bucket. Nó pai: VersioningConfiguration Valores válidos: Enabled: o versionamento está ativado para o bucket. Suspended: o versionamento está suspenso para o bucket. Se o versionamento não estiver ativado para um bucket, o elemento Status não será incluído nos elementos de resposta.

Nós pais: VersioningConfiguration

Valores válidos:

Enabled: o versionamento está ativado para o bucket.
Suspended: o versionamento está suspenso para o bucket.

null

Se o versionamento não estiver ativado para um bucket, o elemento Status não será incluído nos elementos de resposta.

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 estado de versionamento do bucket não será incluído no corpo XML da resposta.

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

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

ossutil

Para informações sobre o comando 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

Mensagem de erro retornada porque você não tem permissão para consultar o estado de versionamento do bucket. Apenas o proprietário do bucket ou usuários RAM com a permissão GetBucketVersioning podem consultar o estado de versionamento de um bucket.

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

NoSuchBucket

404

Mensagem de erro retornada porque o bucket especificado não existe.