GetBucketLogging - Query bucket access log configuration - Object Storage Service

La operación GetBucketLogging consulta la configuración de registros de acceso de un bucket. Solo el propietario del bucket puede invocar esta operación.

Notas de uso

La operación GetBucketLogging requiere el permiso oss:GetBucketLogging. Grant custom access policies to RAM users.

Sintaxis de la solicitud

GET /?logging HTTP/1.1
Host: Host
Date: GMT Date
Authorization: SignatureValue

Encabezados de la solicitud

DescribeRegions utiliza únicamente encabezados de solicitud comunes. Para obtener más información, consulte Common request headers.

Encabezados de la respuesta

La respuesta contiene únicamente encabezados de respuesta comunes. Para obtener más información, consulte Common response headers.

Elementos de la respuesta

Nombre	Tipo	Ejemplo	Descripción
BucketLoggingStatus	Contenedor	No aplicable	Contenedor del estado de los registros de acceso. Elemento secundario: LoggingEnabled Elemento primario: Ninguna Nota Si no se ha configurado ninguna regla de registro para el bucket, OSS devuelve un cuerpo XML con un elemento BucketLoggingStatus vacío.
LoggingEnabled	Contenedor	No aplicable	Contenedor de la información de registros de acceso. Se devuelve únicamente cuando el registro está habilitado. Elementos secundarios: TargetBucket, TargetPrefix y LoggingRole Elemento primario: BucketLoggingStatus
TargetBucket	Cadena	mybucketlogs	El bucket que almacena los registros de acceso. Elemento secundario: Ninguna Elemento primario: BucketLoggingStatus.LoggingEnabled
TargetPrefix	Cadena	mybucket-access_log/	El prefijo de los archivos de registro de acceso almacenados. Elemento secundario: Ninguna Elemento primario: BucketLoggingStatus.LoggingEnabled
LoggingRole	Cadena	AliyunOSSLoggingDefaultRole	El rol para la autorización de almacenamiento de registros. Elemento secundario: Ninguna Elemento primario: BucketLoggingStatus.LoggingEnabled

Ejemplos

Bucket de propósito general

Solicitud

Get /?logging HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com  
Date: Thu, 17 Apr 2025 05:31:04 GMT  
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Respuesta

Respuesta cuando el registro está habilitado

HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 04 May 2012 05:31:04 GMT
Connection: keep-alive
Content-Length: 280  
Server: AliyunOSS

<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com">
    <LoggingEnabled>
        <TargetBucket>mybucketlogs</TargetBucket>
        <TargetPrefix>mybucket-access_log/</TargetPrefix>
        <LoggingRole>AliyunOSSLoggingDefaultRole</LoggingRole>
    </LoggingEnabled>
</BucketLoggingStatus>

Respuesta cuando el registro está deshabilitado

HTTP/1.1 200 
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 04 May 2012 05:31:04 GMT
Connection: keep-alive
Content-Length: 110  
Server: AliyunOSS

<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com">
</BucketLoggingStatus>

Bucket vectorial

Los buckets vectoriales utilizan identificadores de región estándar de Alibaba Cloud (como cn-hangzhou) en el encabezado Host, no los identificadores de región heredados de OSS (como oss-cn-hangzhou).

Solicitud

Get /?logging HTTP/1.1
Host: exampebucket-123***456.cn-hangzhou-internal.oss-vectors.aliyuncs.com
Date: Thu, 17 Apr 2025 05:31:04 GMT  
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Respuesta

HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 04 May 2012 05:31:04 GMT
Connection: keep-alive
Content-Length: 280  
Server: AliyunOSS

{
  "BucketLoggingStatus": {
    "LoggingEnabled": {
      "TargetBucket": "mybucketlogs",
      "TargetPrefix": "mybucket-access_log/",
      "LoggingRole": "AliyunOSSLoggingDefaultRole"
    }
  }
}

SDK

SDK compatibles:

Herramienta de línea de comandos ossutil

El comando correspondiente de ossutil es get-bucket-logging.

Códigos de error

Código de error	Código de estado HTTP	Descripción
NoSuchBucket	404	El bucket especificado no existe.
AccessDenied	403	No tiene permiso para consultar la configuración de registros de acceso del bucket. Solo el propietario del bucket cuenta con este permiso.