Gestionar capturas de disco

Consola

1. En la Google Cloud consola, ve a la página Snapshots (Capturas).

   Ir a la página Capturas

2. En la pestaña Capturas, puede ver las capturas estándar del proyecto actual.

3. Opcional. Acota los resultados con el campo filter_list Filtrar. Introduce un nombre o un valor de propiedad en el campo Filtro o elige una de las propiedades disponibles.

gcloud

• Para ver una lista de todas las capturas disponibles en un proyecto concreto, usa el comando gcloud compute snapshots list.

  gcloud compute snapshots list --project=PROJECT_ID
  

• Vista previa: Para ver una lista de las instantáneas de ámbito regional disponibles en un proyecto concreto, usa el comando gcloud compute snapshots list y especifica la región.

  gcloud compute snapshots list --region=REGION_NAME
  

• Para ver una lista de las copias de seguridad disponibles en un proyecto concreto, usa el comando gcloud compute snapshots list e incluye la marca --global.

  gcloud compute snapshots list --global
  

Haz los cambios siguientes:

• PROJECT_ID: opcional. Sustitúyelo por el ID del proyecto. Si omite esta marca, se usará el proyecto actual. Puedes definir el proyecto predeterminado de tu sesión con el comando gcloud config set project PROJECT_ID de la CLI de gcloud.
• REGION_NAME: el nombre de la región de la que quieras ver las instantáneas.

REST

• Para ver una lista de todas las copias de seguridad disponibles en un proyecto concreto, haz una solicitud GET al método snapshots.list y especifica "aggregated".

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/snapshots
  

• (Vista previa) Para ver una lista de las capturas de ámbito regional disponibles en un proyecto concreto, haz una solicitud GET al método snapshots.list y especifica la región.

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/snapshots
  

• Para ver una lista de las capturas de ámbito global disponibles en un proyecto concreto, haz una solicitud GET al método snapshots.list y especifica "global".

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshots
  

Haz los cambios siguientes:

• PROJECT_ID: el ID del proyecto.
• REGION_NAME: el nombre de la región de la que quieras ver las instantáneas.

Consola

1. En la Google Cloud consola, ve a la página Snapshots (Capturas).

   Ir a la página Capturas

2. En la pestaña Instantáneas, se muestra una lista de todas las instantáneas estándar del proyecto.

3. Acota los resultados por disco de origen:

   1. Introduce Source disk: en el campo filter_list Filter o haz clic en el campo Filter y, a continuación, elige el valor Source disk de la lista Properties.

   2. Selecciona el nombre del disco en la lista Valores que aparece junto a Source disk: en el campo Filtro.

      Las copias de seguridad que se muestran en la consola ahora incluyen todas las copias de seguridad estándar del disco especificado.

      Si no ves el nombre de un disco en la lista Valores, escribe las primeras letras del nombre del disco de origen en el campo Filtro situado junto a Source disk: para cambiar la lista de valores que ves.

gcloud

Lista las capturas estándar de un disco con el comando gcloud compute snapshots list y el argumento --filter.

• Lista de las instantáneas estándar de un disco de zona:

  gcloud compute snapshots list --filter="sourceDisk:projects/PROJECT_ID/zones/SOURCE_ZONE/disks/DISK_NAME
  

• Lista de las instantáneas estándar de un disco regional:

  gcloud compute snapshots list --filter=sourceDisk:projects/PROJECT_ID/regions/SOURCE_REGION/disks/DISK_NAME
  

Haz los cambios siguientes:

• PROJECT_ID: el ID del proyecto.
• SOURCE_ZONE: (solo discos zonales) el nombre de la zona del disco. Por ejemplo, us-west1-a.
• SOURCE_REGION: (solo discos regionales) el nombre de la región del disco. Por ejemplo, us-west1.
• DISK_NAME: el nombre del disco (por ejemplo, disk-1).

REST

Consulta las capturas estándar de un disco de zona o regional con una solicitud GET al método snapshots.list.

Usa el parámetro de consulta filter=sourceDisk para especificar el nombre del disco.

• Lista de las instantáneas estándar de un disco de zona:

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshots?filter=sourceDisk:'https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/SOURCE_ZONE/disks/DISK_NAME'
  

