Restaurar una instancia

En esta página se describe cómo restaurar una instancia a partir de una copia de seguridad.

Para obtener información, prácticas recomendadas y requisitos sobre las operaciones de restauración, consulta Descripción general de la restauración de una instancia.

Restaurar a partir de una copia de seguridad automática o bajo demanda

Puedes usar una copia de seguridad automática o bajo demanda en los siguientes casos:

  • Restaurar en otra instancia del mismo proyecto
  • Restaurar en la misma instancia desde la que se ha creado la copia de seguridad
  • Restaurar en otra instancia de otro proyecto u otra región

Si tienes habilitada la recuperación a un momento dado (PITR), puedes recuperar tu instancia a un momento específico, en función de los ajustes de conservación de registros de tu instancia.

Restaurar en otra instancia

Cuando restauras datos de una copia de seguridad en una instancia diferente, actualizas los datos de la instancia de destino al estado de la instancia de origen cuando creaste la copia de seguridad. Para obtener más información, consulta los consejos generales sobre cómo realizar una restauración y los consejos y requisitos para restaurar en otra instancia.

Si necesitas una lista de las copias de seguridad del proyecto y no puedes verlas en la página de resumen de la instancia debido a una interrupción, puedes usar la API backupRuns.list con un carácter comodín (-). La opción de carácter comodín obtiene una lista de todas las copias de seguridad de todas las instancias del proyecto. Para obtener más información, consulta Ver copias de seguridad durante una interrupción.

Consola

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

    Ir a Instancias de Cloud SQL

  2. Si la instancia de destino tiene réplicas de lectura, usa el menú Más acciones Icono de acciones adicionales. para eliminarlas.
  3. Para abrir la página Overview (Resumen) de una instancia, haz clic en su nombre.
  4. En el menú de navegación de SQL, selecciona Copias de seguridad.
  5. Busca la copia de seguridad que quieras restaurar y haz clic en Restaurar.
  6. En la página Restaurar una instancia a partir de una copia de seguridad, confirma que has seleccionado la copia de seguridad correcta en Revisar detalles de la copia de seguridad.
  7. En Elegir destino de restauración, selecciona Sobrescribir una instancia que ya tengas.
  8. En el menú Instancia que se va a sobrescribir, selecciona la instancia que quieras usar para la restauración. La instancia que selecciones y todos sus datos se sobrescribirán.
  9. Para confirmar la selección, introduce el nombre de la instancia que se va a sobrescribir en el campo ID de la instancia de destino.
  10. Para iniciar el proceso de restauración, haz clic en Restaurar.
  11. Para comprobar el estado de la operación de restauración, ve a la página Operaciones de la instancia.
  12. Una vez completada la operación de restauración, vuelve a crear las réplicas que hayas eliminado en este procedimiento.

gcloud

  1. Para determinar si la instancia de destino tiene réplicas de lectura, usa el comando gcloud sql instances describe:
    gcloud sql instances describe TARGET_INSTANCE_NAME

    Anota las instancias que aparezcan en la columna replicaNames.

  2. Para eliminar todas las réplicas, usa el comando gcloud sql instances delete:
    gcloud sql instances delete REPLICA_NAME

    Repite el proceso para cada réplica.

  3. Para ver una lista de las copias de seguridad de la instancia de origen, usa el comando gcloud sql backups list:
    gcloud sql backups list \
    --instance SOURCE_INSTANCE_NAME
  4. Busca la copia de seguridad que quieras usar y anota su valor ID.
  5. Para restaurar la instancia de destino a partir de la copia de seguridad, usa el comando gcloud sql backups restore:
    gcloud sql backups restore BACKUP_ID \
    --restore-instance=TARGET_INSTANCE_NAME \
    --backup-instance=SOURCE_INSTANCE_NAME
  6. Una vez completada la operación de restauración, vuelve a crear las réplicas que hayas eliminado en este procedimiento.

REST v1

  1. Para determinar si la instancia tiene réplicas de lectura y obtener los IDs de estas réplicas, enumera todas las réplicas de la instancia target.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto
    • INSTANCE_ID: el ID de instancia

    Método HTTP y URL:

    GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID?fields=replicaNames

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

  2. Elimina todas las réplicas.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto
    • REPLICA_ID: el ID de la réplica

    Método HTTP y URL:

    DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_ID

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

    Repite el proceso para cada réplica.

  3. Para obtener el ID de la copia de seguridad que quieras usar, enumera las copias de seguridad de la instancia source.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • project-id: el ID del proyecto
    • instance-id: el ID de instancia.

    Método HTTP y URL:

    GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

    -O-

    Si tu instancia se encuentra en una región que está sufriendo una interrupción, enumera todas las copias de seguridad de un proyecto.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto
    • INSTANCE_ID: el ID de la instancia o - para obtener una lista de todas las copias de seguridad del proyecto.

    Método HTTP y URL:

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

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

    Busca la copia de seguridad de la instancia que quieras restaurar.
  4. Restaura la instancia de destino a partir de la copia de seguridad.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • project-id: el ID del proyecto
    • target-instance-id: ID de la instancia de destino
    • source-instance-id: ID de la instancia de origen.
    • backup-id El ID de la copia de seguridad

    Método HTTP y URL:

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

    Cuerpo JSON de la solicitud:

    {
      "restoreBackupContext":
      {
        "backupRunId": backup-id,
        "instanceId": "source-instance-id"
      }
    }
    

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

  5. Una vez completada la operación de restauración, vuelve a crear las réplicas que hayas eliminado en este procedimiento.

REST v1beta4

  1. Para determinar si la instancia tiene réplicas de lectura y obtener los IDs de estas réplicas, enumera todas las réplicas de la instancia target.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto
    • INSTANCE_ID: el ID de instancia

    Método HTTP y URL:

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID?fields=replicaNames

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

  2. Elimina todas las réplicas.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto
    • REPLICA_ID: el ID de la réplica

    Método HTTP y URL:

    DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/REPLICA_ID

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

    Repite el proceso para cada réplica.

  3. Para obtener el ID de la copia de seguridad que quieras usar, enumera las copias de seguridad de la instancia source.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • project-id: el ID del proyecto
    • instance-id: el ID de instancia.

    Método HTTP y URL:

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

  4. Restaura la instancia de destino a partir de la copia de seguridad.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • project-id: el ID del proyecto
    • target-instance-id: ID de la instancia de destino
    • source-instance-id: ID de la instancia de origen.
    • backup-id El ID de la copia de seguridad

    Método HTTP y URL:

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

    Cuerpo JSON de la solicitud:

    {
      "restoreBackupContext":
      {
        "backupRunId": backup-id,
        "instanceId": "source-instance-id"
      }
    }
    

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

  5. Una vez completada la operación de restauración, vuelve a crear las réplicas que hayas eliminado en este procedimiento.

