Restauración de una copia de seguridad en la IU

Para restaurar una copia de seguridad en una nueva instancia de servicio,

1. Pulse la fila correspondiente para ampliar las opciones para la copia de seguridad que desea restaurar.
2. Pulse Restaurar.
3. En la página Aprovisionamiento, seleccione una de las opciones disponibles.
   • La nueva instancia se denomina automáticamente « <name>-restore-[timestamp] », pero puedes cambiarle el nombre.
   • También puedes seleccionar la región en la que se encuentra la nueva instancia. Se da soporte a las restauraciones entre regiones, excepto para la restauración en o desde la región eu-de.
   • Puedes elegir la asignación inicial de recursos, ya sea para ampliar o reducir los recursos de la nueva instancia. También puede habilitar o inhabilitar núcleos dedicados. Tenga en cuenta que si disminuye la cantidad de recursos, puede provocar un fallo en la provisión o que su base de datos no funcione correctamente.
4. Haga clic en Restaurar copia de seguridad. Aparece un mensaje que indica que "se ha iniciado la restauración a partir de la copia de seguridad". Al hacer clic en «Tu nueva instancia ya está disponible», accederás a tu lista de recursos.

Restauración de una copia de seguridad en la CLI

El controlador de recursos admite el aprovisionamiento de instancias de base de datos; el aprovisionamiento y la restauración son responsabilidad de la interfaz de línea de comandos (CLI) del controlador de recursos. Utilice el mandato resource service-instance-create.

ibmcloud resource service-instance-create <INSTANCE_NAME> <SERVICE-ID> standard <REGION> --service-endpoints <ENDPOINT-TYPE> -p '{"backup_id":"BACKUP_ID"}'

• Cambia el valor de « instance_name » por el nombre que desees para tu nueva instancia.
• El « service-id » es el tipo de instancia, como «databases-for-postgresql » o «messages-for-rabbitmq ».
• El « region » es la ubicación en la que quieres que se encuentre la nueva instancia, que puede ser una región diferente a la de la instancia de origen. Se da soporte a las restauraciones entre regiones, excepto para restaurar en o desde eu-de utilizando otra región.
• El valor backup_id es la copia de seguridad que desea restaurar.

El comando anterior restaurará una copia de seguridad en una máquina con la misma configuración y en el mismo modelo de alojamiento que su despliegue original.

ibmcloud resource service-instance-create <INSTANCE_NAME> <SERVICE-ID> standard <REGION> -p
'{"backup_id":"BACKUP_ID","key_protect_key":"KEY_PROTECT_KEY_CRN", "members_disk_allocation_mb":"DESIRED_DISK_IN_MB", "members_host_flavor": "<VALUE>", "members_memory_allocation_mb":"DESIRED_MEMORY_IN_MB", "members_cpu_allocation_count":"NUMBER_OF_CORES"}'

`ibmcloud resource service-instance-create <INSTANCE_NAME> databases-for-mysql standard us-south -p '{"backup_id":"<BACKUP_ID>", "version": "<VERSION>"}'

Añadir async_restore parámetro (nuevo)- PostgreSQL solo

Se ha añadido un async_restore nuevo parámetro opcional, al bloque parameters restore.

async_restore (booleano) — valor por defecto: false. Cuando se establece en verdadero, la restauración se inicia como una operación asíncrona, lo que ayuda a reducir el tiempo de restauración de extremo a extremo.

`ibmcloud resource service-instance-create <INSTANCE_NAME> databases-for-postgresql standard us-south -p '{"point_in_time_recovery_deployment_id":"<SOURCE_CRN>", "point_in_time_recovery_time":"<PITR_TIME>", version": "<VERSION>", "async_restore": true }'

Ejemplo:

