Restablecer una instancia

En esta página, se describe cómo restablecer tu instancia desde una copia de seguridad y realizar una recuperación de un momento determinado de una instancia.

Para obtener información, prácticas recomendadas y requisitos para las operaciones de restablecimiento o la recuperación de un momento determinado, consulta Descripción general del restablecimiento de una instancia.

Restablece desde una copia de seguridad automática o a pedido

Puedes usar una copia de seguridad automática o a pedido en las siguientes situaciones:

  • Restablece a una instancia diferente en el mismo proyecto
  • Restablece en la misma instancia desde la que se tomó la copia de seguridad
  • Restablece una instancia en un proyecto o una región diferentes

Si tienes habilitada la recuperación de un momento determinado (PITR), puedes recuperar tu instancia en un momento específico según la configuración de retención de registros de tu instancia.

Restablece a una instancia diferente

Cuando restableces datos de una copia de seguridad a una instancia diferente, se actualizan los datos en la instancia de destino al estado de la de origen cuando realizaste la copia. A fin de obtener más información, consulta Sugerencias generales para realizar restablecimientos y Sugerencias y requisitos para restablecer a una instancia diferente.

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

Console

  1. En la consola de Google Cloud, 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 Ícono de más acciones para borrarlas.
  3. Para abrir la página de Descripción general 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 deseas restablecer y, luego, haz clic en Restablecer.
  6. En la página Restablecer una instancia a partir de una copia de seguridad, confirma que seleccionaste la copia de seguridad correcta en Revisa los detalles de la copia de seguridad.
  7. En Elige el destino de restablecimiento, selecciona Reemplazar una instancia existente.
  8. En el menú Instancia que se reemplazará, selecciona la instancia que deseas usar para el restablecimiento. Se reemplazan la instancia que seleccionas y todos los datos.
  9. Para confirmar la selección, ingresa el nombre de la instancia que se reemplazará en el campo ID de instancia de destino.
  10. Para iniciar el proceso de restablecimiento, haz clic en Restablecer.
  11. Para verificar el estado de la operación de restablecimiento, ve a la página Operaciones de la instancia.
  12. Una vez completada la operación, vuelve a crear las réplicas que hayas borrado 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 se enumeran en la columna replicaNames.

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

    Repite este paso para cada réplica.

  3. Para enumerar 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 deseas usar y registra su valor de ID.
  5. Para restablecer 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, vuelve a crear las réplicas que hayas borrado 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 de destino.

    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

    Método HTTP y URL:

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

    Para enviar tu solicitud, expande una de estas opciones:

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

  2. Borra todas las réplicas.

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

    • 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, expande una de estas opciones:

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

    Repite este paso para cada réplica.

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

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

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

    Método HTTP y URL:

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

    Para enviar tu solicitud, expande una de estas opciones:

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

    O

    Si la instancia se encuentra en una región que tiene una interrupción, enumera todas las copias de seguridad en un proyecto.

    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 o - para obtener una lista de todas las copias de seguridad en el proyecto

    Método HTTP y URL:

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

    Para enviar tu solicitud, expande una de estas opciones:

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

    Busca la copia de seguridad de la instancia que necesitas restablecer.
  4. Restablece la instancia de destino a partir de la copia de seguridad:

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

    • project-id: El ID del proyecto
    • target-instance-id: El ID de la instancia de destino
    • source-instance-id: El 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, expande una de estas opciones:

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

  5. Una vez completada la operación, vuelve a crear las réplicas que hayas borrado 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 de destino.

    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

    Método HTTP y URL:

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

    Para enviar tu solicitud, expande una de estas opciones:

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

  2. Borra todas las réplicas.

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

    • 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, expande una de estas opciones:

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

    Repite este paso para cada réplica.

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

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

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

    Método HTTP y URL:

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

    Para enviar tu solicitud, expande una de estas opciones:

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

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

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

    • project-id: El ID del proyecto
    • target-instance-id: El ID de la instancia de destino
    • source-instance-id: El 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, expande una de estas opciones:

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

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

Restablece a la misma instancia

Cuando restableces datos de una copia de seguridad a la misma instancia, puedes regresar los datos de esa instancia al estado que tenían al copiarla. Obtén más información sobre cómo restablecer una instancia en Sugerencias generales para realizar restablecimientos.