• Lista de las instantáneas estándar de un disco regional:

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshots?filter=sourceDisk:'https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/SOURCE_REGION/disks/DISK_NAME'
  

Haz los cambios siguientes:

• PROJECT_ID: el ID del proyecto.
• SOURCE_ZONE: (solo discos zonales) el nombre de la zona del disco. Por ejemplo, us-west1-a.
• SOURCE_REGION: (solo discos regionales) el nombre de la región del disco. Por ejemplo, us-west1.
• DISK_NAME: el nombre del disco de origen, por ejemplo, disk-1.

Consola

1. En la Google Cloud consola, ve a la página Snapshots (Capturas).

   Ir a la página Capturas

2. En la pestaña Capturas, consulta la lista de capturas del proyecto.

3. En la columna Nombre, haga clic en el nombre de la instantánea estándar. Se mostrará la página Detalles de la vista general de la vista general seleccionada, con sus propiedades.

gcloud

• Para ver información sobre una instantánea estándar con ámbito global, usa el comando gcloud compute snapshots describe.

  gcloud compute snapshots describe SNAPSHOT_NAME
  

• Vista previa: para ver información sobre una instantánea estándar de ámbito regional, usa el comando gcloud compute snapshots describe y especifica la región.

  gcloud compute snapshots describe SNAPSHOT_NAME --regions=REGION_NAME
  

Haz los cambios siguientes:

• SNAPSHOT_NAME: nombre de la instantánea estándar.
• REGION_NAME: Nombre de la región a la que se limita tu instantánea.

REST

• Para ver información sobre una instantánea estándar con ámbito global, haz una solicitud GET al método snapshots.get.

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshots/SNAPSHOT_NAME
  

• Vista previa: Para ver información sobre una instantánea estándar con ámbito regional, haz una solicitud GET al método snapshots.get y especifica la región.

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/snapshots/SNAPSHOT_NAME
  

Haz los cambios siguientes:

• PROJECT_ID: Nombre del proyecto que contiene la instantánea estándar.
• SNAPSHOT_NAME: nombre de la instantánea estándar.
• REGION_NAME: Nombre de la región a la que se limita tu instantánea.

Consola

1. Ve a la página Snapshots (Instantáneas) de la Google Cloud consola.

   Ir a la página Capturas

2. Selecciona una o varias copias que quieras eliminar.

3. En la parte superior de la página Historial, haz clic en Eliminar.

gcloud

• Para eliminar una instantánea con ámbito global, usa el comando gcloud compute snapshots delete.

  gcloud compute snapshots delete SNAPSHOT_NAME
  

• (Vista previa) Para eliminar una instantánea con ámbito regional, usa el comando gcloud compute snapshots delete y especifica el nombre de la región.

  gcloud compute snapshots delete SNAPSHOT_NAME --regions=REGION_NAME
  

Haz los cambios siguientes:

• SNAPSHOT_NAME: el nombre de la instantánea que quieras eliminar.
• REGION_NAME: la región a la que se limita el ámbito de la instantánea.

Go

import (
	"context"
	"fmt"
	"io"

	compute "cloud.google.com/go/compute/apiv1"
	computepb "cloud.google.com/go/compute/apiv1/computepb"
)

// deleteSnapshot deletes a snapshot of a disk.
func deleteSnapshot(w io.Writer, projectID, snapshotName string) error {
	// projectID := "your_project_id"
	// snapshotName := "your_snapshot_name"

	ctx := context.Background()
	snapshotsClient, err := compute.NewSnapshotsRESTClient(ctx)
	if err != nil {
		return fmt.Errorf("NewSnapshotsRESTClient: %w", err)
	}
	defer snapshotsClient.Close()

	req := &computepb.DeleteSnapshotRequest{
		Project:  projectID,
		Snapshot: snapshotName,
	}

	op, err := snapshotsClient.Delete(ctx, req)
	if err != nil {
		return fmt.Errorf("unable to delete snapshot: %w", err)
	}

	if err = op.Wait(ctx); err != nil {
		return fmt.Errorf("unable to wait for the operation: %w", err)
	}

	fmt.Fprintf(w, "Snapshot deleted\n")

	return nil
}

Java

