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.
Requisitos
Antes de usar esta función en Cloud Storage, debes realizar las siguientes acciones:
Tener suficiente permiso para ver y actualizar los depósitos y objetos en Cloud Storage:
Si propietario del proyecto que contiene el bucket, es probable que tengas los permisos necesarios.
Si usas IAM, debes tener permisos
storage.buckets.update
,storage.buckets.get
,storage.objects.update
ystorage.objects.get
en el depósito correspondiente. Consulta Usa permisos de Cloud IAM a fin de obtener instrucciones para recibir una función con estos permisos, como Administrador de almacenamiento.Si usas las LCA, debes tener permisos de PROPIETARIO en el bucket relevante y en los objetos que contiene. Consulta Configura las LCA para obtener instrucciones sobre cómo realizar esto.
Trabaja con la propiedad de retención predeterminada basada en eventos
En las siguientes tareas, se muestra cómo habilitar, inhabilitar y ver la propiedad de retención predeterminada basada en eventos en un depósito. Cuando se habilita esta propiedad, los objetos nuevos agregados al bucket obtienen de manera automática una retención basada en eventos.
Habilita la propiedad de retención predeterminada basada en eventos
Sigue los pasos a continuación para colocar automáticamente una retención basada en eventos en cada objeto nuevo agregado a un grupo:
Console
- Abre el navegador de Cloud Storage en Google Cloud Console.
Abrir el navegador de Cloud Storage En la lista de bucket s, haz clic en el nombre del bucket en el que deseas habilitar la propiedad predeterminada de conservación basada en eventos.
Selecciona la pestaña Retención cerca de la parte superior de la página.
En la sección Opción de retención predeterminada basada en eventos, haz clic en el botón Inhabilitada.
Si se ejecuta de forma correcta, el botón cambiará a Habilitada.
Consulta Solución de problemas para obtener información detallada sobre las operaciones fallidas en el navegador de Cloud Storage.
gsutil
Usa el comando gsutil retention event-default set
:
gsutil retention event-default set gs://BUCKET_NAME
En el ejemplo anterior, BUCKET_NAME
es el nombre del depósito correspondiente. Por ejemplo, my-bucket
.
Muestras de código
C++
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para C++.
C#
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para C#.
Go
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Go.
Java
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Java.
Node.js
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Node.js.
PHP
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para PHP.
Python
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Python.
Ruby
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Ruby.
API de REST
API de JSON
- Obtén un token de acceso de autorización de OAuth 2.0 Playground. Configura Playground para usar tus credenciales de OAuth.
Crea un archivo .json que contenga la siguiente información:
{ "defaultEventBasedHold": true }
Usa
cURL
para llamar a la API de JSON con una solicitud de bucketPATCH
:curl -X PATCH --data-binary @JSON_FILE_NAME.json \ -H "Authorization: Bearer OAUTH2_TOKEN" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=defaultEventBasedHold"
Donde:
JSON_FILE_NAME
es el nombre del archivo que creaste en el paso 2.OAUTH2_TOKEN
es el token de acceso que generaste en el paso 1.BUCKET_NAME
es el nombre del depósito correspondiente. Por ejemplo,my-bucket
.
API de XML
La API de XML no se puede usar para trabajar con conservaciones de objetos. Usa una de las otras herramientas de Cloud Storage, como gsutil, en su lugar.
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
- Abre el navegador de Cloud Storage en Google Cloud Console.
Abrir el navegador de Cloud Storage En la lista de bucket s, haz clic en el nombre del bucket del que quieras verificar el estado predeterminado basado en eventos.
Selecciona la pestaña Retenció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.
Consulta Solución de problemas para obtener información detallada sobre las operaciones fallidas en el navegador de Cloud Storage.
gsutil
Usa el siguiente comando gsutil ls
:
gsutil ls -L -b gs://BUCKET_NAME
En el que BUCKET_NAME
es el nombre del bucket correspondiente. Por ejemplo, my-bucket
.
La respuesta se ve como el siguiente ejemplo:
gs://my-bucket/ : Storage class: STANDARD ... ... Default Event-Based Hold: True ...
Si el bucket no coloca conservaciones basadas en eventos en objetos nuevos de forma predeterminada, gsutil omite Default Event-Based Hold
por completo del resultado.
Muestras de código
C++
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para C++.
C#
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para C#.
Go
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Go.
Java
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Java.
Node.js
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Node.js.
PHP
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para PHP.
Python
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Python.
Ruby
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Ruby.
API de REST
API de JSON
- Obtén un token de acceso de autorización de OAuth 2.0 Playground. Configura Playground para usar tus credenciales de OAuth.
Usa
cURL
para llamar a la API de JSON con una solicitud de bucketGET
que incluya losfields
deseados:curl -X GET -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=defaultEventBasedHold"
En la que
OAUTH2_TOKEN
es el token de acceso que generaste en el paso 1.BUCKET_NAME
es el nombre del depósito correspondiente. Por ejemplo,my-bucket
.
Si el bucket tiene habilitada una conservación predeterminada basada en eventos, la respuesta se parece al siguiente ejemplo:
{ "retentionPolicy": true }
API de XML
La API de XML no se puede usar para trabajar con conservaciones de objetos. Usa una de las otras herramientas de Cloud Storage, como gsutil, en su lugar.
Inhabilita una retención predeterminada basada en eventos
Sigue los pasos a continuación para inhabilitar una retención basada en eventos predetermina en un bucket:
Console
- Abre el navegador de Cloud Storage en Google Cloud Console.
Abrir el navegador de Cloud Storage En la lista de bucket s, haz clic en el nombre del bucket en el que deseas inhabilitar la propiedad de retención predeterminada basada en eventos.
Selecciona la pestaña Retención cerca de la parte superior de la página.
En la sección Opción de retención basada en eventos de forma predeterminada, haz clic en el botón Habilitada.
Si se ejecuta de forma correcta, el botón cambiará a Inhabilitada.
Consulta Solución de problemas para obtener información detallada sobre las operaciones fallidas en el navegador de Cloud Storage.
gsutil
Usa el comando gsutil retention event-default release
:
gsutil retention event-default release gs://BUCKET_NAME
En el ejemplo anterior, BUCKET_NAME
es el nombre del depósito correspondiente. Por ejemplo, my-bucket
.
Muestras de código
C++
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para C++.
C#
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para C#.
Go
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Go.
Java
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Java.
Node.js
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Node.js.
PHP
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para PHP.
Python
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Python.
Ruby
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Ruby.
API de REST
API de JSON
- Obtén un token de acceso de autorización de OAuth 2.0 Playground. Configura Playground para usar tus credenciales de OAuth.
Crea un archivo .json que contenga la siguiente información:
{ "defaultEventBasedHold": false }
Usa
cURL
para llamar a la API de JSON con una solicitud de bucketPATCH
:curl -X PATCH --data-binary @JSON_FILE_NAME.json \ -H "Authorization: Bearer OAUTH2_TOKEN" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=defaultEventBasedHold"
Donde:
JSON_FILE_NAME
es el nombre del archivo que creaste en el paso 2.OAUTH2_TOKEN
es el token de acceso que generaste en el paso 1.BUCKET_NAME
es el nombre del depósito correspondiente. Por ejemplo,my-bucket
.
API de XML
La API de XML no se puede usar para trabajar con conservaciones de objetos. Usa una de las otras herramientas de Cloud Storage, como gsutil, en su lugar.
Trabaja con retenciones de objetos
Las siguientes tareas te muestran cómo colocar, ver y liberar retenciones en los objetos.
Coloca una retención de objetos
Sigue los pasos a continuación para colocar una retención en un objeto en tu bucket:
Console
- Abre el navegador de Cloud Storage en Google Cloud Console.
Abrir el navegador de Cloud Storage En la lista de bucket s, haz clic en el nombre del bucket que contiene los objetos a los que quieras colocar en conservación.
Selecciona la casilla de verificación junto a los nombres de los objetos que quieras colocar en retención.
Haz clic en el botón Administrar retenciones.
Aparecerá la ventana Administrar retenciones.
Selecciona la casilla de verificación para los tipos de retenciones que quieras colocar en los objetos seleccionados
Haz clic en Guardar configuración de retención.
Consulta Solución de problemas para obtener información detallada sobre las operaciones fallidas en el navegador de Cloud Storage.
gsutil
Usa el comando gsutil retention
:
gsutil retention HOLD_TYPE set gs://BUCKET_NAME/OBJECT_NAME
Aquí:
HOLD_TYPE
es el tipo de conservación que quieres aplicar a tu objeto. Por ejemplo,temp
oevent
. Consulta Conservaciones de objetos para obtener más información sobre los tipos de conservación.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
.
Muestras de código
C++
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para C++.
El siguiente ejemplo configura una retención basada en eventos en un objeto:
El siguiente ejemplo configura 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 para C#.
El siguiente ejemplo configura una retención basada en eventos en un objeto:
El siguiente ejemplo configura 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 para Go.
El siguiente ejemplo configura una retención basada en eventos en un objeto:
El siguiente ejemplo configura 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 para Java.
El siguiente ejemplo configura una retención basada en eventos en un objeto:
El siguiente ejemplo configura 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 para Node.js.
El siguiente ejemplo configura una retención basada en eventos en un objeto:
El siguiente ejemplo configura 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 para PHP.
El siguiente ejemplo configura una retención basada en eventos en un objeto:
El siguiente ejemplo configura 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 para Python.
El siguiente ejemplo configura una retención basada en eventos en un objeto:
El siguiente ejemplo configura 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 para Ruby.
El siguiente ejemplo configura una retención basada en eventos en un objeto:
El siguiente ejemplo configura una retención temporal en un objeto:
API de REST
API de JSON
- Obtén un token de acceso de autorización de OAuth 2.0 Playground. Configura Playground para usar tus credenciales de OAuth.
Crea un archivo .json que contenga la siguiente información:
{ "HOLD_TYPE": true }
en el que
HOLD_TYPE
es el tipo de conservación que quieres aplicar a tu objeto. Por ejemplo,temporaryHold
oeventBasedHold
. Consulta Conservaciones de objetos para obtener más información sobre los tipos de conservación.Usa
cURL
para llamar a la API de JSON con una solicitud de objetoPATCH
:curl -X PATCH --data-binary @JSON_FILE_NAME.json \ -H "Authorization: Bearer OAUTH2_TOKEN" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME"
En la que:
JSON_FILE_NAME
es el nombre del archivo que creaste en el paso 2.OAUTH2_TOKEN
es el token de acceso que generaste en el paso 1.BUCKET_NAME
es el nombre del depósito correspondiente. Por ejemplo,my-bucket
.OBJECT_NAME
es el nombre del objeto pertinente. Por ejemplo,pets/dog.png
.
API de XML
La API de XML no se puede usar para trabajar con conservaciones de objetos. Usa una de las otras herramientas de Cloud Storage, como gsutil, en su lugar.
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.
Libera una retención de objeto
Sigue los pasos a continuación para liberar una retención de un objeto en tu bucket:
Console
- Abre el navegador de Cloud Storage en Google Cloud Console.
Abrir el navegador de Cloud Storage En la lista de bucket s, haz clic en el nombre del bucket que contiene los objetos a los que les quieres liberar las conservaciones.
Selecciona la casilla de verificación junto a los nombres de los objetos a los que quieras quitarles las retenciones.
Haz clic en el botón Administrar retenciones.
Aparecerá la ventana Administrar conservaciones.
Desmarca la casilla de verificación de las retenciones que quieras quitar.
Haz clic en Guardar configuración de retención.
Consulta Solución de problemas para obtener información detallada sobre las operaciones fallidas en el navegador de Cloud Storage.
gsutil
Usa el comando gsutil retention
:
gsutil retention HOLD_TYPE release gs://BUCKET_NAME/OBJECT_NAME
Aquí:
HOLD_TYPE
es el tipo de conservación que quieres liberar del objeto. Por ejemplo,temp
oevent
. Consulta Conservaciones de objetos para obtener más información sobre los tipos de conservación.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
.
Muestras de código
C++
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para C++.
El siguiente ejemplo configura una retención basada en eventos en un objeto:
El siguiente ejemplo configura 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 para C#.
El siguiente ejemplo libera una retención basada en eventos 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 para Go.
El siguiente ejemplo libera una retención basada en eventos 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 para Java.
El siguiente ejemplo libera una retención basada en eventos 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 para Node.js.
El siguiente ejemplo libera una retención basada en eventos 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 para PHP.
El siguiente ejemplo libera una retención basada en eventos 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 para Python.
El siguiente ejemplo libera una retención basada en eventos 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 para Ruby.
El siguiente ejemplo libera una retención basada en eventos en un objeto:
El siguiente ejemplo libera una retención temporal en un objeto:
API de REST
API de JSON
- Obtén un token de acceso de autorización de OAuth 2.0 Playground. Configura Playground para usar tus credenciales de OAuth.
Crea un archivo .json que contenga la siguiente información:
{ "HOLD_TYPE": false }
en el que
HOLD_TYPE
es el tipo de conservación que quieres liberar del objeto. Por ejemplo,temporaryHold
oeventBasedHold
. Consulta Conservaciones de objetos para obtener más información sobre los tipos de conservación.Usa
cURL
para llamar a la API de JSON con una solicitud de objetoPATCH
:curl -X PATCH --data-binary @JSON_FILE_NAME.json \ -H "Authorization: Bearer OAUTH2_TOKEN" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME"
En la que:
JSON_FILE_NAME
es el nombre del archivo que creaste en el paso 2.OAUTH2_TOKEN
es el token de acceso que generaste en el paso 1.BUCKET_NAME
es el nombre del depósito correspondiente. Por ejemplo,my-bucket
.OBJECT_NAME
es el nombre del objeto pertinente. Por ejemplo,pets/dog.png
.
API de XML
La API de XML no se puede usar para trabajar con conservaciones de objetos. Usa una de las otras herramientas de Cloud Storage, como gsutil, en su lugar.
¿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.