Metadatos de bucket

Ir a ejemplos

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

Introducción

Los bucket creados en 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.

Algunos metadatos existen como pares key: value. Por ejemplo, el nombre de un bucket se representa mediante la entrada de metadatos name: my-bucket-name para la API de JSON. La API de XML presenta estos metadatos como <elements></elements>, como <LocationConstraint>US</LocationConstraint> para la ubicación del bucket.

Otros metadatos pueden tener un arreglo de datos asociados con la clave. Por ejemplo, los metadatos de administración del ciclo de vida pueden contener un conjunto de reglas que se aplican a objetos actuales y futuros en un bucket.

La mutabilidad de los metadatos varía:

  • Solo tú puedes verlo.

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

Metadatos editables

Existen dos categorías de metadatos que puedes cambiar para los buckets:

Metadatos de clave fija

Los metadatos de clave fija son metadatos en los que las claves están configuradas, pero para los que puedes especificar un valor.

Descripción general de los metadatos Vínculo a la guía Notas
Listas de control de acceso (LCA) Crea y administra LCA Solo se recomienda para usuarios de XML.
LCA predeterminadas Establece LCA de objeto predeterminada
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) Configurar 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 de KMS predeterminada Usa claves de Cloud KMS predeterminadas
Conservaciones predeterminadas basadas en eventos1 Trabaja con la propiedad de retención predeterminada basada en eventos
Acceso uniforme a nivel de bucket1 Usa 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 de Lifecycle Administra los ciclos de vida de los objetos
Registros de uso y registros de almacenamiento Configuración de registros de uso
Política de retención2 Usa y bloquea políticas de retención Solo es editable si no bloqueas la política de retención.
Configuración del control de versiones de objetos Usa el control de versiones de objetos
Configuración del sitio web Asigna páginas especializadas para sitios web estáticos

1 Estos metadatos no se pueden ver ni administrar con 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 o administrarlos.

Metadatos de claves personalizadas

Los metadatos personalizados son metadatos que agregas cuando especificas una clave y un valor asociado con la clave. En los buckets, los metadatos de clave personalizada se conocen como etiquetas, que puedes usar para organizar tus buckets.

¿Qué sigue?