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 inventarios de bucket

Actualización más reciente 2024-09-18 GMT+08:00

Ver PDF

Obtención de inventarios de bucket

Funciones

OBS utiliza el método GET para obtener un inventario específico de un bucket.

Para realizar esta operación, debe tener el permiso GetBucketInventoryConfiguration. De forma predeterminada, el propietario del bucket tiene este permiso y puede asignarlo a otros usuarios.

Para obtener más información acerca del control de permisos, consulte el control de permisos en la Guía de configuración de permisos de OBS.

Sintaxis de solicitud

GET /?inventory&id=configuration-id HTTP/1.1
User-Agent: curl/7.29.0
Host: bucketname.obs.region.myhuaweicloud.com 
Accept: */*
Date: date
Authorization: authorization string

Parámetros de solicitud

**Tabla 1** Parámetros de solicitud
Parámetro	Descripción	Obligatorio
id	ID de la configuración de inventario que desea obtener. Tipo: string Especificaciones: Un máximo de 64 caracteres No hay ningún valor predeterminado. Caracteres válidos: letras, dígitos, guiones (-), puntos (.) y guiones bajos (_)	Sí

Encabezados de solicitud

Esta solicitud utiliza encabezados comunes. Para obtener más información, consulte Tabla 3.

Elementos de solicitud

Esta solicitud no implica ningún elemento.

Sintaxis de respuesta

    
     
       
       
         HTTP/1.1 status_code
Server: OBS
x-obs-request-id: request id
x-obs-id-2: id
Content-Type: application/xml
Date: date
Content-Length: length

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<InventoryConfiguration  xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/"> 
  <Id>configuration-id</Id>
  <IsEnabled>true</IsEnabled>
  <Destination>
    <Format>CSV</Format>
    <Bucket>destbucket</Bucket>
    <Prefix>prefix</Prefix>
  </Destination>
  <Schedule>
    <Frequency>Daily</Frequency>
  </Schedule>
  <IncludedObjectVersions>Current</IncludedObjectVersions>
  <OptionalFields>
    <Field>Size</Field>
    <Field>LastModifiedDate</Field>
    <Field>ETag</Field>
    <Field>StorageClass</Field>
    <Field>IsMultipartUploaded</Field>
    <Field>ReplicationStatus</Field>
    <Field>EncryptionStatus</Field>
  </OptionalFields>
</InventoryConfiguration>

        

      

    
   

Encabezados de respuesta

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

Elementos de respuesta

Tabla 2 enumera los elementos contenidos en el cuerpo de respuesta.

**Tabla 2** Elementos de un cuerpo de respuesta a la solicitud de configuraciones de inventario de bucket
Elemento	Descripción
InventoryConfiguration	Configuración de inventario. Tipo: container Antepasado: ninguno Hijos: Id, IsEnabled, Filter, Destination, Schedule, IncludedObjectVersions, and OptionalFields
Id	ID de una configuración de inventario, que debe ser coherente con el ID de configuración de inventario especificado en la solicitud. Tipo: string Especificaciones: Un máximo de 64 caracteres No hay ningún valor predeterminado. Caracteres válidos: letras, dígitos, guiones (-), puntos (.) y guiones bajos (_) Antepasado: InventoryConfiguration
IsEnabled	Indica si la regla está habilitada. Si este parámetro se establece en true, se genera el inventario. Si no, no se generará el inventario. Tipo: boolean Opciones de valor: true, false Antepasado: InventoryConfiguration
Filter	Configuración del filtro de inventario. El inventario contiene solo objetos que cumplen los criterios de filtro (filtrados por prefijo de nombre de objeto). Si no se configura ningún criterio de filtro, se incluyen todos los objetos. Tipo: container Antepasado: InventoryConfiguration Hijos: Prefix
Prefix	Filtrado por prefijo de nombre. Solo los objetos con el prefijo de nombre especificado se incluyen en el inventario. Tipo: string Antepasado: Filter
Schedule	Tiempo programado para la generación de inventarios. Tipo: container Antepasado: InventoryConfiguration Hijos: Frequency
Frequency	Intervalos cuando se generan inventarios. Puede establecer este parámetro en Daily o Weekly. Un inventario se genera dentro de una hora después de que se configura por primera vez. A continuación, se genera en los intervalos especificados. Tipo: string Antepasado: Schedule Opciones de valor: Daily, Weekly
Destination	Bucket de destino de un inventario. Tipo: container Antepasado: InventoryConfiguration
Formato	Formato del inventario. Solo se admite el formato CSV. Tipo: string Antepasado: Destination Value options: CSV
Bucket	Nombre del bucket para el ahorro de inventarios. Tipo: string Antepasado: Destination
Prefix	El prefijo de nombre de los archivos de inventario. Si no se configura ningún prefijo, los nombres de los archivos de inventario comenzarán con el BucketInventory de forma predeterminada. Tipo: string Antepasado: Destination
IncludedObjectVersions	Indica si se incluyen versiones de objetos en un inventario. Si este parámetro se establece en All, todas las versiones de los objetos se incluyen en el inventario y los campos relacionados con el control de versiones se agregan al inventario, incluidos: VersionId, IsLatest, y DeleteMarker. Si este parámetro se establece en Current, el inventario solo contiene las versiones de objetos actuales en el momento en que se genera el inventario. No se muestran campos de control de versiones en el inventario. Tipo: string Antepasado: InventoryConfiguration Opciones de valor: All, Current
OptionalFields	Campos de metadatos adicionales que se pueden agregar a un inventario. Si este parámetro está configurado, los campos especificados en este parámetro están contenidos en el inventario. Tipo: container Antepasado: InventoryConfiguration Hijos: Field
Field	Optional fields. El OptionalFields puede contener varios elementos de campo. Tipo: string Antepasado: OptionalFields Opciones de valor: Size, LastModifiedDate, StorageClass, ETag, IsMultipartUploaded, ReplicationStatus, EncryptionStatus

Respuestas de error

Además de los códigos de error comunes, esta API también devuelve otros códigos de error. En la siguiente tabla se enumeran los errores comunes y las posibles causas. Para obtener más información, consulte Tabla 3.

**Tabla 3** Códigos de error relacionados con la obtención de configuraciones de inventario
Código de error	Descripción	Código de estado de HTTP
NoSuchInventoryConfiguration	No se encontró ninguna configuración de inventario que coincida con el ID especificado.	404 Not Found

Modelo de solicitud

GET /?inventory&id=id1 HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: Tue, 08 Jan 2019 09:32:24 +0000
Authorization: OBS UDSIAMSTUBTEST000001:ySWncC9M08jNsyXdJLSMJkpi7XM=

Modelo de respuesta

    
     
       
       
         HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 000001682CB4C2EE6808A0D8DF9F3D00
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSBjn5O7Jv9CqvUMO0BenehRdil1n8rR
Content-Type: application/xml
Date: Tue, 08 Jan 2019 09:04:30 GMT
Content-Length: 626

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<InventoryConfiguration  xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/"> 
  <Id>id1</Id>
  <IsEnabled>true</IsEnabled>
  <Destination>
    <Format>CSV</Format>
    <Bucket>bucket</Bucket>
    <Prefix>prefix</Prefix>
  </Destination>
  <Schedule>
    <Frequency>Daily</Frequency>
  </Schedule>
  <IncludedObjectVersions>Current</IncludedObjectVersions>
  <OptionalFields>
    <Field>Size</Field>
    <Field>LastModifiedDate</Field>
    <Field>ETag</Field>
    <Field>StorageClass</Field>
    <Field>IsMultipartUploaded</Field>
    <Field>ReplicationStatus</Field>
    <Field>EncryptionStatus</Field>
  </OptionalFields>
</InventoryConfiguration>

        

      

    
   