Definir controle de versão do bucket

Por padrão, os buckets não têm o controle de versão ativado. Para definir ou modificar a configuração do controle de versão de um bucket existente, faça uma solicitação PUT com escopo para o bucket e use o parâmetro de string de consulta versioning. Você precisa incluir um documento XML no corpo da solicitação que contenha a configuração de controle de versões que você quer aplicar. Não é possível definir a configuração de versão em um novo bucket que você está criando.

Você precisa ter a permissão FULL_CONTROL para definir ou modificar a configuração do controle de versão de um bucket atual. Além disso, você precisa estar autenticado para usar o método PUT Bucket.

Parâmetros de string de consulta

Parâmetro Descrição Obrigatório
versioning Use isso para alterar a configuração do controle de versão em um bucket existente. Você precisa fornecer o documento VersioningConfiguration no corpo da solicitação. Não

Consulte parâmetros de string de consulta de URL assinado para informações sobre os parâmetros incluídos ao criar e usar URLs assinados.

Cabeçalhos de solicitação

Veja cabeçalhos de solicitação comuns.

Elementos do corpo da solicitação

Os elementos do corpo da solicitação a seguir são aplicáveis somente se você usar o parâmetro de string de consulta versioning para especificar a configuração de controle de versão de um bucket existente.

Element Descrição
VersioningConfiguration Contêiner para a configuração do controle de versão.
Status Status da versão para esse bucket. Atualmente pode ser Enabled ou Suspended.

Sintaxe da solicitação

PUT /?versioning HTTP/1.1
Host: BUCKET_NAME.storage.googleapis.com
Date: DATE
Content-Length: REQUEST_BODY_LENGTH
Content-Type: MIME_TYPE_OF_THE_BODY
Authorization: AUTHENTICATION_STRING

XML_DOCUMENT_DEFINING_VERSIONING

Cabeçalhos de resposta

A solicitação pode retornar diversos cabeçalhos de resposta, dependendo dos cabeçalhos de solicitação usados.

Elementos do corpo da resposta

A resposta não inclui um documento XML no corpo da resposta.

Exemplo

O exemplo a seguir ativa o controle de versão de objeto em um bucket chamado acme-pets.

Solicitação

PUT /?versioning HTTP/1.1
Host: acme-pets.storage.googleapis.com
Date: Thu, 12 Mar 2012 03:38:42 GMT
Content-Length: 113
Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg

<?xml version="1.0" encoding="UTF-8"?>
<VersioningConfiguration><Status>Enabled</Status></VersioningConfiguration>

Resposta

HTTP/1.1 200 OK
Date: Thu, 12 Mar 2012 03:38:42 GMT
Expires: Mon, 01 Jan 1990 00:00:00 GMT
Cache-Control: no-cache, no-store, must-revalidate
Content-Length: 0
Content-Type: text/html