Cómo reducir la capacidad de almacenamiento de la instancia
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
En esta página, se muestra cómo administrar la capacidad de almacenamiento de una instancia de Cloud SQL con las capacidades de reducción de almacenamiento.
Para obtener la versión actual de gcloud CLI, ejecuta gcloud --version.
Para actualizar la versión de gcloud CLI, ejecuta gcloud components update.
Obtén los siguientes permisos de IAM:
cloudsql.instances.getDiskShrinkConfig
cloudsql.instances.performDiskShrink
Estos permisos están disponibles en cualquiera de los siguientes roles. Cuando asignes tu rol, te recomendamos que apliques el principio de privilegio mínimo:
Administrador de Cloud SQL (roles/cloudsql.admin)
Editor de Cloud SQL (roles/cloudsql.editor)
Para obtener más información, consulta los siguientes recursos:
Si ejecutas una instancia de PostgreSQL, establece el valor de la marca max_wal_size en menos de 5128 MB. Si el valor de max_wal_size es demasiado grande, es posible que la instancia tarde en iniciarse y que la operación falle.
Inhabilita todas las extensiones o funciones que habiliten conexiones salientes (o que requieran transferencia de datos saliente).
Por ejemplo, se puede establecer una conexión saliente con una de estas extensiones o funciones, y se debe inhabilitar antes de realizar una operación de reducción de almacenamiento:
dblink extensión
PL/proxy extensión
pglogical extensión
Wrapper de datos externos (como postgres_fdw, oracle_fdw y tds_fdw)
Cómo reducir la capacidad de almacenamiento de una instancia
Los siguientes pasos son los mismos para las instancias principales y las réplicas de lectura.
Verifica la capacidad de almacenamiento mínima objetivo de la instancia y el tiempo de operación estimado. Esta información puede ayudarte a planificar la operación de reducción del almacenamiento.
INSTANCE_NAME: Es el nombre de la instancia principal.
La respuesta incluye un valor para minimalTargetSizeGb. Puedes usar este valor para determinar el valor que deseas usar para el parámetro --storage-size cuando ejecutas una operación de reducción de almacenamiento.
La respuesta también muestra un mensaje con un tiempo de operación estimado, similar al siguiente:
...
"The estimated operation time is 20 minutes".
REST v1
Usa el método GET para ver la capacidad de almacenamiento mínima objetivo de la instancia.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
PROJECT_ID: Es el nombre del proyecto en el que reside la instancia principal.
INSTANCE_ID: Es el ID de la instancia principal.
Método HTTP y URL:
GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/getDiskShrinkConfig
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Respuesta
{
"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 respuesta incluye un valor para min_target_size_gb. Puedes usar este valor para determinar el valor que deseas usar para el parámetro --storage-size cuando ejecutas una operación de reducción de almacenamiento.
La respuesta también muestra un mensaje con un tiempo de operación estimado, similar al siguiente:
...
"The estimated operation time is 20 minutes".
REST v1beta4
Usa el método GET para ver la capacidad de almacenamiento mínima objetivo de la instancia.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
PROJECT_ID: Es el nombre del proyecto en el que reside la instancia principal.
INSTANCE_ID: Es el ID de la instancia principal.
Método HTTP y URL:
GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/getDiskShrinkConfig
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Respuesta
{
"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 respuesta incluye un valor para min_target_size_gb. Puedes usar este valor para determinar el valor que deseas usar para el parámetro --storage-size cuando ejecutas una operación de reducción de almacenamiento.
La respuesta también muestra un mensaje con un tiempo de operación estimado, similar al siguiente:
...
"The estimated operation time is 20 minutes".
Reducir la capacidad de almacenamiento de la instancia
gcloud
Ejecuta el siguiente comando para reducir el almacenamiento en la instancia:
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2026-03-31 (UTC)"],[],[]]
