UI에서 백업 복원

백업을 새 서비스 인스턴스로 복원하려면 다음을 수행하십시오.

1. 해당 행을 클릭하여 복원할 백업에 대한 옵션을 펼치십시오.
2. 복원을 누릅니다.
3. 프로비저닝 페이지에서 사용 가능한 몇 가지 옵션 중에서 선택합니다.
   • 새 인스턴스의 이름은 자동으로 ‘ <name>-restore-[timestamp] ’로 지정되지만, 이름을 변경할 수 있습니다.
   • 또한 새 인스턴스가 위치할 지역을 선택할 수도 있습니다. eu-de 지역으로(부터) 복원하는 경우를 제외하고 교차 지역 복원이 지원됩니다.
   • 새 인스턴스의 리소스를 확장하거나 축소할 수 있도록 초기 리소스 할당량을 선택할 수 있습니다. 전용 코어를 사용 또는 사용 안함으로 설정할 수도 있습니다. 리소스 양을 줄이면 프로비저닝이 실패하거나 데이터베이스가 제대로 작동하지 않을 수 있다는 점에 유의하세요.
4. 백업 복원을 클릭합니다. "백업에서 복원이 시작됨" 메시지가 나타납니다. '새 인스턴스가 이제 사용 가능합니다'를 클릭하면 리소스 목록으로 이동합니다.

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으로(부터) 복원하는 경우를 제외하고 교차 지역 복원이 지원됩니다.
• 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 단독으로

복원 parameters 블록에 새로운 선택적 매개변수 가 async_restore 추가되었습니다.

async_restore (부울) — 기본값: 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는 데이터베이스 인스턴스 프로비저닝 및 복원을 지원합니다. 생성 요청은 /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 지역으로(부터) 복원하는 경우를 제외하고 교차 지역 복원이 지원됩니다.
• 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 단독

복원 parameters 블록에 새로운 선택적 매개변수 가 async_restore 추가되었습니다.

async_restore (부울) — 기본값: 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의 내용을 참조하십시오.

코드는 다음과 같습니다:

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 참조하세요.

테라폼을 통한 빠른 PG 복원(비동기 복원)- PostgreSQL 전용

1. 새로운 선택적 매개변수 async_restore 가 블록에 추가되었습니다.

2. async_restore (부울) — 기본값: 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 지정되지 않은 경우 서비스는 기본적으로 복원을 동기식으로 수행하며, 이는 현재 동작 방식입니다.