Configura el control de versiones de los depósitos

De forma predeterminada, los depósitos no tienen habilitado el control de versiones. A fin de establecer o modificar la configuración de control de versiones para un depósito existente, realiza una solicitud PUT con alcance al depósito y usa el parámetro de string de consulta versioning. Debes incluir un documento XML en el cuerpo de la solicitud que contiene la configuración de control de versiones que deseas aplicar. Ten en cuenta que no puedes establecer la configuración de control de versiones en un depósito nuevo que estés creando.

Debes tener el permiso FULL_CONTROL a fin de establecer o modificar la configuración del control de versiones para un depósito existente. También debes autenticarte para usar el método de depósito PUT.

Parámetros de string de consulta

Parámetro Descripción Obligatorio
versioning Usa esto para cambiar la configuración del control de versiones en un depósito existente. Debes proporcionar el documento VersioningConfiguration en el cuerpo de la solicitud. No

Consulta los parámetros de string de consulta de URL firmados para obtener información sobre los parámetros que incluyes cuando creas y usas URL firmadas.

Solicita encabezados

Consulta encabezados de solicitud comunes.

Elementos de cuerpo de la solicitud

Los siguientes elementos del cuerpo de la solicitud solo se aplican si usas el parámetro de string de consulta versioning para especificar la configuración de control de versiones para un depósito existente.

Elemento Descripción
VersioningConfiguration Contenedor para la configuración del control de versiones.
Status Estado del control de versiones para este depósito. Actualmente puede ser Enabled o Suspended.

Sintaxis de la solicitud

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

Encabezados de respuesta

La solicitud puede mostrar una variedad de encabezados de respuesta según los encabezados de la solicitud que uses.

Elementos del cuerpo de la respuesta

La respuesta no incluye un documento XML en el cuerpo de la respuesta.

Ejemplo

En el siguiente ejemplo, se activa el control de versiones de objetos en un depósito llamado acme-pets.

Solicitud

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>

Respuesta

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