Gerenciar instantâneos de disco

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Console

1. No console do Google Cloud, acesse a página Instantâneos .

   Vá para a página Instantâneos

2. Na guia Instantâneos , você pode ver os instantâneos padrão do projeto atual.

3. Opcional. Restrinja seus resultados com o campo Filtro filter_list . Insira um nome ou valor de propriedade no campo Filtro ou escolha uma das propriedades disponíveis.

gcloud

• Para ver uma lista de todos os snapshots disponíveis em um projeto específico, use o comando gcloud compute snapshots list .

  gcloud compute snapshots list --project=PROJECT_ID
  

• ( Visualização ) Para ver uma lista de snapshots com escopo regional disponíveis para você em um 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 snapshots com escopo global disponíveis para você em um projeto específico, use o comando gcloud compute snapshots list e inclua a sinalização --global .

  gcloud compute snapshots list --global
  

Substitua o seguinte:

• PROJECT_ID : Opcional. Substitua pelo ID do projeto. Se você omitir esse sinalizador, o projeto atual será usado. Você pode definir o projeto padrão para sua sessão usando o comando da CLI gcloud gcloud config set project PROJECT_ID .
• REGION_NAME : o nome da região da qual você deseja visualizar instantâneos.

DESCANSAR

• Para ver uma lista de todos os snapshots disponíveis em um projeto específico, faça uma solicitação GET para o método snapshots.list e especifique "agregado".

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

• ( Visualização ) Para ver uma lista de snapshots com escopo regional disponíveis para você em um projeto específico, faça uma solicitação GET para o 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 snapshots com escopo global disponíveis para você em um projeto específico, faça uma solicitação GET para o 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 da qual você deseja visualizar instantâneos.

Console

1. No console do Google Cloud, acesse a página Instantâneos .

   Vá para a página Instantâneos

2. Na guia Instantâneos , aparece uma lista de todos os instantâneos padrão do projeto.

3. Limite os resultados por disco de origem:

   1. Insira Source disk: no campo Filtro filter_list ou clique no campo Filtro e escolha o valor Source disk na lista Propriedades .

   2. Selecione o nome do disco na lista Valores que aparece ao lado de Source disk: no campo Filtro .

      Os instantâneos exibidos no console agora mostram todos os instantâneos padrão do disco especificado.

      Se você não vir o nome de um disco na lista Valores , no campo Filtro próximo a Source disk: digite as primeiras letras do nome do disco de origem para alterar a lista de valores que você vê.

gcloud

Liste os snapshots padrão de um disco com o comando gcloud compute snapshots list e o argumento --filter .

• Liste os snapshots padrão para um disco zonal:

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

• Liste os instantâneos padrão para 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 : (somente discos zonais) o nome da zona do disco, por exemplo, us-west1-a .
• SOURCE_REGION : (somente discos regionais) o nome da região do disco, por exemplo, us-west1 .
• DISK_NAME : o nome do disco, por exemplo, disk-1 .

DESCANSAR

Liste os snapshots padrão para um disco zonal ou regional com uma solicitação GET para o método snapshots.list .

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

• Liste os snapshots padrão para 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 para 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 : (somente discos zonais) o nome da zona do disco, por exemplo, us-west1-a .
• SOURCE_REGION : (somente 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 .

Console

1. No console do Google Cloud, acesse a página Instantâneos .

   Vá para a página Instantâneos

2. Na guia Instantâneos , visualize a lista de instantâneos no projeto.

3. Na coluna Nome , clique no nome do instantâneo padrão. A página de detalhes do instantâneo selecionado é exibida, mostrando suas propriedades.

gcloud

• Para visualizar informações sobre um snapshot padrão com escopo global, use o comando gcloud compute snapshots describe .

  gcloud compute snapshots describe SNAPSHOT_NAME
  

• ( Visualização ) Para visualizar informações sobre um snapshot padrão com escopo 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 instantâneo padrão.
• REGION_NAME : o nome da região cujo escopo é o snapshot.

DESCANSAR

• Para visualizar informações sobre um snapshot padrão com escopo global, faça uma solicitação GET para o método snapshots.get .

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

• ( Visualização ) Para visualizar informações sobre um snapshot padrão com escopo regional, faça uma solicitação GET para o 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 o instantâneo padrão.
• SNAPSHOT_NAME : o nome do instantâneo padrão.
• REGION_NAME : o nome da região cujo escopo é o snapshot.

Console

1. Acesse a página Instantâneos no console do Google Cloud.

   Vá para a página Instantâneos

2. Selecione um ou mais instantâneos que deseja excluir.

3. Na parte superior da página Instantâneos , clique em Excluir .

gcloud

• Para excluir um snapshot com escopo global, use o comando gcloud compute snapshots delete .

  gcloud compute snapshots delete SNAPSHOT_NAME
  

• ( Visualização ) Para excluir um snapshot com escopo 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 instantâneo que você deseja excluir.
• REGION_NAME : a região cujo escopo o instantâneo tem como escopo.

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();

Pitão

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")

DESCANSAR

• Para excluir um snapshot com escopo global, faça uma solicitação DELETE para o método snapshots.delete .

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

• ( Visualização ) Para excluir um instantâneo com escopo regional, faça uma solicitação DELETE para o 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 ser excluído.
• REGION_NAME : a região cujo escopo o instantâneo tem como escopo.

gcloud

1. Crie um snapshot padrão no projeto de destino usando o comando gcloud compute snapshots create . Por exemplo, para criar um snapshot de um disco permanente ou hiperdisco zonal, 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 para o 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 baseado no snapshot usando o 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 instantâneo.
   • DESTINATION_PROJECT_ID : o ID do projeto de destino para o novo disco.

DESCANSAR

1. Crie um instantâneo padrão no projeto de destino chamando o método snapshots.insert . Por exemplo, para tirar um snapshot de um disco permanente ou hiperdisco zonal, faça a seguinte solicitação:

   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 para o novo instantâneo.
   • SNAPSHOT_NAME : um nome para o instantâneo.
   • 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 baseado no instantâneo usando o método zonal disks.insert ou o método regional regionDisks.insert .

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

   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 do novo disco.
   • DISK_NAME : um nome para o novo disco.
   • SNAPSHOT_NAME : o nome do instantâneo.

Para obter uma lista de instantâneos disponíveis, consulte Visualizar os instantâneos padrão em um projeto ou local .

gcloud

1. No projeto de origem, crie um disco baseado no snapshot usando 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 instantâneo.
   • SOURCE_PROJECT_ID : o ID do projeto de origem.
   • ZONE : A zona para 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 um snapshot usando o comando gcloud compute snapshots create .

   Por exemplo, para criar um instantâneo usando o disco zonal criado na primeira etapa, 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 instantâneo.
   • 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 na etapa 1.
   • DESTINATION_PROJECT_ID : o ID do projeto de destino para o novo instantâneo.

   Para obter uma lista de instantâneos disponíveis, consulte Visualizar os instantâneos padrão em um projeto ou local .

3. Exclua o disco temporário criado na primeira etapa usando 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 na etapa 1.
   • SOURCE_PROJECT_ID : o ID do projeto que contém o disco de origem.
   • ZONE : A zona do disco.

DESCANSAR

1. No projeto de origem, crie um disco zonal ou regional baseado no snapshot usando o método zonal disks.insert .

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

   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 instantâneo.

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

2. Crie um snapshot no projeto de destino chamando o método snapshots.insert .

   Por exemplo, para criar um instantâneo usando o disco zonal criado na primeira etapa, 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 instantâneo.
   • 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. Exclua o disco temporário criado na primeira etapa usando o 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 na etapa 1.