Habilita e inhabilita la alta disponibilidad

MySQL   |  PostgreSQL   |  SQL Server

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.

La configuración heredada para alta disponibilidad usaba una instancia failover replica. La nueva configuración no usa una failover replica. En su lugar, usa los discos persistentes regionales de Google, que replican los datos a nivel de bloque de forma síncrona entre dos zonas de una región. Si tienes una instancia de MySQL existente que use la configuración de alta disponibilidad heredada, puedes actualizarla para que se use la versión actual. Si deseas obtener más información sobre otros procedimientos relacionados con la configuración heredada para la alta disponibilidad, consulta Configuración heredada para la alta disponibilidad.

Importante: A partir del 13 de enero de 2025, la configuración heredada para la alta disponibilidad (HA) estará obsoleta para todas las instancias. No puedes crear instancias con la configuración heredada de alta disponibilidad ni habilitar la configuración heredada de alta disponibilidad en ninguna instancia existente. Además, después del 13 de enero de 2025, las instancias de alta disponibilidad heredadas ya no estarán cubiertas por el ANS de Cloud SQL.

Te recomendamos que actualices las instancias heredadas restantes de alta disponibilidad a la configuración actual de alta disponibilidad. Para ello, sigue las instrucciones que se indican en Actualiza una instancia de heredada a alta disponibilidad actual. A partir del 1 de mayo de 2025, Cloud SQL comenzará a actualizar automáticamente las instancias que usen la configuración de alta disponibilidad heredada para que usen la configuración de alta disponibilidad actual basada en disco persistente regionales.

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 Google Cloud consola, 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 \
   --tier=MACHINE_TYPE \
   --enable-bin-log

   Para obtener una lista completa de los parámetros disponibles, visita la página de referencias de gcloud sql instances create.
2. Puedes especificar las zonas principal y secundaria con los parámetros --zone y --secondary-zone. Se aplican las siguientes restricciones cuando se usa la zona secundaria durante la creación o la edición de la instancia:
   • Las zonas deben ser válidas.
   • Si se especifica la zona secundaria, también se debe especificar la principal.
   • Si se especifican las zonas principal y secundaria, deben ser zonas diferentes.
   • Si se especifican las zonas principal y secundaria, deben pertenecer a la misma región.
3. Configura el usuario raíz:

   gcloud sql users set-password root --host=% \
   --instance=PRIMARY_INSTANCE_NAME \
   --password=PASSWORD

Terraform

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

resource "google_sql_database_instance" "mysql_instance_ha" {
  name             = "mysql-instance-ha"
  region           = "asia-northeast1"
  database_version = "MYSQL_8_0"
  settings {
    tier              = "db-f1-micro"
    availability_type = "REGIONAL"
    backup_configuration {
      enabled            = true
      binary_log_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 Google Cloud , completa los pasos de las siguientes secciones.

Prepara Cloud Shell

1. Inicia Cloud Shell

2. Establece el proyecto 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. Inicializa 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 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.

Nota: Por lo general, las muestras de Terraform suponen que las APIs necesarias están habilitadas en tu proyecto de Google Cloud .

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

3. 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": {
            "binaryLogEnabled": true,
            "enabled": true
         },
         "availabilityType": "REGIONAL"
      }
   }
   

   Para enviar tu solicitud, expande una de estas opciones:

   curl (Linux, macOS o Cloud Shell)

   Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/v1/projects/project-id/instances"

   PowerShell (Windows)

   Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances" | Select-Object -Expand Content

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

   Respuesta

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-name",
     "status": "PENDING",
     "user": "[e-mail]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "CREATE",
     "name": "operation-id",
     "targetId": "instance-name",
     "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
     "targetProject": "project-id"
   }
   

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?name=root&host=%25'

   Cuerpo JSON de la solicitud:

   {
      "name": "root",
      "host": "%",
      "password": "password"}
   

   Para enviar tu solicitud, expande una de estas opciones:

   curl (Linux, macOS o Cloud Shell)

   Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

   curl -X PATCH \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/users?name=root&host=%25'"

   PowerShell (Windows)

   Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/users?name=root&host=%25'" | Select-Object -Expand Content

   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": {
            "binaryLogEnabled": true,
            "enabled": true
         },
         "availabilityType": "REGIONAL"
      }
   }
   

   Para enviar tu solicitud, expande una de estas opciones:

   curl (Linux, macOS o Cloud Shell)

   Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances"

   PowerShell (Windows)

   Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances" | Select-Object -Expand Content

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

   Respuesta

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-name",
     "status": "PENDING",
     "user": "[e-mail]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "CREATE",
     "name": "operation-id",
     "targetId": "instance-name",
     "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
     "targetProject": "project-id"
   }
   

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?name=root&host=%25'

   Cuerpo JSON de la solicitud:

   {
      "name": "root",
      "host": "%",
      "password": "password"}
   

   Para enviar tu solicitud, expande una de estas opciones:

   curl (Linux, macOS o Cloud Shell)

   Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

   curl -X PATCH \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users?name=root&host=%25'"

   PowerShell (Windows)

   Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users?name=root&host=%25'" | Select-Object -Expand Content

   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 Google Cloud consola, la CLI de gcloud o la API.

