Problèmes de mise à jour de la capacité de stockage

Cette page décrit les messages d'erreur courants que vous pouvez recevoir lorsque vous essayez de réduire ou de diminuer la capacité de stockage d'une instance.

Échec de la réduction du stockage pour les types de machines C4A et N4

L'erreur suivante peut se produire lorsque vous essayez d'appliquer une opération de réduction du stockage à un type de machine C4A ou N4 :

  ERROR: (gcloud.sql.instances.perform-storage-shrink) HTTPError 400: Invalid
  request: Requested provisioned IOPS is too high for the machine type and/or data disk size.

Les types de machines C4A et N4 utilisent Google Cloud Hyperdisk, qui permet aux utilisateurs d'ajuster les valeurs de débit et d'IOPS des disques. Si vous essayez de réduire la taille du disque à un point où les valeurs de débit et d'IOPS configurées deviennent non valides, l'opération de réduction du disque échoue et renvoie une erreur.

Dans cet exemple de message d'erreur, la valeur d'IOPS demandée pour l'instance est supérieure à la nouvelle valeur maximale d'IOPS pour les petits disques, et l'opération échoue.

Pour résoudre ce problème, recalculez la taille de stockage cible que vous souhaitez utiliser en fonction des limites Google Cloud Hyperdisk de votre machine, puis exécutez à nouveau l'opération de réduction du stockage.

Impossible de vérifier l'état de la résiliation

L'erreur suivante peut se produire lorsque vous essayez de vérifier l'état d'une demande d'annulation d'une opération de réduction de l'espace de stockage :

  {
    "kind": "sql#operation",
    "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/example_instance",
    "status": "RUNNING",
    "user": "user@example.com",
    "insertTime": "2023-12-18T22:54:11.663Z",
    "startTime": "2023-12-18T22:54:12.047Z",
    "error": {
      "kind": "sql#operationErrors",
      "errors": [
        {
          "kind": "sql#operationError",
          "code": "CANCEL_ERROR",
          "message": "The UPDATE operation 490cdbe6-8b75-415c-99c1-ccc80000004f can not be cancelled."
        }
      ]
    },
    "operationType": "UPDATE",
    "name": "OPERATION_ID",
    "targetId": "example_instance",
    "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
    "targetProject": "PROJECT_ID"
  }