`ibmcloud resource service-instance-create <INSTANCE_NAME> databases-for-postgresql standard us-south -p '{"point_in_time_recovery_deployment_id":"test_crn", "point_in_time_recovery_time":"2025-12-08T17:08:32Z", version": "17", "async_restore": true }'

Solo se puede solicitar una restauración asíncrona cuando las bases de datos de PostgreSQL origen y destino ejecutan la misma versión principal. No se admiten restauraciones entre diferentes versiones principales. Si no se especifica el async_restore parámetro, el servicio realiza la restauración de forma sincrónica por defecto, que es el comportamiento actual.

Restauración de una copia de seguridad mediante la API

La API del controlador de recursos permite aprovisionar y restaurar instancias de bases de datos. La solicitud de creación es un POST al /resource_instances punto final.

curl -X POST \
  https://resource-controller.cloud.ibm.com/v2/resource_instances \
  -H 'Authorization: Bearer <>' \
  -H 'Content-Type: application/json' \
    -d '{
    "name": "<INSTANCE_NAME>",
    "target": "<REGION>",
    "resource_group": "<YOUR-RESOURCE-GROUP>",
    "resource_plan_id": "<SERVICE-ID>",
    "parameters":{
      "backup_id": "<BACKUP_ID>"
    }
  }'

Los parámetros name, target, resource_group y resource_plan_id son obligatorios y backup_id es la copia de seguridad que desea restaurar.

• Cambia el valor de « name » por el nombre que desees para tu nueva instancia.
• El « resource_plan_id » es el tipo de instancia, como «databases-for-postgresql » o «messages-for-rabbitmq ».
• La « target » es la región en la que quieres que se ubique la nueva instancia, que puede ser una región diferente a la de la instancia de origen. Se da soporte a las restauraciones entre regiones, excepto para la restauración en o desde la región eu-de.
• El valor backup_id es la copia de seguridad que desea restaurar.

Comando anterior restaura una copia de seguridad en un equipo con la misma configuración y el mismo modelo de alojamiento que tu implementación original.

curl -X POST \
  https://resource-controller.cloud.ibm.com/v2/resource_instances \
  -H 'Authorization: Bearer <>' \
  -H 'Content-Type: application/json' \
    -d '{
    "name": "<INSTANCE_NAME>",
    "target": "<REGION>",
    "resource_group": "<YOUR-RESOURCE-GROUP>",
    "resource_plan_id": "<SERVICE-ID>",
    "parameters":{
      "backup_id": "<BACKUP_ID>",
      "members_host_flavor": "<members_host_flavor_value>",
      "version": "<VERSION_NUMBER>"
    }
  }'

Añadir parámetro async_restore (nuevo)- PostgreSQL solo

Se ha añadido un async_restore nuevo parámetro opcional, al bloque parameters restore.

async_restore (booleano) — valor por defecto: false. Cuando se establece en verdadero, la restauración se inicia como una operación asíncrona, lo que ayuda a reducir el tiempo de restauración de extremo a extremo.

curl -X POST \
  https://resource-controller.cloud.ibm.com/v2/resource_instances \
  -H 'Authorization: Bearer <>' \
  -H 'Content-Type: application/json' \
    -d '{
    "name": "<INSTANCE_NAME>",
    "target": "<REGION>",
    "resource_group": "<YOUR-RESOURCE-GROUP>",
    "resource_plan_id": "<SERVICE-ID>",
    "parameters":{
      "point_in_time_recovery_deployment_id": "<SOURCE_CRN>",
      "point_in_time_recovery_time": "<PITR_TIME>",
      "version": "<VERSION_NUMBER>",
      "async_restore": true
    }
  }'

Solo se puede solicitar una restauración asíncrona cuando las bases de datos de PostgreSQL origen y destino ejecutan la misma versión principal. No se admiten restauraciones entre diferentes versiones principales. Si no se especifica el async_restore parámetro, el servicio realiza la restauración de forma sincrónica por defecto, que es el comportamiento actual.

Restaurar una copia de seguridad a través de Terraform

Utilice Terraform para restaurar una copia de seguridad de una versión anterior a una nueva versión.

1. Fija tu backup_id. Para obtener más información, consulte backup_id.
2. Establezca su version en el atributo de versión. Para obtener más información, consulte version.

El código es el siguiente:

resource "ibm_database" "<your-instance>" {
  name                                 = "<your_database_name>"
  service                              = "<service>"
  plan                                 = "<plan>"
  location                             = "<region>"
  version                              = "<version>"
  backup_id                            = "<backup_id>"
}

Para más información, consulte el Cloud Databases Terraform Registry.

Fast PG Restore(async_restore) a través de Terraform - PostgreSQL only

1. Se ha añadido al bloque un nuevo parámetro opcional, async_restore.

2. async_restore (booleano) — valor por defecto: false. Cuando se establece en verdadero, la restauración se inicia como una operación asíncrona, lo que ayuda a reducir el tiempo de restauración de extremo a extremo.

3. Este parámetro sólo es aplicable cuando se restaura una instancia de PostgreSQL.

El código tiene el siguiente aspecto:

data "ibm_resource_group" "group" {
  name = "<your_group>"
}
resource "ibm_database" "<your-instance>" {
  name                                 = "<your_database_name>"
  location                             = "<region>"
  plan                                 = "<plan>"
  service                              = "databases-for-postgresql"
  resource_group_id                    = data.ibm_resource_group.group.id
  service_endpoints                    = "private"
  async_restore                        = true
  point_in_time_recovery_time          = "<PITR_TIME>"
  point_in_time_recovery_deployment_id = "<SOURCE_CRN>"
  version                              = "<VERSION_NUMBER>"
}

Solo se puede solicitar una restauración asíncrona cuando las bases de datos de PostgreSQL origen y destino ejecutan la misma versión principal. No se admiten restauraciones entre diferentes versiones principales. Si no se especifica el async_restore parámetro, el servicio realiza la restauración de forma sincrónica por defecto, que es el comportamiento actual.