Metadatos del objeto

Administrar

En esta página, se analizan los campos de metadatos de uso general que se almacenan junto con objetos en Cloud Storage.

Introducción

Los objetos almacenados en Cloud Storage tienen metadatos asociados a ellos. Los metadatos identifican las propiedades del objeto y especifican cómo se lo debe controlar cuando se accede a él. Los metadatos existen como pares clave-valor. Por ejemplo, la clase de almacenamiento de un objeto se representa mediante la entrada de metadatos storageClass:STANDARD. storageClass es la clave para los metadatos. Todos los objetos tienen una clave similar asociada. STANDARD especifica el valor que tiene este objeto en particular y el valor varía de objeto a objeto.

La mutabilidad de los metadatos varía: a algunos metadatos los puedes editar en cualquier momento, a algunos los puedes configurar solo en el momento en el que se crean y a otros solo los puedes visualizar. Por ejemplo, puedes editar el valor de los metadatos Cache-Control en cualquier momento, pero solo puedes asignar los metadatos storageClass cuando se crea o se reescribe el objeto y no puedes editar de forma directa el valor de los metadatos generation, aunque el valor de generation cambia cuando se reemplaza el objeto.

Metadatos editables

Existen dos categorías de metadatos que los usuarios pueden cambiar por objetos:

• Metadatos de clave fija: metadatos en los que las claves están configuradas, pero para los que puedes especificar un valor.

• Metadatos personalizados: metadatos que agregas cuando especificas una clave y un valor asociado con la clave.

Cuando editas metadatos, debes evitar caracteres que no sean ASCII debido a que no están permitidos en los encabezados HTTP que usa la API de XML.

Metadatos de clave fija

Puedes editar los metadatos siguientes para los objetos, aunque debes tener permiso suficiente si quieres hacerlo:

• Metadatos de control de acceso
• Cache-Control
• Content-Disposition
• Content-Encoding
• Content-Language
• Content-Type
• Custom-Time
• Conservaciones de objetos
• Configuración de la retención

Metadatos de control de acceso

Cloud Storage usa Identity and Access Management (IAM) y listas de control de acceso (LCA) para controlar el acceso a los objetos. Usa estos vínculos para obtener más información sobre estos métodos de control de acceso y metadatos asociados.

Cache-Control

Los metadatos Cache-Control pueden especificar dos aspectos diferentes de cómo se entregan los datos de Cloud Storage: si los datos se pueden almacenar en caché y si se pueden transformar.

Nota: Cache-Control también es un encabezado que puedes especificar en tus solicitudes HTTP de un objeto. Sin embargo, Cloud Storage ignora este encabezado y establece los encabezados Cache-Control de respuesta en función de los valores de metadatos almacenados.

Almacena datos en caché

Los metadatos Cache-Control te permiten controlar si las cachés pueden almacenar en caché tus objetos y durante cuánto tiempo pueden hacerlo. Luego estos objetos se pueden entregar para satisfacer solicitudes futuras. Las memorias caché pueden incluir cachés del navegador y de Internet, así como almacenamiento en caché integrado de Cloud Storage.

Si un objeto aplicable no tiene una entrada de metadatos Cache-Control, Cloud Storage usa el siguiente valor predeterminado:

• public, max-age=3600, si el objeto no se encripta con una clave de encriptación administrada por el cliente ni si se almacena dentro de un perímetro de servicio de nube privada virtual.

• no-cache, no-store, max-age=0, si el objeto se encripta con una clave de encriptación administrada por el cliente.

• private, max-age=0, si el objeto se almacena dentro de un perímetro de servicio de nube privada virtual.

• no-cache, no-store, max-age=0, must-revalidateSi el objeto se almacena en un rangoPerímetro de servicio de la nube privada virtual y encriptados con un archivoclave de encriptación administrada por el cliente.

Si permites que se almacene en caché, las descargas pueden continuar recibiendo versiones anteriores de un objeto, incluso después de subir una versión más nueva. Esto se debe a que esas versiones anteriores permanecen “activas” en las memorias caché durante un período determinado por el max-age. Además, debido a que los objetos se pueden almacenar en caché en varias ubicaciones de Internet, no hay manera de forzar el vencimiento de un objeto almacenado en caché de forma global. Significa que si revocas el acceso público a un objeto, este aún se puede entregar desde una caché, según cuándo se accedió por última vez y su configuración de Cache-Control. Por ejemplo, si tu objeto se entregó con un Cache-Control de public, max-age=3600, puede persistir en una caché durante una hora. Si quieres evitar que se entreguen versiones almacenadas en caché de objetos que se pueden leer de forma pública, configura Cache-Control: no-store en el objeto.

Si necesitas un mayor control sobre el comportamiento de la caché, puedes configurar Cloud CDN frente al bucket.

Transforma datos

Los metadatos Cache-Control también te permiten entregar objetos como están almacenados, sin aplicar ninguna transformación a los datos, como quitar la codificación de contenido gzip para los clientes que no son compatibles. Para entregar un objeto tal como es, configura Cache-Control:no-transform.

