Restablecer una instancia

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

A fin de obtener información, prácticas recomendadas y requisitos para las operaciones de restablecimiento, consulta Descripción general del restablecimiento de una instancia.

Restablece una instancia desde una copia de seguridad

Puedes usar una copia de seguridad para restablecer la misma instancia que se copió o una instancia diferente en el mismo proyecto. Restablecer una instancia desde una copia de seguridad requiere que las instancias de copia de seguridad y de destino estén en la misma zona horaria.

Restablece a una instancia diferente

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. 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 (-) para recuperar 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 en el extremo derecho para borrarlas.
  3. Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
  4. Selecciona Copias de seguridad en el menú de navegación de SQL.
  5. Busca la copia de seguridad que deseas restablecer y selecciona 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ú desplegable Instancia, 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 pestaña Operaciones de la instancia de destino.
  12. Una vez completada la operación, vuelve a crear las réplicas que hayas borrado antes.

gcloud

  1. Describe la instancia de destino para ver si tiene réplicas:
    gcloud sql instances describe TARGET_INSTANCE_NAME
    

    Anota las instancias que se enumeran en replicaNames.

  2. Borra todas las réplicas:
    gcloud sql instances delete REPLICA_NAME
    

    Repite este paso para cada réplica.

  3. Enumera las copias de seguridad para la instancia de origen:
    gcloud sql backups list \
    --instance SOURCE_INSTANCE_NAME
    
  4. Encuentra la copia de seguridad que deseas usar y registra su valor de ID.
  5. Restablece la copia de seguridad especificada a la instancia de destino:
    gcloud sql backups restore BACKUP_ID \
    --restore-instance=TARGET_INSTANCE_NAME \
    --backup-instance=SOURCE_INSTANCE_NAME
        
  6. Una vez completado el restablecimiento, vuelve a crear las réplicas que hayas borrado antes.

REST v1

  1. Enumera todas las réplicas para 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: Es 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. Muestra las copias de seguridad de la instancia de origen para obtener el ID de la copia que deseas usar.

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

    HTTP method and 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 antes.

REST v1beta4

  1. Enumera todas las réplicas para 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: Es 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. Muestra las copias de seguridad de la instancia de origen para obtener el ID de la copia que deseas usar.

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

Restablece a la misma instancia

Cuando restableces a partir 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 en el extremo derecho para borrarlas.
  3. Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
  4. Selecciona Copias de seguridad en el menú de navegación de SQL.
  5. Busca la copia de seguridad que deseas usar y selecciona 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 el primer paso.

gcloud

  1. Describe la instancia para ver si tiene réplicas:
    gcloud sql instances describe INSTANCE_NAME
    

    Anota las instancias que se enumeran en replicaNames.

  2. Borra todas las réplicas:
    gcloud sql instances delete REPLICA_NAME
    

    Repítelo con todas las réplicas.

  3. Enumera las copias de seguridad para la instancia:
    gcloud sql backups list --instance INSTANCE_NAME
    
  4. Encuentra la copia de seguridad que deseas usar y registra su valor de ID.
  5. Restablece la instancia a partir de la copia de seguridad especificada:
    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 el primer paso.

REST v1

  1. Enumera las copias de seguridad de la instancia para obtener el ID de la copia que deseas usar.

    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:

  2. Restablece la instancia 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
    • 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:

  3. Una vez completada la operación, vuelve a crear las réplicas que hayas borrado antes.

REST v1beta4

  1. Enumera las copias de seguridad de la instancia para obtener el ID de la copia que deseas usar.

    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:

  2. Restablece la instancia 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
    • 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/sql/v1beta4/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:

  3. Una vez completada la operación, vuelve a crear las réplicas que hayas borrado antes.

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 están incluidos en la función Cloud SQL Admin.

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

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

Realiza una recuperación de un momento determinado

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

¿Qué sigue?