import com.google.cloud.compute.v1.Operation;
import com.google.cloud.compute.v1.SnapshotsClient;
import java.io.IOException;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.TimeoutException;

public class DeleteSnapshot {

  public static void main(String[] args)
      throws IOException, ExecutionException, InterruptedException, TimeoutException {
    // TODO(developer): Replace these variables before running the sample.

    // Project ID or project number of the Cloud project you want to use.
    String projectId = "YOUR_PROJECT_ID";

    // Name of the snapshot to be deleted.
    String snapshotName = "YOUR_SNAPSHOT_NAME";

    deleteSnapshot(projectId, snapshotName);
  }

  // Delete a snapshot of a disk.
  public static void deleteSnapshot(String projectId, String snapshotName)
      throws IOException, ExecutionException, InterruptedException, TimeoutException {

    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests. After completing all of your requests, call
    // the `snapshotsClient.close()` method on the client to safely
    // clean up any remaining background resources.
    try (SnapshotsClient snapshotsClient = SnapshotsClient.create()) {

      Operation operation = snapshotsClient.deleteAsync(projectId, snapshotName)
          .get(3, TimeUnit.MINUTES);

      if (operation.hasError()) {
        System.out.println("Snapshot deletion failed!" + operation);
        return;
      }

      System.out.println("Snapshot deleted!");
    }
  }
}

Node.js

/**
 * TODO(developer): Uncomment and replace these variables before running the sample.
 */
// const projectId = 'YOUR_PROJECT_ID';
// const snapshotName = 'YOUR_SNAPSHOT_NAME';

const compute = require('@google-cloud/compute');

async function deleteSnapshot() {
  const snapshotsClient = new compute.SnapshotsClient();

  const [response] = await snapshotsClient.delete({
    project: projectId,
    snapshot: snapshotName,
  });
  let operation = response.latestResponse;
  const operationsClient = new compute.GlobalOperationsClient();

  // Wait for the create disk operation to complete.
  while (operation.status !== 'DONE') {
    [operation] = await operationsClient.wait({
      operation: operation.name,
      project: projectId,
    });
  }

  console.log('Snapshot deleted.');
}

deleteSnapshot();

Python

from __future__ import annotations

import sys
from typing import Any

from google.api_core.extended_operation import ExtendedOperation
from google.cloud import compute_v1


def wait_for_extended_operation(
    operation: ExtendedOperation, verbose_name: str = "operation", timeout: int = 300
) -> Any:
    """
    Waits for the extended (long-running) operation to complete.

    If the operation is successful, it will return its result.
    If the operation ends with an error, an exception will be raised.
    If there were any warnings during the execution of the operation
    they will be printed to sys.stderr.

    Args:
        operation: a long-running operation you want to wait on.
        verbose_name: (optional) a more verbose name of the operation,
            used only during error and warning reporting.
        timeout: how long (in seconds) to wait for operation to finish.
            If None, wait indefinitely.

    Returns:
        Whatever the operation.result() returns.

    Raises:
        This method will raise the exception received from `operation.exception()`
        or RuntimeError if there is no exception set, but there is an `error_code`
        set for the `operation`.

        In case of an operation taking longer than `timeout` seconds to complete,
        a `concurrent.futures.TimeoutError` will be raised.
    """
    result = operation.result(timeout=timeout)

    if operation.error_code:
        print(
            f"Error during {verbose_name}: [Code: {operation.error_code}]: {operation.error_message}",
            file=sys.stderr,
            flush=True,
        )
        print(f"Operation ID: {operation.name}", file=sys.stderr, flush=True)
        raise operation.exception() or RuntimeError(operation.error_message)

    if operation.warnings:
        print(f"Warnings during {verbose_name}:\n", file=sys.stderr, flush=True)
        for warning in operation.warnings:
            print(f" - {warning.code}: {warning.message}", file=sys.stderr, flush=True)

    return result


def delete_snapshot(project_id: str, snapshot_name: str) -> None:
    """
    Delete a snapshot of a disk.

    Args:
        project_id: project ID or project number of the Cloud project you want to use.
        snapshot_name: name of the snapshot to delete.
    """

    snapshot_client = compute_v1.SnapshotsClient()
    operation = snapshot_client.delete(project=project_id, snapshot=snapshot_name)

    wait_for_extended_operation(operation, "snapshot deletion")