Restaurar en la misma instancia

Cuando restauras datos de una copia de seguridad en la misma instancia, los datos de esa instancia vuelven al estado que tenían cuando se creó la copia de seguridad. Si deseas obtener más información sobre la restauración de instancias, consulta Consejos generales sobre cómo realizar una restauración.

Consola

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

    Ir a Instancias de Cloud SQL

  2. Si la instancia de destino tiene réplicas de lectura, usa el menú Más acciones Icono de acciones adicionales. para eliminarlas.
  3. Para abrir la página Overview (Resumen) de una instancia, haz clic en su nombre.
  4. En el menú de navegación de SQL, selecciona Copias de seguridad.
  5. Busca la copia de seguridad que quieras usar y haz clic en Restaurar.
  6. En la página Restaurar una instancia a partir de una copia de seguridad, confirma que has seleccionado la copia de seguridad correcta en Revisar detalles de la copia de seguridad.
  7. En Elegir destino de restauración, selecciona Sobrescribir la instancia de origen.

    Comprueba que el nombre de la instancia de origen se especifique entre paréntesis.

  8. Para confirmar la selección, introduzca el nombre de la instancia en el campo ID de la instancia de destino.
  9. Para iniciar el proceso de restauración, haz clic en Restaurar.
  10. Para comprobar el estado de la operación de restauración, ve a la página Operaciones de la instancia.
  11. Una vez completada la operación de restauración, vuelve a crear las réplicas que hayas eliminado en este procedimiento.

gcloud

  1. Para determinar si la instancia tiene réplicas de lectura, usa el comando gcloud sql instances describe:
    gcloud sql instances describe INSTANCE_NAME

    Anota las instancias que aparezcan en la columna replicaNames.

  2. Para eliminar todas las réplicas, usa el comando gcloud sql instances delete:
    gcloud sql instances delete REPLICA_NAME

    Repite el proceso para cada réplica.

  3. Para ver una lista de las copias de seguridad de la instancia, usa el comando gcloud sql backups list:
    gcloud sql backups list --instance INSTANCE_NAME
  4. Busca la copia de seguridad que quieras usar y anota su valor ID.
  5. Para restaurar la instancia a partir de la copia de seguridad especificada, usa el comando gcloud sql backups restore:
    gcloud sql backups restore BACKUP_ID \
    --restore-instance=INSTANCE_NAME
  6. Una vez completada la operación de restauración, vuelve a crear las réplicas que hayas eliminado en este procedimiento.

REST v1

  1. Para obtener el ID de la copia de seguridad que quieras usar, enumera las copias de seguridad de la instancia.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • project-id: el ID del proyecto
    • instance-id: el ID de instancia.

    Método HTTP y URL:

    GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

  2. Restaura la instancia a partir de la copia de seguridad especificada.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto
    • INSTANCE_ID: el ID de instancia
    • BACKUP_ID el ID de la copia de seguridad

    Método HTTP y URL:

    POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/restoreBackup

    Cuerpo JSON de la solicitud:

    {
      "restoreBackupContext":
      {
        "backupRunId": "BACKUP_ID",
      }
    }
    

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

  3. Una vez completada la operación de restauración, vuelve a crear las réplicas que hayas eliminado en este procedimiento.

REST v1beta4

  1. Para obtener el ID de la copia de seguridad que quieras usar, enumera las copias de seguridad de la instancia.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • project-id: el ID del proyecto
    • instance-id: el ID de instancia.

    Método HTTP y URL:

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

  2. Restaura la instancia a partir de la copia de seguridad especificada.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto
    • INSTANCE_ID: el ID de instancia
    • BACKUP_RUN_ID: marca de fecha y hora de cuándo restaura Cloud SQL la instancia a partir de la copia de seguridad

    Método HTTP y URL:

    POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/restoreBackup

    Cuerpo JSON de la solicitud:

    {
      "restoreBackupContext":
      {
        "backupRunId": "BACKUP_RUN_ID",
      }
    }
    

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

  3. Una vez completada la operación de restauración, vuelve a crear las réplicas que hayas eliminado en este procedimiento.

Restaurar en una instancia de otro proyecto

Puedes usar el parámetro project para restaurar datos en una instancia de un proyecto distinto al proyecto en el que se creó la copia de seguridad. Cuando se usa el parámetro project, llama a restoreBackup en el proyecto y en la instancia en los que quieras restaurar los datos. Cuando se restaura desde una copia de seguridad en una instancia diferente, se actualizan los datos en la instancia de destino al estado de la instancia de origen cuando se realizó la copia de seguridad.

Permisos

El usuario que restaura la instancia en otro proyecto debe tener el permiso cloudsql.instances.restoreBackup en el proyecto de destino y el permiso cloudsql.backupRuns.get en la instancia de origen. Estos permisos se incluyen en el rol Cloud SQL Admin.

Para restaurar datos en una instancia de otro proyecto, sigue estos pasos:

gcloud

  1. Lista las copias de seguridad de la instancia.

    gcloud sql backups list --instance INSTANCE_NAME

    Sustituye INSTANCE_NAME por el nombre de la instancia.

  2. Busca la copia de seguridad que te interesa y registra su valor de ID.
  3. Restaurar datos en una instancia de otro proyecto.

    gcloud sql backups restore BACKUP_ID \
    --restore-instance=TARGET_INSTANCE_NAME \
    --backup-instance=SOURCE_INSTANCE_NAME \
    --backup-project=SOURCE_INSTANCE_PROJECT

    Haz las siguientes sustituciones:

    • BACKUP_ID: el ID de la copia de seguridad. Has obtenido este ID anteriormente en este procedimiento.
    • TARGET_INSTANCE_NAME: la instancia del proyecto de destino en la que vas a restaurar los datos.
    • SOURCE_INSTANCE_NAME: la instancia del proyecto de origen que contiene los datos que quieres restaurar en la instancia del proyecto de destino.
    • SOURCE_INSTANCE_PROJECT: el proyecto que contiene la instancia de origen.

