Metadatos de bucket

Los metadatos de un bucket de Cloud Storage identifican las propiedades del bucket y te permiten controlar su comportamiento. Los metadatos de un bucket incluyen campos no editables, como el nombre del bucket y el número del proyecto, además de parámetros de configuración, como la clase de almacenamiento predeterminada, las reglas del ciclo de vida y los roles de IAM.

Descripción general de los metadatos de bucket

Los metadatos se almacenan como pares key: value, en los que value puede tomar una variedad de formas, incluidas strings, arrays o incluso pares key:value anidados. Por ejemplo, el nombre del bucket es una string, mientras que una configuración de Administración del ciclo de vida de los objetos del bucket es un array de reglas en el que cada regla contiene varios pares key: value secundarios.

La mutabilidad de los metadatos varía:

  • Algunos metadatos son de solo lectura.

  • Algunos metadatos se pueden configurar cuando se crea el bucket, pero no se pueden editar ni quitar.

  • Algunos metadatos se pueden agregar y editar, pero no se pueden quitar.

  • Algunos metadatos se pueden agregar, editar y quitar en cualquier momento.

Metadatos no editables

Los siguientes metadatos se configuran durante la creación del bucket y no se pueden editar ni quitar:

  • Nombre del bucket

  • El proyecto del bucket es parte de lo siguiente

  • Número de generación

    • El número de generación de un bucket identifica de forma única la versión del bucket, incluso si más de una versión de un bucket comparte el mismo nombre.

    • El valor de generación de un bucket nunca cambia.

    • No se garantiza que los números de generación aumenten para las versiones sucesivas, solo que cada versión nueva tenga un número de generación único.

    • No existe una relación entre los números de generación de buckets no relacionados.

  • Número de metageneración

    • El número de metageneración de un bucket identifica de forma única el estado de los metadatos del bucket. El número de metageneración es 1 en el momento de la creación del bucket y aumenta cada vez que modificas los metadatos del bucket.

  • Si el espacio de nombres jerárquico está habilitado para el bucket

Metadatos editables

Los metadatos de bucket editables son metadatos cuyos valores puedes modificar en cualquier momento normalmente. En algunos casos, como cuando el bucket está sujeto a una restricción de políticas de la organización, existen restricciones para modificar ciertos valores de metadatos.

Descripción general de los metadatos Vínculo a la guía Notas
Listas de control de acceso (LCA) Crea y administra las LCA Se recomienda solo para usuarios de XML.
LCA predeterminadas Establece LCA de objeto predeterminadas
Políticas de Identity and Access Management (IAM)1 Usa permisos de IAM
Facturación (pagos del solicitante) Usa los pagos del solicitante
Configuración de uso compartido de recursos entre dominios (CORS) Establece y visualiza las configuraciones de CORS
Clase de almacenamiento predeterminada Cambia la clase de almacenamiento predeterminada Se configura durante la creación del bucket y se puede editar, pero no quitar.
Encriptación de datos Configura qué métodos de encriptación se permiten o restringen La actualización de este parámetro de configuración no afecta el tipo de encriptación de los objetos que ya existen en el bucket.
Clave de encriptación predeterminada de Cloud KMS Usa las claves predeterminadas de Cloud KMS
Conservaciones predeterminadas basadas en eventos1 Trabaja con la propiedad de retención predeterminada basada en eventos
Prevención del acceso público1 Usa la prevención de acceso público
Acceso uniforme a nivel de bucket1 Usar el acceso uniforme a nivel de bucket Solo se puede editar durante los primeros 90 días después de que habilitas el acceso uniforme a nivel de bucket en un bucket.
Política de configuración del ciclo de vida Administra los ciclos de vida de los objetos
Autoclass Usar Autoclass
Replicación turbo1 Administrar la replicación turbo
Registros de uso y almacenamiento Configuración de registros de uso
Bloqueo del bucket2 Usa y bloquea políticas de retención Solo se puede editar si no bloqueas la política de retención.
Bloqueo de retención de objetos Habilita y usa la configuración de retención de objetos Una vez que se habilita para un bucket, no se puede inhabilitar.
Configuración del control de versiones de objetos Usa el control de versiones de objetos
Etiquetas de buckets Usa etiquetas de bucket
Borra de forma no definitiva la duración de la retención Usa borrarr de forma no definitiva
Configuración del sitio web Asigna páginas especializadas para sitios web estáticos
Ubicación del bucket Reubica buckets Antes de reubicar un bucket, revisa la página Descripción general de la reubicación de buckets.

1 Estos metadatos no se pueden ver ni administrar mediante la API de XML.

2 Puedes usar la API de XML para configurar estos metadatos durante la creación del bucket, pero no para verlos ni administrarlos.

¿Qué sigue?