Faça a gestão dos instantâneos de discos

Consola

1. Na Trusted Cloud consola, aceda à página Instantâneos.

   Aceda à página Instantâneos

2. No separador Instantâneos, pode ver os instantâneos padrão do projeto atual.

3. Opcional. Limite os resultados com o campo filter_list Filtro. Introduza um nome ou um valor de propriedade no campo Filtro, ou escolha entre as propriedades disponíveis.

gcloud

• Para ver uma lista de todas as imagens instantâneas disponíveis para si num projeto específico, use o comando gcloud compute snapshots list.

  gcloud compute snapshots list --project=PROJECT_ID
  

• (Pré-visualização) Para ver uma lista de instantâneos com âmbito regional disponíveis para si num projeto específico, use o comando gcloud compute snapshots list e especifique a região.

  gcloud compute snapshots list --region=REGION_NAME
  

• Para ver uma lista de instantâneos com âmbito global disponíveis para si num projeto específico, use o comando gcloud compute snapshots list e inclua a flag --global.

  gcloud compute snapshots list --global
  

Substitua o seguinte:

• PROJECT_ID: opcional. Substitua pelo ID do projeto. Se omitir esta flag, é usado o projeto atual. Pode definir o projeto predefinido para a sua sessão através do comando gcloud config set project PROJECT_ID da CLI gcloud.
• REGION_NAME: o nome da região para a qual quer ver capturas de ecrã.

REST

• Para ver uma lista de todas as capturas instantâneas disponíveis para si num projeto específico, faça um pedido GET ao método snapshots.list e especifique "aggregated".

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

• (Pré-visualização) Para ver uma lista de instantâneos com âmbito regional disponíveis para si num projeto específico, faça um pedido GET ao método snapshots.list e especifique a região.

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

• Para ver uma lista de instantâneos com âmbito global disponíveis para si num projeto específico, faça um pedido GET ao método snapshots.list e especifique "global".

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

Substitua o seguinte:

• PROJECT_ID: o ID do projeto.
• REGION_NAME: o nome da região para a qual quer ver capturas de ecrã.

Consola

1. Na Trusted Cloud consola, aceda à página Instantâneos.

   Aceda à página Instantâneos

2. No separador Snapshots, é apresentada uma lista de todos os snapshots padrão no projeto.

3. Restrinja os resultados por disco de origem:

   1. Introduza Source disk: no campo filter_list Filtro ou clique no campo Filtro e, de seguida, escolha o valor Source disk na lista Propriedades.

   2. Selecione o nome do disco na lista Valores apresentada junto a Source disk: no campo Filtro.

      As imagens instantâneas apresentadas na consola mostram agora todas as imagens instantâneas padrão para o disco especificado.

      Se não vir o nome de um disco na lista Valores, no campo Filtro junto a Source disk:, introduza as primeiras letras do nome do disco de origem para alterar a lista de valores apresentada.

gcloud

Liste as imagens instantâneas padrão de um disco com o comando gcloud compute snapshots list e o argumento --filter.

• Liste os instantâneos padrão de um disco zonal:

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

• Liste os instantâneos padrão de um disco regional:

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

Substitua o seguinte:

• PROJECT_ID: o ID do projeto.
• SOURCE_ZONE: (apenas discos zonais) o nome da zona para o disco, por exemplo, us-west1-a.
• SOURCE_REGION: (apenas discos regionais) o nome da região do disco, por exemplo, us-west1.
• DISK_NAME: o nome do disco, por exemplo, disk-1.

REST

Liste as imagens instantâneas padrão de um disco zonal ou regional com um pedido GET ao método snapshots.list.

Use o parâmetro de consulta filter=sourceDisk para especificar o nome do disco.

• Liste os instantâneos padrão de um disco zonal:

  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'
  

• Liste os instantâneos padrão de um 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'
  

Substitua o seguinte:

• PROJECT_ID: o ID do projeto.
• SOURCE_ZONE: (apenas discos zonais) o nome da zona para o disco, por exemplo, us-west1-a.
• SOURCE_REGION: (apenas discos regionais) o nome da região do disco, por exemplo, us-west1.
• DISK_NAME: o nome do disco de origem, por exemplo, disk-1.