REST v1

Para obtener el backupId, ejecuta lo siguiente.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • project-id: el ID del proyecto
  • instance-id: el ID de instancia.

Método HTTP y URL:

GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Restaura la copia de seguridad en una instancia de otro proyecto:

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • source-project-id: ID del proyecto de origen
  • target-project-id: ID del proyecto de destino
  • target-instance-id: ID de la instancia de destino
  • source-instance-id: ID de la instancia de origen.
  • backup-id El ID de la copia de seguridad

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

{
  "restoreBackupContext":
  {
    "backupRunId": backup-id,
    "project": "source-project-id",
    "instanceId": "source-instance-id"
  }
}

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Para obtener más información sobre la propiedad project, consulta restoreBackup

REST v1beta4

Para obtener el backupId, ejecuta lo siguiente.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • project-id: el ID del proyecto
  • instance-id: el ID de instancia.

Método HTTP y URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Restaura la copia de seguridad en una instancia de otro proyecto:

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • source-project-id: ID del proyecto de origen
  • target-project-id: ID del proyecto de destino
  • target-instance-id: ID de la instancia de destino
  • source-instance-id: ID de la instancia de origen.
  • backup-id El ID de la copia de seguridad

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

{
  "restoreBackupContext":
  {
    "backupRunId": backup-id,
    "project": "source-project-id",
    "instanceId": "source-instance-id"
  }
}

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Para obtener más información sobre la propiedad project, consulta restoreBackup

Restaurar a partir de una copia de seguridad final

Puedes usar una copia de seguridad final en los siguientes casos:

  • Restaurar la copia de seguridad final en una instancia nueva
  • Restaurar en una instancia nueva de otro proyecto u otra región

Como vas a usar una copia de seguridad final de una instancia eliminada para restaurar tu instancia, también puedes usar la copia de seguridad para crear una instancia con la configuración de la instancia eliminada y recuperar tus datos.

Restaurar en una instancia nueva

Cuando creas una instancia a partir de una copia de seguridad final, Cloud SQL usa los ajustes de configuración de la instancia de la que se toma la copia de seguridad final. Una vez creada la instancia, Cloud SQL restaura los datos al estado en el que se encontraba cuando se creó la copia de seguridad final.

Consola

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

    Ir a copias de seguridad de Cloud SQL

    En esta página se enumeran todas las copias de seguridad, incluidas las finales, asociadas a un Google Cloud proyecto.

  2. Haz clic en la copia de seguridad final que contiene los datos que quieres restaurar en una instancia nueva.
  3. En el cuadro de diálogo Copia de seguridad final, haz clic en Restaurar.
  4. En la página Restaurar una instancia a partir de una copia de seguridad, confirma que has seleccionado la copia de seguridad correcta en Revisar detalles de la copia de seguridad.
  5. En Elegir destino de restauración, selecciona Restaurar en una instancia nueva.
  6. En el menú Región, selecciona la región de la nueva instancia.
  7. En el campo ID de instancia, introduzca un ID para la nueva instancia.
  8. Para iniciar el proceso de restauración, haz clic en Restaurar.
  9. Para comprobar el estado de la operación de restauración, ve a la página Operaciones de la instancia.

gcloud

  1. Para enumerar las copias de seguridad finales de la instancia source, usa el comando gcloud sql backups list:
    gcloud sql backups list \
    --filter='type:FINAL instance: SOURCE_INSTANCE_NAME'
  2. Busca la copia de seguridad que quieras usar y anota su valor NAME.
  3. Para restaurar una instancia nueva a partir de la copia de seguridad final especificada, usa el comando gcloud sql backups restore:
    gcloud sql backups restore BACKUP_NAME \
    --restore-instance=TARGET_INSTANCE_NAME 

REST v1

  1. Para obtener el ID de la copia de seguridad que quieras usar, enumera las copias de seguridad finales de la instancia source.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto
    • INSTANCE_ID: el ID de instancia

    Método HTTP y URL:

    GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter='type:FINAL AND instance:INSTANCE_ID'

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

  2. Restaura una instancia nueva a partir de la copia de seguridad final especificada.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto
    • TARGET_INSTANCE_ID: el ID de instancia de destino
    • BACKUP_ID: el ID de la copia de seguridad

    Método HTTP y URL:

    POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID/restoreBackup

    Cuerpo JSON de la solicitud:

    {
      backup: projects/PROJECT_ID/backups/BACKUP_ID
      restore_instance_settings: {}
    }
    

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

REST v1beta4

  1. Para obtener el ID de la copia de seguridad que quieras usar, enumera las copias de seguridad finales de la instancia source.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto
    • INSTANCE_ID: el ID de instancia

    Método HTTP y URL:

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter='type:FINAL AND instance:INSTANCE_ID'

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

  2. Restaura una instancia nueva a partir de la copia de seguridad final especificada.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto
    • TARGET_INSTANCE_ID: el ID de instancia de destino
    • BACKUP_ID: el ID de la copia de seguridad

    Método HTTP y URL:

    POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID/restoreBackup

    Cuerpo JSON de la solicitud:

    {
      backup: projects/PROJECT_ID/backups/BACKUP_ID
      restore_instance_settings: {}
    }
    

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

Restaurar en una instancia

Cuando restauras datos de una copia de seguridad final en una instancia, actualizas los datos de la instancia de destino al estado de la instancia de origen cuando se realizó la copia de seguridad. Para obtener más información, consulta los consejos generales sobre cómo realizar una restauración y los consejos y requisitos para restaurar en otra instancia.

Si necesitas una lista de copias de seguridad del proyecto y no puedes verlas en la página de resumen de la instancia debido a una interrupción, puedes usar la API backupRuns.list.

