VM 삭제

이 문서에서는 가상 머신(VM) 인스턴스를 삭제하는 방법을 설명합니다.

VM이 더 이상 필요하지 않으면 VM과 연결된 리소스에 대한 요금이 청구되지 않도록 VM을 삭제합니다. 연결된 리소스를 보존하려면 VM을 삭제하기 전에 다음 중 하나 이상을 수행합니다.

삭제하려는 N1 VM에 연결된 GPU를 보존하려면 VM에서 GPU를 삭제합니다.
Persistent Disk를 보존하려면 다음 중 하나를 수행합니다.
- 부팅 디스크를 보존하려면 VM에서 부팅 디스크를 분리합니다.
- 부팅 디스크나 비부팅 디스크를 보존하려면 디스크의 자동 삭제 설정을 false로 설정합니다.
VM에서 고정 외부 IP 주소를 할당 해제합니다.

시작하기 전에

아직 인증을 설정하지 않았다면 설정합니다. 인증은 Google Cloud 서비스 및 API에 액세스하기 위해 ID를 확인하는 프로세스입니다. 로컬 개발 환경에서 코드 또는 샘플을 실행하려면 다음과 같이 Compute Engine에 인증하면 됩니다.

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.

필요한 역할

VM을 삭제하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Compute 인스턴스 관리자(v1)(roles/compute.instanceAdmin.v1) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 VM을 삭제하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

VM을 삭제하려면 다음 권한이 필요합니다.

VM에 대한 compute.instances.delete 권한
연결된 Persistent Disk 강제: 디스크에 대한 compute.disks.delete 권한

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

가격 영향

VM을 삭제한 후에는 다음 상황이 발생하지 않는 한 Google Cloud에서 더 이상 VM과 연결된 리소스에 대한 요금을 청구하지 않습니다.

단독 테넌트 노드에서 호스팅되는 VM을 삭제하면 노드에서 호스팅되는 개별 VM 대신 단독 테넌트 노드 자체에 대한 요금이 계속 청구됩니다.
약정 사용 할인의 경우 리소스 사용 여부와 관계없이 약정한 리소스에 대한 요금이 계속 청구됩니다.
VM에 연결된 리소스를 보존하는 경우 리소스를 삭제할 때까지 리소스에 대한 요금이 계속 청구됩니다. 예를 들어 VM을 삭제했지만 VM에 연결된 Persistent Disk 볼륨을 보존하면 디스크에 대한 요금이 계속 청구됩니다.

자세한 내용은 VM 인스턴스 가격 책정을 참조하세요.

VM 삭제 프로세스

VM을 삭제하면 Compute Engine에서 다음을 수행합니다.

Compute Engine은 ACPI 종료 신호를 VM에 전송한 후 몇 초 이내에 VM 상태를 STOPPING으로 설정합니다.
Compute Engine이 VM 내에서 운영체제(OS) 완전 종료를 시작합니다. 종료 기간은 VM 유형에 따라 다음과 같이 지속됩니다.
- 선점형 VM: 선점형 VM의 종료 기간은 30초이며 이는 선점 프로세스 길이와 같습니다.
- 기타 VM 유형: 다른 모든 VM 유형의 종료 기간은 최소 90초 이상입니다.
종료 기간이 끝나면 Compute Engine에서 VM과 연결된 리소스를 영구 삭제합니다. 연결된 VM을 삭제할 때 Persistent Disk를 보존하도록 구성한 경우 Compute Engine은 VM을 삭제할 때 디스크를 보존합니다.

VM 삭제

VM을 하나 이상 삭제하려면 이 문서의 다음 섹션 중 하나를 참조하세요.

VM과 연결된 모든 리소스를 삭제하려면(기본값) VM 및 연결된 모든 리소스 삭제를 참조하세요.
VM을 삭제하지만 연결된 Persistent Disk 볼륨을 보존하려면 VM 삭제 및 Persistent Disk 볼륨 보존을 참조하세요.

VM 및 연결된 모든 리소스 삭제

