Habilita e inhabilita la alta disponibilidad

En esta página, se describe cómo configurar una instancia para alta disponibilidad.

Puedes configurar una instancia para alta disponibilidad cuando la creas, o bien habilitar la alta disponibilidad en una instancia existente.

Para obtener más información sobre la alta disponibilidad, consulta la página Descripción general de la configuración de alta disponibilidad.

Crea una instancia nueva para alta disponibilidad

Cuando creas una instancia y la configuras para alta disponibilidad, Cloud SQL la crea como una instancia regional.

Para crear una instancia que tenga alta disponibilidad configurada, realiza los siguientes pasos:

Console

  1. En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

  2. Selecciona Crear instancia.
  3. Selecciona el motor de base de datos.
  4. En la sección Elegir la región y la disponibilidad zonal, selecciona Varias zonas (con alta disponibilidad).
  5. Expande Especificar zonas.
  6. Selecciona las zonas principal y secundaria. Se aplican las siguientes condiciones cuando se usa la zona secundaria durante la creación o la edición de la instancia:
    • Las zonas están predeterminadas como Any para la zona principal y Any (different from primary) para la zona secundaria.
    • Si se especifican las zonas principal y secundaria, deben ser zonas diferentes.

  7. Haz clic en Guardar.

    Volverás a la página de la instancia principal mientras la instancia se actualiza.

gcloud

  1. Crea la instancia regional:
    gcloud sql instances create REGIONAL_INSTANCE_NAME \
    --availability-type=REGIONAL \
    --database-version=DATABASE_VERSION \
    --cpu=NUMBER_CPUS \
    --memory=MEMORY_SIZE
    
    Para obtener una lista completa de los parámetros disponibles, consulta la página de referencia gcloud sql instances create.
  2. Configura el usuario raíz:
    gcloud sql users set-password root no-host \
    --instance=REGIONAL_INSTANCE_NAME \
    --password=PASSWORD
    

Terraform

Para crear una instancia con alta disponibilidad, usa un recurso de Terraform.