Consola

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

    Ir a Instancias de Cloud SQL

  2. Si la instancia de destino tiene réplicas de lectura, usa el menú Más acciones Icono de acciones adicionales. para eliminarlas.
  3. En la Google Cloud consola, ve a la página Copias de seguridad de Cloud SQL.

    Ir a copias de seguridad de Cloud SQL

    En esta página se enumeran todas las copias de seguridad, incluidas las finales, asociadas a un Google Cloud proyecto.

  4. Haz clic en la copia de seguridad final que contenga los datos que quieras restaurar en otra instancia.
  5. En el cuadro de diálogo Copia de seguridad final, haz clic en Restaurar.
  6. En la página Restaurar una instancia a partir de una copia de seguridad, confirma que has seleccionado la copia de seguridad correcta en Revisar detalles de la copia de seguridad.
  7. En Elegir destino de restauración, selecciona Sobrescribir una instancia.
  8. En el menú Instancia que se va a sobrescribir, selecciona la instancia que quieras usar para la restauración. La instancia que selecciones y todos sus datos se sobrescribirán.

  9. Para confirmar la selección, en el campo ID de instancia de destino, introduce el nombre de la instancia que se va a sobrescribir.
  10. Para iniciar el proceso de restauración, haz clic en Restaurar.
  11. Para comprobar el estado de la operación de restauración, ve a la página Operaciones de la instancia.
  12. Una vez completada la operación de restauración, vuelve a crear las réplicas que hayas eliminado en este procedimiento.

gcloud

  1. Para determinar si la instancia de destino tiene réplicas de lectura, usa el comando gcloud sql instances describe:
    gcloud sql instances describe TARGET_INSTANCE_NAME

    Anota las instancias que aparezcan en la columna replicaNames.

  2. Para eliminar todas las réplicas, usa el comando gcloud sql instances delete:
    gcloud sql instances delete REPLICA_NAME

    Repite el proceso para cada réplica.

  3. Para ver las copias de seguridad finales de la instancia de origen, usa el comando gcloud sql backups list:
    gcloud sql backups list \
    --filter='type:FINAL instance: SOURCE_INSTANCE_NAME'
  4. Busca la copia de seguridad que quieras usar y anota su valor NAME.
  5. Para restaurar la instancia de destino a partir de la copia de seguridad, usa el comando gcloud sql backups restore:
    gcloud sql backups restore BACKUP_NAME \
    --restore-instance=TARGET_INSTANCE_NAME
  6. Una vez completada la operación de restauración, vuelve a crear las réplicas que hayas eliminado en este procedimiento.

REST v1

  1. Para determinar si la instancia tiene réplicas de lectura y obtener los IDs de estas réplicas, enumera todas las réplicas de la instancia target.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto
    • INSTANCE_ID: el ID de instancia

    Método HTTP y URL:

    GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID?fields=replicaNames

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

  2. Elimina todas las réplicas.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto
    • REPLICA_ID: el ID de la réplica

    Método HTTP y URL:

    DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_ID

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

    Repite el proceso para cada réplica.

  3. Para obtener el ID de la copia de seguridad final que quieras usar, enumera las copias de seguridad de la instancia source.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto
    • INSTANCE_ID: el ID de instancia

    Método HTTP y URL:

    GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter='type:FINAL AND instance:INSTANCE_ID'

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

    Busca la copia de seguridad de la instancia que quieras restaurar.
  4. Restaura la instancia de destino a partir de la copia de seguridad.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto
    • TARGET_INSTANCE_ID: el ID de instancia de destino
    • BACKUP_ID: el ID de la copia de seguridad

    Método HTTP y URL:

    POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID/restoreBackup

    Cuerpo JSON de la solicitud:

    {
      backup: projects/PROJECT_ID/backups/BACKUP_ID
    }
    

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

  5. Una vez completada la operación de restauración, vuelve a crear las réplicas que hayas eliminado en este procedimiento.

REST v1beta4

  1. Para determinar si la instancia tiene réplicas de lectura y obtener los IDs de estas réplicas, enumera todas las réplicas de la instancia target.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto
    • INSTANCE_ID: el ID de instancia

    Método HTTP y URL:

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID?fields=replicaNames

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

  2. Elimina todas las réplicas.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto
    • REPLICA_ID: el ID de la réplica

    Método HTTP y URL:

    DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/REPLICA_ID

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

    Repite el proceso para cada réplica.

  3. Para obtener el ID de la copia de seguridad final que quieras usar, enumera las copias de seguridad de la instancia source.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto
    • INSTANCE_ID: el ID de instancia

    Método HTTP y URL:

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter='type:FINAL AND instance:INSTANCE_ID'

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

    Busca la copia de seguridad de la instancia que quieras restaurar.
  4. Restaura la instancia de destino a partir de la copia de seguridad.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto
    • TARGET_INSTANCE_ID: el ID de instancia de destino
    • BACKUP_ID: el ID de la copia de seguridad

    Método HTTP y URL:

    POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID/restoreBackup

    Cuerpo JSON de la solicitud:

    {
      backup: projects/PROJECT_ID/backups/BACKUP_ID
    }
    

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

  5. Una vez completada la operación de restauración, vuelve a crear las réplicas que hayas eliminado en este procedimiento.

Restaurar en una instancia de otro proyecto

El usuario que restaure datos en una instancia de otro proyecto debe tener el permiso cloudsql.instances.restoreBackup, el permiso cloudsql.instances.create en el proyecto de destino y el permiso cloudsql.backupRuns.get en la instancia de origen. Estos permisos se incluyen en el rol Cloud SQL Admin.

Para restaurar datos en una instancia de otro proyecto, sigue estos pasos:

REST v1

Para obtener el backupId de la copia de seguridad final, ejecuta lo siguiente:

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto
  • INSTANCE_ID: el ID de instancia

Método HTTP y URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter='type:FINAL AND instance:INSTANCE_ID'

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Restaura la copia de seguridad en una instancia de otro proyecto:

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto
  • TARGET_INSTANCE_ID: el ID de instancia de destino
  • BACKUP_ID: el ID de la copia de seguridad

Método HTTP y URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID/restoreBackup

Cuerpo JSON de la solicitud:

{
  backup: projects/PROJECT_ID/backups/BACKUP_ID
}

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Para obtener más información sobre la propiedad project, consulta restoreBackup

REST v1beta4

Para obtener el backupId de la copia de seguridad final, ejecuta lo siguiente:

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto
  • INSTANCE_ID: el ID de instancia

Método HTTP y URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter='type:FINAL AND instance:INSTANCE_ID'

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Restaura la copia de seguridad en una instancia de otro proyecto:

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto
  • TARGET_INSTANCE_ID: el ID de instancia de destino
  • BACKUP_ID: el ID de la copia de seguridad