Content-Disposition

Los metadatos Content-Disposition especifican información de presentación de los datos que se transmiten. La configuración Content-Disposition te permite controlar el estilo de presentación del contenido, por ejemplo, determinar si un adjunto se debe mostrar de forma automática o si se requiere que el usuario realice alguna acción para abrirlo. Consulta https://datatracker.ietf.org/doc/html/rfc6266 para ver la especificación Content-Disposition.

Content-Encoding

Los metadatos Content-Encoding se pueden usar para indicar que un objeto está comprimido y, al mismo tiempo, mantener el Content-Type subyacente del objeto. Por ejemplo, para un archivo de texto comprimido en gzip, el hecho de que es un archivo de texto se puede indicar en Content-Type y en Content-Encoding, se puede indicar que está comprimido en gzip. Te debes asegurar de que los archivos se compriman con el Content-Encoding especificado antes de subirlos, de lo contrario, puede ocurrir un comportamiento inesperado cuando se intenten descargar los objetos. Para obtener más información, consulta la página de transcodificación.

Para el contenido que se puede comprimir, como el texto, el uso de Content-Encoding: gzip ahorra costos de red y almacenamiento, y mejora el rendimiento de la entrega del contenido. Sin embargo, para el contenido ya comprimido de manera inherente, como los archivos y muchos formatos de contenido multimedia, aplicar otro nivel de compresión y marcarlo en los metadatos Content-Encoding suele ser perjudicial para el tamaño y el rendimiento del objeto, por lo que debe evitarse.

Content-Language

Los metadatos Content-Language indican los lenguajes para los que está destinado el objeto. Consulta los códigos de lenguajes ISO 639-1 para los valores típicos de estos metadatos.

Cloud Storage admite valores Content-Language de hasta 100 caracteres.

Content-Type

Los metadatos que se configuran con mayor frecuencia son Content-Type (también conocidos como tipo de medio), que permiten que los navegadores procesen el objeto de forma adecuada. Todos los objetos tienen un valor especificado en sus metadatos Content-Type, pero este valor no tiene que coincidir con el tipo subyacente del objeto. Por ejemplo, si quien lo sube no especifica el Content-Type y este no se puede determinar, se configura en application/octet-stream o application/x-www-form-urlencoded, según cómo subiste el objeto. Para ver una lista de los tipos de contenido válidos, consulta la página Tipos de medios de IANA.

Nota: Algunas herramientas, como gcloud storage, intentan establecer Content-Type de manera automática en el momento de la carga según la extensión del archivo que se está subiendo. Sin embargo, cualquier valor explícito que configures para Content-Type anula este mecanismo.

Custom-Time

Los metadatos Custom-Time son una fecha y hora especificadas por el usuario que se representan en el formato YYYY-MM-DD'T'HH:MM:SS.SS'Z' o YYYY-MM-DD'T'HH:MM:SS'Z' de RFC 3339 cuando los milisegundos son cero. Por lo general, estos metadatos se configuran para usar la condición DaysSinceCustomTime en la Administración del ciclo de vida de los objetos.

No puedes quitar Custom-Time una vez configurado en un objeto. Además, el valor de Custom-Time no puede disminuir. Es decir, no puedes configurar Custom-Time para que sea una fecha y hora anteriores a la Custom-Time existente. Sin embargo, puedes quitar o restablecer los metadatos Custom-Time mediante la reescritura del objeto.

Conservaciones de objetos

Usa marcas de metadatos para colocar conservaciones de objetos, lo que impedirá que se borren o reemplacen objetos. Para obtener más información, consulta la página de conservaciones de objetos.

Configuración de la retención

Cuando está presente, la configuración de retención de un objeto define una fecha y una hora anteriores a las cuales el objeto no se puede borrar ni reemplazar. Consulta Bloqueo de retención de objetos para obtener más información.

Metadatos personalizados

Los metadatos personalizados son metadatos para los que defines la clave y el valor. Para crear metadatos personalizados, especifica una clave y un valor. Una vez que hayas creado un par de metadatos personalizados key:value, puedes borrar la clave o cambiar el valor.

Los metadatos personalizados están sujetos a un límite de tamaño y, además, incurren en costos de almacenamiento.

En la página Visualiza y edita metadatos, se incluye información sobre cómo configurar metadatos personalizados.

El prefijo x-goog-meta-

La API de XML establece y recupera metadatos de objetos mediante encabezados de solicitudes, y la API de JSON permite configurar metadatos personalizados en la solicitud final de una carga reanudable mediante encabezados de solicitud. Para distinguir claramente los encabezados de metadatos personalizados de los encabezados de solicitudes estándar, ambos prefijos incluyen los encabezados de metadatos personalizados con x-goog-meta-.

Metadatos no editables

