Halaman ini diterjemahkan oleh Cloud Translation API.

Menghapus instance Compute Engine

Dokumen ini menjelaskan cara menghapus instance Compute Engine. Untuk mempelajari lebih lanjut siklus proses instance, lihat Siklus proses instance Compute Engine.

Jika Anda tidak lagi memerlukan instance, hapus instance tersebut untuk berhenti dikenai tagihan untuk instance dan resource yang terpasang.

Jika Anda ingin mempertahankan resource yang terlampir, lakukan satu atau beberapa hal berikut sebelum menghapus instance:

Untuk mempertahankan GPU yang terpasang ke instance virtual machine (VM) N1, hapus GPU dari VM.
Untuk mempertahankan disk yang terpasang, lakukan salah satu hal berikut:
- Untuk mempertahankan boot disk, lepaskan boot disk dari instance.
- Untuk mempertahankan disk booting atau non-booting, tetapkan setelan penghapusan otomatis disk ke false.
Untuk mempertahankan data disk SSD Lokal, salin data disk ke opsi penyimpanan persisten.
Untuk menggunakan kembali alamat IP eksternal statis instance, batalkan penetapan alamat IP.

Sebelum memulai

Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi adalah proses verifikasi identitas Anda untuk mengakses layanan dan API Google Cloud. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat mengautentikasi ke Compute Engine dengan memilih salah satu opsi berikut:

Select the tab for how you plan to use the samples on this page:
Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
1. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk menghapus instance komputasi, minta administrator untuk memberi Anda peran IAM Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) pada project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk menghapus instance komputasi. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk menghapus instance komputasi:

compute.instances.delete pada instance
Untuk memaksa penghapusan disk yang terpasang: compute.disks.delete pada disk

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Implikasi penagihan

Setelah Anda menghapus instance komputasi, Google Cloud tidak lagi menagih Anda untuk instance dan resource yang terpasang, kecuali jika salah satu situasi berikut berlaku:

Jika menghapus instance yang dihosting di node tenant tunggal, Anda akan terus membayar untuk node tenant tunggal itu sendiri, bukan instance individual yang dihosting di node tersebut.
Jika memiliki diskon abonemen, Anda akan terus membayar untuk resource yang sudah disepakati, terlepas dari apakah Anda menggunakan resource tersebut atau tidak.
Jika Anda mempertahankan semua resource yang telah terpasang ke instance, Anda akan terus dikenai biaya untuk resource tersebut sampai Anda menghapusnya. Misalnya, jika Anda menghapus instance, tetapi mempertahankan disk yang terpasang, Anda akan terus dikenai biaya untuk disk tersebut.

Untuk mengetahui informasi selengkapnya, lihat Harga instance VM.

Menghapus instance

Saat Anda menghapus instance komputasi, Compute Engine akan terlebih dahulu menghentikan instance jika instance tersebut sedang berjalan. Selain itu, Anda dapat memilih untuk menghapus atau mempertahankan disk yang terpasang sebagai berikut:

Menghapus instance dan semua resource yang terpasang

Gunakan opsi ini untuk menghapus satu atau beberapa instance secara bersamaan, dan menghapus, atau memaksa penghapusan, disk yang terpasang.
Menghapus instance dan mempertahankan disk

Gunakan opsi ini untuk menghapus satu atau beberapa instance secara bersamaan, tetapi mempertahankan disk yang terpasang.

Menghapus instance dan semua resource yang terpasang

Saat Anda menghapus instance komputasi, Compute Engine akan menghapus instance tersebut dan semua resource yang terpasang secara default. Namun, jika Anda mengonfigurasi disk yang terpasang untuk dipertahankan setelah penghapusan instance, Anda dapat mengganti setelan ini dan memaksa penghapusannya saat menghapus instance menggunakan gcloud CLI.

Anda dapat menghapus beberapa instance secara bersamaan atau satu per satu. Untuk beberapa instance, gunakan konsol Google Cloud atau, untuk instance yang berada di zona yang sama, gunakan gcloud CLI. Untuk setiap instance, pilih salah satu opsi berikut:

Konsol

Di konsol Google Cloud, buka halaman Instance VM.

Buka instance VM
Pilih instance yang ingin Anda hapus.
Klik Hapus, lalu klik Hapus lagi untuk mengonfirmasi.

gcloud

Untuk menghapus satu atau beberapa instance dalam satu zona, gunakan perintah gcloud compute instances delete:

gcloud compute instances delete INSTANCE_NAMES \
    --zone=ZONE

Ganti kode berikut:

INSTANCE_NAMES: daftar nama instance yang dipisahkan spasi—misalnya, instance-01 instance-02 instance-03.
ZONE: zona tempat instance berada.

