Tạo cơ sở dữ liệu mới bằng cách khôi phục từ bản sao lưu hiện có.
Cơ sở dữ liệu mới phải ở cùng khu vực đám mây hoặc vị trí nhiều vùng với bản sao lưu hiện có. Thao tác này hoạt động tương tự như [FirestoreAdmin.CreateDatabase][google.firestore.admin.v1.CreateDatabase] ngoại trừ thay vì tạo cơ sở dữ liệu trống mới, bạn sẽ tạo cơ sở dữ liệu mới bằng loại cơ sở dữ liệu, cấu hình chỉ mục và tài liệu từ bản sao lưu hiện có.
Bạn có thể sử dụng long-running operation
để theo dõi tiến trình khôi phục, với loại trường metadata
của Hoạt động là RestoreDatabaseMetadata
. Loại response
là Database
nếu khôi phục thành công. Người dùng sẽ không đọc hoặc ghi được cơ sở dữ liệu mới này cho đến khi LRO hoàn tất.
Yêu cầu HTTP
POST https://firestore.googleapis.com/v1/{parent=projects/*}/databases:restore
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Tham số | |
---|---|
parent |
Bắt buộc. Dự án khôi phục cơ sở dữ liệu. Định dạng là |
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{ "databaseId": string, // Union field |
Trường | |
---|---|
databaseId |
Bắt buộc. Mã nhận dạng để sử dụng cho cơ sở dữ liệu, mã này sẽ trở thành thành phần cuối cùng trong tên tài nguyên của cơ sở dữ liệu. Không được liên kết mã cơ sở dữ liệu này với một cơ sở dữ liệu hiện có. Giá trị này phải dài từ 4 đến 63 ký tự. Các ký tự hợp lệ là /[a-z][0-9]-/ với ký tự đầu tiên là một chữ cái và chữ cái cuối cùng là một số. Không được giống như UUID /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/. Mã cơ sở dữ liệu "(mặc định)" cũng hợp lệ. |
Trường hợp
|
|
backup |
Sao lưu để khôi phục. Phải thuộc cùng một dự án với mẫu gốc. Định dạng là: |
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Operation
.
Phạm vi uỷ quyền
Yêu cầu một trong các phạm vi OAuth sau đây:
https://www.googleapis.com/auth/datastore
https://www.googleapis.com/auth/cloud-platform
Để biết thêm thông tin, hãy xem bài viết Tổng quan về hoạt động xác thực.