Restablece 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 a partir de 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.

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 Google Cloud Console, 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. Haz clic en el nombre de la instancia para abrir la página Descripción general de esa instancia.
  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 el cuadro de diálogo Restablece una instancia desde una copia de seguridad, verifica que el nombre de la instancia que deseas usar para el restablecimiento esté seleccionado en el menú desplegable de instancias. La instancia de destino predeterminada es la misma a partir de la cual se creó la copia de seguridad.
  7. Escribe el nombre de la instancia en el campo Nombre de la instancia para confirmar la selección.
  8. Haz clic en Restablecer para iniciar el proceso de restablecimiento.
  9. Puedes comprobar el estado de la operación de restablecimiento en la página Operaciones de la instancia.
  10. Una vez completada la operación, vuelve a crear las réplicas que hayas borrado en el primer paso.

    No puedes volver a usar los nombres de instancia hasta una semana después de que se haya borrado.

gcloud

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

    Observa las instancias que aparecen 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: 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 siguiente:

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

    No puedes volver a usar los nombres de instancia hasta una semana después de que se haya borrado.

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

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

    No puedes volver a usar los nombres de instancia hasta una semana después de que se haya borrado.

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 Google Cloud Console, 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. Haz clic en el nombre de la instancia para abrir la página Descripción general de esa instancia.
  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 el cuadro de diálogo Restablece una instancia desde una copia de seguridad, selecciona la instancia a la que deseas restablecer en el menú desplegable Instancia.
  7. En el cuadro de diálogo Restablece una instancia desde una copia de seguridad, selecciona la instancia que deseas usar para el restablecimiento en el menú desplegable Instancia. La instancia de destino predeterminada es la misma a partir de la cual se creó la copia de seguridad.
  8. Escribe el nombre de la instancia en el campo Nombre de la instancia para confirmar la selección.
  9. Haz clic en Restablecer para iniciar el proceso de restablecimiento.
  10. Puedes comprobar el estado de la operación de restablecimiento en la pestaña Operaciones de la instancia de destino.
  11. Una vez completada la operación, vuelve a crear las réplicas que hayas borrado antes.

    No puedes volver a usar los nombres de instancia hasta una semana después de que se haya borrado.

gcloud

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

    Observa las instancias que aparecen 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: 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: 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, an outage, 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

    Método HTTP y URL:

    GET https://sqladmin.googleapis.com/v1beta4/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 siguiente:

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

    No puedes volver a usar los nombres de instancia hasta una semana después de que se haya borrado.

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

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

    No puedes volver a usar los nombres de instancia hasta una semana después de que se haya borrado.

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: 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 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 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/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 siguiente:

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

Próximos pasos