REST

• Para eliminar una instantánea con ámbito global, envía una solicitud DELETE al método snapshots.delete.

  DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshots/SNAPSHOT_NAME
  

• Vista previa: Para eliminar una instantánea con ámbito regional, haz una solicitud DELETE al método snapshots.delete y especifica la región.

  DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/snapshots/SNAPSHOT_NAME
  

Haz los cambios siguientes:

• PROJECT_ID: el nombre de tu proyecto.
• SNAPSHOT_NAME: el nombre de la captura que se va a eliminar.
• REGION_NAME: la región a la que se limita el ámbito de la instantánea.

gcloud

1. Crea una instantánea estándar en el proyecto de destino con el comando gcloud compute snapshots create. Por ejemplo, para crear una captura de un disco persistente o un Hyperdisk de zona, usa el siguiente comando:

   gcloud compute snapshots create SNAPSHOT_NAME \
    --source-disk https://www.googleapis.com/compute/v1/projects/SOURCE_PROJECT_ID/zones/ZONE/disks/SOURCE_DISK_NAME \
    --project DESTINATION_PROJECT_ID
   

   Haz los cambios siguientes:

   • SNAPSHOT_NAME: nombre de la nueva captura.
   • SOURCE_PROJECT_ID: ID del proyecto del disco de origen.
   • ZONE: la zona del disco de origen.
   • SOURCE_DISK_NAME: nombre del disco de origen.
   • DESTINATION_PROJECT_ID: ID del proyecto de destino de la nueva instantánea.

2. En el proyecto de destino, crea un disco zonal o regional basado en la captura mediante el comando gcloud compute disks create:

   gcloud compute disks create DISK_NAME \
    --source-snapshot SNAPSHOT_NAME \
    --project DESTINATION_PROJECT_ID
   

   Haz los cambios siguientes:

   • DISK_NAME: el nombre del nuevo disco.
   • SNAPSHOT_NAME: el nombre de la captura.
   • DESTINATION_PROJECT_ID: ID del proyecto de destino del nuevo disco.

REST

1. Crea una instantánea estándar en el proyecto de destino llamando al método snapshots.insert. Por ejemplo, para crear una captura de un disco persistente o un Hyperdisk de zona, haz la siguiente solicitud:

   POST https://compute.googleapis.com/compute/v1/projects/DESTINATION_PROJECT_ID/global/snapshots
   {
    "name": SNAPSHOT_NAME
    "sourceDisk": "projects/SOURCE_PROJECT_ID/zones/SOURCE_ZONE/disks/SOURCE_DISK_NAME
   }
   

   Haz los cambios siguientes:

   • DESTINATION_PROJECT_ID: ID del proyecto de destino de la nueva instantánea.
   • SNAPSHOT_NAME: nombre de la captura.
   • SOURCE_PROJECT_ID: el ID del proyecto del disco de origen.
   • SOURCE_ZONE: la zona del disco de origen.
   • SOURCE_DISK_NAME: nombre del disco de origen.

2. En el proyecto de destino, crea un disco de zona o regional basado en la captura mediante el método de zona disks.insert o el método regional regionDisks.insert.

   Por ejemplo, para crear un disco zonal, haz la siguiente solicitud:

   POST https://compute.googleapis.com/compute/v1/projects/DESTINATION_PROJECT_ID/zones/DESTINATION_ZONE/disks
   {
    "name": DISK_NAME
    "sourceSnapshot": SNAPSHOT_NAME
   }
   

   Haz los cambios siguientes:

   • DESTINATION_PROJECT_ID: ID del proyecto de destino del nuevo disco.
   • DESTINATION_ZONE: la zona del proyecto de destino del nuevo disco.
   • DISK_NAME: el nombre del nuevo disco.
   • SNAPSHOT_NAME: el nombre de la captura.

Para obtener una lista de las instantáneas disponibles, consulta Ver las instantáneas estándar de un proyecto o una ubicación.

gcloud