resource "google_sql_database_instance" "postgres_instance_ha" {
  name             = "postgres-instance-ha"
  region           = "us-central1"
  database_version = "POSTGRES_14"
  settings {
    tier              = "db-custom-2-7680"
    availability_type = "REGIONAL"
    backup_configuration {
      enabled                        = true
      point_in_time_recovery_enabled = true
      start_time                     = "20:55"
    }
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

Aplique los cambios

Para aplicar tu configuración de Terraform en un proyecto de Google Cloud, completa los pasos de las siguientes secciones.

Prepara Cloud Shell

  1. Inicia Cloud Shell
  2. Establece el proyecto de Google Cloud predeterminado en el que deseas aplicar tus configuraciones de Terraform.

    Solo necesitas ejecutar este comando una vez por proyecto y puedes ejecutarlo en cualquier directorio.

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

    Las variables de entorno se anulan si configuras valores explícitos en el archivo de configuración de Terraform.

Prepara el directorio

Cada archivo de configuración de Terraform debe tener su propio directorio (también llamado módulo raíz).

  1. En Cloud Shell, crea un directorio y un archivo nuevo dentro de ese directorio. El nombre del archivo debe tener la extensión .tf, por ejemplo, main.tf. En este instructivo, el archivo se denomina main.tf.
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf
  2. Si sigues un instructivo, puedes copiar el código de muestra en cada sección o paso.

    Copia el código de muestra en el main.tf recién creado.

    De manera opcional, copia el código de GitHub. Esto se recomienda cuando el fragmento de Terraform es parte de una solución de extremo a extremo.

  3. Revisa y modifica los parámetros de muestra que se aplicarán a tu entorno.
  4. Guarda los cambios.
  5. Inicialice Terraform. Solo debes hacerlo una vez por directorio.
    terraform init

    De manera opcional, incluye la opción -upgrade para usar la última versión del proveedor de Google:

    terraform init -upgrade

Aplica los cambios

  1. Revisa la configuración y verifica que los recursos que creará o actualizará Terraform coincidan con tus expectativas:
    terraform plan

    Corrige la configuración según sea necesario.

  2. Para aplicar la configuración de Terraform, ejecuta el siguiente comando y, luego, escribe yes cuando se te solicite:
    terraform apply

    Espera hasta que Terraform muestre el mensaje “¡Aplicación completa!”.

  3. Abre tu proyecto de Google Cloud para ver los resultados. En la consola de Google Cloud, navega a tus recursos en la IU para asegurarte de que Terraform los haya creado o actualizado.

Borra los cambios

Para borrar tus cambios, haz lo siguiente:

  1. Para inhabilitar la protección contra la eliminación, en tu archivo de configuración de Terraform, establece el argumento deletion_protection en false.
    deletion_protection =  "false"
  2. Para aplicar la configuración actualizada de Terraform, ejecuta el siguiente comando y, luego, ingresa yes cuando se te solicite:
    terraform apply
  1. Quita los recursos que se aplicaron antes con tu configuración de Terraform a través de la ejecución del siguiente comando y, luego, ingresa yes cuando se te solicite:

    terraform destroy

REST v1

Si quieres obtener la lista completa de los parámetros de esta solicitud, visita la página instances:insert.

Crea la instancia regional.

  1. Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

    • project-id: El ID del proyecto
    • instance-name: es el nombre de la instancia.
    • database-version: es la string de enumeración de la versión de la base de datos.
    • region: La región de GCP
    • machine-type: es el tipo de máquina.

    Método HTTP y URL:

    POST https://sqladmin.googleapis.com/v1/projects/project-id/instances

    Cuerpo JSON de la solicitud:

    {
      "name": "instance-name",
      "region": "region",
      "databaseVersion": "database-version",
       "settings": {
         "tier": "machine-type",
         "backupConfiguration": {
             "enabled": true,
             "pointInTimeRecoveryEnabled": true
          },
          "availabilityType": "REGIONAL"
       }
    }
    

    Para enviar tu solicitud, expande una de estas opciones:

    Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

  2. Una vez que la instancia termina de inicializarse, actualiza la contraseña raíz en la instancia:

    Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

    • project-id: el ID del proyecto
    • instance-id: El ID de la instancia
    • password: es la contraseña de usuario raíz nueva.

    Método HTTP y URL:

    PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/users?host=%25&name=postgres'

    Cuerpo JSON de la solicitud:

    {
       "name": "postgres",
       "host": "nohost",
       "password": "password"}
    

    Para enviar tu solicitud, expande una de estas opciones:

    Deberías recibir un código de estado exitoso (2xx) y una respuesta vacía.

REST v1beta4

Si quieres obtener la lista completa de los parámetros de esta solicitud, visita la página instances:insert.

Crea la instancia regional.

  1. Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

    • project-id: El ID del proyecto
    • instance-name: es el nombre de la instancia.
    • database-version: es la string de enumeración de la versión de la base de datos.
    • region: La región de GCP
    • machine-type: es el tipo de máquina.

    Método HTTP y URL:

    POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances

    Cuerpo JSON de la solicitud:

    {
      "name": "instance-name",
      "region": "region",
      "databaseVersion": "database-version",
       "settings": {
         "tier": "machine-type",
         "backupConfiguration": {
             "enabled": true,
             "pointInTimeRecoveryEnabled": true
          },
          "availabilityType": "REGIONAL"
       }
    }
    

    Para enviar tu solicitud, expande una de estas opciones:

    Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

  2. Una vez que la instancia termina de inicializarse, actualiza la contraseña raíz en la instancia:

    Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

    • project-id: el ID del proyecto
    • instance-id: El ID de la instancia
    • password: es la contraseña de usuario raíz nueva.

    Método HTTP y URL:

    PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users?host=%25&name=postgres'

    Cuerpo JSON de la solicitud:

    {
       "name": "postgres",
       "host": "nohost",
       "password": "password"}
    

    Para enviar tu solicitud, expande una de estas opciones:

    Deberías recibir un código de estado exitoso (2xx) y una respuesta vacía.

Para obtener más información sobre cómo crear una instancia, consulta Crea instancias.

Configura una instancia existente de alta disponibilidad

Para configurar una instancia de Cloud SQL para obtener alta disponibilidad, puedes usar la consola de Google Cloud, gcloud CLI o la API.

Console

Para configurar una instancia para obtener alta disponibilidad, sigue estos pasos:

  1. En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

  2. Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
  3. Haz clic en Edit.
  4. En la sección de opciones de configuración Copias de seguridad automáticas y alta disponibilidad, selecciona Alta disponibilidad (regional). También se recomienda habilitar Automatizar copias de seguridad.
  5. Haz clic en Guardar.

gcloud

Si quieres configurar una instancia para que sea regional y de alta disponibilidad, usa el comando gcloud sql instances patch:

gcloud sql instances patch INSTANCE_NAME \
--availability-type REGIONAL

Reemplaza INSTANCE_NAME por el nombre de la instancia de Cloud SQL que configuras para obtener alta disponibilidad.

REST v1

Para configurar una instancia para que sea regional y con alta disponibilidad, sigue estos pasos:

  1. Verifica la instancia para ver si las copias de seguridad automáticas y la recuperación de un momento determinado están habilitadas. Estos son obligatorios para las instancias de alta disponibilidad.

    Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

    • PROJECT_ID: el ID o el número del proyecto de Google Cloud que contiene la instancia
    • INSTANCE_NAME: el nombre de la instancia que configuras para obtener alta disponibilidad

    HTTP method and URL:

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

    Para enviar tu solicitud, expande una de estas opciones:

    Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

    {
      "kind": "sql#instance",
      "state": "RUNNABLE",
      "databaseVersion": "POSTGRES_13"
    }
    

    El resultado contiene una sección similar a la siguiente:

      "backupConfiguration": {
        "kind": "sql#backupConfiguration",
        "startTime": "12:00",
        "enabled": true,
        "pointInTimeRecoveryEnabled": true
        }
      
  2. Si enabled o pointInTimeRecoveryEnabled son false, usa el método instances:patch para habilitarlos a ambos. Para habilitar las copias de seguridad, configura enabled en true y startTime en un valor que sea el inicio de la ventana de copia de seguridad. Para habilitar el registro binario, configura pointInTimeRecoveryEnabled en true.

    Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

    • PROJECT_ID: el ID o el número del proyecto de Google Cloud que contiene la instancia
    • INSTANCE_NAME: el nombre de la instancia principal o de réplica de lectura que configuras para obtener alta disponibilidad
    • START_TIME: el tiempo (en horas y minutos)

    HTTP method and URL:

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

    Cuerpo JSON de la solicitud:

    {
      "settings":
      {
        "backupConfiguration":
        {
          "startTime": "START_TIME",
          "enabled": true,
          "pointInTimeRecoveryEnabled": true
        }
      }
    }
    

    Para enviar tu solicitud, expande una de estas opciones:

    Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

  3. Configura la instancia para que sea una instancia regional y de alta disponibilidad:

    Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

    • PROJECT_ID: el ID o el número del proyecto de Google Cloud que contiene la instancia
    • INSTANCE_NAME: el nombre de la instancia que configuras para obtener alta disponibilidad

    HTTP method and URL:

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

    Cuerpo JSON de la solicitud:

    {
      "settings": {"availabilityType": "REGIONAL" }
    }
    

    Para enviar tu solicitud, expande una de estas opciones:

    Deberías recibir un código de estado exitoso (2xx) y una respuesta vacía.

REST v1beta4

Para configurar una instancia para que sea regional y con alta disponibilidad, sigue estos pasos:

  1. Verifica la instancia para ver si las copias de seguridad automáticas y la recuperación de un momento determinado están habilitadas. Estos son obligatorios para las instancias de alta disponibilidad.

    Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

    • PROJECT_ID: el ID o el número del proyecto de Google Cloud que contiene la instancia
    • INSTANCE_NAME: el nombre de la instancia que configuras para obtener alta disponibilidad

    HTTP method and URL:

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

    Para enviar tu solicitud, expande una de estas opciones:

    Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

    {
      "kind": "sql#instance",
      "state": "RUNNABLE",
      "databaseVersion": "POSTGRES_13",
    }
    

    El resultado contiene una sección similar a la siguiente:

      "backupConfiguration": {
        "kind": "sql#backupConfiguration",
        "startTime": "12:00",
        "enabled": true,
        "pointInTimeRecoveryEnabled": true
        }
      
  2. Si enabled o pointInTimeRecoveryEnabled son false, usa el método instances:patch para habilitarlos a ambos. Para habilitar las copias de seguridad, configura enabled en true y startTime en un valor que sea el inicio de la ventana de copia de seguridad. Para habilitar el registro binario, configura pointInTimeRecoveryEnabled en true.

    Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

    • PROJECT_ID: el ID o el número del proyecto de Google Cloud que contiene la instancia
    • INSTANCE_NAME: el nombre de la instancia principal o de réplica de lectura que configuras para obtener alta disponibilidad
    • START_TIME: el tiempo (en horas y minutos)

    HTTP method and URL:

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

    Cuerpo JSON de la solicitud:

    {
      "settings":
      {
        "backupConfiguration":
        {
          "startTime": "START_TIME",
          "enabled": true,
          "pointInTimeRecoveryEnabled": true
        }
      }
    }
    

    Para enviar tu solicitud, expande una de estas opciones:

    Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

  3. Configura la instancia para que sea una instancia regional y de alta disponibilidad:

    Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

    • PROJECT_ID: el ID o el número del proyecto de Google Cloud que contiene la instancia
    • INSTANCE_NAME: el nombre de la instancia que configuras para obtener alta disponibilidad

    HTTP method and URL:

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

    Cuerpo JSON de la solicitud:

    {
      "settings": {"availabilityType": "REGIONAL" }
    }
    

    Para enviar tu solicitud, expande una de estas opciones:

    Deberías recibir un código de estado exitoso (2xx) y una respuesta vacía.

Inicia la conmutación por error

Realizar pruebas sobre la conmutación por error es opcional, pero se recomienda para probar cómo responde tu aplicación en caso de que ocurra una conmutación por error.

Para obtener más información sobre las conmutaciones por error, consulta la Descripción general de conmutaciones por error.

Console

  1. En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

  2. Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
  3. Haz clic en Conmutación por error.
  4. En el cuadro de diálogo Activar una conmutación por error de forma manual, ingresa el ID de tu instancia en el campo de texto y, luego, haz clic en Activar conmutación por error.

gcloud

Inicia la conmutación por error:

gcloud sql instances failover PRIMARY_INSTANCE_NAME

REST v1

  1. Describe la instancia principal para obtener el valor del campo settingsVersion.

    Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

    • PROJECT_ID: el ID o el número del proyecto de Google Cloud que contiene la instancia
    • INSTANCE_NAME: el nombre de la instancia que configuras para obtener alta disponibilidad

    HTTP method and URL:

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

    Para enviar tu solicitud, expande una de estas opciones:

    Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

    {
      "kind": "sql#instance",
      "state": "RUNNABLE",
      "databaseVersion": "POSTGRES_13"
    }
    
  2. Inicia la conmutación por error:

    Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

    • project-id: El ID del proyecto
    • instance-name: El nombre de la instancia
    • settings-version: es el valor settingsVersion de instanceInfo.

    Método HTTP y URL:

    POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-name/failover

    Cuerpo JSON de la solicitud:

    {
      "failoverContext":
         {
            "settingsVersion":"settings-version"
         }
    }
    

    Para enviar tu solicitud, expande una de estas opciones:

    Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

REST v1beta4

  1. Describe la instancia principal para obtener el valor del campo settingsVersion.

    Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

    • PROJECT_ID: el ID o el número del proyecto de Google Cloud que contiene la instancia
    • INSTANCE_NAME: el nombre de la instancia que configuras para obtener alta disponibilidad

    HTTP method and URL:

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

    Para enviar tu solicitud, expande una de estas opciones:

    Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

    {
      "kind": "sql#instance",
      "state": "RUNNABLE",
      "databaseVersion": "POSTGRES_13"
    }
    
  2. Inicia la conmutación por error:

    Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

    • project-id: El ID del proyecto
    • instance-name: El nombre de la instancia
    • settings-version: es el valor settingsVersion de instanceInfo.

    Método HTTP y URL:

    POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-name/failover

    Cuerpo JSON de la solicitud:

    {
      "failoverContext":
         {
            "settingsVersion":"settings-version"
         }
    }
    

    Para enviar tu solicitud, expande una de estas opciones:

    Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

La instancia se conmuta por error y deja de estar disponible para entregar datos durante algunos minutos.

Verifica la configuración de alta disponibilidad de una instancia

Para verificar que una instancia tiene alta disponibilidad y ver las zonas en las que se ejecuta, sigue estos pasos:

Console

  1. En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

  2. Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
  3. Confirma que los siguientes parámetros de configuración de alta disponibilidad se muestran en la sección Configuración:
    • Con alta disponibilidad (regional)
    • Ubicada en muestra la zona principal actual de la instancia.

gcloud

gcloud sql instances describe INSTANCE_NAME

El resultado indica que availabilityType es REGIONAL. En los campos gceZone y secondaryGceZone, se muestran las zonas principal y secundaria actuales de la instancia.

REST v1

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: el ID o el número del proyecto de Google Cloud que contiene la instancia
  • INSTANCE_NAME: el nombre de la instancia que configuras para obtener alta disponibilidad

HTTP method and URL:

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

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_13"
}

El resultado indica que availabilityType es REGIONAL. En los campos gceZone y secondaryGceZone, se muestran las zonas principal y secundaria actuales de la instancia.

REST v1beta4

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: el ID o el número del proyecto de Google Cloud que contiene la instancia
  • INSTANCE_NAME: el nombre de la instancia que configuras para obtener alta disponibilidad

HTTP method and URL:

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

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_13",
}