Console

  1. En la consola de Google Cloud, 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 Ícono de más acciones para borrarlas.
  3. Para abrir la página de Descripción general 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 deseas usar y, luego, haz clic en Restablecer.
  6. En la página Restablecer una instancia a partir de una copia de seguridad, confirma que seleccionaste la copia de seguridad correcta en Revisa los detalles de la copia de seguridad.
  7. En Elegir destino de restablecimiento, selecciona Reemplazar la instancia de origen.

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

  8. Para confirmar la selección, ingresa el nombre de la instancia en el campo ID de instancia de destino.
  9. Para iniciar el proceso de restablecimiento, haz clic en Restablecer.
  10. Para verificar el estado de la operación de restablecimiento, ve a la página Operaciones de la instancia.
  11. Una vez completada la operación, vuelve a crear las réplicas que hayas borrado 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 se enumeran en la columna replicaNames.

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

    Repite este paso para cada réplica.

  3. Para enumerar 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 deseas usar y registra su valor de ID.
  5. Para restablecer 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, vuelve a crear las réplicas que hayas borrado 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.

    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

    Método HTTP y URL:

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

    Para enviar tu solicitud, expande una de estas opciones:

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

  2. Borra todas las réplicas.

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

    • 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, expande una de estas opciones:

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

    Repite este paso para cada réplica.

  3. Para obtener el ID de la copia de seguridad que deseas usar, enumera las copias de seguridad de 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: Es el ID de la instancia.

    Método HTTP y URL:

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

    Para enviar tu solicitud, expande una de estas opciones:

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

  4. Restablece la instancia a partir de la copia de seguridad especificada.

    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
    • 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, expande una de estas opciones:

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

  5. Una vez completada la operación, vuelve a crear las réplicas que hayas borrado 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.

    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

    Método HTTP y URL:

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

    Para enviar tu solicitud, expande una de estas opciones:

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

  2. Borra todas las réplicas.

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

    • 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, expande una de estas opciones:

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

    Repite este paso para cada réplica.

  3. Para obtener el ID de la copia de seguridad que deseas usar, enumera las copias de seguridad de 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: Es el ID de la instancia.

    Método HTTP y URL:

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

    Para enviar tu solicitud, expande una de estas opciones:

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

  4. Restablece la instancia a partir de la copia de seguridad especificada.

    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
    • BACKUP_RUN_ID: Una marca de fecha y hora de la fecha en la que Cloud SQL restablece la instancia desde 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, expande una de estas opciones:

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

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

Restablece una instancia en otro proyecto

Puedes usar el parámetro project para restablecer datos a una instancia en un proyecto diferente al que se le realizó la copia de seguridad. Cuando uses el parámetro project, llama a restoreBackup en el proyecto y en la instancia en la que deseas restablecer los datos. Cuando restableces a partir de una copia de seguridad a una instancia diferente, se actualizan los datos en la instancia de destino al estado de la de origen cuando realizaste la copia.

Permisos

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

Para restablecer datos a una instancia en un proyecto diferente, realiza lo siguiente:

gcloud

  1. Enumera las copias de seguridad de la instancia.

    gcloud sql backups list --instance INSTANCE_NAME

    Reemplaza INSTANCE_NAME por el nombre de la instancia.

  2. Encuentra la copia de seguridad que deseas usar y registra su valor de ID.
  3. Restablece datos a una instancia en un proyecto diferente.

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

    Realiza los siguientes reemplazos:

    • BACKUP_ID: Es el ID de la copia de seguridad. Obtuviste este ID antes en este procedimiento.
    • TARGET_INSTANCE_NAME: Es la instancia del proyecto de destino en la que restableces los datos.
    • SOURCE_INSTANCE_NAME: Es la instancia del proyecto de origen que contiene los datos que deseas restablecer en la instancia del proyecto de destino.
    • SOURCE_INSTANCE_PROJECT: Es el proyecto que contiene la instancia de origen.

REST v1

Para obtener el backupId, ejecuta lo siguiente.

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

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

Método HTTP y URL:

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

Para enviar tu solicitud, expande una de estas opciones:

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

Restablece la copia de seguridad a una instancia en un proyecto diferente:

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

  • source-project-id: El ID del proyecto de origen
  • target-project-id: El ID del proyecto de destino
  • target-instance-id: El ID de la instancia de destino
  • source-instance-id: El 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, expande una de estas opciones:

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

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

