put-bucket-logging - Object Storage Service - Centro de documentación de Alibaba Cloud

Habilite el registro de un bucket de Object Storage Service (OSS). Una vez habilitada esta función, OSS genera objetos de registro de acceso cada hora con base en reglas de nomenclatura predefinidas y los almacena en el bucket especificado.

Notas de uso

Antes de habilitar el registro, asegúrese de comprender bien esta función. Para obtener más información, consulte Log shipping.

Permisos

De forma predeterminada, una cuenta de Alibaba Cloud tiene todos los permisos. Los usuarios o roles de RAM asociados a una cuenta no tienen ningún permiso de manera predeterminada. La cuenta de Alibaba Cloud o su administrador deben otorgar los permisos de operación mediante RAM policies o Bucket Policy.

API	Action	Descripción
PutBucketLogging	`oss:PutBucketLogging`	Habilite el registro de un bucket.
PutBucketLogging	`oss:PutObject`	Este permiso es obligatorio para el bucket de destino cuando los registros se escriben en otro bucket durante la configuración del registro.

Sintaxis del comando

ossutil api put-bucket-logging --bucket value --bucket-logging-status value [flags]

Parámetro	Tipo	Descripción
--bucket	string	El nombre del bucket.
--bucket-logging-status	string	El contenedor que almacena la información del estado de registro.

Nota

El comando put-bucket-logging equivale a la operación PutBucketLogging. Para obtener más detalles sobre esta API, consulte PutBucketLogging.

--bucket-logging-status

El parámetro --bucket-logging-status es compatible con los formatos XML y JSON. Si el valor del parámetro comienza con "file://", la configuración se carga desde el archivo especificado.

Formato XML:

<BucketLoggingStatus>
  <LoggingEnabled>
    <TargetBucket>string</TargetBucket>
    <TargetPrefix>string</TargetPrefix>
  </LoggingEnabled>
</BucketLoggingStatus>

Formato JSON:

{
  "LoggingEnabled": {
    "TargetBucket": "string",
    "TargetPrefix": "string"
  }
}

Nota

Para conocer las opciones globales de línea de comandos compatibles, consulte Command-line options.

Ejemplos

Habilite el registro del bucket examplebucket. Los registros de acceso llevarán el prefijo MyLog- y se almacenarán en el bucket dest-bucket.

Uso de un archivo de configuración XML (en este ejemplo, bucket-logging-status.xml)

<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus>
  <LoggingEnabled>
    <TargetBucket>dest-bucket</TargetBucket>
    <TargetPrefix>MyLog-</TargetPrefix>
  </LoggingEnabled>
</BucketLoggingStatus>

Comando de ejemplo:

ossutil api put-bucket-logging --bucket examplebucket --bucket-logging-status file://bucket-logging-status.xml

Uso de un archivo de configuración JSON (en este ejemplo, bucket-logging-status.json)

{
  "LoggingEnabled": {
    "TargetBucket": "destBucket",
    "TargetPrefix": "MyLog-"
  }
}

Comando de ejemplo:

ossutil api put-bucket-logging --bucket examplebucket --bucket-logging-status file://bucket-logging-status.json

Uso de parámetros JSON directamente en la línea de comandos

ossutil api put-bucket-logging --bucket examplebucket --bucket-logging-status "{\"LoggingEnabled\":{\"TargetBucket\":\"destBucket\",\"TargetPrefix\":\"MyLog-\"}}"