Supprimer une VM

Ce document explique comment supprimer des instances de machine virtuelle (VM).

Si vous n'avez plus besoin d'une VM, supprimez-la pour éviter que des frais ne soient facturés pour la VM et les ressources associées. Si vous souhaitez conserver une ressource associée, effectuez l'une ou plusieurs des opérations suivantes avant de supprimer la VM :

Pour conserver un GPU associé à une VM N1 que vous souhaitez supprimer, supprimez le GPU de la VM.
Pour conserver un disque persistant, effectuez l'une des opérations suivantes :
- Pour conserver un disque de démarrage, dissociez le disque de démarrage de la VM.
- Pour conserver un disque de démarrage ou non amorçable, définissez le paramètre de suppression automatique du disque sur false.
Annulez l'attribution de l'adresse IP externe statique à la VM.

Avant de commencer

Si ce n'est pas déjà fait, configurez l'authentification. L'authentification est le processus permettant de valider votre identité pour accéder aux services et aux API Google Cloud. Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine comme suit :

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.

Rôles requis

Pour obtenir les autorisations nécessaires pour supprimer une VM, demandez à votre administrateur de vous accorder le rôle IAM Administrateur d'instances Compute (v1) (roles/compute.instanceAdmin.v1) sur le projet. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient les autorisations nécessaires pour supprimer une VM. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour supprimer une VM :

compute.instances.delete sur la VM
Pour forcer la suppression d'un disque persistant associé : compute.disks.delete sur le disque

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Implications en termes de facturation

Une fois que vous avez supprimé une VM, Google Cloud ne vous facture plus la VM et ses ressources associées, sauf dans les cas suivants :

Si vous supprimez une VM hébergée sur un nœud à locataire unique, vous continuez à payer pour celui-ci et non pour les VM individuelles hébergées sur le nœud.
Si vous bénéficiez d'une remise sur engagement d'utilisation, vous continuez à payer pour les ressources auxquelles vous êtes abonné, que vous les utilisiez ou non.
Si vous conservez des ressources associées à la VM, elles continueront de vous être facturées jusqu'à ce que vous les supprimiez. Par exemple, si vous supprimez une VM, mais que vous conservez les volumes Persistent Disk qui y sont associés, les disques continuent à vous être facturés.

Pour en savoir plus, consultez la page Tarifs des instances de VM.

Procédure de suppression d'une VM

Lorsque vous supprimez une VM, Compute Engine effectue les opérations suivantes :

Compute Engine envoie le signal ACPI de désactivation à la VM, puis définit l'état de la VM sur STOPPING en quelques secondes.
Compute Engine lance un arrêt normal du système d'exploitation (OS) au sein de la VM. La période d'arrêt dure comme suit en fonction du type de VM :
- VM préemptives : les VM préemptives ont un temps d'arrêt de 30 secondes, soit la même durée que le processus de préemption.
- Autres types de VM : tous les autres types de VM ont une période d'arrêt d'au moins 90 secondes.
À la fin de la période d'arrêt, Compute Engine supprime définitivement la VM et ses ressources associées. Si vous avez configuré un disque persistant à conserver lors de la suppression de la VM à laquelle il est associé, Compute Engine le conserve lors de la suppression de la VM.

Supprimer des VM

Pour supprimer une ou plusieurs VM, consultez l'une des sections suivantes de ce document :

Pour supprimer les VM et toutes les ressources qui leur sont associées (par défaut), consultez la section Supprimer les VM et toutes les ressources associées.
Pour supprimer des VM tout en conservant les volumes de disques persistants qui y sont associés, consultez la section Supprimer des VM tout en conservant les volumes de disques persistants.

Supprimer les VM et toutes les ressources associées

Lorsque vous supprimez une VM, Compute Engine supprime par défaut la VM et toutes les ressources qui lui sont associées. Toutefois, si vous avez configuré un disque persistant à conserver lors de la suppression de la VM, vous pouvez remplacer ce paramètre et supprimer à la fois la VM et le disque à l'aide de gcloud CLI.

Pour supprimer plusieurs VM simultanément, utilisez la console Google Cloud ou, pour les VM situées dans la même zone, CLI gcloud. Sinon, pour supprimer une seule VM, utilisez l'une des méthodes décrites dans cette section.

Console

Pour supprimer une ou plusieurs VM, procédez comme suit :

Dans Google Cloud Console, accédez à la page Instances de VM.

Accéder à la page Instances de VM
Sélectionnez la version que vous souhaitez supprimer.
Cliquez sur Supprimer, puis à nouveau sur Supprimer pour confirmer l'opération.

gcloud

Pour supprimer une ou plusieurs VM, utilisez la commande gcloud compute instances delete.

gcloud compute instances delete VM_NAMES \
    --zone=ZONE

Remplacez les éléments suivants :

VM_NAMES : liste des noms des VM situées dans la même zone, séparés par des espaces (par exemple, vm-01 vm-02 vm-03).
ZONE : zone de la VM.

Vous pouvez également forcer la suppression des volumes de disques persistants associés à une ou plusieurs VM en incluant l'option --delete-disks.

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

Remplacez DELETE_DISK_TYPE par le type des volumes de disques persistants associés à supprimer. Spécifiez une des valeurs suivantes :

Pour supprimer tous les types de disques : all.
Pour ne supprimer que les disques de démarrage : boot.
Pour supprimer uniquement les disques non amorçables : 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

Pour supprimer une réservation, envoyez une requête DELETE à la méthode instances delete.

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

Remplacez les éléments suivants :

PROJECT_ID : ID du projet dans lequel se trouve la VM.
ZONE : zone de la VM.
VM_NAME : nom de la VM.

Supprimer des VM et conserver les volumes de disque persistant

Par défaut, la suppression d'une VM supprime la VM et les ressources associées. Toutefois, lorsque vous supprimez une VM à l'aide de gcloud CLI, vous pouvez spécifier de conserver les disques de démarrage associés, les disques non amorçables, ou les deux, indépendamment du paramétrage automatique des disques.

Pour supprimer une ou plusieurs VM situées dans la même zone tout en conservant les volumes de disques persistants associés, utilisez la commande gcloud compute instances delete avec l'option --keep-disks.

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

Remplacez les éléments suivants :

VM_NAMES : liste des noms des VM situées dans la même zone, séparés par des espaces (par exemple, vm-01 vm-02 vm-03).
KEEP_DISK_TYPE : types de volumes de disques persistants associés à conserver. Spécifiez une des valeurs suivantes :
- Pour conserver tous les types de disques : all.
- Pour ne conserver que les disques de démarrage : boot.
- Pour conserver uniquement les disques non amorçables : data.
ZONE : zone où se trouvent les VM.

Étape suivante

Obtenez davantage d'informations sur le cycle de vie des VM.
En savoir plus sur les frais liés aux VM arrêtées
Découvrez comment limiter l'environnement d'exécution d'une VM.