Secara opsional, untuk memaksa penghapusan disk yang dilampirkan ke satu atau beberapa instance, sertakan flag --delete-disks.

gcloud compute instances delete INSTANCE_NAMES \
    --delete-disks=DELETE_DISK_TYPE \
    --zone=ZONE

Ganti DELETE_DISK_TYPE dengan salah satu nilai berikut:

Untuk menghapus penyimpanan persisten booting dan non-booting yang terpasang: all
Untuk hanya menghapus penyimpanan persisten booting yang terpasang: boot
Untuk menghapus hanya penyimpanan persisten non-boot: data

C#


using Google.Cloud.Compute.V1;
using System.Threading.Tasks;

public class DeleteInstanceAsyncSample
{
    public async Task DeleteInstanceAsync(
        // TODO(developer): Set your own default values for these parameters or pass different values when calling this method.
        string projectId = "your-project-id",
        string zone = "us-central1-a",
        string machineName = "test-machine")
    {

        // Initialize client that will be used to send requests. This client only needs to be created
        // once, and can be reused for multiple requests.
        InstancesClient client = await InstancesClient.CreateAsync();

        // Make the request to delete a VM instance.
        var instanceDeletion = await client.DeleteAsync(projectId, zone, machineName);

        // Wait for the operation to complete using client-side polling.
        await instanceDeletion.PollUntilCompletedAsync();
    }
}

Go

import (
	"context"
	"fmt"
	"io"

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

// deleteInstance sends a delete request to the Compute Engine API and waits for it to complete.
func deleteInstance(w io.Writer, projectID, zone, instanceName string) error {
	// projectID := "your_project_id"
	// zone := "europe-central2-b"
	// instanceName := "your_instance_name"
	ctx := context.Background()
	instancesClient, err := compute.NewInstancesRESTClient(ctx)
	if err != nil {
		return fmt.Errorf("NewInstancesRESTClient: %w", err)
	}
	defer instancesClient.Close()

	req := &computepb.DeleteInstanceRequest{
		Project:  projectID,
		Zone:     zone,
		Instance: instanceName,
	}

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

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

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

	return nil
}

Java


import com.google.api.gax.longrunning.OperationFuture;
import com.google.cloud.compute.v1.DeleteInstanceRequest;
import com.google.cloud.compute.v1.InstancesClient;
import com.google.cloud.compute.v1.Operation;
import java.io.IOException;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.TimeoutException;

public class DeleteInstance {

  public static void main(String[] args)
      throws IOException, InterruptedException, ExecutionException, TimeoutException {
    // TODO(developer): Replace these variables before running the sample.
    String project = "your-project-id";
    String zone = "zone-name";
    String instanceName = "instance-name";
    deleteInstance(project, zone, instanceName);
  }

  // Delete the instance specified by `instanceName`
  // if it's present in the given project and zone.
  public static void deleteInstance(String project, String zone, String instanceName)
      throws IOException, InterruptedException, ExecutionException, 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 `instancesClient.close()` method on the client to safely
    // clean up any remaining background resources.
    try (InstancesClient instancesClient = InstancesClient.create()) {

      System.out.printf("Deleting instance: %s ", instanceName);

      // Describe which instance is to be deleted.
      DeleteInstanceRequest deleteInstanceRequest = DeleteInstanceRequest.newBuilder()
          .setProject(project)
          .setZone(zone)
          .setInstance(instanceName).build();

      OperationFuture<Operation, Operation> operation = instancesClient.deleteAsync(
          deleteInstanceRequest);
      // Wait for the operation to complete.
      Operation response = operation.get(3, TimeUnit.MINUTES);

      if (response.hasError()) {
        System.out.println("Instance deletion failed ! ! " + response);
        return;
      }
      System.out.println("Operation Status: " + response.getStatus());
    }
  }
}

Node.js

/**
 * TODO(developer): Uncomment these variables before running the sample.
 */
// const projectId = 'YOUR_PROJECT_ID';
// const zone = 'europe-central2-b'
// const instanceName = 'YOUR_INSTANCE_NAME';

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

