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 para usar 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 uno o varios proyectos.

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 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 su 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 usar etiquetas a fin de crear una clave team que tenga los valores alpha, beta y delta, y aplicar las etiquetas team:alpha, team:beta y team:delta a depósitos diferentes para indicar qué equipo está asociado 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.

La barra (/) es un carácter común que se incluye en los nombres de objetos. Mediante el uso de barras, puedes hacer que los objetos aparezcan como si estuvieran almacenados en una estructura jerárquica. Por ejemplo, puedes nombrar /europe/france/paris.jpg a un objeto y /europe/france/cannes.jpg a otro. 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 volver a nombrar un objeto, consulta los lineamientos para asignar nombres a los objetos.

Números de generación

Un número de generación es un número asociado con cada objeto. Cada vez que se reemplaza el objeto, su número de generación cambia. Cuando tu depósito contiene varias versiones del mismo objeto, como en el caso en el que el control de versiones de objetos está habilitado, puedes usar el número de generación para identificar versiones específicas.

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 la forma projects/_/buckets/[BUCKET_NAME], en la que [BUCKET_NAME] es el ID del depósito. Los objetos tienen un nombre de recurso con la forma projects/_/buckets/[BUCKET_NAME]/objects/[OBJECT_NAME], en la 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 de la versión más reciente de un objeto. Es útil agregar #0 cuando el nombre del objeto termina con una string que se interpreta como 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 ubicaciones de varias regiones tienen redundancia geográfica, sin importar 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 una ubicación birregional, la redundancia geográfica se logra mediante dos ubicaciones regionales específicas. Para otras ubicaciones de varias regiones, la redundancia geográfica se logra mediante cualquier combinación de centros de datos dentro de varias regiones especificadas, en la que se pueden incluir centros de datos que no están disponibles de manera explícita como ubicaciones regionales.

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 en la velocidad con la que puedes crear o actualizar objetos diferentes 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 antes de una vez por segundo puede provocar 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 sirvió esta página? Envíanos tu opinión:

Enviar comentarios sobre…

¿Necesitas ayuda? Visita nuestra página de asistencia.