Supprimer des instances

Cette page explique comment supprimer des instances Cloud SQL.

Tenez compte des points suivants lorsque vous prévoyez de supprimer une instance :

Vous ne pouvez pas supprimer une instance qui contient des instances dupliquées. Vous devez d'abord supprimer toutes les instances dupliquées.
Vous pouvez réduire le risque de suppression accidentelle d'une instance en créant une instance dupliquée ; une instance dupliquée doit être supprimée avant son instance principale.
Après la suppression d'une instance, il est possible que celle-ci apparaisse toujours dans votre projet avec une taille "inconnue", mais avec l'état "Suppression en cours". Ce comportement est normal. L'instance disparaît complètement après un court instant.
La suppression complète des ressources sous-jacentes associées à une instance peut prendre jusqu'à une semaine, à l'exception des instances dupliquées avec accès en lecture, qui sont souvent supprimées en quelques minutes.
Le nom de l'instance supprimée peut être réutilisé immédiatement pour créer une nouvelle instance.
Si la protection contre la suppression est activée sur une instance, vous devez la désactiver avant de supprimer l'instance.

Autorisations requises

Par défaut, seuls les comptes utilisateur ou comptes de service dotés du rôle Cloud SQL Admin (roles/cloudsql.admin) ou Owner (roles/owner) sont autorisés à supprimer une instance Cloud SQL. (cloudsql.instances.delete).

Vous pouvez également définir un rôle personnalisé IAM pour le compte d'utilisateur ou le compte de service, qui inclut l'autorisation cloudsql.instances.delete. Cette autorisation est compatible avec les rôles personnalisés IAM.

Supprimer une instance

Vous pouvez supprimer une instance Cloud SQL à l'aide de gcloud CLI ou de l'API.

Remarque : Avant de supprimer une instance, assurez-vous que cela ne présente aucun risque. Vérifiez ensuite que la protection contre la suppression est désactivée pour l'instance.

Si vous supprimez une instance pour laquelle Private Service Connect est activé, les actions suivantes se produisent :

Le rattachement de service est automatiquement supprimé. Toutefois, le point de terminaison Private Service Connect qui pointe vers le rattachement de service n'est pas supprimé automatiquement. En listant la règle de transfert qui est associée au point de terminaison, vous pouvez voir que cette règle possède l'état CLOSED. Une fois que vous avez reçu cet état, vous pouvez supprimer le point de terminaison.
Vous constaterez que la connexion au point de terminaison expire.

Pour éviter des frais supplémentaires, nous vous recommandons vivement de supprimer également la zone DNS et l'enregistrement DNS correspondants.

Console

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

Accéder à la page Instances Cloud SQL
Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
Cliquez sur Supprimer.
Dans la boîte de dialogue Supprimer une instance de base de données, cliquez sur OK.

gcloud

Pour supprimer une instance, utilisez la commande gcloud sql instances delete :

gcloud sql instances delete INSTANCE_NAME \
--project=PROJECT_ID

Effectuez les remplacements suivants :

INSTANCE_NAME : nom de l'instance
PROJECT_ID : ID ou numéro de projet du projet Google Cloud contenant l'instance que vous souhaitez supprimer.

REST v1

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

PROJECT_ID : ID ou numéro de projet du projet Google Cloud contenant l'instance que vous souhaitez supprimer.
INSTANCE_NAME : nom de l'instance

Méthode HTTP et URL :

DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

Vous devriez recevoir une réponse JSON de ce type :

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-15T00:10:22.078Z",
  "operationType": "DELETE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Pour découvrir comment est formée la requête sous-jacente de l'API REST pour cette tâche, consultez la page sur la méthode instances:delete dans APIs Explorer.

REST v1beta4

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

PROJECT_ID : ID ou numéro de projet du projet Google Cloud contenant l'instance que vous souhaitez supprimer.
INSTANCE_NAME : nom de l'instance

Méthode HTTP et URL :

DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Exécutez la commande suivante :

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

Exécutez la commande suivante :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

Vous devriez recevoir une réponse JSON de ce type :

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-15T00:10:22.078Z",
  "operationType": "DELETE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Pour découvrir comment est formée la requête sous-jacente de l'API REST pour cette tâche, consultez la page sur la méthode instances:delete dans APIs Explorer.