Configura el registro de depósitos

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

Debes tener el permiso FULL_CONTROL para establecer o modificar la configuración de registro de 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
logging Usa esto para cambiar la configuración de registro en un depósito existente. Debes proporcionar el documento de registro 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 logging para especificar la configuración de registro de un depósito existente.

Elemento Descripción
Logging Contenedor para la configuración de registro. Usa un elemento vacío (por ejemplo, <Logging/>) para inhabilitar el registro del depósito.
LogBucket El depósito que recibirá los objetos de registro Debe ser un nombre de depósito válido. Obligatorio
LogObjectPrefix Prefijo de objeto para los objetos de registro Puede tener un máximo de 900 caracteres y debe ser un nombre de objeto válido. Opcional.

Sintaxis de la solicitud

PUT /?logging 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_logging

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 habilita Logging para un depósito llamado example.com.

Solicitud

PUT /example.com?logging HTTP/1.1
Host: storage.googleapis.com
Content-Length: 148
Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg

<?xml version="1.0" encoding="UTF-8"?>
<Logging>
    <LogBucket>
        logs-bucket
    </LogBucket>
    <LogObjectPrefix>
        my-logs-enabled-bucket
    </LogObjectPrefix>
</Logging>

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