Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda> Object Storage Service> Referencia de la API> Las API> Configuración avanzada del bucket> Obtención de una configuración de registro de bucket

Actualización más reciente 2023-07-11 GMT+08:00

Ver PDF

Obtención de una configuración de registro de bucket

Funciones

Esta operación consulta el estado de registro de un bucket. Utiliza el subrecurso de registro para devolver el estado de registro de un bucket.

Solo el propietario del bucket o los usuarios a los que se ha concedido el permiso GetBucketLogging pueden consultar el estado de registro del bucket.

Sintaxis de solicitud

    
         GET /?logging HTTP/1.1 
Host: bucketname.obs.region.myhuaweicloud.com Date: date
Authorization: authorization

Parámetros de solicitud

Esta solicitud no contiene ningún parámetro.

Encabezados de solicitud

Esta solicitud utiliza encabezados comunes. Para más detalles, consulte Tabla 3.

Elementos de solicitud.

Esta solicitud no implica ningún elemento.

Sintaxis de respuesta

    
     
       
       
         HTTP/1.1 status_code
Content-Type: application/xml 
Date: date
Content-Length: length

<?xml version="1.0" encoding="UTF-8"?> 
<BucketLoggingStatus xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/">
<Agency>agency-name</Agency>
<LoggingEnabled> 
    <TargetBucket>bucketName</TargetBucket> 
    <TargetPrefix>prefix</TargetPrefix> 
        <TargetGrants> 
            <Grant> 
                <Grantee> 
                    <ID>id</ID> 
                </Grantee> 
                <Permission>permission</Permission> 
            </Grant> 
        </TargetGrants> 
    </LoggingEnabled> 
</BucketLoggingStatus>

        

      

    
   

Encabezados de respuesta

La respuesta a la solicitud utiliza encabezados comunes. Para más detalles, consulte Tabla 1.

Elementos de respuesta

Esta respuesta contiene elementos para especificar el estado del registro del bucket. Tabla 1 describe los elementos.

**Tabla 1** Elementos de respuesta
Elemento	Descripción
BucketLoggingStatus	Contenedor para registrar información de estado Tipo: container
Agency	Nombre de la delegación creada por el propietario del bucket de log para cargar archivos de log por OBS Tipo: string
LoggingEnabled	Contenedor para la información de registro. Este elemento activa o desactiva la función de registro. Presente este elemento al habilitar el registro. De lo contrario, a falta de ello. Tipo: container
Grant	Contenedor para el concesionario y los permisos concedidos Tipo: container
Grantee	Contenedor para el usuario al que se le concede el permiso de registro Tipo: container
ID	ID de dominio del concesionario, un ID único a nivel mundial Tipo: string
Permission	Permiso de registro otorgado al concesionario para un bucket. El propietario del bucket recibe automáticamente el permiso FULL_CONTROL al crear el bucket. Los permisos de registro controlan el acceso a diferentes registros. Tipo: string Opciones de valor: FULL_CONTROL \| READ \| WRITE
TargetBucket	Al habilitar la función de log, el propietario del bucket que se está registrando puede especificar un bucket de destino para almacenar los archivos de log generados. Los archivos de registro generados para varios bucket se pueden almacenar en el mismo bucket de destino. Si lo hace, debe especificar diferentes TargetPrefixes para clasificar los registros de diferentes los bucket. Tipo: string
TargetPrefix	Puede especificar un prefijo utilizando este elemento para que los archivos de log se nombren con este prefijo. Tipo: string
TargetGrants	Contenedor para la concesión de información Tipo: container

Respuestas de error

No hay respuestas de error especiales involucradas. Para obtener más información sobre las respuestas de error, consulte Tabla 2.

Modelo de solicitud

    
         GET /?logging HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 02:42:46 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:hUk+jTnR07hcKwJh4ousF2E1U3E=

Modelo de respuesta

    
     
       
       
         HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: BF260000016436B8EEE7FBA2AA3335E3
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCShuQJoWFpS77C8bOv1mqURv0UY+0ejx
Content-Type: application/xml
Date: WED, 01 Jul 2015 02:42:46 GMT
Content-Length: 429

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BucketLoggingStatus xmlns="http://obs.ap-southeast-1.myhuaweicloud.com/doc/2015-06-30/">
  <Agency>agency-name</Agency>
  <LoggingEnabled>
    <TargetBucket>log-bucket</TargetBucket>
    <TargetPrefix>mybucket-access_log-/</TargetPrefix>
    <TargetGrants>
      <Grant>
        <Grantee>
          <ID>b4bf1b36d9ca43d984fbcb9491b6fce9</ID>
        </Grantee>
        <Permission>READ</Permission>
      </Grant>
    </TargetGrants>
  </LoggingEnabled>
</BucketLoggingStatus>

        

      

    
   