Usa el control de versiones de objetos

Ir a los conceptos

En esta página, se describe cómo configurar el control de versiones de objetos y se dan ejemplos sobre su uso.

Configura el control de versiones de objetos

En las próximas secciones, se muestra cómo activar y desactivar el control de versiones de objetos mediante la herramienta de gsutil, la API de JSON y la API de XML. En la actualidad, el control de versiones de objetos no se puede controlar mediante Google Cloud Console.

Habilita el control de versiones de objetos

Nota: El control de versiones de los objetos no se puede habilitar en un depósito que tiene una política de retención en la actualidad.

Para habilitar el control de versiones de objetos en un depósito, sigue estos pasos:

gsutil

Usa el comando gsutil versioning set on:

gsutil versioning set on gs://[BUCKET_NAME]

Donde [BUCKET_NAME] es el nombre del depósito pertinente. 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++.

Ver en GitHub Comentarios

namespace gcs = google::cloud::storage;
using ::google::cloud::StatusOr;
[](gcs::Client client, std::string const& bucket_name) {
  StatusOr<gcs::BucketMetadata> original =
      client.GetBucketMetadata(bucket_name);
  if (!original) throw std::runtime_error(original.status().message());

  StatusOr<gcs::BucketMetadata> patched = client.PatchBucket(
      bucket_name,
      gcs::BucketMetadataPatchBuilder().SetVersioning(
          gcs::BucketVersioning{true}),
      gcs::IfMetagenerationMatch(original->metageneration()));
  if (!patched) throw std::runtime_error(patched.status().message());

  if (patched->versioning().has_value()) {
    std::cout << "Object versioning for bucket " << bucket_name << " is "
              << (patched->versioning()->enabled ? "enabled" : "disabled")
              << "\n";
  } else {
    std::cout << "Object versioning for bucket " << bucket_name
              << " is disabled.\n";
  }
}

Java

Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Java.

Ver en GitHub Comentarios

import com.google.cloud.storage.Bucket;
import com.google.cloud.storage.Storage;
import com.google.cloud.storage.StorageOptions;

public class EnableBucketVersioning {
  public static void enableBucketVersioning(String projectId, String bucketName) {
    // The ID of your GCP project
    // String projectId = "your-project-id";

    // The ID of your GCS bucket
    // String bucketName = "your-unique-bucket-name";

    Storage storage = StorageOptions.newBuilder().setProjectId(projectId).build().getService();
    Bucket bucket = storage.get(bucketName);
    bucket.toBuilder().setVersioningEnabled(true).build().update();

    System.out.println("Versioning is now enabled for bucket " + bucketName);
  }
}

API de REST

API de JSON

1. Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus credenciales de OAuth.

2. Crea un archivo .json que contenga la siguiente información:

   {
     "versioning": {
       "enabled": true
     }
   }

3. Usa cURL para llamar a la API de JSON con una solicitud de depósito PATCH:

   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=versioning"

   En el ejemplo anterior, se ilustra lo siguiente:

   • [JSON_FILE_NAME] es el archivo que creaste en el paso 2.
   • [OAUTH2_TOKEN] es el token de acceso que creaste en el paso 1.
   • [BUCKET_NAME] es el nombre del depósito relevante. Por ejemplo, my-bucket.

API de XML

1. Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus propias credenciales de OAuth.

2. Crea un archivo .xml que contenga la siguiente información:

   <VersioningConfiguration>
     <Status>Enabled</Status>
   </VersioningConfiguration>

3. Usa cURL para llamar a la API de XML con una solicitud de depósito PUT y el parámetro de string de consulta versioning:

   curl -X PUT --data-binary @[XML_FILE_NAME].xml \
     -H "Authorization: Bearer [OAUTH2_TOKEN]" \
     "https://storage.googleapis.com/[BUCKET_NAME]?versioning"

   En el ejemplo anterior, se ilustra lo siguiente:

   • [XML_FILE_NAME] es el archivo que creaste en el paso 2.
   • [OAUTH2_TOKEN] es el token de acceso que creaste en el paso 1.
   • [BUCKET_NAME] es el nombre del depósito relevante. Por ejemplo, my-bucket.

