Inventario de buckets

Escenarios

Un inventario de buckets puede enumerar objetos de un bucket, guardar la información de objeto relacionada en archivos CSV y entregar los archivos CSV al bucket especificado para almacenar archivos de inventario de buckets. De esta manera, puede gestionar fácilmente objetos en un bucket. Un bucket de origen también puede ser el bucket de destino.

• Un archivo de inventario de bucket puede contener la siguiente información relacionada con el objeto: versiones, tamaños, clases de almacenamiento, etiquetas, estados de cifrado y tiempo de última modificación.
• Puede cifrar los archivos de inventario de buckets en el modo SSE-KMS.
• Puede establecer la frecuencia (diaria o semanal) para generar archivos de inventario de buckets.
• También puede especificar un bucket para almacenar los archivos de inventario de bucket generados.

Restricciones

Versiones de bucket

• Los inventarios solo se pueden generar para los bucket de OBS 3.0, pero se pueden almacenar en bucket de OBS 3.0 o OBS 2.0.

Número de inventarios de bucket

• Un bucket puede tener un máximo de 10 inventarios.

Bucket de origen y de destino

• El bucket de origen (para el que se configura una regla de inventario de bucket) y el bucket de destino (donde se almacenan los archivos de inventario generados) deben pertenecer a la misma cuenta.
• El bucket de origen y el bucket de destino deben estar en la misma región.
• No se puede habilitar el cifrado predeterminado para el bucket de destino configurado para almacenar archivos de inventario.

Funciones

• Los archivos de inventario deben estar en formato CSV.
• OBS puede generar archivos de inventario para todos los objetos de un bucket o un grupo de objetos cuyos nombres comienzan con el mismo prefijo.
• Si un bucket tiene varias reglas de inventario, estas reglas no deben solaparse.
  • Si un bucket ya tiene una regla de inventario para todo el bucket, no se pueden crear nuevas reglas de inventario que filtren objetos por prefijos. Si necesita una regla de inventario que cubra solo un subconjunto de objetos del bucket, elimine primero la regla de inventario configurada para todo el bucket.
  • Si ya existe una regla de inventario que filtra objetos por un prefijo especificado, no puede crear una regla de inventario para todo el bucket. Para crear una regla de inventario para todo el bucket, asegúrese de que el bucket no tiene otras reglas de inventario que filtren los objetos por prefijos especificados.
  • Si un bucket ya tiene una regla de inventario que filtra objetos por el prefijo de nombre de objeto ab, el filtro de una nueva regla de inventario no puede comenzar con a o abc. O bien, puede eliminar la regla de inventario existente y crear una nueva que filtre los objetos según sus necesidades.
• Solo se puede utilizar SSE-KMS para cifrar inventarios de bucket.

Permisos

• Los archivos de inventario son entregados al bucket de destino por un usuario del sistema de OBS. Por lo tanto, debe autorizar al usuario del sistema el permiso para escribir el bucket de destino.

¿Cómo se configura un inventario de bucket?

Configuración de un inventario de bucket

Puede usar OBS Console o invocar a la API para configurar un inventario de bucket. Si configura un inventario de bucket en OBS Console, se genera automáticamente una política de bucket con la configuración de permisos requerida para el bucket de destino. Si invoca a la API para configurar el inventario del bucket, debe configurar manualmente la política del bucket para el bucket de destino.

1. Agregue una política de bucket para el bucket de destino.

   Se debe configurar una política de bucket para el bucket de destino, para conceder a los usuarios del sistema OBS el permiso para escribir objetos en el bucket de destino. El formato de la política de bucket es el siguiente. Reemplace destbucket por el nombre real del bucket de destino.

   {
   	"Statement": [
   		{
   			"Effect": "Allow",
   			"Sid": "1",
   			"Principal": {"Service": "obs"},
                           "Resource": ["destbucket/*"],
   			"Action": ["PutObject"]
   		}
   	]
   }

2. Configura el inventario de bucket.

   Proporcionamos múltiples herramientas para configurar un inventario de cubetas. Para obtener más información, véase Cómo usarlo.

Contenido de un archivo de inventario

El contenido de un archivo de inventario se puede configurar al crear el inventario. Para obtener más información sobre todos los campos posibles, consulte Tabla 1.

Nombre de archivo de inventario

El nombre de un archivo de inventario tiene el siguiente formato:

destinationPrefix/sourceBucketName/inventoryId/yyyy-MM-dd'T'HH-mm'Z'/files/UUID_index.csv

Archivo de manifiesto

Si hay un gran número de objetos en un bucket, se pueden generar múltiples archivos de inventario para una única configuración de inventario. Se necesita algún tiempo para generar estos archivos. Por ejemplo, si 200,000 hay objetos en un bucket, se tarda aproximadamente 1.5 minutos en generar todos los archivos de inventario. Una o dos horas después de que se hayan generado todos los archivos de inventario, se generará un archivo manifest.json. El archivo manifest.json contiene información acerca de todos los archivos de inventario generados esta vez, incluidos:

• sourceBucket: nombre del bucket fuente
• destinationBucket: nombre del bucket de destino
• version: versión del inventario
• fileFormat: formato de archivos de inventario
• fileSchema: campos de metadatos de objetos contenidos en los archivos de inventario
• files: lista de todos los archivos de inventario
• key: nombre del archivo de inventario
• size: tamaño de un archivo de inventario, en bytes
• inventoriedRecord: número de registros contenidos en un archivo de inventario

{
        "sourceBucket":"user001",
        "destinationBucket":"bucket001",
        "version":"2019-01-03",
        "fileFormat":"CSV",
        "fileSchema":"Bucket,Key,Size,LastModifiedDate,ETag,StorageClass,IsMultipartUploaded,ReplicationStatus,EncryptionStatus",
        "files":[
                {
                        "key":"inventory/user001/test_id/2019-01-03T12-28Z/files/0000016813AF58E66806C1E2D7F15155_1.csv",
                        "size":6705647390,
                        "inventoriedRecord":70585762,
                }
        ]
}

El nombre de un archivo de manifest es el siguiente (para detalles sobre cada campo, vea Nombre de archivo de inventario):

destinationPrefix/sourceBucketName/inventoryId/yyyy-MM-dd'T'HH-mm'Z'/manifest.json

Cómo usarlo

Puede configurar inventarios de buckets mediante OBS Console, APIs o SDKs.