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 la Guía de inicio rápido: Usa Console.

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.

Depósitos

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

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

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

Nombres de depósitos

Los nombres de depósitos tienen más restricciones que los nombres de objetos y deben ser exclusivos a nivel global, ya que cada depósito reside en un espacio de nombres único de Cloud Storage. Los nombres de depósitos también se pueden usar con un redireccionamiento CNAME, lo que significa que deben cumplir con las convenciones de nombres de DNS. A fin de obtener más información, consulta la guía de nombres de depósitos.

Etiquetas de depósitos

Las etiquetas de depósitos son pares de metadatos de clave-valor con los que puedes agrupar tus depósitos junto con otros recursos de Google Cloud Platform, 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 depósitos a fin de indicar cuál equipo se relaciona con esos depósitos.

Puedes aplicar varias etiquetas a cada depósito con un máximo de 64 etiquetas por depósito.

  • 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.

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 depósito.

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. 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) y deben tener menos de 1024 bytes de longitud.

Un carácter común que se debe incluir en los nombres de objetos es una barra (/). Si usas barras, puedes hacer que los objetos aparezcan como si estuvieran almacenados en una estructura jerárquica. Por ejemplo, podrías nombrar un objeto /europe/france/paris.jpg y otro objeto /europe/france/cannes.jpg. Cuando enumeras estos objetos, parecen estar en una estructura de directorio jerárquica según la ubicación. Sin embargo, en Cloud Storage, se considera que los objetos son independientes sin ninguna relación jerárquica en absoluto.

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.

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 la reemplaza por una versión nueva. Cuando habilitas el control de versiones de objetos en tu depósito, las versiones anteriores permanecen en el depósito cuando se produce un reemplazo o 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 en tu depósito o borrar permanentemente 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 en Google Cloud Platform. Cada proyecto, depósito y objeto es un recurso en Google Cloud Platform, igual que las instancias de Compute Engine.

Nombres de recursos

Cada recurso tiene un nombre exclusivo que lo identifica, como 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.

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.

Opacidad de datos

El componente de datos de un objeto es totalmente opaco para Cloud Storage. Es solo una parte de los datos para Cloud Storage.

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 (cuando se sube) 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 que están almacenados en Cloud Storage, lo que ocurre de manera atómica. El objeto se entregará 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 simplemente marca el final del ciclo de vida de un objeto inmutable y el comienzo del ciclo de vida de un objeto inmutable nuevo.

No hay límite para la frecuencia con la que puedes crear o actualizar diferentes objetos en un depósito. Sin embargo, un objeto único en particular solo puede actualizarse o reemplazarse hasta una vez por segundo. Por ejemplo, si tienes un objeto bar en el depósito foo, solo debes subir una copia nueva de foo/bar aproximadamente una vez por segundo. Actualizar el mismo objeto con más frecuencia que una vez por segundo puede generar errores 429 Too Many Requests.

Debes volver a tratar las solicitudes de errores con la retirada exponencial truncada.

Jerarquía

En Cloud Storage, se usa un espacio de nombres fijo para almacenar objetos. Sin embargo, algunas herramientas (por ejemplo, Google Cloud Platform Console y gsutil) pueden funcionar con objetos como si estuvieran almacenados en una jerarquía virtual, por conveniencia.

Espacio de nombres

Solo hay un espacio de nombres de Cloud Storage, lo que significa que cada depósito debe tener un nombre exclusivo en todo el espacio de nombres de Cloud Storage. Los nombres de objetos deben ser exclusivos únicamente dentro de un depósito dado.

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

Enviar comentarios sobre...

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