Una vez que el control de versiones de objetos está habilitado, Cloud Storage crea una versión no actual de un objeto cada vez que se reemplaza o borra la versión publicada del objeto.

Inhabilita el control de versiones de objetos

Sigue los pasos a continuación para inhabilitar el control de versiones de objetos en un depósito:

gsutil

Usa el comando gsutil versioning set off:

gsutil versioning set off gs://[BUCKET_NAME]

Donde [BUCKET_NAME] es el nombre del depósito pertinente. 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++.

Ver en GitHub Comentarios

namespace gcs = google::cloud::storage;
using ::google::cloud::StatusOr;
[](gcs::Client client, std::string const& bucket_name) {
  StatusOr<gcs::BucketMetadata> original =
      client.GetBucketMetadata(bucket_name);
  if (!original) throw std::runtime_error(original.status().message());

  StatusOr<gcs::BucketMetadata> patched = client.PatchBucket(
      bucket_name,
      gcs::BucketMetadataPatchBuilder().SetVersioning(
          gcs::BucketVersioning{false}),
      gcs::IfMetagenerationMatch(original->metageneration()));
  if (!patched) throw std::runtime_error(patched.status().message());

  if (patched->versioning().has_value()) {
    std::cout << "Object versioning for bucket " << bucket_name << " is "
              << (patched->versioning()->enabled ? "enabled" : "disabled")
              << "\n";
  } else {
    std::cout << "Object versioning for bucket " << bucket_name
              << " is disabled.\n";
  }
}

Java

Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Java.

Ver en GitHub Comentarios

import com.google.cloud.storage.Bucket;
import com.google.cloud.storage.Storage;
import com.google.cloud.storage.StorageOptions;

public class DisableBucketVersioning {
  public static void disableBucketVersioning(String projectId, String bucketName) {
    // The ID of your GCP project
    // String projectId = "your-project-id";

    // The ID of your GCS bucket
    // String bucketName = "your-unique-bucket-name";

    Storage storage = StorageOptions.newBuilder().setProjectId(projectId).build().getService();
    Bucket bucket = storage.get(bucketName);
    bucket.toBuilder().setVersioningEnabled(false).build().update();

    System.out.println("Versioning is now disabled for bucket " + bucketName);
  }
}

API de REST

API de JSON

1. Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus credenciales de OAuth.

2. Crea un archivo .json que contenga la siguiente información:

   {
     "versioning": {
       "enabled": false
     }
   }

3. Usa cURL para llamar a la API de JSON con una solicitud de depósito PATCH:

   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=versioning"

   En el ejemplo anterior, se ilustra lo siguiente:

   • [JSON_FILE_NAME] es el archivo que creaste en el paso 2.
   • [OAUTH2_TOKEN] es el token de acceso que creaste en el paso 1.
   • [BUCKET_NAME] es el nombre del depósito relevante. Por ejemplo, my-bucket.

API de XML

1. Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus propias credenciales de OAuth.

2. Crea un archivo .xml que contenga la siguiente información:

   <VersioningConfiguration>
     <Status>Suspended</Status>
   </VersioningConfiguration>

3. Usa cURL para llamar a la API de XML con una solicitud de depósito PUT y el parámetro de string de consulta versioning:

   curl -X PUT --data-binary @[XML_FILE_NAME].xml \
     -H "Authorization: Bearer [OAUTH2_TOKEN]" \
     "https://storage.googleapis.com/[BUCKET_NAME]?versioning"

   En el ejemplo anterior, se ilustra lo siguiente:

   • [XML_FILE_NAME] es el archivo que creaste en el paso 2.
   • [OAUTH2_TOKEN] es el token de acceso que creaste en el paso 1.
   • [BUCKET_NAME] es el nombre del depósito relevante. Por ejemplo, my-bucket.

Comprueba si el control de versiones de objetos está habilitado

