Términos clave

Para usar Cloud Storage de manera eficaz, debes comprender algunos de los conceptos en los que se basa. En esta página, se proporciona una descripción general de los términos y conceptos clave que se aplican a Cloud Storage.

A fin de ver una introducción sobre cómo usar Cloud Storage, consulta ¿Qué es Cloud Storage?

Proyectos

Todos los datos en Cloud Storage están dentro de un proyecto. Un proyecto consiste en un conjunto de usuarios, un conjunto de API y configuración de facturación, autenticación y supervisión para las API. Puedes tener un proyecto o varios.

Buckets

Los depósitos son los contenedores básicos que conservan tus datos. Todo lo que almacenes en Cloud Storage se debe contener en un bucket. Puedes usar depósitos para organizar y controlar el acceso a los datos, pero, a diferencia de los directorios y las carpetas, no puedes anidar los depósitos. Debido a que hay límites para la creación y la eliminación de buckets, debes diseñar las aplicaciones de almacenamiento de modo que se favorezcan las operaciones intensivas de objetos y las relativamente pocas de buckets.

Cuando crees un bucket, especifica un nombre exclusivo a nivel global, una ubicación geográfica en la que se almacenen el bucket y su contenido, y una clase de almacenamiento predeterminada. La clase predeterminada que elijas se aplica a los objetos agregados al bucket que no cuenten con una clase de almacenamiento especificada de manera explícita.

Después de crear un bucket, puedes cambiar tu clase de almacenamiento predeterminada a cualquier clase que se admita en la ubicación del bucket. Sin embargo, solo puedes cambiar el nombre del bucket y la ubicación si borras y vuelves a crear el bucket.

Nombres de buckets

Los nombres de buckets tienen más restricciones que los nombres de objetos y deben ser exclusivos a nivel global, ya que cada bucket reside en un espacio de nombres único de Cloud Storage. A fin de obtener más información, consulta los lineamientos para asignar nombres de depósitos.

Etiquetas de buckets

Las etiquetas de buckets son pares de metadatos de clave-valor con los que puedes agrupar tus buckets junto con otros recursos de Google Cloud, como instancias de máquina virtual y discos persistentes. Por ejemplo, puedes crear etiquetas para crear una clave team que tenga valores alpha, beta y delta, y aplicar las etiquetas team:alpha, team:beta y team:delta a diferentes buckets a fin de indicar qué equipo se relaciona con esos buckets.

Puedes aplicar varias etiquetas a cada bucket con un máximo de 64 etiquetas por bucket.

  • Las claves y los valores no pueden tener más de 63 caracteres.
  • Las claves y los valores solo pueden contener letras en minúscula, números, guiones y guiones bajos. Se permite el uso de caracteres internacionales.
  • Las claves de etiquetas deben comenzar con una letra en minúscula y se permite el uso de caracteres internacionales.
  • Las claves de etiquetas no pueden estar vacías.
  • Como suele ser el caso de los metadatos de bucket, las etiquetas de bucket no están asociadas con objetos individuales ni metadatos de objetos.

A fin de ver un ejemplo general de cómo usar las etiquetas para organizar tus recursos en la facturación, consulta Ejemplos de consultas de exportación de facturación a BigQuery.

Objetos

Los objetos son los datos individuales que almacenas en Cloud Storage. No hay límite en la cantidad de objetos que puedes crear en un bucket.

Los objetos tienen dos componentes: datos de objeto y metadatos de objeto. Los datos de objeto suelen ser un archivo que deseas almacenar en Cloud Storage y son completamente opacos para Cloud Storage. Los metadatos de objeto son una recopilación de pares nombre-valor en los que se describen varias calidades del objeto.

Nombres de objetos

El nombre de un objeto se trata como una parte de los metadatos del objeto en Cloud Storage. Los nombres de objetos pueden contener cualquier combinación de caracteres Unicode (codificados en UTF-8), deben tener menos de 1,024 bytes de longitud y deben ser únicos en un bucket.

Cloud Storage usa un espacio de nombres sin formato para almacenar objetos, lo que significa que Cloud Storage ve a todos los objetos en un bucket determinado como independientes, sin relación jerárquica. Para mayor comodidad, herramientas como Google Cloud Consolegsutil trabajan con objetos que usan el carácter de barra (/) como si se almacenaran en una jerarquía virtual.

Por ejemplo, podrías nombrar un objeto /europe/france/paris.jpg y otro objeto /europe/france/cannes.jpg. Cuando usas Cloud Console, puedes navegar a estos objetos como si estuvieran en una estructura de directorio jerárquico en las carpetas europe y france.