El resultado indica que availabilityType es REGIONAL. En los campos gceZone y secondaryGceZone, se muestran las zonas principal y secundaria actuales de la instancia.

Cambia las zonas de una instancia de alta disponibilidad

Cambiar una o ambas zonas de una instancia de alta disponibilidad existente causa unos minutos de tiempo de inactividad mientras la instancia se reconfigura. Para ver las zonas principal y secundaria actuales en las que se ejecuta la instancia de alta disponibilidad, consulta Verifica la configuración de alta disponibilidad de una instancia.

Para cambiar las zonas de una instancia de alta disponibilidad, haz lo siguiente:

Console

  1. En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

  2. Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
  3. Haga clic en Editar.
  4. En la sección Elige la región y la disponibilidad zonal, expande Especificar zonas y selecciona zonas nuevas. Las zonas están predeterminadas como Any para la zona principal y Any (different from primary) para la zona secundaria. Se aplican las restricciones siguientes:
    • Solo puedes especificar la zona principal o las zonas principal y secundaria.
    • Si se especifican las zonas principal y secundaria, deben ser zonas diferentes.
  5. Haz clic en Guardar.

    Volverás a la página de la instancia principal mientras la instancia se actualiza.

gcloud

Cambia la zona en la que se ejecuta la instancia:

gcloud sql instances patch INSTANCE_NAME \
  --zone=PRIMARY_ZONE --secondary-zone=SECONDARY_ZONE

El parámetro --secondary-zone es opcional. Si lo omites, Cloud SQL seleccionará una zona disponible que sea diferente de la zona principal.

Se aplican las siguientes restricciones:

  • Las zonas deben ser zonas válidas que pertenezcan a la misma región que la instancia de Cloud SQL.
  • Si se especifica la zona secundaria, debe ser diferente de la zona principal.

REST v1

  1. Cambia las zonas de la instancia regional:

    Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

    • PROJECT_ID: El ID del proyecto
    • INSTANCE_NAME: El nombre de la instancia
    • PRIMARY_ZONE: La zona principal
    • SECONDARY_ZONE: La zona secundaria

    Método HTTP y URL:

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

    Cuerpo JSON de la solicitud:

    {
    "settings": {"locationPreference": {"zone": "PRIMARY_ZONE", "secondaryZone": "SECONDARY_ZONE"}}
    }
    

    Para enviar tu solicitud, expande una de estas opciones:

    Deberías recibir un código de estado exitoso (2xx) y una respuesta vacía.

    El parámetro secondaryZone es opcional. Si lo omites, Cloud SQL seleccionará una zona disponible que sea diferente de la zona principal.

    Se aplican las siguientes restricciones:

    • Las zonas deben ser válidas.
    • Todas las zonas que elijas deben pertenecer a la misma región que la instancia de Cloud SQL.