Sigue los pasos a continuación para comprobar si el control de versiones de objetos está habilitado en un depósito:

gsutil

Usa el comando gsutil versioning get:

gsutil versioning get gs://[BUCKET_NAME]

Donde [BUCKET_NAME] es el nombre del depósito pertinente. Por ejemplo, my-bucket.

Si el control de versiones de objetos está habilitado, la respuesta es similar a la siguiente:

gs://[BUCKET_NAME]: Enabled

API de REST

API de JSON

1. Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus propias credenciales de OAuth.

2. Usa cURL para llamar a la API de JSON con una solicitud de depósito GET:

   curl -X GET \
     -H "Authorization: Bearer [OAUTH2_TOKEN]" \
     "https://storage.googleapis.com/storage/v1/b/[BUCKET_NAME]?fields=versioning"

   En el ejemplo anterior, se ilustra lo siguiente:

   • [OAUTH2_TOKEN] es el token de acceso que creaste en el paso 1.
   • [BUCKET_NAME] es el nombre del depósito relevante. Por ejemplo, my-bucket.

API de XML

1. Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus propias credenciales de OAuth.

2. Usa cURL para llamar a la API de XML con una solicitud de depósito GET y el parámetro de string de consulta versioning:

   curl -X GET \
     -H "Authorization: Bearer [OAUTH2_TOKEN]" \
     "https://storage.googleapis.com/[BUCKET_NAME]?versioning"

   En el ejemplo anterior, se ilustra lo siguiente:

   • [OAUTH2_TOKEN] es el token de acceso que creaste en el paso 1.
   • [BUCKET_NAME] es el nombre del depósito relevante. Por ejemplo, my-bucket.

Trabaja con el control de versiones de objetos

En las siguientes secciones, se muestra cómo trabajar con el control de versiones de objetos. Para obtener un ejemplo detallado de cómo trabajar con el control de versiones de objetos, consulta Ejemplo de control de versiones de objetos.

Enumera las versiones no actuales de objetos

Para enumerar las versiones publicadas y no actuales de un objeto y ver sus números de generation, haz lo siguiente:

gsutil

Usa el comando gsutil ls -a:

gsutil ls -a gs://[BUCKET_NAME]

Donde [BUCKET_NAME] es el nombre del depósito pertinente. Por ejemplo, my-bucket.

La respuesta se ve como el siguiente ejemplo:

gs://[BUCKET_NAME]/[OBJECT_NAME1]#[GENERATION_NUMBER1]
gs://[BUCKET_NAME]/[OBJECT_NAME1]#[GENERATION_NUMBER2]
gs://[BUCKET_NAME]/[OBJECT_NAME1]#[GENERATION_NUMBER3]
...

Nota: Usa las marcas -l y -a para obtener números de metageneración en la respuesta. Usa las marcas -L y -a para obtener el Noncurrent Time de las versiones no actuales de un objeto.

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

Ver en GitHub Comentarios

namespace gcs = google::cloud::storage;
[](gcs::Client client, std::string const& bucket_name) {
  for (auto&& object_metadata :
       client.ListObjects(bucket_name, gcs::Versions{true})) {
    if (!object_metadata) {
      throw std::runtime_error(object_metadata.status().message());
    }

    std::cout << "bucket_name=" << object_metadata->bucket()
              << ", object_name=" << object_metadata->name()
              << ", generation=" << object_metadata->generation() << "\n";
  }
}

Java

Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Java.

Ver en GitHub Comentarios

import com.google.api.gax.paging.Page;
import com.google.cloud.storage.Blob;
import com.google.cloud.storage.Bucket;
import com.google.cloud.storage.Storage;
import com.google.cloud.storage.StorageOptions;

public class ListObjectsWithOldVersions {
  public static void listObjectsWithOldVersions(String projectId, String bucketName) {
    // The ID of your GCP project
    // String projectId = "your-project-id";

    // The ID of your GCS bucket
    // String bucketName = "your-unique-bucket-name";
    Storage storage = StorageOptions.newBuilder().setProjectId(projectId).build().getService();
    Bucket bucket = storage.get(bucketName);
    Page<Blob> blobs = bucket.list(Storage.BlobListOption.versions(true));

    for (Blob blob : blobs.iterateAll()) {
      System.out.println(blob.getName() + "," + blob.getGeneration());
    }
  }
}

