Laufwerk-Snapshots verwalten

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Console

1. Rufen Sie in der Google Cloud Console die Seite Snapshots auf.

   Zur Seite "Snapshots"

2. Auf dem Tab Snapshots sehen Sie die Standard-Snapshots für das aktuelle Projekt.

3. Optional. Mit dem Feld filter_list Filter können Sie die Ergebnisse eingrenzen. Geben Sie im Feld Filter einen Namen oder Wert für das Attribut ein oder wählen Sie eine der verfügbaren Attribute aus.

gcloud

• Mit dem Befehl gcloud compute snapshots list können Sie eine Liste aller Snapshots abrufen, die Ihnen in einem bestimmten Projekt zur Verfügung stehen.

  gcloud compute snapshots list --project=PROJECT_ID
  

• (Vorabversion) Mit dem Befehl gcloud compute snapshots list und der Angabe der Region können Sie eine Liste der regional verfügbaren Snapshots in einem bestimmten Projekt aufrufen.

  gcloud compute snapshots list --region=REGION_NAME
  

• Mit dem Befehl gcloud compute snapshots list und dem Flag --global können Sie eine Liste der global verfügbaren Snapshots in einem bestimmten Projekt abrufen.

  gcloud compute snapshots list --global
  

Ersetzen Sie Folgendes:

• PROJECT_ID: Optional. Ersetzen Sie das durch die Projekt-ID. Wenn Sie dieses Flag weglassen, wird das aktuelle Projekt verwendet. Sie können das Standardprojekt für Ihre Sitzung mit dem gcloud CLI-Befehl gcloud config set project PROJECT_ID festlegen.
• REGION_NAME: Der Name der Region, für die Sie Snapshots aufrufen möchten.

REST

• Wenn Sie eine Liste aller Snapshots abrufen möchten, die Ihnen in einem bestimmten Projekt zur Verfügung stehen, senden Sie eine GET-Anfrage an die Methode snapshots.list und geben Sie „aggregated“ an.

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

• (Vorabversion) Wenn Sie eine Liste der regional verfügbaren Snapshots in einem bestimmten Projekt aufrufen möchten, senden Sie eine GET-Anfrage an die Methode snapshots.list und geben Sie die Region an.

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

• Wenn Sie eine Liste der Snapshots mit globalem Umfang abrufen möchten, die Ihnen in einem bestimmten Projekt zur Verfügung stehen, senden Sie eine GET-Anfrage an die Methode snapshots.list und geben Sie „global“ an.

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

Ersetzen Sie Folgendes:

• PROJECT_ID: die Projekt-ID
• REGION_NAME: Der Name der Region, für die Sie Snapshots aufrufen möchten.

Console

1. Rufen Sie in der Google Cloud Console die Seite Snapshots auf.

   Zur Seite "Snapshots"

2. Auf dem Tab Snapshots wird eine Liste aller Standard-Snapshots im Projekt angezeigt.

3. Ergebnisse nach Quelllaufwerk eingrenzen:

   1. Geben Sie Source disk: im Feld Filtern filter_list ein oder klicken Sie auf das Feld Filtern und wählen Sie dann den WertSource disk aus dem Attribute Liste.

   2. Wählen Sie im Feld Filter neben Source disk: in der Liste Werte den Namen des Laufwerks aus.

      In der Konsole werden jetzt alle Standard-Snapshots für das angegebene Laufwerk angezeigt.

      Wenn Sie den Namen eines Laufwerks nicht in der Liste Werte sehen, geben Sie im Feld Filter neben Source disk: die ersten Buchstaben des Namens des Quelllaufwerks ein, um die angezeigte Werteliste zu ändern.

gcloud

Standard-Snapshots für ein Laufwerk mit dem Befehl gcloud compute snapshots list und dem Argument --filter auflisten:

• Standard-Snapshots für ein zonales Laufwerk auflisten:

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

• Standard-Snapshots für ein regionales Laufwerk auflisten:

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

