기존 백업에서 복원하여 새 데이터베이스를 만듭니다.
새 데이터베이스는 기존 백업과 동일한 클라우드 리전 또는 멀티 리전 위치에 있어야 합니다. 이는 [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 |
필수 항목입니다. 데이터베이스를 복원할 프로젝트입니다. 형식은 |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "databaseId": string, // Union field |
입력란 | |
---|---|
databaseId |
필수 항목입니다. 데이터베이스에 사용할 ID로, 데이터베이스 리소스 이름의 최종 구성요소가 됩니다. 이 데이터베이스 ID는 기존 데이터베이스와 연결될 수 없습니다. 이 값은 4~63자(영문 기준)여야 합니다. 유효한 문자는 /[a-z][0-9]-/ 이며 첫 문자는 문자, 마지막 글자는 문자 또는 숫자입니다. UUID와 같아서는 안 됩니다. /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/. '(기본값)' 데이터베이스 ID도 유효합니다. |
통합 필드
|
|
backup |
복원할 백업입니다. 상위 프로젝트와 동일한 프로젝트에 속해야 합니다. 형식은 |
응답 본문
성공한 경우 응답 본문에 Operation
의 인스턴스가 포함됩니다.
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/datastore
https://www.googleapis.com/auth/cloud-platform
자세한 내용은 인증 개요를 참조하세요.