// Delete the instance specified by `instanceName` if it's present in the given project and zone.
async function deleteInstance() {
  const instancesClient = new compute.InstancesClient();

  console.log(`Deleting ${instanceName} from ${zone}...`);

  const [response] = await instancesClient.delete({
    project: projectId,
    zone,
    instance: instanceName,
  });
  let operation = response.latestResponse;
  const operationsClient = new compute.ZoneOperationsClient();

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

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

deleteInstance();

PHP

use Google\Cloud\Compute\V1\Client\InstancesClient;
use Google\Cloud\Compute\V1\DeleteInstanceRequest;

/**
 * Delete an instance.
 *
 * @param string $projectId Your Google Cloud project ID.
 * @param string $zone Zone where the instance you want to delete is (like "us-central1-a").
 * @param string $instanceName Unique name for the Compute instance to delete.
 *
 * @throws \Google\ApiCore\ApiException if the remote call fails.
 * @throws \Google\ApiCore\ValidationException if local error occurs before remote call.
 */
function delete_instance(
    string $projectId,
    string $zone,
    string $instanceName
) {
    // Delete the Compute Engine instance using InstancesClient.
    $instancesClient = new InstancesClient();
    $request = (new DeleteInstanceRequest())
        ->setInstance($instanceName)
        ->setProject($projectId)
        ->setZone($zone);
    $operation = $instancesClient->delete($request);

    // Wait for the operation to complete.
    $operation->pollUntilComplete();
    if ($operation->operationSucceeded()) {
        printf('Deleted instance %s' . PHP_EOL, $instanceName);
    } else {
        $error = $operation->getError();
        printf('Failed to delete instance: %s' . PHP_EOL, $error?->getMessage());
    }
}

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_instance(project_id: str, zone: str, machine_name: str) -> None:
    """
    Send an instance deletion request to the Compute Engine API and wait for it to complete.

    Args:
        project_id: project ID or project number of the Cloud project you want to use.
        zone: name of the zone you want to use. For example: “us-west3-b”
        machine_name: name of the machine you want to delete.
    """
    instance_client = compute_v1.InstancesClient()

    print(f"Deleting {machine_name} from {zone}...")
    operation = instance_client.delete(
        project=project_id, zone=zone, instance=machine_name
    )
    wait_for_extended_operation(operation, "instance deletion")
    print(f"Instance {machine_name} deleted.")

Ruby


require "google/cloud/compute/v1"

# Sends an instance deletion request to the Compute Engine API and waits for it to complete.
#
# @param [String] project project ID or project number of the Cloud project you want to use.
# @param [String] zone name of the zone you want to use. For example: "us-west3-b"
# @param [String] instance_name name of the instance you want to delete.
def delete_instance project:, zone:, instance_name:
  # Initialize client that will be used to send requests. This client only needs to be created
  # once, and can be reused for multiple requests.
  client = ::Google::Cloud::Compute::V1::Instances::Rest::Client.new

  puts "Deleting #{instance_name} from #{zone}..."
  begin
    # Make the request to delete a VM instance.
    operation = client.delete project: project, zone: zone, instance: instance_name
    # Wait for the delete operation to complete.
    operation = wait_until_done operation: operation

    if operation.error?
      warn "Error during deletion:", operation.error
    else
      compute_operation = operation.operation
      warn "Warning during creation:", compute_operation.warnings unless compute_operation.warnings.empty?
      puts "Instance #{instance_name} deleted."
    end
  rescue ::Google::Cloud::Error => e
    warn "Exception during deletion:", e
  end
end

REST

Untuk menghapus instance, buat permintaan DELETE ke metode instances delete:

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME

Ganti kode berikut:

PROJECT_ID: ID project tempat instance berada.
ZONE: zona instance.
INSTANCE_NAME: nama instance.

Menghapus instance dan mempertahankan disk

Secara default, menghapus instance komputasi akan menghapus instance dan resource terlampir. Namun, saat menghapus instance menggunakan gcloud CLI, Anda dapat menentukan untuk mempertahankan disk yang terpasang, terlepas dari setelan hapus otomatis-nya.

Untuk menghapus satu atau beberapa instance dalam satu zona sekaligus mempertahankan disk yang terpasang, gunakan perintah gcloud compute instances delete dengan flag --keep-disks:

gcloud compute instances delete INSTANCE_NAMES \
    --keep-disks=KEEP_DISK_TYPE \
    --zone=ZONE

Ganti kode berikut:

INSTANCE_NAMES: daftar nama instance yang dipisahkan spasi—misalnya, instance-01 instance-02 instance-03.
KEEP_DISK_TYPE: tentukan salah satu nilai berikut:
- Untuk mempertahankan penyimpanan persisten booting dan non-booting yang terpasang: all
- Untuk hanya mempertahankan penyimpanan persisten booting yang terpasang: boot
- Untuk hanya mempertahankan penyimpanan persisten non-boot yang terpasang: data
ZONE: zona tempat instance berada.

Menghapus instance Compute Engine

Sebelum memulai

Console

gcloud

C#

Go

Java

Node.js

PHP

Python

Ruby

REST

Peran yang diperlukan

Izin yang diperlukan

Implikasi penagihan

Menghapus instance

Menghapus instance dan semua resource yang terpasang

Konsol

gcloud

C#

Go

Java

Node.js

PHP

Python

Ruby

REST

Menghapus instance dan mempertahankan disk

Langkah selanjutnya