API de REST

API de JSON

1. Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus propias credenciales de OAuth.

2. Usa cURL para llamar a la API de JSON con una solicitud de objeto LIST:

   curl -X GET \
     -H "Authorization: Bearer [OAUTH2_TOKEN]" \
     "https://storage.googleapis.com/storage/v1/b/[BUCKET_NAME]/o?versions=true"

   En el ejemplo anterior, se ilustra lo siguiente:

   • [OAUTH2_TOKEN] es el token de acceso que creaste en el paso 1.
   • [BUCKET_NAME] es el nombre del depósito relevante. Por ejemplo, my-bucket.

Las versiones no actuales de objetos tienen una propiedad timeDeleted.

API de XML

1. Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus propias credenciales de OAuth.

2. Usa cURL para llamar a la API de XML con una solicitud de depósito GET y el parámetro de string de consulta versions:

   curl -X GET \
     -H "Authorization: Bearer [OAUTH2_TOKEN]" \
     "https://storage.googleapis.com/[BUCKET_NAME]?versions"

   En el ejemplo anterior, se ilustra lo siguiente:

   • [OAUTH2_TOKEN] es el token de acceso que creaste en el paso 1.
   • [BUCKET_NAME] es el nombre del depósito relevante. Por ejemplo, my-bucket.

Hay algunas diferencias en los resultados de la solicitud GET cuando se usa el parámetro de consulta versions. En particular, Cloud Storage muestra la siguiente información cuando incluyes un parámetro de consulta versions en la solicitud:

• Un elemento Version que contiene información sobre cada objeto.
• Un elemento DeletedTime que contiene la hora en que una versión de objeto se convirtió en no actual (se borró o se reemplazó).
• Un elemento IsLatest que indica si el objeto especificado es la última versión.
• Se muestra un elemento NextGenerationMarker si la lista de objetos es parcial, lo que ocurre cuando tienes muchas versiones de objetos en un depósito. Usa el valor de este elemento en el parámetro de consulta generationmarker de las solicitudes posteriores para reanudar desde el último punto. El parámetro de consulta generationmarker se usa de la misma manera que se usa el parámetro marker para navegar por una lista de un depósito sin control de versiones.

Accede a las versiones no actuales de objetos

Para usar la versión no actual de un objeto cuando realizas tareas como descargar el objeto, ver sus metadatos o actualizar sus metadatos, haz lo siguiente:

gsutil

1. Agrega el número de generation de la versión no actual al nombre del objeto:

   [OBJECT_NAME]#[GENERATION_NUMBER]

   En el ejemplo anterior, se ilustra lo siguiente:

   • [OBJECT_NAME] es el nombre de la versión no actual. Por ejemplo, pets/dog.png.
   • [GENERATION_NUMBER] es el número de generación de la versión no actual. Por ejemplo, 1560468815691234.

2. Con la string del paso 1, procede como lo harías con la versión publicada del objeto.

API de REST

API de JSON

1. Agrega el número de generation de la versión no actual al URI del objeto:

   https://storage.googleapis.com/storage/v1/b/[BUCKET_NAME]/o/[OBJECT_NAME]?generation=[GENERATION_NUMBER]

   En el ejemplo anterior, se ilustra lo siguiente:

   • [BUCKET_NAME] es el nombre del depósito que contiene la versión no actual. Por ejemplo, my-bucket.
   • [OBJECT_NAME] es el nombre de la versión no actual. Por ejemplo, pets/dog.png.
   • [GENERATION_NUMBER] es el número de generación de la versión no actual. Por ejemplo, 1560468815691234.

2. Con el URI del paso 1, procede como lo harías con la versión publicada del objeto.

API de XML