A fin de obtener más información, incluida la manera de cambiarle el nombre a un objeto, consulta los lineamientos para nombrar los objetos.

Inmutabilidad de objetos

Los objetos son inmutables, lo que significa que un objeto subido no puede cambiar durante su ciclo de vida de almacenamiento. El ciclo de vida de almacenamiento de un objeto es el tiempo entre la creación correcta de un objeto, como subir un objeto, y la eliminación correcta de un objeto. En la práctica, esto significa que no puedes realizar cambios incrementales en los objetos, como agregar o truncar operaciones. Sin embargo, es posible reemplazar objetos almacenados en Cloud Storage, lo que ocurre de manera atómica. El objeto se entrega a los lectores hasta que la carga nueva complete la versión anterior del objeto y después de completar su versión nueva. Por lo tanto, una operación de reemplazo única solo marca el final del ciclo de vida de un objeto inmutable y el comienzo del ciclo de vida de un objeto inmutable nuevo.

Ten en cuenta que existe un límite para reemplazar con rapidez el mismo objeto de una vez por segundo. Por ejemplo, si tienes un objeto bar en el bucket foo, solo debes subir una copia nueva de foo/bar aproximadamente una vez por segundo. Reemplazar el mismo objeto con más frecuencia que una vez por segundo puede generar errores 429 Too Many Requests, que deben manejarse mediante la retirada exponencial truncada.

Versiones de objeto y números de generación

Un objeto en Cloud Storage puede tener diferentes versiones: de forma predeterminada, cuando reemplazas un objeto, Cloud Storage borra la versión anterior y agrega una versión nueva. Cuando habilitas el control de versiones de objetos en el bucket, las versiones anteriores permanecen en el bucket cuando se produce un reemplazo o una eliminación.

Cada versión de objeto se identifica de manera única por su número de generación, que se encuentra en los metadatos del objeto. Cuando el control de versiones de objetos crea una versión anterior de un objeto, puedes usar el número de generación para hacer referencia a la versión anterior. Esto te permite restablecer un objeto reemplazado o borrado en tu bucket, o borrar de forma permanente versiones de objetos anteriores que ya no necesitas. Los números de generación también se usan cuando se incluyen condiciones previas en tus solicitudes.

Recursos

Un recurso es una entidad dentro de Google Cloud. Cada proyecto, depósito y objeto es un recurso en Google Cloud, igual que las instancias de Compute Engine.

Nombres de recursos

Cada recurso tiene un nombre exclusivo que lo identifica, similar a un nombre de archivo. Los depósitos tienen un nombre de recurso con el formato projects/_/buckets/BUCKET_NAME, en el que BUCKET_NAME es el ID del depósito. Los objetos tienen un nombre de recurso con el formato projects/_/buckets/BUCKET_NAME/objects/OBJECT_NAME, en el que OBJECT_NAME es el ID del objeto.

Un #NUMBER agregado al final del nombre del recurso indica una generación específica del objeto. #0 es un identificador especial para la versión más reciente de un objeto. #0 es útil para agregar cuando el nombre del objeto termina en una string que, de otro modo, se interpretaría como un número de generación.

Uso de red

Uso de red representa los datos enviados hacia o desde Cloud Storage.

Salida representa los datos enviados desde Cloud Storage en las respuestas HTTP. La lectura de datos o metadatos desde un bucket de Cloud Storage es un ejemplo de salida.

Entrada representa los datos enviados a Cloud Storage en las solicitudes HTTP. Los datos o metadatos escritos en un bucket de Cloud Storage son un ejemplo del tráfico de entrada.

Para obtener más información, consulta los precios de Cloud Storage y las cuotas de Cloud Storage.

Redundancia geográfica

Los datos con redundancia geográfica se almacenan de manera redundante en al menos dos lugares geográficos separados por al menos 100 millas. Los objetos almacenados en multirregiones y regiones duales son georedundantes, independientemente de su clase de almacenamiento.

La redundancia geográfica se produce de manera asíncrona, pero todos los datos de Cloud Storage son redundantes en al menos un lugar geográfico en cuanto se suben.

Con la redundancia geográfica, se garantiza la disponibilidad máxima de tus datos, incluso en el caso de interrupciones a gran escala, como desastres naturales. Para las regiones duales, la redundancia geográfica se logra con dos regiones específicas. Para las multirregiones, la redundancia geográfica se logra con cualquier combinación de centros de datos dentro de la multirregión especificada, que puede incluir centros de datos que no están explícitamente indicados como regiones disponibles.

Pruébalo tú mismo

Si es la primera vez que usas Google Cloud, crea una cuenta para evaluar el rendimiento de Cloud Storage en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

Probar Cloud Storage gratis