Ersetzen Sie Folgendes:

• PROJECT_ID: die ID des Projekts.
• SOURCE_ZONE: (Nur zonale Laufwerke) Der Name der Zone für das Laufwerk, z. B. us-west1-a.
• SOURCE_REGION: (Nur regionale Laufwerke) der Name der Region für das Laufwerk, z. B. us-west1.
• DISK_NAME: der Name des Laufwerks, z. B. disk-1.

REST

Listen Sie Standard-Snapshots für ein zonales oder regionales Laufwerk mit einer GET-Anfrage an die Methode snapshots.list auf.

Verwenden Sie den Abfrageparameter filter=sourceDisk, um den Namen des Laufwerks anzugeben.

• Standard-Snapshots für ein zonales Laufwerk auflisten:

  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'
  

• Standard-Snapshots für ein regionales Laufwerk auflisten:

  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'
  

Ersetzen Sie Folgendes:

• PROJECT_ID: die ID des Projekts.
• SOURCE_ZONE: (Nur zonale Laufwerke) Der Name der Zone für das Laufwerk, z. B. us-west1-a.
• SOURCE_REGION: (Nur regionale Laufwerke) der Name der Region für das Laufwerk, z. B. us-west1.
• DISK_NAME: der Name des Quelllaufwerks, z. B. disk-1.

Console

1. Rufen Sie in der Google Cloud Console die Seite Snapshots auf.

   Zur Seite "Snapshots"

2. Auf dem Tab Snapshots finden Sie eine Liste der Snapshots im Projekt.

3. Klicken Sie in der Spalte Name auf den Namen des Standard-Snapshots. Die Seite Details zu Snapshots für den ausgewählten Snapshot wird mit den zugehörigen Attributen angezeigt.

gcloud

• Verwenden Sie den Befehl gcloud compute snapshots describe, um Informationen zu einem global gültigen Standard-Snapshot aufzurufen.

  gcloud compute snapshots describe SNAPSHOT_NAME
  

• (Vorabversion) Wenn Sie Informationen zu einem regional gültigen Standard-Snapshot aufrufen möchten, verwenden Sie den Befehl gcloud compute snapshots describe und geben Sie die Region an.

  gcloud compute snapshots describe SNAPSHOT_NAME --regions=REGION_NAME
  

Ersetzen Sie Folgendes:

• SNAPSHOT_NAME: Der Name des Standard-Snapshots.
• REGION_NAME: Der Name der Region, auf die sich Ihr Snapshot bezieht.

REST

• Wenn Sie Informationen zu einem global gültigen Standard-Snapshot aufrufen möchten, senden Sie eine GET-Anfrage an die Methode snapshots.get.

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

• (Vorabversion) Wenn Sie Informationen zu einem regional orientierten Standard-Snapshot aufrufen möchten, senden Sie eine GET-Anfrage an die Methode snapshots.get und geben Sie die Region an.

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

Ersetzen Sie Folgendes:

• PROJECT_ID: Der Name des Projekts, das den Standard-Snapshot enthält.
• SNAPSHOT_NAME: Der Name des Standard-Snapshots.
• REGION_NAME: Der Name der Region, auf die sich Ihr Snapshot bezieht.

Console

1. Rufen Sie in der Google Cloud Console die Seite Snapshots auf.

   Zur Seite "Snapshots"

2. Wählen Sie einen oder mehrere Snapshots aus, den oder die Sie löschen möchten.

3. Klicken Sie oben auf der Seite Snapshots auf Löschen.

gcloud

• Verwenden Sie den Befehl gcloud compute snapshots delete, um einen Snapshot mit globalem Umfang zu löschen.

  gcloud compute snapshots delete SNAPSHOT_NAME
  

• (Vorabversion) Wenn Sie einen Snapshot auf regionaler Ebene löschen möchten, verwenden Sie den Befehl gcloud compute snapshots delete und geben Sie den Namen der Region an.

  gcloud compute snapshots delete SNAPSHOT_NAME --regions=REGION_NAME
  