Método HTTP y URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID/restoreBackup

Cuerpo JSON de la solicitud:

{
  backup: projects/PROJECT_ID/backups/BACKUP_ID
}

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Para obtener más información sobre la propiedad project, consulta restoreBackup

Restaurar en una instancia nueva de otra región

El usuario que restaure datos en una instancia nueva de otra región debe tener el permiso cloudsql.instances.restoreBackup en el proyecto de destino y el permiso cloudsql.backupRuns.get en la instancia de origen. Estos permisos se incluyen en el rol Cloud SQL Admin.

Además, para crear una instancia en otra región, debes cumplir los criterios de las políticas de organización de esa región.

Para restaurar los datos en una instancia nueva de otra región, sigue estos pasos:

gcloud

  1. Para enumerar las copias de seguridad finales de la instancia source, usa el comando gcloud sql backups list:
    gcloud sql backups list \
    --filter='type:FINAL instance: SOURCE_INSTANCE_NAME'
  2. Busca la copia de seguridad que quieras usar y anota su valor NAME.
  3. Para usar la copia de seguridad final y restaurar los datos en una instancia nueva de otra región, usa el comando gcloud sql backups restore:
    gcloud sql backups restore BACKUP_NAME \
    --restore-instance=TARGET_INSTANCE_NAME \
    --region=TARGET_REGION 

REST v1

Para obtener el backupId de la copia de seguridad final, ejecuta lo siguiente:

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto
  • INSTANCE_ID: el ID de instancia

Método HTTP y URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter='type:FINAL AND instance:INSTANCE_ID'

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Restaura la copia de seguridad en una instancia nueva de otra región:

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto
  • TARGET_INSTANCE_ID: el ID de instancia de destino
  • BACKUP_ID: el ID de la copia de seguridad
  • REGION: la región de la instancia de destino (por ejemplo, us-central1)

Método HTTP y URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID/restoreBackup

Cuerpo JSON de la solicitud:

{
  backup: projects/PROJECT_ID/backups/BACKUP_ID
  restore_instance_settings: {
    region: REGION
  }
}

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Para obtener más información sobre la propiedad project, consulta restoreBackup

REST v1beta4

Para obtener el backupId de la copia de seguridad final, ejecuta lo siguiente:

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto
  • INSTANCE_ID: el ID de instancia

Método HTTP y URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter='type:FINAL AND instance:INSTANCE_ID'

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Restaura la copia de seguridad en una instancia nueva de otra región:

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto
  • TARGET_INSTANCE_ID: el ID de instancia de destino
  • BACKUP_ID: el ID de la copia de seguridad
  • REGION: la región de la instancia de destino (por ejemplo, us-central1)

Método HTTP y URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID/restoreBackup

Cuerpo JSON de la solicitud:

{
  backup: projects/PROJECT_ID/backups/BACKUP_ID
  restore_instance_settings: {
    region: REGION
  }
}

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Para obtener más información sobre la propiedad project, consulta restoreBackup

Restaurar a partir de una copia de seguridad conservada

Puedes usar una copia de seguridad conservada en los siguientes casos:

  • Restaurar la copia de seguridad conservada en una instancia nueva
  • Restaurar la copia de seguridad conservada en una instancia
  • Restaurar en una instancia nueva o en una ya creada de otro proyecto u otra región

Como vas a usar una copia de seguridad conservada de una instancia eliminada para restaurar tu instancia, también puedes usar la copia de seguridad para crear una instancia con la configuración de la instancia eliminada y recuperar tus datos.

Restaurar una copia de seguridad conservada en una instancia nueva

Cuando creas una instancia a partir de una copia de seguridad conservada, Cloud SQL usa los ajustes de configuración de la instancia desde la que se tomó la copia de seguridad conservada.

Para restaurar datos de una copia de seguridad conservada en una instancia nueva, debes tener el permiso cloudsql.instances.create.

Consola

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

    Ir a copias de seguridad de Cloud SQL

  2. Haga clic en el nombre de la instancia eliminada que contiene la copia de seguridad que quiere restaurar.

  3. Busca el nombre de la copia de seguridad que quieras restaurar y haz clic en Restaurar.

  4. En la página Restaurar una instancia a partir de una copia de seguridad, confirma que has seleccionado la copia de seguridad correcta en Revisar detalles de la copia de seguridad.

  5. En Elegir destino de restauración, selecciona Restaurar en una instancia nueva.

  6. En el menú Región, selecciona la región de la nueva instancia.

  7. En el campo ID de instancia, introduzca un ID para la nueva instancia.

  8. Haz clic en Restaurar.

    Cloud SQL restaurará la copia de seguridad en una instancia nueva. Para comprobar el estado de la operación de restauración, ve a la página Operaciones de la instancia.

gcloud

  1. Usa gcloud sql backups list para encontrar la copia de seguridad que quieras almacenar en una instancia nueva.

    gcloud sql backups list
    --project=PROJECT_ID
    

    Haz los cambios siguientes:

    • PROJECT_ID: el ID de tu proyecto de Google Cloud .
  2. Busca la copia de seguridad que te interesa y registra su valor de BACKUP_NAME.

  3. Para restaurar una instancia nueva, usa el comando gcloud sql backups restore:

    gcloud sql backups restore BACKUP_NAME
    --restore-instance=TARGET_INSTANCE_NAME
    

    Haz los cambios siguientes:

    • BACKUP_NAME: el nombre de la copia de seguridad conservada que quieras restaurar.

    • TARGET_INSTANCE_NAME: el nombre de la nueva instancia en la que quieras restaurar la copia de seguridad.

REST v1

Restaurar una instancia nueva a partir de la copia de seguridad conservada especificada

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto
  • TARGET_INSTANCE_ID: el ID de instancia de destino
  • BACKUP_ID: el ID de la copia de seguridad

Método HTTP y URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID/restoreBackup

Cuerpo JSON de la solicitud:

{
  backup: projects/PROJECT_ID/backups/BACKUP_ID
  restore_instance_settings: {}
}

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

REST v1beta4

Restaurar una instancia nueva a partir de la copia de seguridad conservada especificada

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto
  • TARGET_INSTANCE_ID: el ID de instancia de destino
  • BACKUP_ID: el ID de la copia de seguridad

Método HTTP y URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID/restoreBackup

Cuerpo JSON de la solicitud:

{
  backup: projects/PROJECT_ID/backups/BACKUP_ID
  restore_instance_settings: {}
}

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Restaurar una copia de seguridad conservada en una instancia

Cuando restauras datos de una copia de seguridad conservada en una instancia, actualizas los datos de la instancia de destino al estado de la instancia de origen cuando se creó la copia de seguridad.

Consola

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

    Ir a Instancias de Cloud SQL

  2. Si la instancia de destino tiene réplicas de lectura, usa el menú de más acciones Icono de acciones adicionales. para eliminarlas. Todas las réplicas deben eliminarse para poder restaurar la copia de seguridad conservada en la instancia.

  3. En la Google Cloud consola, ve a la página Copias de seguridad de Cloud SQL.

    Ir a copias de seguridad de Cloud SQL

  4. Haga clic en el nombre de la instancia eliminada que contiene la copia de seguridad que quiere restaurar.

  5. Busca el nombre de la copia de seguridad que quieras restaurar y haz clic en Restaurar.

  6. En la página Restaurar una instancia a partir de una copia de seguridad, confirma que has seleccionado la copia de seguridad correcta en Revisar detalles de la copia de seguridad.

  7. En Elegir destino de restauración, selecciona Sobrescribir una instancia.

  8. En el menú Instancia que se va a sobrescribir, selecciona la instancia que quieras usar para la restauración. La instancia que selecciones y todos sus datos se sobrescribirán.

  9. Para confirmar la selección, en el campo ID de instancia de destino, introduce el nombre de la instancia que se va a sobrescribir.

  10. Haz clic en Restaurar.

    Cloud SQL restaurará la copia de seguridad en la instancia. Para comprobar el estado de la operación de restauración, ve a la página Operaciones de la instancia.

    Puedes crear réplicas cuando se complete la operación de restauración.

gcloud

  1. Determina si la instancia de destino tiene réplicas de lectura mediante el comando gcloud sql instances describe:

    gcloud sql instance describe TARGET_INSTANCE_NAME
    

    Haz los cambios siguientes:

    • TARGET_INSTANCE_NAME: el nombre de la instancia de destino en la que quieres restaurar la copia de seguridad.
  2. Elimina todas las réplicas de tu instancia de destino con el comando gcloud sql instances delete:

    gcloud sql instance delete REPLICA_NAME
    

    Haz los cambios siguientes:

    • REPLICA_NAME: el nombre de la réplica de la instancia de destino que quieras eliminar.

    Debes eliminar todas las réplicas para poder restaurar una instancia.

  3. Usa gcloud sql backups list para encontrar la copia de seguridad que quieras restaurar en la instancia.

    gcloud sql backups list
    --project=PROJECT_ID
    

    Haz los cambios siguientes:

    • PROJECT_ID: el ID de tu proyecto de Google Cloud .
  4. Busca la copia de seguridad que te interesa y registra su valor de BACKUP_NAME.

  5. Para restaurar una instancia, usa el comando gcloud sql backups restore:

    gcloud sql backups restore BACKUP_NAME
    --restore-instance=TARGET_INSTANCE_NAME
    

    Haz los cambios siguientes:

    • BACKUP_NAME: el nombre de la copia de seguridad conservada que quieras restaurar.

    • TARGET_INSTANCE_NAME: el nombre de la instancia que ya tienes y en la que quieres restaurar la copia de seguridad.

    Una vez que se haya completado la operación de restauración, vuelva a crear las réplicas que se hayan eliminado.

REST v1

  1. Para determinar si la instancia tiene réplicas de lectura y obtener los IDs de estas réplicas, enumera todas las réplicas de la instancia de destino.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto
    • INSTANCE_ID: el ID de instancia

    Método HTTP y URL:

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID?fields=replicaNames

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

  2. Elimina todas las réplicas de la instancia de destino.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto
    • REPLICA_ID: el ID de la réplica

    Método HTTP y URL:

    DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_ID

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

  3. Obtén el ID de la copia de seguridad conservada que quieras restaurar.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto

    Método HTTP y URL:

    GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

  4. Restaura la instancia de destino a partir de la copia de seguridad conservada.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto
    • TARGET_INSTANCE_ID: el ID de instancia de destino
    • BACKUP_ID: el ID de la copia de seguridad

    Método HTTP y URL:

    POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID/restoreBackup

    Cuerpo JSON de la solicitud:

    {
      backup: projects/PROJECT_ID/backups/BACKUP_ID
    }
    

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

REST v1beta4

  1. Para determinar si la instancia tiene réplicas de lectura y obtener los IDs de estas réplicas, enumera todas las réplicas de la instancia de destino.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto
    • INSTANCE_ID: el ID de instancia

    Método HTTP y URL:

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID?fields=replicaNames

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

  2. Elimina todas las réplicas de la instancia de destino.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto
    • REPLICA_ID: el ID de la réplica

    Método HTTP y URL:

    DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/REPLICA_ID

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

  3. Obtén el ID de la copia de seguridad conservada que quieras restaurar.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto

    Método HTTP y URL:

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

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

  4. Restaura la instancia de destino a partir de la copia de seguridad conservada.

    Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

    • PROJECT_ID: el ID del proyecto
    • TARGET_INSTANCE_ID: el ID de instancia de destino
    • BACKUP_ID: el ID de la copia de seguridad

    Método HTTP y URL:

    POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID/restoreBackup

    Cuerpo JSON de la solicitud:

    {
      backup: projects/PROJECT_ID/backups/BACKUP_ID
    }
    

    Para enviar tu solicitud, despliega una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

Restaurar en una instancia de otro proyecto

Para restaurar una instancia con una copia de seguridad conservada en otro proyecto, debes tener los siguientes permisos:

Solo puedes restaurar en otro proyecto con la CLI de gcloud o la API Cloud SQL.

gcloud

  1. Usa gcloud sql backups list para encontrar la copia de seguridad que quieras almacenar en una instancia nueva.

    gcloud sql backups list
    --project=PROJECT_ID
    

    Haz los cambios siguientes:

    • PROJECT_ID: el ID de tu proyecto de Google Cloud .
  2. Busca la copia de seguridad que te interesa y registra su valor de BACKUP_NAME.

  3. Para restaurar una instancia nueva, usa el comando gcloud sql backups restore:

    gcloud sql backups restore BACKUP_ID
    --restore-instance=TARGET_INSTANCE_NAME
    

    Haz los cambios siguientes:

    • BACKUP_ID: el nombre de la copia de seguridad conservada que quieras restaurar.

    • TARGET_INSTANCE_NAME: el nombre de la nueva instancia ubicada en el proyecto de destino en el que quieras restaurar la copia de seguridad.