REST v1beta4

  1. Cambia las zonas de la instancia regional:

    Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

    • PROJECT_ID: El ID del proyecto
    • INSTANCE_NAME: El nombre de la instancia
    • PRIMARY_ZONE: La zona principal
    • SECONDARY_ZONE: La zona secundaria

    Método HTTP y URL:

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

    Cuerpo JSON de la solicitud:

    {
    "settings": {"locationPreference": {"zone": "PRIMARY_ZONE", "secondaryZone": "SECONDARY_ZONE"}}
    }
    

    Para enviar tu solicitud, expande una de estas opciones:

    Deberías recibir un código de estado exitoso (2xx) y una respuesta vacía.

    El parámetro secondaryZone es opcional. Si lo omites, Cloud SQL seleccionará una zona disponible que sea diferente de la zona principal.

    Se aplican las siguientes restricciones:

    • Las zonas deben ser válidas.
    • Todas las zonas que elijas deben pertenecer a la misma región que la instancia de Cloud SQL.

Desactiva la alta disponibilidad para una instancia

Puedes inhabilitar la alta disponibilidad para una instancia de Cloud SQL con la consola de Google Cloud, , gcloud CLI o la API.

Console

Para desactivar la alta disponibilidad de una instancia, sigue estos pasos:

  1. En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

  2. Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
  3. Haz clic en Edit.
  4. Abre Copias de seguridad automáticas.
  5. En la sección Disponibilidad, haz clic en Zona única.
  6. Haz clic en Guardar. Esta edición requiere que reinicies la instancia.
  7. Cuando aparezca el cuadro de diálogo, haz clic en Guardar y reiniciar.