Consola

1. Na Trusted Cloud consola, aceda à página Instantâneos.

   Aceda à página Instantâneos

2. No separador Resumos, veja a lista de resumos no projeto.

3. Na coluna Nome, clique no nome da imagem instantânea padrão. É apresentada a página Detalhes do resumo do resumo selecionado, que mostra as respetivas propriedades.

gcloud

• Para ver informações sobre uma imagem instantânea padrão com âmbito global, use o comando gcloud compute snapshots describe.

  gcloud compute snapshots describe SNAPSHOT_NAME
  

• (Pré-visualização) Para ver informações sobre um resumo padrão com âmbito regional, use o comando gcloud compute snapshots describe e especifique a região.

  gcloud compute snapshots describe SNAPSHOT_NAME --regions=REGION_NAME
  

Substitua o seguinte:

• SNAPSHOT_NAME: o nome do resumo padrão.
• REGION_NAME: o nome da região à qual a sua imagem instantânea está delimitada.

REST

• Para ver informações sobre um instantâneo padrão com âmbito global, faça um pedido GET ao métodosnapshots.get.

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

• (Pré-visualização) Para ver informações sobre um instantâneo padrão com âmbito regional, faça um pedido GET ao método snapshots.get e especifique a região.

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

Substitua o seguinte:

• PROJECT_ID: o nome do projeto que contém a imagem instantânea padrão.
• SNAPSHOT_NAME: o nome do resumo padrão.
• REGION_NAME: o nome da região à qual a sua imagem instantânea está delimitada.

Consola

1. Aceda à página Instantâneos na Trusted Cloud consola.

   Aceda à página Instantâneos

2. Selecione uma ou mais capturas instantâneas que quer eliminar.

3. Na parte superior da página Momentos, clique em Eliminar.

gcloud

• Para eliminar uma imagem instantânea com âmbito global, use o comando gcloud compute snapshots delete.

  gcloud compute snapshots delete SNAPSHOT_NAME
  

• (Pré-visualização) Para eliminar uma captura de ecrã com âmbito regional, use o comando gcloud compute snapshots delete e especifique o nome da região.

  gcloud compute snapshots delete SNAPSHOT_NAME --regions=REGION_NAME
  

Substitua o seguinte:

• SNAPSHOT_NAME: o nome do resumo que quer eliminar.
• REGION_NAME: a região à qual o resumo está limitado.

Ir

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 uma captura instantânea com âmbito global, faça um DELETEpedido ao método snapshots.delete.

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

• (Pré-visualização) Para eliminar uma captura de ecrã com âmbito regional, faça um pedido DELETE ao método snapshots.delete e especifique a região.

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

Substitua o seguinte:

• PROJECT_ID: o nome do seu projeto.
• SNAPSHOT_NAME: o nome do instantâneo a eliminar.
• REGION_NAME: a região à qual o resumo está limitado.

gcloud

1. Crie uma captura instantânea padrão no projeto de destino com o comando gcloud compute snapshots create. Por exemplo, para criar uma imagem instantânea de um disco persistente zonal ou de um Hyperdisk, use o seguinte 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
   

   Substitua o seguinte:

   • SNAPSHOT_NAME: um nome para o novo instantâneo.
   • SOURCE_PROJECT_ID: o ID do projeto do disco de origem.
   • ZONE: a zona do disco de origem.
   • SOURCE_DISK_NAME: o nome do disco de origem.
   • DESTINATION_PROJECT_ID: o ID do projeto de destino para o novo instantâneo.

2. No projeto de destino, crie um disco zonal ou regional com base na captura de ecrã através do comando gcloud compute disks create:

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

   Substitua o seguinte:

   • DISK_NAME: um nome para o novo disco.
   • SNAPSHOT_NAME: o nome do resumo.
   • DESTINATION_PROJECT_ID: o ID do projeto de destino para o novo disco.

REST