REST v1

Para obtener el backupID de la copia de seguridad conservada, ejecuta lo siguiente:

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto

Método HTTP y URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Restaurar en otro proyecto

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto
  • TARGET_INSTANCE_ID: el ID de instancia de destino
  • BACKUP_ID: el ID de la copia de seguridad

Método HTTP y URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID/restoreBackup

Cuerpo JSON de la solicitud:

{
  backup: projects/PROJECT_ID/backups/BACKUP_ID
}

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

REST v1beta4

Para obtener el backupID de la copia de seguridad conservada, ejecuta lo siguiente:

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto

Método HTTP y URL:

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

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Restaurar en otro proyecto

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto
  • TARGET_INSTANCE_ID: el ID de instancia de destino
  • BACKUP_ID: el ID de la copia de seguridad

Método HTTP y URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID/restoreBackup

Cuerpo JSON de la solicitud:

{
  backup: projects/PROJECT_ID/backups/BACKUP_ID
}

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Restaurar en una instancia de otra región

Para restaurar una instancia con una copia de seguridad conservada en otra región, debes tener los siguientes permisos:

Solo puedes restaurar en otra región con gcloud CLI o con la API de Cloud SQL. La región de destino debe cumplir las políticas de la organización de la región.

gcloud

  1. Usa gcloud sql backups list para encontrar la copia de seguridad que quieras almacenar en una instancia nueva.

    gcloud sql backups list
    --project=PROJECT_ID
    

    Haz los cambios siguientes:

    • PROJECT_ID: el ID de tu proyecto de Google Cloud .
  2. Busca la copia de seguridad que te interesa y registra su valor de NAME.

  3. Para restaurar una instancia nueva, usa el comando gcloud sql backups restore:

    gcloud sql backups restore BACKUP_ID
    --restore-instance=TARGET_INSTANCE_NAME
    --region=TARGET_REGION
    

    Haz los cambios siguientes:

    • BACKUP_ID: el nombre de la copia de seguridad conservada que quieras restaurar.

    • TARGET_INSTANCE_NAME: el nombre de la nueva instancia ubicada en el proyecto de destino en el que quieras restaurar la copia de seguridad.

    • TARGET_REGION: la nueva región en la que quieras restaurar la copia de seguridad.

REST v1

Para obtener el backupID de la copia de seguridad conservada, ejecuta lo siguiente:

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto

Método HTTP y URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Restaurar en otro proyecto

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto
  • TARGET_INSTANCE_ID: el ID de instancia de destino
  • BACKUP_ID: el ID de la copia de seguridad
  • REGION: la región de la instancia de destino (por ejemplo, us-central1)

Método HTTP y URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID/restoreBackup

Cuerpo JSON de la solicitud:

{
  backup: projects/PROJECT_ID/backups/BACKUP_ID
  restore_instance_settings: {
    region: REGION
  }
}

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

REST v1beta4

Para obtener el backupID de la copia de seguridad conservada, ejecuta lo siguiente:

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto

Método HTTP y URL:

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

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Restaurar en otro proyecto

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto
  • TARGET_INSTANCE_ID: el ID de instancia de destino
  • BACKUP_ID: el ID de la copia de seguridad
  • REGION: la región de la instancia de destino (por ejemplo, us-central1)

Método HTTP y URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID/restoreBackup

Cuerpo JSON de la solicitud:

{
  backup: projects/PROJECT_ID/backups/BACKUP_ID
  restore_instance_settings: {
    region: REGION
  }
}

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Restaurar a partir de una copia de seguridad en el almacén de copias de seguridad

Si tu instancia de Cloud SQL tiene habilitadas las copias de seguridad mejoradas, puedes restaurarla a partir de una copia de seguridad del archivo de copias de seguridad. Puedes restaurar tu instancia en los siguientes casos:

  • Restaurar en una instancia nueva
  • Restaurar en una instancia
  • Restaurar en una instancia nueva o ya creada de otro proyecto

Restaurar una copia de seguridad del almacén de copias de seguridad en una instancia nueva

Cuando restauras datos de una copia de seguridad en una instancia nueva, actualizas los datos de la instancia de destino al estado de la instancia de origen cuando creaste la copia de seguridad.

Consola

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

    Ir a copias de seguridad de Cloud SQL

  2. En el menú desplegable Nivel de copia de seguridad, selecciona Nivel mejorado y, a continuación, selecciona el Almacén de copias de seguridad que contenga la copia de seguridad que quieras usar.

    Se muestran todas las copias de seguridad disponibles en el almacén de copias de seguridad de la instancia seleccionada.

  3. Busca el nombre de la copia de seguridad que quieras restaurar y haz clic en Restaurar.

  4. En la página Restaurar una instancia a partir de una copia de seguridad, confirma que has seleccionado la copia de seguridad correcta en Revisar detalles de la copia de seguridad.

  5. En Elegir destino de restauración, selecciona Restaurar en una instancia nueva y, a continuación, actualiza lo siguiente:

    • En Proyecto, selecciona el proyecto de la nueva instancia. El proyecto debe estar en la misma región que tu bóveda de copias de seguridad y debes tener acceso a él.

    • En Región, confirma la región. La región debe coincidir con la de la nueva instancia.

    • En el cuadro ID de instancia, asigna un nombre a la nueva instancia. Este nombre es permanente y no se puede cambiar.

  6. Haz clic en Restaurar.

    Cloud SQL restaura la copia de seguridad en una instancia nueva. Para comprobar el estado de la operación de restauración, ve a la página Operaciones de la instancia.

    La nueva instancia tiene la opción de copias de seguridad estándar de forma predeterminada. Para cambiar a las copias de seguridad mejoradas, consulta Habilitar copias de seguridad mejoradas.

    Puedes crear réplicas cuando se complete la operación de restauración.

gcloud

Para restaurar una instancia nueva, usa el comando gcloud sql backups restore:

gcloud sql backups restore BACKUP_ID
--restore-instance=TARGET_INSTANCE_NAME