REST v1beta4

Para obtener el backupId, ejecuta lo siguiente.

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

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

Método HTTP y URL:

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

Para enviar tu solicitud, expande una de estas opciones:

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

Restablece la copia de seguridad a una instancia en un proyecto diferente:

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

  • source-project-id: El ID del proyecto de origen
  • target-project-id: El ID del proyecto de destino
  • target-instance-id: El ID de la instancia de destino
  • source-instance-id: El 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, expande una de estas opciones:

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

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

Restablece desde una copia de seguridad final

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

  • Restablece la copia de seguridad final en una instancia nueva
  • Restablece a una instancia nueva en un proyecto o una región diferentes

Como usas una copia de seguridad final de una instancia borrada para restablecerla, también puedes usar la copia de seguridad para crear una instancia con la configuración de la instancia borrada y recuperar tus datos.

Restablecer en una instancia nueva

Cuando creas una instancia a partir de una copia de seguridad final, Cloud SQL usa la configuración de la instancia desde la que se tomó la copia de seguridad final. Después de crear la instancia, Cloud SQL restablece los datos al estado en el que se tomó la copia de seguridad final.

Console

  1. En la consola de Google Cloud, 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, que están asociadas con un proyecto de Google Cloud.

  2. Haz clic en la copia de seguridad final que contiene los datos que deseas restablecer en una instancia nueva.
  3. En el diálogo Copia de seguridad final, haz clic en Restablecer.
  4. En la página Restablecer una instancia a partir de una copia de seguridad, confirma que seleccionaste la copia de seguridad correcta en Revisa los detalles de la copia de seguridad.
  5. En Elige el destino de restablecimiento, selecciona Restablecer en una instancia nueva.
  6. En el menú Región, selecciona la región de la instancia nueva.
  7. En el campo ID de instancia, ingresa un ID para la instancia nueva.
  8. Para iniciar el proceso de restablecimiento, haz clic en Restablecer.
  9. Para verificar el estado de la operación de restablecimiento, ve a la página Operaciones de la instancia.

gcloud

  1. Para enumerar 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'
  2. Busca la copia de seguridad que deseas usar y registra su valor de NAME.
  3. Para restablecer 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 deseas usar, enumera las copias de seguridad finales de la instancia de origen.

    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

    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, expande una de estas opciones:

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

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

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

    • PROJECT_ID: El ID del proyecto
    • TARGET_INSTANCE_ID: el ID de la instancia de destino
    • BACKUP_ID: Es 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, expande una de estas opciones:

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

REST v1beta4

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

    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

    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, expande una de estas opciones:

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

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

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

    • PROJECT_ID: El ID del proyecto
    • TARGET_INSTANCE_ID: el ID de la instancia de destino
    • BACKUP_ID: Es 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, expande una de estas opciones:

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

Restablece en una instancia existente

Cuando restableces datos de una copia de seguridad final a una instancia existente, se actualizan los datos en la instancia de destino al estado de la de origen cuando realizaste la copia. A fin de obtener más información, consulta Sugerencias generales para realizar restablecimientos y Sugerencias y requisitos para restablecer a una instancia diferente.

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

