Method: projects.databases.restore

기존 백업에서 복원하여 새 데이터베이스를 만듭니다.

새 데이터베이스는 기존 백업과 동일한 클라우드 리전 또는 멀티 리전 위치에 있어야 합니다. 새로운 빈 데이터베이스를 만드는 대신 데이터베이스 유형, 색인 구성, 기존 백업의 문서로 새 데이터베이스가 생성된다는 점을 제외하면 [FirestoreAdmin.CreateDatabase][google.firestore.admin.v1.CreateDatabase] 와 유사하게 동작합니다.

long-running operation는 복원 진행 상황을 추적하는 데 사용할 수 있으며 작업의 metadata 필드 유형은 RestoreDatabaseMetadata입니다. 복원이 성공하면 response 유형은 Database입니다. LRO가 완료될 때까지 새 데이터베이스를 읽거나 쓸 수 없습니다.

HTTP 요청

POST https://firestore.googleapis.com/v1/{parent=projects/*}/databases:restore

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
parent

string

필수 항목입니다. 데이터베이스를 복원할 프로젝트입니다. 형식은 projects/{projectId}입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "databaseId": string,

  // Union field source can be only one of the following:
  "backup": string
  // End of list of possible types for union field source.
}
필드
databaseId

string

필수 항목입니다. 데이터베이스에 사용할 ID로, 데이터베이스 리소스 이름의 최종 구성요소가 됩니다. 이 데이터베이스 ID는 기존 데이터베이스와 연결되어서는 안 됩니다.

이 값은 4~63자(영문 기준)여야 합니다. 유효한 문자는 /[a-z][0-9]-/ 이며 첫 번째 문자는 문자, 마지막 문자는 문자 또는 숫자여야 합니다. UUID와 같은 /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/가 아니어야 합니다.

'(기본값)' 데이터베이스 ID도 유효합니다.

통합 필드 source.

source는 다음 중 하나여야 합니다.

backup

string

복원할 백업입니다. 상위 요소와 동일한 프로젝트에 속해야 합니다.

형식은 projects/{projectId}/locations/{location}/backups/{backup}입니다.

응답 본문

성공한 경우 응답 본문에 Operation의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/datastore
  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.