gcloud

Para desactivar la alta disponibilidad de una instancia, usa el comando gcloud sql instances patch:

gcloud sql instances patch INSTANCE_NAME \
--availability-type ZONAL

Reemplaza INSTANCE_NAME por el nombre de la instancia de Cloud SQL para la que deseas desactivar la alta disponibilidad.

REST v1

Para cambiar el tipo de disponibilidad de la instancia a ZONAL, usa el método instances:patch. Con este método, se desactiva la alta disponibilidad para la instancia.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: el ID o el número del proyecto de Google Cloud que contiene la instancia
  • INSTANCE_NAME: el nombre de la instancia para la que deseas desactivar la alta disponibilidad

HTTP method and URL:

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

Cuerpo JSON de la solicitud:

{
  "settings": {"availabilityType": "ZONAL" }
}

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir un código de estado exitoso (2xx) y una respuesta vacía.

REST v1beta4

Para cambiar el tipo de disponibilidad de la instancia a ZONAL, usa el método instances:patch. Con este método, se desactiva la alta disponibilidad para la instancia.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: el ID o el número del proyecto de Google Cloud que contiene la instancia
  • INSTANCE_NAME: el nombre de la instancia para la que deseas desactivar la alta disponibilidad

HTTP method and URL:

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

Cuerpo JSON de la solicitud:

{
  "settings": {"availabilityType": "ZONAL" }
}

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir un código de estado exitoso (2xx) y una respuesta vacía.

Solucionar problemas

Problema Soluciona problemas
No puedes encontrar las métricas de una conmutación por error manual. Solo las conmutaciones por error automáticas se incluyen en las métricas.
Los recursos de la instancia de Cloud SQL (CPU y RAM) tienen un uso de alrededor del 100%, lo que hace que se interrumpa el funcionamiento de la instancia con alta disponibilidad. El tamaño de la máquina de la instancia es demasiado pequeño para la carga.

Edita la instancia para actualizarla a un tamaño de máquina más grande y obtener más CPU y memoria.

¿Qué sigue?