Restauration d'une sauvegarde dans l'interface utilisateur

Restaurer une sauvegarde sur une nouvelle instance de service

1. Cliquez sur la ligne correspondante pour développer les options de sauvegarde que vous souhaitez restaurer.
2. Cliquez sur Restaurer.
3. Sur la page Provisionnement, sélectionnez l'une des options disponibles.
   • La nouvelle instance est automatiquement nommée « <name>-restore-[timestamp] », mais vous pouvez la renommer.
   • Vous pouvez également sélectionner la région dans laquelle se trouve la nouvelle instance. Les restaurations interrégionales sont prises en charge, à l'exception de la restauration dans ou hors de la région eu-de.
   • Vous pouvez choisir la configuration initiale des ressources, que ce soit pour augmenter ou réduire les ressources de la nouvelle instance. Vous pouvez également activer ou désactiver des coeurs dédiés. Notez que si vous réduisez votre quantité de ressources, cela peut entraîner un échec de l'approvisionnement ou un mauvais fonctionnement de votre base de données.
4. Cliquez sur Restaurer la sauvegarde. Le message "restore from backup started" s'affiche. En cliquant sur « Votre nouvelle instance est désormais disponible », vous accédez à votre liste de ressources.

Restauration d'une sauvegarde dans l'interface de ligne de commande

Le contrôleur de ressources prend en charge la mise à disposition d'instances de base de données; la mise à disposition et la restauration relèvent de la responsabilité de l'interface de ligne de commande (CLI) du contrôleur de ressources. Utilisez la commande resource service-instance-create.

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

• Remplacez la valeur « instance_name » par le nom que vous souhaitez attribuer à votre nouvelle instance.
• L'« service-id » correspond au type d'instance, comme par exemple « databases-for-postgresql » ou « messages-for-rabbitmq ».
• L' region correspond à l'emplacement où vous souhaitez que la nouvelle instance soit déployée; il peut s'agir d'une région différente de celle de l'instance source. Les restaurations interrégionales sont prises en charge, à l'exception de la restauration vers ou depuis eu-de en utilisant une autre région.
• backup_id est la sauvegarde que vous souhaitez restaurer.

La commande précédente permet de restaurer une sauvegarde sur une machine de même configuration et sur le même modèle d'hébergement que votre déploiement initial.

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>"}'

Ajouter async_restore paramètre (nouveau)- PostgreSQL uniquement

Un nouveau paramètre facultatif, async_restore a été ajouté au bloc parameters restore.

async_restore (booléen) — valeur par défaut : false. Lorsque cette option est définie sur true, la restauration est lancée en tant qu'opération asynchrone, ce qui permet de réduire la durée totale de la restauration.

`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 }'

Exemple :

`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 }'

Une restauration asynchrone ne peut être demandée que lorsque les bases de données PostgreSQL source et cible utilisent la même version majeure. Les restaurations entre différentes versions majeures ne sont pas prises en charge. Si le async_restore paramètre n'est pas spécifié, le service effectue par défaut la restauration de manière synchrone, ce qui correspond au comportement actuel.

Restauration d'une sauvegarde via l'API

L'API du contrôleur de ressources prend en charge l'approvisionnement et la restauration des instances de base de données. La demande de création est un POST vers le /resource_instances point de terminaison.

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>"
    }
  }'

Les paramètres name, target, resource_group et resource_plan_id sont tous obligatoires, et backup_id est la sauvegarde que vous souhaitez restaurer.

• Remplacez la valeur « name » par le nom que vous souhaitez attribuer à votre nouvelle instance.
• L'« resource_plan_id » correspond au type d'instance, comme par exemple « databases-for-postgresql » ou « messages-for-rabbitmq ».
• L'« target » correspond à la région dans laquelle vous souhaitez que la nouvelle instance soit hébergée; il peut s'agir d'une région différente de celle de l'instance source. Les restaurations interrégionales sont prises en charge, à l'exception de la restauration dans ou hors de la région eu-de.
• backup_id est la sauvegarde que vous souhaitez restaurer.

La commande précédente permet de restaurer une sauvegarde sur une machine présentant la même configuration et utilisant le même modèle d'hébergement que votre déploiement d'origine.

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>"
    }
  }'

Ajouter le paramètre async_restore (nouveau)- PostgreSQL uniquement

Un nouveau paramètre facultatif, async_restore a été ajouté au bloc parameters restore.

async_restore (booléen) — valeur par défaut : false. Lorsque cette option est définie sur true, la restauration est lancée en tant qu'opération asynchrone, ce qui permet de réduire la durée totale de la restauration.

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

Une restauration asynchrone ne peut être demandée que lorsque les bases de données PostgreSQL source et cible utilisent la même version majeure. Les restaurations entre différentes versions majeures ne sont pas prises en charge. Si le async_restore paramètre n'est pas spécifié, le service effectue par défaut la restauration de manière synchrone, ce qui correspond au comportement actuel.

Restauration d'une sauvegarde par Terraform

Utilisez Terraform pour restaurer une sauvegarde d'une ancienne version vers une nouvelle version.

1. Définissez votre backup_id. Pour plus d'informations, voir backup_id.
2. Définissez votre version dans l'attribut de version. Pour plus d'informations, voir version.

Le code se présente comme suit :

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

Pour plus d'informations, voir le Cloud Databases Terraform Registry.

Fast PG Restore(async_restore) via Terraform - PostgreSQL uniquement

1. Un nouveau paramètre facultatif, async_restore, a été ajouté au bloc.

2. async_restore (booléen) — valeur par défaut : false. Lorsque cette option est définie sur true, la restauration est lancée en tant qu'opération asynchrone, ce qui permet de réduire la durée totale de la restauration.

3. Ce paramètre ne s'applique que lors de la restauration d'une instance PostgreSQL.

Le code se présente comme suit :

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

Une restauration asynchrone ne peut être demandée que lorsque les bases de données PostgreSQL source et cible utilisent la même version majeure. Les restaurations entre différentes versions majeures ne sont pas prises en charge. Si le async_restore paramètre n'est pas spécifié, le service effectue par défaut la restauration de manière synchrone, ce qui correspond au comportement actuel.