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 2024-09-18 GMT+08:00
Ver PDF
Compartir

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

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

Parámetros de solicitud

Esta solicitud no contiene parámetros de mensaje.

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

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
 
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 se devuelven respuestas de error especiales. Para obtener más información sobre las respuestas de error, consulte Tabla 2.

Modelo de solicitud

1
2
3
4
5
6
 
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

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
 
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>