Pour résoudre ce problème, procédez comme suit :

  1. Ce message d'erreur peut indiquer que la demande de résiliation est presque terminée. Réessayez de vérifier l'état de l'opération dans quelques minutes.
  2. Si le même message d'erreur s'affiche toujours, contactez l'assistance Cloud SQL pour obtenir de l'aide.

  3. Si l'opération réussit, un message semblable à celui-ci s'affiche :

    {
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/example_instance",
  "status": "DONE",
  "user": "user@example.com",
  "insertTime": "2023-12-18T22:54:11.663Z",
  "startTime": "2023-12-18T22:54:12.047Z",
  "error": {
    "kind": "sql#operationErrors",
    "errors": [
      {
        "kind": "sql#operationError",
        "code": "CANCEL_SUCCESSFUL",
        "message": "The UPDATE operation is canceled."
      }
    ]
  },
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "example_instance",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Échec de la réduction de l'espace de stockage

L'erreur suivante peut se produire lorsque vous essayez d'exécuter une opération de réduction du stockage :

  There is a pending blocking operation for instance: INSTANCE_NAME

Ce message d'erreur peut indiquer qu'une autre opération est toujours en cours, par exemple :

  • Opération de sauvegarde
  • Opération d'importation
  • Une opération de réduction du stockage précédente sur l'instance
  • Une opération de réduction du stockage est toujours en cours sur une instance principale associée à l'instance répliquée avec accès en lecture que vous souhaitez modifier.

Pour résoudre ce problème, attendez la fin de l'opération précédente.

Si une opération IMPORT précédente est bloquée, contactez l'assistance Cloud SQL pour demander de l'aide afin d'annuler l'opération.

Pour en savoir plus, consultez la section Limites.

Taille de stockage non valide pour une instance principale

Les erreurs suivantes peuvent se produire lorsque vous essayez d'exécuter une opération de réduction du stockage sur une instance principale et que la taille cible demandée n'est pas valide :

Exemple 1

  Invalid target storage size SIZE. Target storage
  size should be at least 10GB, which is the minimum storage size for a
  Cloud SQL instance.

  • La taille cible demandée doit être supérieure ou égale à la taille de stockage minimale autorisée pour l'instance.

    Pour résoudre le problème, spécifiez une taille de stockage cible plus importante et exécutez à nouveau l'opération.

    Pour en savoir plus, consultez la section Limites.

Exemple 2

  Instance INSTANCE_NAME cannot shrink storage further
  because the storage size is 10GB and the minimum storage size for a Cloud SQL
  instance is 10GB.

  • La taille cible demandée est trop petite. Si la taille cible demandée pour --storage-size est déjà à la taille minimale de 10 Go, vous ne pouvez pas la réduire davantage.

    Pour résoudre le problème, spécifiez une taille de stockage cible plus grande et exécutez à nouveau l'opération.

    Pour en savoir plus, consultez la section Limites.

Exemple 3

  ERROR: (gcloud.sql.instances.perform-storage-shrink) argument --storage-size: VALUE
  must be greater than or equal to 10GB; received: SIZE

  • Si la taille cible demandée pour --storage-size est trop petite, exécutez la commande suivante sur l'instance principale pour obtenir la capacité de stockage minimale autorisée :

    gcloud sql instances get-storage-shrink-config PRIMARY_INSTANCE_NAME

    La réponse inclut une valeur pour minimalTargetSizeGb. Vous pouvez utiliser cette valeur pour le paramètre --storage-size et exécuter à nouveau l'opération.

Exemple 4

  Invalid target storage size SIZE. Target storage
  size should be smaller than present storage size CURRENT_SIZE.

  • Si la taille cible demandée pour --storage-size est trop grande, cela signifie que la valeur est supérieure à la taille de stockage actuelle de l'instance principale et que vous devez utiliser une valeur plus petite.

    Si vous souhaitez disposer d'un disque plus volumineux, modifiez d'abord l'instance, puis réessayez l'opération.

Exemple 5

  Requested storage size is too close to current storage usage, request storage
  size should be minimum SIZEGB.

  • Si la taille cible demandée est trop proche de la taille de stockage existante, vous devez modifier la valeur et exécuter à nouveau l'opération. Voici quelques options de modification :

    • Augmentez la valeur cible.
    • Définissez la valeur cible sur la même valeur que minimalTargetSizeGb.

    Pour en savoir plus, consultez la section Limites.

Taille de stockage non valide pour une réplique

Les erreurs suivantes peuvent se produire lorsque vous essayez d'exécuter une opération de réduction du stockage sur un réplica et que la taille cible demandée n'est pas valide :

Exemple 1

  Cannot shrink storage further for replica INSTANCE_NAME
  because the minimum storage size for a Cloud SQL replica is 10GB.

Si la taille cible demandée pour --storage-size est déjà à la taille minimale de 10 Go, vous ne pouvez pas la réduire davantage.

Pour résoudre le problème, spécifiez une taille de stockage cible qui se situe dans une plage acceptable, puis exécutez à nouveau l'opération.

Pour en savoir plus, consultez la section Limites.

Exemple 2

  Cannot shrink storage further for replica REPLICA_INSTANCE_NAME
  because current replica storage size isn't greater than primary instance
  PRIMARY_INSTANCE_ID storage size. If you want to shrink
  both primary and replica instance, please shrink primary instance first.

La capacité de stockage d'une instance répliquée avec accès en lecture ne peut en aucun cas être inférieure à celle de son instance principale associée. Si vous souhaitez réduire la capacité de stockage d'une réplique, vous devez d'abord effectuer une opération de réduction du stockage sur son instance principale associée.

Pour en savoir plus, consultez la section Limites.

Espace de stockage insuffisant

L'erreur suivante peut se produire lorsque vous essayez de définir la taille de réduction du stockage :

  {
    "error": {
      "code": 400,
      "message": "Invalid target storage size TARGET_SIZE. ...",
      "errors": ...
  }

Ce message d'erreur peut indiquer que vous ne disposez pas de suffisamment d'espace de stockage sur l'instance.

Pour résoudre ce problème, procédez comme suit :

  1. Veillez à suivre toutes les étapes de réduction de l'espace de stockage.
  2. Assurez-vous que la taille de stockage cible est supérieure à la taille cible minimale que vous avez définie précédemment.

L'opération de réduction de l'espace de stockage échoue au bout de 10 jours

Les opérations de réduction du stockage expirent si elles durent plus de 10 jours.

Pour résoudre le problème, mettez à niveau le processeur de l'instance afin de réduire le temps d'opération global.

L'espace de stockage ne peut pas être réduit en raison d'une erreur interne

Les opérations de réduction de l'espace de stockage qui échouent peuvent renvoyer un message indiquant une erreur interne.

Pour résoudre le problème, contactez l'assistance Cloud SQL.

La commande de réduction du stockage gcloud échoue au bout de 10 minutes

L'erreur suivante peut se produire lorsque vous essayez de réduire la taille de stockage d'une instance à l'aide de la commande gcloud sql instances :

  Performing a storage size decrease on a Cloud SQL instance....failed.

Ce message d'erreur peut s'afficher si l'opération dure plus de 10 minutes.

Pour résoudre le problème, ajoutez l'indicateur --async à la fin de la commande pour attendre l'opération de manière asynchrone.

Étapes suivantes