En esta página, se describe cómo usar conservaciones de objetos, incluida la colocación predeterminada de conservaciones en objetos nuevos y en objetos individuales.
Permisos necesarios
Antes de usar esta función en Cloud Storage, debes tener permisos suficientes para ver y actualizar los buckets y objetos en Cloud Storage:
Si eres propietario del proyecto que contiene el bucket, es probable que tengas los permisos necesarios.
Si usas IAM, debes tener los permisos
storage.buckets.update
,storage.buckets.get
,storage.objects.update
ystorage.objects.get
en el bucket correspondiente. Consulta Usa permisos de Cloud IAM para obtener instrucciones sobre como recibir un rol con estos permisos, como el de Administrador de almacenamiento.Si usas las LCA, debes tener permisos de PROPIETARIO en el bucket relevante y en los objetos que contiene. Consulta el documento Configura las LCA para obtener instrucciones sobre cómo hacerlo.
Usa la propiedad de retención predeterminada basada en eventos
En las siguientes tareas, se muestra cómo configurar y ver la propiedad de retención predeterminada basada en eventos en un bucket. Cuando se habilita esta propiedad, los objetos nuevos agregados al bucket obtienen de manera automática una retención basada en eventos.
Configura la propiedad de retención predeterminada basada en eventos
Sigue estos pasos para habilitar o inhabilitar la propiedad de retención predeterminada basada en eventos para un bucket:
Console
- En la consola de Google Cloud, ve a la página Buckets de Cloud Storage.
En la lista de buckets, haz clic en el nombre del bucket en el que deseas establecer la propiedad de retención predeterminada basada en eventos.
Selecciona la pestaña Protección cerca de la parte superior de la página.
El estado actual del bucket aparece en la sección Opción de retención predeterminada basada en eventos.
En la sección Opción de retención predeterminada basada en eventos, haz clic en el estado actual para cambiarla.
El estado aparece como Habilitado o Inhabilitado.
Para obtener información sobre cómo ver detalles de errores acerca de operaciones fallidas de Cloud Storage en la consola de Google Cloud, consulta Solución de problemas.
Línea de comandos
Usa el comando gcloud storage buckets update
con la marca adecuada:
gcloud storage buckets update gs://BUCKET_NAME FLAG
Aquí:
BUCKET_NAME
es el nombre del bucket correspondiente. Por ejemplo,my-bucket
.FLAG
es--default-event-based-hold
para habilitar las conservaciones de objetos predeterminadas basadas en eventos o--no-default-event-based-hold
para inhabilitarlas.
Bibliotecas cliente
C++
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage C++.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
En el siguiente ejemplo, se habilitan las retenciones predeterminadas basadas en eventos en un bucket:
En el siguiente ejemplo, se inhabilitan las retenciones predeterminadas basadas en eventos en un bucket:
C#
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage C#.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
En el siguiente ejemplo, se habilitan las retenciones predeterminadas basadas en eventos en un bucket:
En el siguiente ejemplo, se inhabilitan las retenciones predeterminadas basadas en eventos en un bucket:
Go
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Go.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
En el siguiente ejemplo, se habilitan las retenciones predeterminadas basadas en eventos en un bucket:
En el siguiente ejemplo, se inhabilitan las retenciones predeterminadas basadas en eventos en un bucket:
Java
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Java.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
En el siguiente ejemplo, se habilitan las retenciones predeterminadas basadas en eventos en un bucket:
En el siguiente ejemplo, se inhabilitan las retenciones predeterminadas basadas en eventos en un bucket:
Node.js
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Node.js.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
En el siguiente ejemplo, se habilitan las retenciones predeterminadas basadas en eventos en un bucket:
En el siguiente ejemplo, se inhabilitan las retenciones predeterminadas basadas en eventos en un bucket:
PHP
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage PHP.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
En el siguiente ejemplo, se habilitan las retenciones predeterminadas basadas en eventos en un bucket:
En el siguiente ejemplo, se inhabilitan las retenciones predeterminadas basadas en eventos en un bucket:
Python
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Python.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
En el siguiente ejemplo, se habilitan las retenciones predeterminadas basadas en eventos en un bucket:
En el siguiente ejemplo, se inhabilitan las retenciones predeterminadas basadas en eventos en un bucket:
Ruby
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Ruby.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
En el siguiente ejemplo, se habilitan las retenciones predeterminadas basadas en eventos en un bucket:
En el siguiente ejemplo, se inhabilitan las retenciones predeterminadas basadas en eventos en un bucket:
API de REST
API de JSON
Tener la gcloud CLI instalada e inicializadaa fin de generar un token de acceso para el encabezado
Authorization
.Como alternativa, puedes crear un token de acceso con OAuth 2.0 Playground y, luego, incluirlo en el encabezado
Authorization
.Crea un archivo JSON que contenga la siguiente información:
{ "defaultEventBasedHold": STATE }
En el que STATE es
true
ofalse
.Usa
cURL
para llamar a la API de JSON con una solicitud de bucketPATCH
:curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=defaultEventBasedHold"
Aquí:
JSON_FILE_NAME
es la ruta de acceso del archivo que creaste en el paso 2.BUCKET_NAME
es el nombre del bucket correspondiente. Por ejemplo,my-bucket
API de XML
La API de XML no se puede usar para trabajar con conservaciones de objetos. En su lugar, usa una de las otras herramientas de Cloud Storage, como gcloud CLI.
Obtén el estado de retención predeterminado de un bucket
Sigue los pasos a continuación para ver si un bucket coloca retenciones basadas en eventos en objetos nuevos de forma predeterminada:
Console
- En la consola de Google Cloud, ve a la página Buckets de Cloud Storage.
En la lista de buckets, haz clic en el nombre del bucket del que quieras verificar el estado predeterminado basado en eventos.
Selecciona la pestaña Protección cerca de la parte superior de la página.
El estado aparece en la sección Opción de retención basada en eventos de forma predeterminada.
Para obtener información sobre cómo ver detalles de errores acerca de operaciones fallidas de Cloud Storage en la consola de Google Cloud, consulta Solución de problemas.
Línea de comandos
Usa el comando gcloud storage buckets describe
con la marca --format
:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(default_event_based_hold)"
En el ejemplo anterior, BUCKET_NAME
es el nombre del bucket cuyo estado deseas ver. Por ejemplo, my-bucket
Si se realiza de forma correcta, la respuesta se verá como el ejemplo siguiente:
default_event_based_hold: true
Bibliotecas cliente
C++
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage C++.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
C#
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage C#.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Go.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Java.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Node.js.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
PHP
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage PHP.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Python.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Ruby.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
APIs de REST
API de JSON
Tener la gcloud CLI instalada e inicializadaa fin de generar un token de acceso para el encabezado
Authorization
.Como alternativa, puedes crear un token de acceso con OAuth 2.0 Playground y, luego, incluirlo en el encabezado
Authorization
.Usa
cURL
para llamar a la API de JSON con una solicitud de bucketGET
que incluya losfields
deseados:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=defaultEventBasedHold"
En el que
BUCKET_NAME
es el nombre del bucket correspondiente. Por ejemplo,my-bucket
.Si el bucket tiene habilitada una conservación predeterminada basada en eventos, la respuesta se parece al siguiente ejemplo:
{ "defaultEventBasedHold": true }
API de XML
La API de XML no se puede usar para trabajar con conservaciones de objetos. En su lugar, usa una de las otras herramientas de Cloud Storage, como gcloud CLI.
Administra conservaciones de objetos individuales
En las siguientes tareas, se muestra cómo modificar y ver conservaciones en los objetos individuales.
Coloca o libera una conservación de objeto
Sigue los pasos a continuación para colocar o liberar una conservación en un objeto en tu bucket:
Console
- En la consola de Google Cloud, ve a la página Buckets de Cloud Storage.
En la lista de buckets, haz clic en el nombre del bucket que contiene los objetos en los que deseas colocar o liberar conservaciones.
Selecciona la casilla de verificación junto a los nombres de los objetos en los que deseas colocar o liberar conservaciones.
Haz clic en el botón Administrar retenciones.
Aparecerá la ventana Administrar retenciones.
Activa o desactiva las casillas de verificación de cada tipo de conservación como desees.
Haz clic en Guardar configuración de conservación.
Para obtener información sobre cómo ver detalles de errores acerca de operaciones fallidas de Cloud Storage en la consola de Google Cloud, consulta Solución de problemas.
Línea de comandos
Usa el comando gcloud storage objects update
con la marca adecuada:
gcloud storage objects update gs://BUCKET_NAME/OBJECT_NAME FLAG
Aquí:
BUCKET_NAME
es el nombre del bucket correspondiente. Por ejemplo,my-bucket
.OBJECT_NAME
es el nombre del objeto pertinente. Por ejemplo,pets/dog.png
FLAG
es una de las siguientes opciones:--event-based-hold
para habilitar una conservación basada en eventos en el objeto--no-event-based-hold
para inhabilitar cualquier conservación basada en eventos en el objeto--temporary-hold
para habilitar una conservación temporal en el objeto.--no-temporary-hold
para inhabilitar cualquier conservación temporal en el objeto
Consulta Conservaciones de objetos para obtener más información sobre los tipos de conservación.
Bibliotecas cliente
C++
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage C++.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
El siguiente ejemplo configura una retención basada en eventos en un objeto:
El siguiente ejemplo libera una retención basada en eventos en un objeto:
El siguiente ejemplo configura una retención temporal en un objeto:
El siguiente ejemplo libera una retención temporal en un objeto:
C#
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage C#.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
El siguiente ejemplo configura una retención basada en eventos en un objeto:
El siguiente ejemplo libera una retención basada en eventos en un objeto:
El siguiente ejemplo configura una retención temporal en un objeto:
El siguiente ejemplo libera una retención temporal en un objeto:
Go
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Go.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
El siguiente ejemplo configura una retención basada en eventos en un objeto:
El siguiente ejemplo libera una retención basada en eventos en un objeto:
El siguiente ejemplo configura una retención temporal en un objeto:
El siguiente ejemplo libera una retención temporal en un objeto:
Java
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Java.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
El siguiente ejemplo configura una retención basada en eventos en un objeto:
El siguiente ejemplo libera una retención basada en eventos en un objeto:
El siguiente ejemplo configura una retención temporal en un objeto:
El siguiente ejemplo libera una retención temporal en un objeto:
Node.js
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Node.js.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
El siguiente ejemplo configura una retención basada en eventos en un objeto:
El siguiente ejemplo libera una retención basada en eventos en un objeto:
El siguiente ejemplo configura una retención temporal en un objeto:
El siguiente ejemplo libera una retención temporal en un objeto:
PHP
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage PHP.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
El siguiente ejemplo configura una retención basada en eventos en un objeto:
El siguiente ejemplo libera una retención basada en eventos en un objeto:
El siguiente ejemplo configura una retención temporal en un objeto:
El siguiente ejemplo libera una retención temporal en un objeto:
Python
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Python.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
El siguiente ejemplo configura una retención basada en eventos en un objeto:
El siguiente ejemplo libera una retención basada en eventos en un objeto:
El siguiente ejemplo configura una retención temporal en un objeto:
El siguiente ejemplo libera una retención temporal en un objeto:
Ruby
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Ruby.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
El siguiente ejemplo configura una retención basada en eventos en un objeto:
El siguiente ejemplo libera una retención basada en eventos en un objeto:
El siguiente ejemplo configura una retención temporal en un objeto:
El siguiente ejemplo libera una retención temporal en un objeto:
API de REST
API de JSON
Tener la gcloud CLI instalada e inicializadaa fin de generar un token de acceso para el encabezado
Authorization
.Como alternativa, puedes crear un token de acceso con OAuth 2.0 Playground y, luego, incluirlo en el encabezado
Authorization
.Crea un archivo JSON que contenga la siguiente información:
{ "HOLD_TYPE": STATE }
Aquí:
HOLD_TYPE
es el tipo de conservación que quieres establecer o liberar en tu objeto. Por ejemplo,temporaryHold
oeventBasedHold
. Consulta Conservaciones de objetos para obtener más información sobre los tipos de conservación.STATE
estrue
para colocar la conservación ofalse
para liberar la conservación.
Usa
cURL
para llamar a la API de JSON con una solicitud de objetoPATCH
:curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME"
Aquí:
JSON_FILE_NAME
es la ruta de acceso del archivo que creaste en el paso 2.BUCKET_NAME
es el nombre del bucket correspondiente. Por ejemplo,my-bucket
.OBJECT_NAME
es el nombre codificado en URL del objeto relevante. Por ejemplo,pets/dog.png
, codificado en URL comopets%2Fdog.png
.
API de XML
La API de XML no se puede usar para trabajar con conservaciones de objetos. En su lugar, usa una de las otras herramientas de Cloud Storage, como gcloud CLI.
Obtén el estado de conservación de un objeto
A fin de ver si alguna retención existe en un objeto, sigue las instrucciones generales para ver metadatos de objeto.
¿Qué sigue?
- Obtén más información sobre las retenciones de objetos, incluidos los diferentes tipos de retenciones que puede tener un objeto.
- Aprende a usar las políticas de retención.
- Aprende a usar condiciones previas de solicitud para evitar las condiciones de carrera.