Nota: Después de iniciar la configuración de alta disponibilidad para una instancia, no puedes detenerla. Si vuelves a configurar la instancia, se reinicia. Por lo general, Cloud SQL solo tarda unos minutos en volver a configurar la instancia y reiniciarla. Sin embargo, si la instancia tiene una carga o un disco grande, es posible que tarde hasta una hora.

Console

Importante: No puedes usar la consola de Google Cloud para configurar instancias que tengan Private Service Connect habilitado para obtener alta disponibilidad. Para configurar estas instancias, usa gcloud CLI o la API.

Para configurar una instancia con alta disponibilidad, sigue estos pasos:

1. En la Google Cloud consola, 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 Editar.
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. Las siguientes condiciones se aplican cuando usas la zona secundaria mientras creas o editas una instancia:
   • Las zonas están predeterminadas como Any para la zona principal y Any (different from primary) para la zona secundaria.

   Si especificas tanto la zona principal como la secundaria, estas deben ser zonas diferentes.

7. 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 \
--enable-bin-log \
--backup-start-time=HH:MM

Realiza los siguientes reemplazos:

• INSTANCE_NAME: Es el nombre de la instancia de Cloud SQL que configuras para alta disponibilidad.
• HH:MM: el tiempo (en horas y minutos)

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 los registros binarios están habilitados. 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 del proyecto Google Cloud que contiene la instancia
   • INSTANCE_NAME: el nombre de la instancia que configuras para obtener alta disponibilidad

   Método HTTP y URL:

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

   Para enviar tu solicitud, expande una de estas opciones:

   curl (Linux, macOS o Cloud Shell)

   Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Ejecuta el siguiente comando:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell (Windows)

   Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Ejecuta el siguiente comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

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

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

     "backupConfiguration": {
       "kind": "sql#backupConfiguration",
       "startTime": "12:00",
       "enabled": true,
       "binaryLogEnabled": true
       }
     

2. Si enabled o binaryLogEnabled 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 binaryLogEnabled 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 del proyecto 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)

   Método HTTP y 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,
         "binaryLogEnabled": true
       }
     }
   }
   

   Para enviar tu solicitud, expande una de estas opciones:

   curl (Linux, macOS o Cloud Shell)

   Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

   curl -X PATCH \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell (Windows)

   Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

   Respuesta

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME",
     "status": "PENDING",
     "user": "[e-mail]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "UPDATE",
     "name": "OPERATION_ID",
     "targetId": "INSTANCE_NAME",
     "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
     "targetProject": "PROJECT_ID"
   }
   

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 del proyecto 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:

   curl (Linux, macOS o Cloud Shell)

   Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

   curl -X PATCH \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell (Windows)

   Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   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 los registros binarios están habilitados. 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 del proyecto Google Cloud que contiene la instancia
   • INSTANCE_NAME: el nombre de la instancia que configuras para obtener alta disponibilidad

   Método HTTP y URL:

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

   Para enviar tu solicitud, expande una de estas opciones:

   curl (Linux, macOS o Cloud Shell)

   Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Ejecuta el siguiente comando:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell (Windows)

   Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Ejecuta el siguiente comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

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

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

     "backupConfiguration": {
       "kind": "sql#backupConfiguration",
       "startTime": "12:00",
       "enabled": true,
       "binaryLogEnabled": true
       }
     

2. Si enabled o binaryLogEnabled 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 binaryLogEnabled 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 del proyecto 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)

   Método HTTP y URL:

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

   Cuerpo JSON de la solicitud:

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

   Para enviar tu solicitud, expande una de estas opciones:

   curl (Linux, macOS o Cloud Shell)

   Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

   curl -X PATCH \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell (Windows)

   Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

   Respuesta

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME",
     "status": "PENDING",
     "user": "[e-mail]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "UPDATE",
     "name": "OPERATION_ID",
     "targetId": "INSTANCE_NAME",
     "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
     "targetProject": "PROJECT_ID"
   }
   

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 del proyecto 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:

   curl (Linux, macOS o Cloud Shell)

   Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

   curl -X PATCH \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell (Windows)

   Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   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.

