Pour obtenir la version actuelle de gcloud CLI, exécutez gcloud --version.
Pour mettre à jour la version de gcloud CLI, exécutez gcloud components update.
Obtenez les autorisations IAM suivantes :
cloudsql.instances.getDiskShrinkConfig
cloudsql.instances.performDiskShrink
Ces autorisations sont disponibles dans l'un des rôles suivants. Lorsque vous attribuez votre rôle, nous vous recommandons d'appliquer le principe du moindre privilège :
Administrateur Cloud SQL (roles/cloudsql.admin)
Éditeur Cloud SQL (roles/cloudsql.editor)
Pour en savoir plus, consultez les ressources suivantes :
Avant de commencer, assurez-vous de satisfaire les conditions suivantes.
Ces étapes sont les mêmes pour les instances principales et les instances dupliquées avec accès en lecture.
Si vous mettez à jour une instance répliquée avec accès en lecture, veillez à réduire d'abord la capacité de l'instance principale, puis la taille de la réplique.
Désactivez toutes les extensions ou fonctionnalités qui permettent les connexions sortantes (ou qui nécessitent le transfert de données sortantes).
Réduire la capacité de stockage d'une instance
Les étapes suivantes sont les mêmes pour les instances principales et les instances répliquées avec accès en lecture.
Vérifiez la capacité de stockage minimale cible de l'instance et la durée estimée de l'opération. Ces informations peuvent vous aider à planifier l'opération de réduction de l'espace de stockage.
La réponse inclut une valeur pour minimalTargetSizeGb. Vous pouvez utiliser cette valeur pour déterminer celle que vous souhaitez utiliser pour le paramètre --storage-size lorsque vous exécutez une opération de réduction du stockage.
La réponse renvoie également un message indiquant la durée estimée de l'opération, semblable à ce qui suit :
...
"The estimated operation time is 20 minutes".
REST v1
Utilisez la méthode GET pour afficher la capacité de stockage minimale cible de l'instance.
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
PROJECT_ID : nom du projet dans lequel réside l'instance principale.
INSTANCE_ID : ID de l'instance principale.
Méthode HTTP et URL :
GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/getDiskShrinkConfig
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{
"kind": "sql#instance",
"min_target_size_gb": "1234"
"message": "The size of your instance's storage impacts IOPS, and therefore shrinking your storage
may have a negative impact on IOPS. Before shrinking your storage, please refer to our
documentation on Cloud SQL limits to understand what impact shrinking your storage might have:
https://cloud.google.com/sql/docs/quotas#fixed-limits. Additionally, we recommend leaving an
appropriate buffer for operational purposes, like reindexing, etc. We recommend a buffer of at
least 100 GB or 20% more than current usage, whichever is larger. For more details, please refer
to: https://cloud.google.com/sql/docs/shared-responsibility. The estimated operation time is
20 minutes."
}
La réponse inclut une valeur pour min_target_size_gb. Vous pouvez utiliser cette valeur pour déterminer celle que vous souhaitez utiliser pour le paramètre --storage-size lorsque vous exécutez une opération de réduction du stockage.
La réponse renvoie également un message indiquant la durée estimée de l'opération, comme suit :
...
"The estimated operation time is 20 minutes".
REST v1beta4
Utilisez la méthode GET pour afficher la capacité de stockage minimale cible de l'instance.
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
PROJECT_ID : nom du projet dans lequel réside l'instance principale.
INSTANCE_ID : ID de l'instance principale.
Méthode HTTP et URL :
GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/getDiskShrinkConfig
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{
"kind": "sql#instance",
"min_target_size_gb": "1234"
"message": "The size of your instance's storage impacts IOPS, and therefore shrinking your storage
may have a negative impact on IOPS. Before shrinking your storage, please refer to our
documentation on Cloud SQL limits to understand what impact shrinking your storage might have:
https://cloud.google.com/sql/docs/quotas#fixed-limits. Additionally, we recommend leaving an
appropriate buffer for operational purposes, like reindexing, etc. We recommend a buffer of at
least 100 GB or 20% more than current usage, whichever is larger. For more details, please refer
to: https://cloud.google.com/sql/docs/shared-responsibility. The estimated operation time is
20 minutes."
}
La réponse inclut une valeur pour min_target_size_gb. Vous pouvez utiliser cette valeur pour déterminer celle que vous souhaitez utiliser pour le paramètre --storage-size lorsque vous exécutez une opération de réduction du stockage.
La réponse renvoie également un message indiquant la durée estimée de l'opération, semblable à ce qui suit :
...
"The estimated operation time is 20 minutes".
Réduisez la capacité de stockage de l'instance.
gcloud
Exécutez la commande suivante pour réduire l'espace de stockage sur l'instance :
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2026/03/31 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2026/03/31 (UTC)."],[],[]]