1. Crie um instantâneo padrão no projeto de destino chamando o método snapshots.insert. Por exemplo, para tirar uma captura de ecrã de um disco persistente zonal ou de um Hyperdisk, faça o seguinte pedido:

   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
   }
   

   Substitua o seguinte:

   • DESTINATION_PROJECT_ID: o ID do projeto de destino do novo instantâneo.
   • SNAPSHOT_NAME: um nome para o resumo.
   • SOURCE_PROJECT_ID: o ID do projeto do disco de origem.
   • SOURCE_ZONE: a zona do disco de origem.
   • SOURCE_DISK_NAME: o nome do disco de origem.

2. No projeto de destino, crie um disco zonal ou regional com base na captura de ecrã através do disks.insertmétodo zonal ou do regionDisks.insertmétodo regional.

   Por exemplo, para criar um disco zonal, faça o seguinte pedido:

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

   Substitua o seguinte:

   • DESTINATION_PROJECT_ID: o ID do projeto de destino para o novo disco.
   • DESTINATION_ZONE: a zona no projeto de destino para o novo disco.
   • DISK_NAME: um nome para o novo disco.
   • SNAPSHOT_NAME: o nome do resumo.

Para ver uma lista dos instantâneos disponíveis, consulte o artigo Veja os instantâneos padrão num projeto ou numa localização.

gcloud

1. No projeto de origem, crie um disco baseado na captura de ecrã com o comando gcloud compute disks create.

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

   Substitua o seguinte:

   • DISK_NAME: um nome para o novo disco.
   • SNAPSHOT_NAME: o nome do resumo.
   • SOURCE_PROJECT_ID: o ID do projeto de origem.
   • ZONE: a zona na qual criar o novo disco.

   Este disco é um disco temporário criado apenas para copiar o instantâneo entre organizações.

2. No projeto de destino, crie uma captura instantânea com o comando gcloud compute snapshots create.

   Por exemplo, para criar um resumo com o disco zonal criado no primeiro passo, use o seguinte 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
   

   Substitua o seguinte:

   • SNAPSHOT_NAME: um nome para o resumo.
   • SOURCE_PROJECT_ID: o ID do projeto que contém o disco de origem.
   • ZONE: a zona do disco de origem.
   • DISK_NAME: o nome do disco criado no passo 1.
   • DESTINATION_PROJECT_ID: o ID do projeto de destino para o novo instantâneo.

   Para ver uma lista dos instantâneos disponíveis, consulte o artigo Veja os instantâneos padrão num projeto ou numa localização.

3. Elimine o disco temporário criado no primeiro passo com o comando gcloud compute disks delete.

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

   Substitua o seguinte:

   • DISK_NAME: o nome do disco criado no passo 1.
   • SOURCE_PROJECT_ID: o ID do projeto que contém o disco de origem.
   • ZONE: a zona do disco.

REST

1. No projeto de origem, crie um disco zonal ou regional com base na captura de ecrã através do método disks.insert zonal.

   Por exemplo, para criar um disco zonal, faça o seguinte pedido:

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

   Substitua o seguinte:

   • SOURCE_PROJECT_ID: o ID do projeto de origem do novo disco.
   • SOURCE_ZONE: a zona do novo disco.
   • DISK_NAME: um nome para o novo disco.
   • SNAPSHOT_NAME: o nome do resumo.

   Este disco é um disco temporário criado apenas para copiar o instantâneo entre organizações.

2. Crie um instantâneo no projeto de destino chamando o método snapshots.insert.

   Por exemplo, para criar um resumo com o disco zonal criado no primeiro passo, use o seguinte 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
   }
   

   Substitua o seguinte:

   • DESTINATION_PROJECT_ID: o ID do projeto de destino para o novo instantâneo.
   • SNAPSHOT_NAME: um nome para o resumo.
   • SOURCE_PROJECT_ID: O ID do projeto que contém o disco de origem.
   • SOURCE_ZONE: a zona do disco de origem.
   • DISK_NAME: o nome do disco de origem.

3. Elimine o disco temporário criado no primeiro passo através do método disks.delete.

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

   Substitua o seguinte:

   • SOURCE_PROJECT_ID: o ID do projeto que contém o disco temporário.
   • SOURCE_ZONE: a zona do disco.
   • DISK_NAME: o nome do disco temporário criado no passo 1.