Haz los cambios siguientes:

  • BACKUP_ID: el ID de la copia de seguridad del almacén de copias de seguridad. Deberá incluir la ruta completa de la copia de seguridad en este campo. Para ver la ruta completa, consulta List all the backups in the backup vault for an instance (Lista de todas las copias de seguridad del almacén de copias de seguridad de una instancia).

  • TARGET_INSTANCE_NAME: el nombre de la nueva instancia en la que quieras restaurar la copia de seguridad.

REST v1

REST v1beta4

Restaurar una copia de seguridad de la bóveda de copias de seguridad en una instancia

Cuando restauras datos de una copia de seguridad en una instancia, actualizas los datos de la instancia de destino al estado de la instancia de origen cuando creaste la copia de seguridad.

Consola

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

    Ir a Instancias de Cloud SQL

  2. Si la instancia de destino tiene réplicas de lectura, usa el menú de más acciones Icono de acciones adicionales. para eliminarlas. Todas las réplicas deben eliminarse para poder restaurar la copia de seguridad conservada en la instancia.

  3. En la Google Cloud consola, ve a la página Copias de seguridad de Cloud SQL.

    Ir a copias de seguridad de Cloud SQL

  4. En el menú desplegable Nivel de copia de seguridad, selecciona Nivel mejorado y, a continuación, selecciona el Almacén de copias de seguridad que contenga la copia de seguridad que quieras usar.

    Se muestran todas las copias de seguridad disponibles en el almacén de copias de seguridad de la instancia seleccionada.

  5. Busca el nombre de la copia de seguridad que quieras restaurar y haz clic en Restaurar.

  6. En la página Restaurar una instancia a partir de una copia de seguridad, confirma que has seleccionado la copia de seguridad correcta en Revisar detalles de la copia de seguridad.

  7. En Elegir destino de restauración, selecciona Sobrescribir una instancia.

  8. En el menú Instancia que se va a sobrescribir, selecciona la instancia que quieras usar para la restauración. La instancia que selecciones y todos sus datos se sobrescribirán.

  9. Para confirmar la selección, en el campo ID de instancia de destino, introduce el nombre de la instancia que se va a sobrescribir.

  10. Haz clic en Restaurar.

    Cloud SQL restaurará la copia de seguridad en la instancia. Para comprobar el estado de la operación de restauración, ve a la página Operaciones de la instancia.

    Puedes crear réplicas cuando se complete la operación de restauración.

gcloud

Para restaurar una copia de seguridad de un almacén de copias de seguridad en una instancia, haz lo siguiente:

  1. Determina si la instancia de destino tiene réplicas de lectura mediante el comando gcloud sql instances describe:

    gcloud sql instance describe TARGET_INSTANCE_NAME
    

    Haz los cambios siguientes:

    • TARGET_INSTANCE_NAME: el nombre de la instancia de destino.
  2. Elimina todas las réplicas de tu instancia de destino con el comando gcloud sql instances delete:

    gcloud sql instance delete REPLICA_NAME
    

    Haz los cambios siguientes:

    • REPLICA_NAME: el nombre de la réplica de la instancia de destino.

    Debes eliminar todas las réplicas para poder restaurar una instancia.

  3. Busca la copia de seguridad que quieras usar con la opción listar todas las copias de seguridad del archivo de copias de seguridad de una instancia. Necesitarás la dirección de la ruta de copia de seguridad completa para restaurar.

  4. Para restaurar una instancia, usa el comando gcloud sql backups restore:

    gcloud sql backups restore BACKUP_ID
    --restore-instance=TARGET_INSTANCE_NAME
    

    Haz los cambios siguientes:

    Una vez que se haya completado la operación de restauración, vuelva a crear las réplicas que se hayan eliminado.

REST v1

REST v1beta4

Restaurar una copia de seguridad de la bóveda de copias de seguridad en una instancia nueva o en una instancia de otro proyecto

Cuando restauras datos de una copia de seguridad en una instancia nueva o en una instancia de otro proyecto, actualizas los datos de la instancia de destino al estado de la instancia de origen cuando se creó la copia de seguridad. Solo puedes restaurar una instancia en otro proyecto mediante la CLI de gcloud o la API Cloud SQL.

gcloud

Para restaurar una copia de seguridad de un almacén de copias de seguridad en una instancia, haz lo siguiente:

  1. Si vas a restaurar una instancia, determina si la instancia de destino tiene réplicas de lectura con el comando gcloud sql instances describe:

    gcloud sql instance describe TARGET_INSTANCE_NAME
    

    Haz los cambios siguientes:

    • TARGET_INSTANCE_NAME: el nombre de la instancia de destino en la que quieres restaurar la copia de seguridad.

    Elimina todas las réplicas de tu instancia de destino con el comando gcloud sql instances delete:

    gcloud sql instance delete REPLICA_NAME
    

    Haz los cambios siguientes:

    • REPLICA_NAME: el nombre de la réplica de la instancia de destino.

    Debes eliminar todas las réplicas para poder restaurar una instancia.

  2. Busca la copia de seguridad que quieras restaurar con el comando list all the backups in the backup vault for an instance (listar todas las copias de seguridad del almacén de copias de seguridad de una instancia). Necesitarás la dirección de la ruta de copia de seguridad completa para restaurar.

  3. Para restaurar una instancia nueva o una que ya tengas en un proyecto nuevo, usa el comando gcloud sql backups restore:

    gcloud sql backups restore BACKUP_ID
    --restore-instance=TARGET_INSTANCE_NAME
    --backup-instance=SOURCE_INSTANCE_NAME
    --backup-project=SOURCE_INSTANCE_PROJECT
    

    Haz los cambios siguientes:

    • BACKUP_ID: ID de la copia de seguridad del depósito de copias de seguridad. Deberá incluir la ruta completa de la copia de seguridad en este campo.

    • TARGET_INSTANCE_NAME: la instancia del proyecto de destino en la que vas a restaurar los datos.

    • SOURCE_INSTANCE_NAME: el nombre de la instancia del proyecto de origen donde se encuentran los datos.

    • SOURCE_INSTANCE_PROJECT: el proyecto que contiene la instancia de origen.

REST v1

REST v1beta4

Realizar una recuperación a un momento dado

Para realizar una recuperación a un momento dado, consulta Recuperación a un momento dado.

Siguientes pasos