1. Agrega el número de generation de la versión no actual al URI del objeto:

   https://storage.googleapis.com/[BUCKET_NAME]/[OBJECT_NAME]?generation=[GENERATION_NUMBER]

   En el ejemplo anterior, se ilustra lo siguiente:

   • [BUCKET_NAME] es el nombre del depósito que contiene la versión no actual. Por ejemplo, my-bucket.
   • [OBJECT_NAME] es el nombre de la versión no actual. Por ejemplo, pets/dog.png.
   • [GENERATION_NUMBER] es el número de generación de la versión no actual. Por ejemplo, 1560468815691234.

2. Con el URI del paso 1, procede como lo harías con la versión publicada del objeto.

Copia las versiones no actuales de objetos

Para copiar una versión no actual de un objeto, haz lo siguiente:

gsutil

Usa el comando gsutil cp:

gsutil cp gs://[SOURCE_BUCKET_NAME]/[SOURCE_OBJECT_NAME]#[GENERATION_NUMBER] gs://[DESTINATION_BUCKET_NAME]/[DESTINATION_OBJECT_NAME]

En el ejemplo anterior, se ilustra lo siguiente:

• [SOURCE_BUCKET_NAME] es el nombre del depósito que contiene la versión no actual que deseas copiar. Por ejemplo, my-bucket.
• [SOURCE_OBJECT_NAME] es el nombre de la versión no actual que deseas copiar. Por ejemplo, pets/dog.png.
• [GENERATION_NUMBER] es el número de generación de la versión no actual que deseas copiar. Por ejemplo, 1560468815691234.
• [DESTINATION_BUCKET_NAME] es el nombre del depósito en el que deseas copiar la versión no actual. Por ejemplo, my-bucket.
• [DESTINATION_OBJECT_NAME] es el nombre de la copia de la versión no actual. Por ejemplo, pets/shiba.png.

Si se ejecuta de forma correcta, la respuesta se ve como el siguiente ejemplo:

Operation completed over 1 objects/58.8 KiB.

Nota: Algunos shells, como zsh cuando la opción extendedglob está habilitada, tratan el carácter de hash, #, como un carácter especial. Si este es el caso de tu shell, debes incluir ese argumento entre comillas simples (o comillas dobles para Windows).

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

Ver en GitHub Comentarios

namespace gcs = google::cloud::storage;
using ::google::cloud::StatusOr;
[](gcs::Client client, std::string const& source_bucket_name,
   std::string const& source_object_name,
   std::string const& destination_bucket_name,
   std::string const& destination_object_name,
   std::int64_t source_object_generation) {
  StatusOr<gcs::ObjectMetadata> copy =
      client.CopyObject(source_bucket_name, source_object_name,
                        destination_bucket_name, destination_object_name,
                        gcs::SourceGeneration{source_object_generation});
  if (!copy) throw std::runtime_error(copy.status().message());

  std::cout << "Successfully copied " << source_object_name << " generation "
            << source_object_generation << " in bucket " << source_bucket_name
            << " to bucket " << copy->bucket() << " with name "
            << copy->name()
            << ".\nThe full metadata after the copy is: " << *copy << "\n";
}

Java

Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Java.

Ver en GitHub Comentarios

import com.google.cloud.storage.BlobId;
import com.google.cloud.storage.Storage;
import com.google.cloud.storage.StorageOptions;

public class CopyOldVersionOfObject {
  public static void copyOldVersionOfObject(
      String projectId,
      String bucketName,
      String objectToCopy,
      long generationToCopy,
      String newObjectName) {
    // The ID of your GCP project
    // String projectId = "your-project-id";

    // The ID of your GCS bucket
    // String bucketName = "your-unique-bucket-name";

    // The ID of the GCS object to copy an old version of
    // String objectToCopy = "your-object-name";

    // The generation of objectToCopy to copy
    // long generationToCopy = 1579287380533984;

    // What to name the new object with the old data from objectToCopy
    // String newObjectName = "your-new-object";

    Storage storage = StorageOptions.newBuilder().setProjectId(projectId).build().getService();
    Storage.CopyRequest copyRequest =
        Storage.CopyRequest.newBuilder()
            .setSource(BlobId.of(bucketName, objectToCopy, generationToCopy))
            .setTarget(BlobId.of(bucketName, newObjectName))
            .build();
    storage.copy(copyRequest);

    System.out.println(
        "Generation "
            + generationToCopy
            + " of object "
            + objectToCopy
            + " in bucket "
            + bucketName
            + " was copied to "
            + newObjectName);
  }
}