Algunos metadatos no se pueden editar directamente. Estos metadatos se configuran al momento de la creación o de la reescritura del objeto. Como parte de la creación o la reescritura del objeto, puedes configurar algunos de estos metadatos, como la clase de almacenamiento del objeto o las claves de encriptación administradas por el cliente. Otros metadatos se agregan de forma automática y solo se pueden visualizar, como el número de generación del objeto o la fecha de creación.

Números de generación y metageneración

Como parte de sus metadatos, cada objeto de Cloud Storage tiene una propiedad generation numérica y una propiedad metageneration numérica que identifica el objeto de manera inequívoca:

Propiedad	Descripción
generation	Identifica la versión de un objeto y existe para cada objeto, sin importar si un bucket usa el control de versiones de objetos. El valor de generation de la versión de un objeto nunca cambia. Un objeto nuevo con el mismo nombre puede reemplazar un objeto existente, pero el objeto nuevo siempre tiene una generation diferente asignada. Ten en cuenta que no hay garantía de que los números de generación aumenten para las versiones sucesivas, solo que cada versión nueva tiene un número de generación único. No existe una relación entre los números de generación de objetos no relacionados, incluso si los objetos están en el mismo bucket.
metageneration	Identifica la versión de metadatos y aumenta cada vez que se actualizan los metadatos de una generation determinada. metageneration comienza en 1 para cada generation nueva de un objeto. La propiedad metageneration no tiene sentido sin la propiedad generation y debe usarse solo junto con ella. No tiene sentido comparar las generaciones de metadatos de dos versiones de objetos.

Las propiedades generation y metageneration se usan en las siguientes circunstancias:

• Cuando se usan condiciones previas en solicitudes: las condiciones previas hacen que la solicitud falle si no se cumple la condición previa. Fallar de esta manera evita que la solicitud se aplique a una versión inesperada de un objeto, como recuperar los datos de objeto incorrectos o modificar el estado incorrecto de los metadatos de un objeto.

• Cuando enumeras, restableces, borras y accedes a versiones de objetos no actuales: las versiones de objetos no actuales son relevantes en los buckets que usan o usaron antes el control de versiones de objetos.

Sumas de verificación

Las sumas de comprobación son metadatos calculados a partir de los datos del objeto asociado. Las sumas de verificación se usan para validar que los datos del objeto no estén dañados. Los objetos de Cloud Storage tienen varios campos de metadatos de suma de comprobación.

CRC32C

Todos los objetos de Cloud Storage tienen un hash CRC32C. Entre las bibliotecas para procesar CRC32C se incluyen las siguientes:

• CRC32C de Google para C++
• hash/crc32 para Go
• Guava de GoogleAPI para Java
• google-crc32c para Python
• digest-crc en Ruby

Nota: CRC, conocido como CRC32, es distinto del algoritmo CRC32C que usa Cloud Storage.

CRC32C codificado en Base64 está en el orden de bytes big-endian.

MD5

Los objetos de Cloud Storage tienen un hash MD5 si cumplen con los siguientes criterios:

• El objeto no es un objeto compuesto
• El objeto no se subió mediante una carga multiparte de la API de XML

Este hash solo se aplica en un objeto completo, por lo que no se puede usar para verificar la integridad de descargas parciales generadas por la realización de un rango GET.

ETag

Todos los objetos de Cloud Storage tienen una ETag. Sin embargo, el mismo objeto puede tener un valor de ETag diferente cuando se solicita desde la API de XML en comparación con la API de JSON. En la mayoría de los casos, los usuarios no deben hacer suposiciones sobre el valor usado en una ETag, excepto que cambia cada vez que cambian los datos subyacentes o metadatos, según la especificación.

El encabezado ETag de un objeto muestra el valor MD5 del objeto si se cumplen las siguientes condiciones:

• La solicitud se realiza mediante la API de XML.
• El objeto solo usa claves que son propiedad de Google y administradas por Google para la encriptación del servidor.
• El objeto no es un objeto compuesto y no se subió mediante una carga multiparte de la API de XML.

Hora de modificación

Como parte de sus metadatos, cada objeto de Cloud Storage tiene una propiedad updated que indica la última vez que se modificaron los metadatos del objeto. La hora updated se establece inicialmente en la hora de creación del objeto y, luego, cambia cada vez que cambia algún metadato del objeto. Esto incluye los cambios que realiza un solicitante, como modificar metadatos personalizados, y los cambios que realiza Cloud Storage en nombre de un solicitante, como cambiar la clase de almacenamiento según una configuración del ciclo de vida de los objetos.

¿Qué sigue?

• Mira y edita metadatos de objetos.
• Obtén información sobre las clases de almacenamiento disponibles.
• Para obtener una descripción detallada de todos los campos de metadatos de objetos disponibles en la API de JSON, consulta la documentación de referencia de objetos para JSON.
• Obtén información sobre los informes de inventario de Storage Insights, que te permiten obtener los metadatos de todos los objetos de un bucket a la vez.