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:
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. |