Cloud Databasesバックアップの管理

UI でのバックアップのリストア

新規サービス・インスタンスにバックアップをリストアするには、以下のようにします。

1. 対応する行をクリックして、リストアしようとしているバックアップのオプションを展開します。
2. **「復元」**をクリックします。
3. Provisioning（プロビジョニング） ページで、利用可能なオプションから選択します。
   • 新しいインスタンスは自動的に <name>-restore-[timestamp] という名前になるが、名前を変更することもできる。
   • 新しいインスタンスが配置される地域を選択することもできます。 リージョンを超えたリストアもサポートされていますが、eu-de リージョンから、または eu-de リージョンへのリストアは例外です。
   • 新しいインスタンスのリソースを拡張するか縮小するか、初期リソースの割り当てを選択できます。 さらに専用コアを有効または無効にすることもできます。 リソース量を減らすと、プロビジョニングに失敗したり、データベースが正しく機能しなくなる可能性があることに注意してください。
4. バックアップの復元をクリックします。 「バックアップからのリストアを開始しました (restore from backup started)」というメッセージが表示されます。 Your new instance is available now をクリックすると、 _リソース・リストに_移動します。

CLI でのバックアップのリストア

リソースコントローラはデータベースインスタンスのプロビジョニングをサポートし、プロビジョニングとリストアはリソースコントローラCLIの責任です。 resource service-instance-create コマンドを使用します。

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

• instance_name の値を新しいインスタンスに必要な名前に変更する。
• service-id 、 databases-for-postgresqlや _messages-for-rabbitmqといった_インスタンスの種類を示す。
• region は、新しいインスタンスを配置する場所であり、ソース・インスタンスとは異なるリージョンにすることができます。 別のリージョンを使用するクロスリージョン・リストアがサポートされます (ただし、eu-de へのリストア、または eu-de からのリストアは除きます)。
• backup_id は、リストアしようとしているバックアップです。

前のコマンドは、元の配置と同じ構成で同じ ホスティングモデル 上のマシンにバックアップをリストアします。

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

パラメータの async_restore 追加（新規） - PostgreSQL のみ

restore parameters ブロックに新しいオプションパラメータが追加されました async_restore。

async_restore (boolean)- デフォルト：false。 trueに設定すると、復元は非同期操作として開始され、エンドツーエンドの復元時間の短縮に役立ちます。

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

次に例を示します。

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

非同期復元は、ソースデータベースとターゲット PostgreSQL データベースが同じメジャーバージョンを実行している場合にのみ要求できます。 異なるメジャーバージョン間の復元はサポートされていません。 パラメータ async_restore が指定されていない場合、サービスはデフォルトで復元を同期的に実行します。これが現在の動作です。

API でのバックアップのリストア

リソースコントローラAPIは、データベースインスタンスのプロビジョニングとリストアをサポートします。 createリクエストは /resource_instances エンドポイントへの POST リクエストである。

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

パラメーター、name、target、resource_group、resource_plan_id はすべて、必須パラメーターです。また、backup_id はリストアするバックアップです。

• name の値を新しいインスタンスに必要な名前に変更する。
• resource_plan_id 、 databases-for-postgresqlや _messages-for-rabbitmqといった_インスタンスの種類を示す。
• target は、新しいインスタンスを配置するリージョンで、ソース・インスタンスとは異なるリージョンにすることができます。 リージョンを超えたリストアもサポートされていますが、eu-de リージョンから、または eu-de リージョンへのリストアは例外です。
• backup_id は、リストアしようとしているバックアップです。

上記のコマンドは、元の配置と同じ構成で同じ ホスティングモデル 上のマシンにバックアップをリストアします。

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

async_restore パラメータを追加（新規） - PostgreSQL のみ

restore parameters ブロックに新しいオプションパラメータが追加されました async_restore。

async_restore (boolean)- デフォルト：false。 trueに設定すると、復元は非同期操作として開始され、エンドツーエンドの復元時間の短縮に役立ちます。

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

非同期復元は、ソースデータベースとターゲット PostgreSQL データベースが同じメジャーバージョンを実行している場合にのみ要求できます。 異なるメジャーバージョン間の復元はサポートされていません。 パラメータ async_restore が指定されていない場合、サービスはデフォルトで復元を同期的に実行します。これが現在の動作です。

Terraformでバックアップをリストアする

Terraformを使って、古いバージョンから新しいバージョンへのバックアップにリストアする。

1. backup_id 設定する。 細については、 backup_idを参照してください。
2. version属性に version を設定してください。 細については、 versionを参照してください。

コードは次のようになる：

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

詳しくは、Cloud Databases Terraform Registryを参照のこと。

Terraformによる高速PGリストア(async_restore)- PostgreSQL のみ

1. 新しいオプション・パラメーター、 async_restore がブロックに追加された。

2. async_restore (boolean)- デフォルト：false。 trueに設定すると、復元は非同期操作として開始され、エンドツーエンドの復元時間の短縮に役立ちます。

3. このパラメータは、 PostgreSQL インスタンスをリストアする場合にのみ適用される。

コードは以下のようになる：

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

非同期復元は、ソースデータベースとターゲット PostgreSQL データベースが同じメジャーバージョンを実行している場合にのみ要求できます。 異なるメジャーバージョン間の復元はサポートされていません。 パラメータ async_restore が指定されていない場合、サービスはデフォルトで復元を同期的に実行します。これが現在の動作です。