Cette page a été traduite par l'API Cloud Translation.

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 :

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.
En cas de problème, effectuez une sauvegarde finale pour restaurer l'instance supprimée.

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 la console Google Cloud, 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. Nous vous recommandons également vivement de créer une dernière sauvegarde de l'instance avant de la supprimer.

Si vous avez utilisé Cloud Key Management Service pour chiffrer votre instance, mais que les clés KMS ne sont pas accessibles, l'état de la sauvegarde finale est FAILED après la suppression de l'instance. Dans ce cas, demandez à récupérer votre instance en contactant le service client Cloud dans les quatre jours suivant la suppression de 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.

ConsolegcloudREST v1REST v1beta4

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 l'instance, procédez comme suit:

Dans le champ de texte, saisissez l'ID de l'instance qui s'affiche.
Si vous souhaitez effectuer une sauvegarde finale de l'instance, laissez la case Effectuer une sauvegarde finale cochée, développez le menu Options de conservation, puis, dans le champ Conserver pendant, saisissez le nombre de jours pendant lesquels vous souhaitez conserver la sauvegarde finale. Vous pouvez spécifier une période comprise entre 1 et 365 jours.

Si vous souhaitez supprimer l'instance sans effectuer de sauvegarde finale, décochez la case.
Dans la zone de texte Décrire cette sauvegarde, vous pouvez fournir une description de la sauvegarde.
Cliquez sur Supprimer.

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.

Remarque : Si vous souhaitez effectuer une dernière sauvegarde de l'instance, utilisez les options suivantes:

--enable-final-backup: définissez la valeur de cet indicateur sur true pour effectuer une dernière sauvegarde. Si vous souhaitez supprimer l'instance sans effectuer de sauvegarde finale, définissez la valeur sur false.
--final-backup-description: fournit des informations sur la sauvegarde finale. La valeur par défaut est vide.
--final-backup-ttl-days: spécifiez le nombre de jours de conservation de la sauvegarde finale. C'est ce que l'on appelle la valeur TTL (Time to Live). La valeur par défaut est de 30 jours. La période de conservation autorisée varie de 1 à 365 jours. Pour indiquer la période de conservation, utilisez cette option ou --final-backup-expiry-time.
--final-backup-expiry-time: code temporel (au format UTC) de l'expiration de la sauvegarde. Cette période ne peut pas dépasser un an. Pour indiquer la période de conservation, utilisez cette option ou --final-backup-ttl-days.

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

Remarque : Si vous souhaitez effectuer une dernière sauvegarde de l'instance, utilisez les paramètres de requête suivants:

enable_final_backup: définissez la valeur de ce paramètre sur true pour effectuer une sauvegarde finale. Si vous souhaitez supprimer l'instance sans effectuer de sauvegarde finale, définissez la valeur sur false.
final_backup_description: fournit des informations sur la sauvegarde finale. La valeur par défaut est vide.
final_backup_ttl_days: spécifiez le nombre de jours de conservation de la sauvegarde finale. C'est ce que l'on appelle la valeur TTL (Time to Live). La valeur par défaut est de 30 jours. La période de conservation autorisée varie de 1 à 365 jours. Pour indiquer la période de conservation, utilisez ce paramètre ou final_backup_expiry_time.
final_backup_expiry_time: code temporel (au format UTC) de l'expiration de la sauvegarde. Cette période ne peut pas dépasser un an. Pour indiquer la période de conservation, utilisez ce paramètre ou final_backup_ttl_days.

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.

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

Remarque : Si vous souhaitez effectuer une dernière sauvegarde de l'instance, utilisez les paramètres de requête suivants:

enable_final_backup: définissez la valeur de ce paramètre sur true pour effectuer une sauvegarde finale. Si vous souhaitez supprimer l'instance sans effectuer de sauvegarde finale, définissez la valeur sur false.
final_backup_description: fournit des informations sur la sauvegarde finale. La valeur par défaut est vide.
final_backup_ttl_days: spécifiez le nombre de jours de conservation de la sauvegarde finale. C'est ce que l'on appelle la valeur TTL (Time to Live). La valeur par défaut est de 30 jours. La période de conservation autorisée varie de 1 à 365 jours. Pour indiquer la période de conservation, utilisez ce paramètre ou final_backup_expiry_time.
final_backup_expiry_time: code temporel (au format UTC) de l'expiration de la sauvegarde. Cette période ne peut pas dépasser un an. Pour indiquer la période de conservation, utilisez ce paramètre ou final_backup_ttl_days.

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.

Restaurer une instance supprimée

Lorsque vous supprimez une instance, Cloud SQL supprime toutes les ressources associées, y compris les sauvegardes à la demande et les sauvegardes automatiques.

Si vous effectuez une sauvegarde finale lors de la suppression d'une instance, vous pouvez utiliser cette sauvegarde pour la récupérer, soit en créant une instance à partir de la sauvegarde finale, soit en la restaurant sur une instance existante.

Si vous utilisez une sauvegarde finale pour récupérer votre instance, il est possible qu'elle ait une adresse IP différente de celle de l'instance d'origine supprimée.

Si vous supprimez accidentellement une instance sans effectuer de sauvegarde finale, vous pouvez demander à la récupérer en contactant le service client Cloud dans les quatre jours suivant la suppression de l'instance. Si l'instance peut être récupérée, sa configuration, y compris les adresses IP utilisées avant la suppression, est restaurée. Toutes les sauvegardes disponibles au moment de la suppression sont également récupérées.