VM을 삭제하면 Compute Engine은 기본적으로 VM과 연결된 모든 리소스를 삭제합니다. 그러나 VM을 삭제할 때 Persistent Disk가 보존되도록 구성한 경우 gcloud CLI를 사용하여 이 설정을 재정의하고 VM과 디스크를 모두 삭제할 수 있습니다.

VM 여러 개를 동시에 삭제하려면 Google Cloud 콘솔을 사용하거나 같은 영역에 있는 VM의 경우 gcloud CLI를 사용합니다. 그렇지 않은 경우 단일 VM을 삭제하려면 이 섹션에 설명된 메서드를 사용합니다.

콘솔

VM을 하나 이상 삭제하려면 다음을 수행합니다.

Google Cloud 콘솔에서 VM 인스턴스 페이지로 이동합니다.

VM 인스턴스로 이동
삭제하려는 VM을 선택합니다.
삭제를 클릭한 후 다시 삭제를 클릭하여 확인합니다.

gcloud

VM을 하나 이상 삭제하려면 gcloud compute instances delete 명령어를 사용합니다.

gcloud compute instances delete VM_NAMES \
    --zone=ZONE

다음을 바꿉니다.

VM_NAMES: 공백으로 구분된 같은 영역에 있는 VM 이름 목록입니다(예: vm-01 vm-02 vm-03).
ZONE: VM의 영역

원하는 경우 VM 하나 이상에 연결된 Persistent Disk 볼륨을 강제 삭제하려면 --delete-disks 플래그를 포함합니다.

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

DELETE_DISK_TYPE을 삭제할 연결된 Persistent Disk 볼륨 유형으로 바꿉니다. 다음 값 중 하나를 지정합니다.

모든 유형의 디스크를 삭제하려면 all을 지정합니다.
부팅 디스크만 삭제하려면 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
}

자바


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

VM을 삭제하려면 DELETE 요청을 instances delete 메서드에 보냅니다.

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

다음을 바꿉니다.

PROJECT_ID: VM이 있는 프로젝트의 ID입니다.
ZONE: VM의 영역
VM_NAME: VM 이름입니다.

VM 삭제 및 Persistent Disk 볼륨 보존

기본적으로 VM을 삭제하면 VM과 연결된 리소스가 삭제됩니다. 하지만 gcloud CLI를 사용하여 VM을 삭제하면 디스크의 자동 삭제 설정과 관계없이 연결된 부팅 디스크, 비부팅 디스크 또는 둘 다 보존되도록 지정할 수 있습니다.

연결된 Persistent Disk 볼륨을 보존하면서 같은 영역에 있는 VM을 하나 이상 삭제하려면 --keep-disks 플래그와 함께 gcloud compute instances delete 명령어를 사용합니다.

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

다음을 바꿉니다.

VM_NAMES: 공백으로 구분된 같은 영역에 있는 VM 이름 목록입니다(예: vm-01 vm-02 vm-03).
KEEP_DISK_TYPE: 보존할 연결된 Persistent Disk 볼륨의 유형입니다. 다음 값 중 하나를 지정합니다.
- 모든 유형의 디스크를 보존하려면 all을 지정합니다.
- 부팅 디스크만 보존하려면 boot를 지정합니다.
- 비부팅 디스크만 보존하려면 data를 지정합니다.
ZONE: VM이 있는 영역입니다.

다음 단계

VM 수명 주기 자세히 알아보기
중지된 VM에 발생하는 비용 자세히 알아보기
VM 런타임을 제한하는 방법 알아보기

VM 삭제

시작하기 전에

Console

gcloud

C#

Go

자바

Node.js

PHP

Python

Ruby

REST

필요한 역할

필수 권한

가격 영향

VM 삭제 프로세스

VM 삭제

VM 및 연결된 모든 리소스 삭제

콘솔

gcloud

C#

Go

자바

Node.js

PHP

Python

Ruby

REST

VM 삭제 및 Persistent Disk 볼륨 보존

다음 단계