Console

  1. En la consola de Google Cloud, 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 Ícono de más acciones para borrarlas.
  3. En la consola de Google Cloud, 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, que están asociadas con un proyecto de Google Cloud.

  4. Haz clic en la copia de seguridad final que contiene los datos que deseas restablecer en una instancia diferente.
  5. En el diálogo Copia de seguridad final, haz clic en Restablecer.
  6. En la página Restablecer una instancia a partir de una copia de seguridad, confirma que seleccionaste la copia de seguridad correcta en Revisa los detalles de la copia de seguridad.
  7. En Elige el destino de restablecimiento, selecciona Reemplazar una instancia existente.
  8. En el menú Instancia que se reemplazará, selecciona la instancia que deseas usar para el restablecimiento. Se reemplazan la instancia que seleccionas y todos los datos.

  9. Para confirmar la selección, ingresa el nombre de la instancia que se reemplazará en el campo ID de instancia de destino.
  10. Para iniciar el proceso de restablecimiento, haz clic en Restablecer.
  11. Para verificar el estado de la operación de restablecimiento, ve a la página Operaciones de la instancia.
  12. Una vez completada la operación, vuelve a crear las réplicas que hayas borrado 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 se enumeran en la columna replicaNames.

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

    Repite este paso para cada réplica.

  3. Para enumerar 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 deseas usar y registra su valor de NAME.
  5. Para restablecer 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, vuelve a crear las réplicas que hayas borrado 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 de destino.

    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

    Método HTTP y URL:

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

    Para enviar tu solicitud, expande una de estas opciones:

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

  2. Borra todas las réplicas.

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

    • 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, expande una de estas opciones:

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

    Repite este paso para cada réplica.

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

    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

    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, expande una de estas opciones:

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

    Busca la copia de seguridad de la instancia que necesitas restablecer.
  4. Restablece la instancia de destino a partir de la copia de seguridad:

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

    • PROJECT_ID: El ID del proyecto
    • TARGET_INSTANCE_ID: el ID de la instancia de destino
    • BACKUP_ID: Es 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, expande una de estas opciones:

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

  5. Una vez completada la operación, vuelve a crear las réplicas que hayas borrado 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 de destino.

    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

    Método HTTP y URL:

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

    Para enviar tu solicitud, expande una de estas opciones:

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

  2. Borra todas las réplicas.

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

    • 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, expande una de estas opciones:

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

    Repite este paso para cada réplica.

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

    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

    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, expande una de estas opciones:

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

    Busca la copia de seguridad de la instancia que necesitas restablecer.
  4. Restablece la instancia de destino a partir de la copia de seguridad.

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

    • PROJECT_ID: El ID del proyecto
    • TARGET_INSTANCE_ID: el ID de la instancia de destino
    • BACKUP_ID: Es 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, expande una de estas opciones:

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

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

Restablece una instancia en otro proyecto

El usuario que restablece datos en una instancia de un proyecto diferente debe tener el permiso cloudsql.instances.restoreBackup para el proyecto de destino y el permiso cloudsql.backupRuns.get para la instancia de origen. Estos permisos se incluyen en el rol Cloud SQL Admin.

Para restablecer datos a una instancia en un proyecto diferente, realiza lo siguiente:

REST v1

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

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

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, expande una de estas opciones:

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

Restablece la copia de seguridad a una instancia en un proyecto diferente:

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

  • PROJECT_ID: El ID del proyecto
  • TARGET_INSTANCE_ID: el ID de la instancia de destino
  • BACKUP_ID: Es 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, expande una de estas opciones:

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

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 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

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, expande una de estas opciones:

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

Restablece la copia de seguridad a una instancia en un proyecto diferente:

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

  • PROJECT_ID: El ID del proyecto
  • TARGET_INSTANCE_ID: el ID de la instancia de destino
  • BACKUP_ID: Es 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, expande una de estas opciones:

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

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

Restablece en una instancia nueva en otra región

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

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

Para restablecer datos a una instancia nueva en una región diferente, sigue estos pasos:

gcloud

  1. Para enumerar 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'
  2. Busca la copia de seguridad que deseas usar y registra su valor de NAME.
  3. Para usar la copia de seguridad final y restablecer datos en una instancia nueva en una región diferente, 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 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

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, expande una de estas opciones:

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

Restablece la copia de seguridad en una instancia nueva en una región diferente:

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

  • PROJECT_ID: El ID del proyecto
  • TARGET_INSTANCE_ID: el ID de la instancia de destino
  • BACKUP_ID: Es 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, expande una de estas opciones:

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

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 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

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, expande una de estas opciones:

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

Restablece la copia de seguridad en una instancia nueva en una región diferente:

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

  • PROJECT_ID: El ID del proyecto
  • TARGET_INSTANCE_ID: el ID de la instancia de destino
  • BACKUP_ID: Es 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, expande una de estas opciones:

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

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

Realiza una recuperación de un momento determinado

Para realizar una recuperación de un momento determinado, consulta Recuperación de un momento determinado.

Identifica la posición de recuperación

Antes de poder realizar una recuperación de un momento determinado, debes identificar un nombre de archivo de registro binario y una posición que correspondan al momento al que deseas recuperar la instancia.

Para realizar esta tarea, consulta Identifica la posición de recuperación.

Próximos pasos