API de REST

API de JSON

1. Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus propias credenciales de OAuth.

2. Usa cURL para llamar a la API de JSON con una solicitud de objeto POST:

   curl -X POST \
     -H "Authorization: Bearer [OAUTH2_TOKEN]" \
     -H "Content-Length: 0" \
     "https://storage.googleapis.com/upload/storage/v1/b/[SOURCE_BUCKET_NAME]/o/[SOURCE_OBJECT_NAME]/rewriteTo/b/[DESTINATION_BUCKET_NAME]/o/[NAME_OF_COPY]?sourceGeneration=[GENERATION_NUMBER]"

   En el ejemplo anterior, se ilustra lo siguiente:

   • [OAUTH2_TOKEN] es el token de acceso que generaste en el paso 1.
   • [SOURCE_BUCKET_NAME] es el nombre del depósito que contiene la versión no actual que deseas copiar. Por ejemplo, my-bucket.
   • [SOURCE_OBJECT_NAME] es el nombre de la versión no actual que deseas copiar. Por ejemplo, pets/dog.png.
   • [DESTINATION_BUCKET_NAME] es el nombre del depósito en el que deseas copiar la versión no actual. Por ejemplo, my-bucket.
   • [NAME OF COPY] es el nombre de la copia de la versión no actual. Por ejemplo, pets/shiba.png.
   • [GENERATION_NUMBER] es el número de generación de la versión no actual que deseas copiar. Por ejemplo, 1560468815691234.

API de XML

1. Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus propias credenciales de OAuth.

2. Usa cURL para llamar a la API de XML con una solicitud de objeto PUT:

   curl -X PUT \
     -H "Authorization: Bearer [OAUTH2_TOKEN]" \
     -H "x-goog-copy-source: [SOURCE_BUCKET_NAME]/[SOURCE_OBJECT_NAME]" \
     -H "x-goog-copy-source-generation:[GENERATION_NUMBER]" \
     "https://storage.googleapis.com/[DESTINATION_BUCKET_NAME]/[NAME_OF_COPY]"

   En el ejemplo anterior, se ilustra lo siguiente:

   • [OAUTH2_TOKEN] es el token de acceso que generaste en el paso 1.
   • [SOURCE_BUCKET_NAME] es el nombre del depósito que contiene la versión no actual que deseas copiar. Por ejemplo, my-bucket.
   • [SOURCE_OBJECT_NAME] es el nombre de la versión no actual que deseas copiar. Por ejemplo, pets/dog.png.
   • [GENERATION_NUMBER] es el número de generación de la versión no actual que deseas copiar. Por ejemplo, 1560468815691234.
   • [DESTINATION_BUCKET_NAME] es el nombre del depósito en el que deseas copiar la versión no actual. Por ejemplo, my-bucket.
   • [NAME OF COPY] es el nombre de la copia de la versión no actual. Por ejemplo, pets/shiba.png.

Borra las versiones no actuales de objetos

Para borrar una versión no actual de un objeto, haz lo siguiente:

gsutil

Usa el comando gsutil rm:

gsutil rm gs://[BUCKET_NAME]/[OBJECT_NAME]#[GENERATION_NUMBER]

En el ejemplo anterior, se ilustra lo siguiente:

• [BUCKET_NAME] es el nombre del depósito que contiene la versión no actual que deseas borrar. Por ejemplo, my-bucket.
• [OBJECT_NAME] es el nombre de la versión no actual que deseas borrar. Por ejemplo, pets/dog.png.
• [GENERATION_NUMBER] es el número de generación de la versión no actual que deseas borrar. Por ejemplo, 1560468815691234.