1. En el proyecto de origen, crea un disco basado en la instantánea con el comando gcloud compute disks create.

   gcloud compute disks create DISK_NAME \
    --source-snapshot SNAPSHOT_NAME \
    --project SOURCE_PROJECT_ID \
    --zone ZONE
   

   Haz los cambios siguientes:

   • DISK_NAME: el nombre del nuevo disco.
   • SNAPSHOT_NAME: el nombre de la captura.
   • SOURCE_PROJECT_ID: ID del proyecto de origen.
   • ZONE: la zona en la que se creará el nuevo disco.

   Este disco es un disco temporal que se crea únicamente para copiar la captura entre organizaciones.

2. En el proyecto de destino, crea una instantánea con el comando gcloud compute snapshots create.

   Por ejemplo, para crear una captura con el disco zonal creado en el primer paso, usa el siguiente comando:

   gcloud compute snapshots create SNAPSHOT_NAME \
    --source-disk https://www.googleapis.com/compute/v1/projects/SOURCE_PROJECT_ID/zones/ZONE/disks/DISK_NAME \
    --project DESTINATION_PROJECT_ID
   

   Haz los cambios siguientes:

   • SNAPSHOT_NAME: nombre de la captura.
   • SOURCE_PROJECT_ID: el ID del proyecto que contiene el disco de origen.
   • ZONE: la zona del disco de origen.
   • DISK_NAME: el nombre del disco creado en el paso 1.
   • DESTINATION_PROJECT_ID: ID del proyecto de destino de la nueva instantánea.

   Para obtener una lista de las instantáneas disponibles, consulta Ver las instantáneas estándar de un proyecto o una ubicación.

3. Elimina el disco temporal creado en el primer paso con el comando gcloud compute disks delete.

   gcloud compute disks delete DISK_NAME \
    --project SOURCE_PROJECT_ID --zone ZONE
   

   Haz los cambios siguientes:

   • DISK_NAME: el nombre del disco creado en el paso 1.
   • SOURCE_PROJECT_ID: el ID del proyecto que contiene el disco de origen.
   • ZONE: la zona del disco.

REST

1. En el proyecto de origen, crea un disco de zona o regional basado en la instantánea mediante el método disks.insert de zona.

   Por ejemplo, para crear un disco zonal, haz la siguiente solicitud:

   POST https://compute.googleapis.com/compute/v1/projects/SOURCE_PROJECT_ID/zones/SOURCE_ZONE/disks
   {
    "name": DISK_NAME
    "sourceSnapshot": SNAPSHOT_NAME
   }
   

   Haz los cambios siguientes:

   • SOURCE_PROJECT_ID: ID del proyecto de origen del nuevo disco.
   • SOURCE_ZONE: la zona del disco nuevo.
   • DISK_NAME: el nombre del nuevo disco.
   • SNAPSHOT_NAME: el nombre de la captura.

   Este disco es un disco temporal que se crea únicamente para copiar la captura entre organizaciones.

2. Crea una captura en el proyecto de destino llamando al método snapshots.insert.

   Por ejemplo, para crear una instantánea con el disco zonal creado en el primer paso, usa el siguiente comando:

   POST https://compute.googleapis.com/compute/v1/projects/DESTINATION_PROJECT_ID/global/snapshots
   {
      "name": SNAPSHOT_NAME
      "sourceDisk": "projects/SOURCE_PROJECT_ID/zones/SOURCE_ZONE/disks/DISK_NAME
   }
   

   Haz los cambios siguientes:

   • DESTINATION_PROJECT_ID: ID del proyecto de destino de la nueva instantánea.
   • SNAPSHOT_NAME: nombre de la captura.
   • SOURCE_PROJECT_ID: ID del proyecto que contiene el disco de origen.
   • SOURCE_ZONE: la zona del disco de origen.
   • DISK_NAME: nombre del disco de origen.

3. Elimina el disco temporal creado en el primer paso con el método disks.delete.

   DELETE https://compute.googleapis.com/compute/v1/projects/SOURCE_PROJECT_ID/zones/SOURCE_ZONE/disks/DISK_NAME
   

   Haz los cambios siguientes:

   • SOURCE_PROJECT_ID: ID del proyecto que contiene el disco temporal.
   • SOURCE_ZONE: la zona del disco.
   • DISK_NAME: el nombre del disco temporal creado en el paso 1.