Ersetzen Sie Folgendes:

• SNAPSHOT_NAME: Der Name des Snapshots, den Sie löschen möchten.
• REGION_NAME: Die Region, auf die sich der Snapshot bezieht.

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

• Wenn Sie einen Snapshot mit globalem Umfang löschen möchten, senden Sie eine DELETE-Anfrage an die snapshots.delete-Methode.

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

• (Vorabversion) Wenn Sie einen Snapshot auf regionaler Ebene löschen möchten, senden Sie eine DELETE-Anfrage an die Methode snapshots.delete und geben Sie die Region an.

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

Ersetzen Sie Folgendes:

• PROJECT_ID ist der Name Ihres Projekts.
• SNAPSHOT_NAME: Der Name des zu löschenden Snapshots.
• REGION_NAME: Die Region, auf die sich der Snapshot bezieht.

gcloud

1. Erstellen Sie mit dem Befehl gcloud compute snapshots create einen Standard-Snapshot im Zielprojekt. Verwenden Sie beispielsweise den folgenden Befehl, um einen Snapshot eines zonalen nichtflüchtigen Speichers oder einer zonalen Hyperdisk zu erstellen:

   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
   

   Ersetzen Sie Folgendes:

   • SNAPSHOT_NAME ist der Name des neuen Snapshots.
   • SOURCE_PROJECT_ID: Die ID des Projekts für das Quelllaufwerk.
   • ZONE: Die Zone des Quelllaufwerks.
   • SOURCE_DISK_NAME: Der Name des Quelllaufwerks.
   • DESTINATION_PROJECT_ID: Die ID des Zielprojekts für den neuen Snapshot.

2. Erstellen Sie im Zielprojekt mit dem Befehl gcloud compute disks create ein zonales oder regionales Laufwerk, das auf dem Snapshot basiert:

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

   Dabei gilt:

   • DISK_NAME: Ein Name für das neue Laufwerk.
   • SNAPSHOT_NAME: Der Name des Snapshots.
   • DESTINATION_PROJECT_ID: Die ID des Zielprojekts für das neue Laufwerk.

REST

1. Erstellen Sie einen Standard-Snapshot im Zielprojekt, indem Sie die Methode snapshots.insert aufrufen. Wenn Sie beispielsweise einen Snapshot eines zonalen nichtflüchtigen Speichers oder Hyperdisks erstellen möchten, stellen Sie folgende Anfrage:

   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
   }
   

   Ersetzen Sie Folgendes:

   • DESTINATION_PROJECT_ID: Die ID des Zielprojekts für den neuen Snapshot.
   • SNAPSHOT_NAME: Ein Name für den Snapshot.
   • SOURCE_PROJECT_ID: Die ID des Projekts des Quelllaufwerks.
   • SOURCE_ZONE: Die Zone des Quelllaufwerks.
   • SOURCE_DISK_NAME: Der Name des Quelllaufwerks.

2. Erstellen Sie im Zielprojekt ein zonales oder regionales Laufwerk, das auf dem Snapshot basiert. Verwenden Sie dazu die zonale Methode disks.insert oder die regionale Methode regionDisks.insert.

   Stellen Sie zum Beispiel die folgende Anfrage zum Erstellen eines zonalen Laufwerks:

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

   Ersetzen Sie Folgendes:

   • DESTINATION_PROJECT_ID: Die ID des Zielprojekts für das neue Laufwerk.
   • DESTINATION_ZONE: Die Zone im Zielprojekt für das neue Laufwerk.
   • DISK_NAME: Ein Name für das neue Laufwerk.
   • SNAPSHOT_NAME: Der Name des Snapshots.

Eine Liste der verfügbaren Snapshots finden Sie unter Standard-Snapshots in einem Projekt oder an einem Standort ansehen.

gcloud