Si se ejecuta de forma correcta, la respuesta se ve como el siguiente ejemplo:

Operation completed over 1 objects.

Nota: Puedes quitar todas las versiones de un objeto, incluidas las publicadas y las no actuales si usas la marca -a y omites el #[GENERATION_NUMBER].

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

Ver en GitHub Comentarios

namespace gcs = google::cloud::storage;
[](gcs::Client client, std::string const& bucket_name,
   std::string const& object_name, std::int64_t object_generation) {
  google::cloud::Status status = client.DeleteObject(
      bucket_name, object_name, gcs::Generation{object_generation});
  if (!status.ok()) throw std::runtime_error(status.message());

  std::cout << "Deleted " << object_name << " generation "
            << object_generation << " in bucket " << bucket_name << "\n";
}

Java

Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Java.

Ver en GitHub Comentarios

import com.google.cloud.storage.BlobId;
import com.google.cloud.storage.Storage;
import com.google.cloud.storage.StorageOptions;

public class DeleteOldVersionOfObject {
  public static void deleteOldVersionOfObject(
      String projectId, String bucketName, String objectName, long generationToDelete) {
    // The ID of your GCP project
    // String projectId = "your-project-id";

    // The ID of your GCS bucket
    // String bucketName = "your-unique-bucket-name";

    // The ID of your GCS object
    // String objectName = "your-object-name";

    // The generation of objectName to delete
    // long generationToDelete = 1579287380533984;

    Storage storage = StorageOptions.newBuilder().setProjectId(projectId).build().getService();
    storage.delete(BlobId.of(bucketName, objectName, generationToDelete));

    System.out.println(
        "Generation "
            + generationToDelete
            + " of object "
            + objectName
            + " was deleted from "
            + bucketName);
  }
}

API de REST

API de JSON

1. Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus propias credenciales de OAuth.

2. Usa cURL para llamar a la API de JSON con una solicitud de objeto DELETE:

   curl -X DELETE \
     -H "Authorization: Bearer [OAUTH2_TOKEN]" \
     "https://storage.googleapis.com/storage/v1/b/[BUCKET_NAME]/o/[OBJECT_NAME]?generation=[GENERATION_NUMBER]"

   En el ejemplo anterior, se ilustra lo siguiente:

   • [OAUTH2_TOKEN] es el token de acceso que generaste en el paso 1.
   • [BUCKET_NAME] es el nombre del depósito que contiene la versión no actual que deseas borrar. Por ejemplo, my-bucket.
   • [OBJECT_NAME] es el nombre de la versión no actual que deseas borrar. Por ejemplo, pets/dog.png.
   • [GENERATION_NUMBER] es el número de generación de la versión no actual que deseas borrar. Por ejemplo, 1560468815691234.

API de XML

1. Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus propias credenciales de OAuth.

2. Usa cURL para llamar a la API de XML con una solicitud de objeto DELETE:

   curl -X DELETE \
     -H "Authorization: Bearer [OAUTH2_TOKEN]" \
     "https://storage.googleapis.com/[BUCKET_NAME]/[OBJECT_NAME]?generation=[GENERATION_NUMBER]"

   En el ejemplo anterior, se ilustra lo siguiente:

   • [OAUTH2_TOKEN] es el token de acceso que generaste en el paso 1.
   • [BUCKET_NAME] es el nombre del depósito que contiene la versión no actual que deseas borrar. Por ejemplo, my-bucket.
   • [OBJECT_NAME] es el nombre de la versión no actual que deseas borrar. Por ejemplo, pets/dog.png.
   • [GENERATION_NUMBER] es el número de generación de la versión no actual que deseas borrar. Por ejemplo, 1560468815691234.

Próximos pasos

• Obtén más información sobre el control de versiones de objetos.
• Aprende a usar la Administración del ciclo de vida de los objetos para administrar sus versiones de forma automática.