Metadatos de bucket

Obtener metadatos

Obtén el tamaño del bucket

En esta página, se analizan los campos de metadatos que se almacenan junto con buckets en Cloud Storage.

Introducción

Los buckets de Cloud Storage tienen metadatos asociados a ellos. Los metadatos identifican las propiedades del bucket y especifican cómo se debe manejar cuando se accede a él.

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:

  • Solo puedes ver algunas.

  • Algunos solo se pueden configurar cuando se crea el bucket por primera vez y no se pueden editar ni quitar.

  • Algunos se pueden agregar y editar, pero no pueden quitarse.

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

  • Ubicación 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.

    • Ten en cuenta que no hay garantía de que los números de generación aumenten para las versiones sucesivas, solo que cada versión nueva tiene 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.

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

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?