1. Erstellen Sie im Quellprojekt mit dem Befehl gcloud compute disks create ein Laufwerk, das auf dem Snapshot basiert.

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

   Ersetzen Sie Folgendes:

   • DISK_NAME: Ein Name für das neue Laufwerk.
   • SNAPSHOT_NAME: Der Name des Snapshots.
   • SOURCE_PROJECT_ID: Die ID des Quellprojekts.
   • ZONE ist die Zone, in der die neue VM erstellt werden soll.

   Dieses Laufwerk ist ein temporäres Laufwerk, das nur zum organisationsübergreifenden Kopieren des Snapshots erstellt wird.

2. Erstellen Sie mit dem Befehl gcloud compute snapshots create einen Snapshot im Zielprojekt.

   Verwenden Sie beispielsweise den folgenden Befehl, um einen Snapshot mit dem im ersten Schritt erstellten zonalen Laufwerk zu erstellen:

   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
   

   Ersetzen Sie Folgendes:

   • SNAPSHOT_NAME: Ein Name für den Snapshot.
   • SOURCE_PROJECT_ID: Die ID des Projekts, das das Quelllaufwerk enthält.
   • ZONE: Die Zone des Quelllaufwerks.
   • DISK_NAME: Der Name des in Schritt 1 erstellten Laufwerks.
   • DESTINATION_PROJECT_ID: Die ID des Zielprojekts für den neuen Snapshot.

   Eine Liste der verfügbaren Snapshots finden Sie unter Standard-Snapshots in einem Projekt oder an einem Standort ansehen.

3. Löschen Sie das im ersten Schritt erstellte temporäre Laufwerk mit dem Befehl gcloud compute disks delete.

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

   Ersetzen Sie Folgendes:

   • DISK_NAME: Der Name des in Schritt 1 erstellten Laufwerks.
   • SOURCE_PROJECT_ID: Die ID des Projekts, das das Quelllaufwerk enthält.
   • ZONE: die Zone des Laufwerks

REST

1. Erstellen Sie im Quellprojekt mithilfe der zonalen Methode disks.insert ein zonales oder regionales Laufwerk, das auf dem Snapshot basiert.

   Stellen Sie zum Beispiel die folgende Anfrage zum Erstellen eines zonalen Laufwerks:

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

   Ersetzen Sie Folgendes:

   • SOURCE_PROJECT_ID: Die ID des Quellprojekts für das neue Laufwerk.
   • SOURCE_ZONE: Die Zone für das neue Laufwerk.
   • DISK_NAME: Ein Name für das neue Laufwerk.
   • SNAPSHOT_NAME: Der Name des Snapshots.

   Dieses Laufwerk ist ein temporäres Laufwerk, das nur zum organisationsübergreifenden Kopieren des Snapshots erstellt wird.

2. Erstellen Sie einen Snapshot im Zielprojekt, indem Sie die Methode snapshots.insert aufrufen.

   Verwenden Sie beispielsweise den folgenden Befehl, um einen Snapshot mit dem im ersten Schritt erstellten zonalen Laufwerk zu erstellen:

   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
   }
   

   Ersetzen Sie Folgendes:

   • DESTINATION_PROJECT_ID: Die ID des Zielprojekts für den neuen Snapshot.
   • SNAPSHOT_NAME: Ein Name für den Snapshot.
   • SOURCE_PROJECT_ID: Die ID des Projekts, das das Quelllaufwerk enthält.
   • SOURCE_ZONE: Die Zone des Quelllaufwerks.
   • DISK_NAME: Der Name des Quelllaufwerks.

3. Löschen Sie das im ersten Schritt erstellte temporäre Laufwerk mit der Methode disks.delete.

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

   Ersetzen Sie Folgendes:

   • SOURCE_PROJECT_ID: Die ID des Projekts, das das temporäre Laufwerk enthält.
   • SOURCE_ZONE: die Zone des Laufwerks
   • DISK_NAME: Der Name des temporären Laufwerks, das Sie in Schritt 1 erstellt haben.