Cómo establecer períodos de retención de bucket de almacenamiento para proyectos

En esta página, se muestra cómo establecer períodos de retención para los buckets de almacenamiento aislados de Google Distributed Cloud (GDC).

Antes de comenzar

Un espacio de nombres del proyecto administra los recursos del bucket en el servidor de la API de Management. Debes tener un proyecto para trabajar con buckets y objetos.

También debes tener los permisos de bucket adecuados para realizar la siguiente operación. Consulta Cómo otorgar acceso al bucket.

Establece un período de retención del bucket

Console

  1. En el menú de navegación, haz clic en Object Storage.
  2. Haz clic en el nombre del bucket que deseas actualizar.
  3. Haz clic en la pestaña Configuración.
  4. En la sección Seguridad, junto al campo Política de retención, haz clic en Editar.
  5. Edita la cantidad de días con un valor superior a la cantidad existente y haz clic en Guardar.

CLI

De forma predeterminada, puedes borrar objetos en cualquier momento. Puedes habilitar el bloqueo de objetos con un período de retención para evitar que se borren todos los objetos del bucket durante la cantidad de días especificada. No puedes borrar un bucket hasta que borres todos los objetos después del período de retención.

Debes habilitar el bloqueo de objetos cuando crees el bucket. No puedes habilitar ni inhabilitar el bloqueo de objetos después de crear un bucket. Sin embargo, puedes modificar el período de retención predeterminado del objeto.

Puedes crear un bucket con o sin habilitar el bloqueo de objetos. Si habilitaste el bloqueo de objetos, especificar un período de retención predeterminado es opcional.

Para modificar el período de retención, actualiza el campo Bucket.spec.buckePolicy.lockingPolicy.defaultObjectRetentionDays en el recurso Bucket.

A continuación, se muestra un ejemplo de cómo actualizar el campo en el recurso Bucket:

apiVersion: object.gdc.goog/v1
kind: Bucket
metadata:
  name: BUCKET_NAME
  namespace: NAMESPACE_NAME
spec:
  description: "This bucket has a default retention period specified."
  storageClass: Standard
  bucketPolicy:
    lockingPolicy:
      defaultObjectRetentionDays: RETENTION_DAY_COUNT
----------
apiVersion: object.gdc.goog/v1
kind: Bucket
metadata:
  name: BUCKET_NAME
  namespace: NAMESPACE_NAME
spec:
  description: "This would enable object locking but not specify a default retention period."
  storageClass: Standard
  bucketPolicy:
    lockingPolicy:
----------
apiVersion: object.gdc.goog/v1
kind: Bucket
metadata:
  name: BUCKET_NAME
  namespace: NAMESPACE_NAME
spec:
  description: "This bucket does not have locking or retention enabled."
  storageClass: Standard

Las actualizaciones del período de retención se aplican a los objetos creados en el bucket después de la actualización. En el caso de los objetos existentes, el período de retención no cambia.

Cuando habilitas el bloqueo de objetos, si intentas reemplazar un objeto, agregas una nueva versión de este. Puedes recuperar ambas versiones del objeto. Para recuperar versiones de objetos, consulta Enumera objetos de almacenamiento.

Para crear un bucket de escritura única y lectura múltiple (WORM), consulta la sección Bucket WORM.