Metadatos de objeto

En esta página, se analizan los campos de metadatos que se almacenan junto con objetos en Cloud Storage. Para obtener más información sobre cómo visualizar y configurar metadatos en objetos, consulta Visualiza y edita metadatos de objetos.

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 debe controlar al objeto cuando se accede a él. Los metadatos existen como pares de clave-valor. Por ejemplo, la clase de almacenamiento de un objeto está representada por la entrada de metadatos storageClass:REGIONAL. storageClass es la clave para los metadatos y todos los objetos tienen esa clave asociada a ellos. REGIONAL 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 de Cache-Control en cualquier momento, pero solo les puedes asignar los metadatos de storageClass cuando se crea o se reescribe el objeto y no puedes editar directamente el valor para los metadatos de generation, aunque el valor 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. Cuando usas la API de XML, existe también un límite de 16 KB en el tamaño combinado de la solicitud URL y los encabezados HTTP, por lo que el tamaño total de tus metadatos debe tener en cuenta este límite.

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

Cloud Storage usa administración de identidades y accesos (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 de 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é o si se pueden transformar.

Almacena datos en caché

Los metadatos de Cache-Control te permiten controlar por cuánto tiempo tienen permitido almacenar en caché tus objetos de Internet y las cachés del navegador, y si pueden hacerlo. La configuración del valor de Cache-Control en no-cache significa que el objeto no se debe almacenar en caché y la configuración en max-age=[TIME_IN_SECONDS] significa que el objeto se puede almacenar en caché por un tiempo específico.

Cache-Control solo aplica a objetos que están disponibles de manera pública, debido a que los datos no públicos no se pueden almacenar en caché. A menos que se especifique de otra manera, la configuración Cache-Control para los objetos accesibles de manera pública es 3,600 segundos.

Si permites el almacenamiento en caché, en el momento de la descarga puedes ver versiones anteriores de objetos, aún después de subir un objeto de reemplazo más nuevo, debido a que los objetos anteriores permanecen en caché por un tiempo. Además, debido a que los objetos se pueden almacenar en caché en varios lugares de Internet, no hay manera de forzar el vencimiento de un objeto en caché de manera global. Si quieres evitar el almacenamiento en caché de objetos que se pueden leer de manera pública, debes configurar Cache-Control:private en el objeto.

Transforma datos

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

Content-Disposition

Los metadatos Content-Disposition especifican la información de presentación sobre los datos que se transmiten. La configuración de Content-Disposition te permite controlar el estilo de la presentación del contenido, por ejemplo, determinar si un archivo adjunto se debe mostrar de manera automática o si se debe requerir algún tipo de acción de parte del usuario para abrirlo. Consulta https://tools.ietf.org/html/rfc6266 para la especificación de Content-Disposition.

Content-Encoding

Los metadatos Content-Encoding se pueden usar para indicar que un objeto está comprimido y mantener, al mismo tiempo, el Content-Type subyacente del objeto. Por ejemplo, un archivo de texto que está comprimido en gzip puede tener el hecho de que es un archivo de texto indicado en Content-Type y el hecho de que está comprimido en gzip indicado en Content-Encoding. Debes asegurarte de que los archivos estén comprimidos con la Content-Encoding especificada antes de subirlos, si no puede existir un comportamiento inesperado cuando trates de descargar los objetos. Para obtener más información, consulta la página de transcodificación.

Para el contenido que puede comprimirse, como texto, el uso de Content-Encoding: gzip ahorra costos de almacenamiento y red y mejora el rendimiento de entrega de contenido. Sin embargo, para el contenido que ya se comprimió de manera inherente, como archivos y varios formatos de medios, aplicar otro nivel de compresión y que sean los metadatos de Content-Encoding es perjudicial para el tamaño y el rendimiento del objeto por lo que debe evitarse.

Content-Language

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

Content-Type

Los metadatos con el contenido más común son los Content-Type (también conocidos como tipo MIME), que permiten a los navegadores procesar el objeto de manera correcta. 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 el Content-Type no está especificado por quién lo sube y no se puede determinar, se configura en application/octet-stream o application/x-www-form-urlencoded, según cómo subiste el objeto.

Metadatos personalizados

Los metadatos personalizados son metadatos que puedes agregar o quitar. Para crear metadatos personalizados, tienes que especificar un valor y una clave. Una vez que creaste un par key:value de metadatos personalizados, puedes borrar la clave o cambiar el valor.

La página Visualiza y edita metadatos incluye información sobre la configuración de metadatos personalizados. Ten en cuenta que el uso de metadatos personalizados genera costos de red y almacenamiento.

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 clases de almacenamiento del objeto o claves de encriptación suministradas por el cliente. Otros metadatos se agregan de manera automática y solo se pueden visualizar, como el número de generación del objeto o la fecha de creación.

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Si necesitas ayuda, visita nuestra página de asistencia.