Esta función te permite probar la respuesta de tu aplicación ante una conmutación por error automática. Comprueba si tu instancia completó cualquier conmutación por error anterior (de manera que responda las solicitudes de conexiones) antes de activar otra. Además, antes de iniciar la conmutación por error en la instancia, configura la instancia para alta disponibilidad.

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

Console

1. En la Google Cloud consola, 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 del proyecto Google Cloud que contiene la instancia
   • INSTANCE_NAME: el nombre de la instancia que configuras para obtener alta disponibilidad

   Método HTTP y URL:

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

   Para enviar tu solicitud, expande una de estas opciones:

   curl (Linux, macOS o Cloud Shell)

   Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Ejecuta el siguiente comando:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell (Windows)

   Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Ejecuta el siguiente comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

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

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:

   curl (Linux, macOS o Cloud Shell)

   Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-name/failover"

   PowerShell (Windows)

   Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-name/failover" | Select-Object -Expand Content

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

   Respuesta

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-name",
     "status": "PENDING",
     "user": "[e-mail]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "CREATE",
     "name": "operation-id",
     "targetId": "instance-name",
     "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
     "targetProject": "project-id"
   }
   

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 del proyecto Google Cloud que contiene la instancia
   • INSTANCE_NAME: el nombre de la instancia que configuras para obtener alta disponibilidad

   Método HTTP y URL:

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

   Para enviar tu solicitud, expande una de estas opciones:

   curl (Linux, macOS o Cloud Shell)

   Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Ejecuta el siguiente comando:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell (Windows)

   Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Ejecuta el siguiente comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

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

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:

   curl (Linux, macOS o Cloud Shell)

   Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-name/failover"

   PowerShell (Windows)

   Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-name/failover" | Select-Object -Expand Content

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

   Respuesta

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-name",
     "status": "PENDING",
     "user": "[e-mail]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "CREATE",
     "name": "operation-id",
     "targetId": "instance-name",
     "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
     "targetProject": "project-id"
   }
   

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 Google Cloud consola, 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.

La nueva alta disponibilidad no usa la réplica de conmutación por error heredada. No verás una réplica de conmutación por error en la lista de instancias, a menos que uses la configuración heredada.

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 del proyecto Google Cloud que contiene la instancia
• INSTANCE_NAME: el nombre de la instancia que configuras para obtener alta disponibilidad

Método HTTP y URL:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

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

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 del proyecto Google Cloud que contiene la instancia
• INSTANCE_NAME: el nombre de la instancia que configuras para obtener alta disponibilidad

Método HTTP y URL:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

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

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.

Nota: Una vez que inicias la operación de cambio de zona en una instancia, no puedes detenerla. Esta operación reinicia la instancia. Por lo general, la configuración y el reinicio solo demoran unos minutos en completarse. Sin embargo, si la instancia tiene una carga o un disco grande, es posible que tarde hasta una hora.

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

Console

1. En la Google Cloud consola, 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 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:

   curl (Linux, macOS o Cloud Shell)

   Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

   curl -X PATCH \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell (Windows)

   Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   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:

   curl (Linux, macOS o Cloud Shell)

   Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

   curl -X PATCH \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell (Windows)

   Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   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 Google Cloud consola, la CLI de gcloud o la API.

Nota: Antes de realizar este procedimiento, asegúrate de que no se estén ejecutando operaciones en la instancia.

Si desactivas la alta disponibilidad para una instancia, en caso de una interrupción de zona, deberás recuperar la instancia de forma manual. Para obtener más información, consulta Opciones de recuperación para instancias independientes.

Console

Importante: No puedes usar la consola de Google Cloud para desactivar la alta disponibilidad para las instancias que tienen Private Service Connect habilitado. Para desactivar estas instancias, usa gcloud CLI o la API.

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

1. En la Google Cloud consola, 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 Editar.
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 del proyecto 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:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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 del proyecto 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:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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?

• Obtén más información sobre cómo funciona la configuración para alta disponibilidad.
• Verifica cómo responde tu aplicación cuando se pierde una conexión mediante el reinicio de instancia.
• Obtén más información sobre cómo administrar las conexiones de tu base de datos.
• Obtén más información sobre Google Cloud Observability.
• Obtén más información sobre la Configuración heredada para alta disponibilidad.
• Crea réplicas de lectura para tu instancia.