Method: projects.databases.restore

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 một khu vực trên đám mây hoặc vị trí nhiều vùng với bản sao lưu hiện có. Cách hoạt động này tương tự như [FirestoreAdmin.CreateDatabase][google.firestore.admin.v1.CreateDatabase] ngoại trừ việc thay vì tạo cơ sở dữ liệu trống mới, cơ sở dữ liệu mới được tạo với 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 Thao tác là RestoreDatabaseMetadata. Loại responseDatabase nếu khôi phục thành công. Cơ sở dữ liệu mới không thể đọc hoặc ghi được 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

Thông số
parent

string

Bắt buộc. Dự án khôi phục cơ sở dữ liệu. Định dạng là projects/{projectId}.

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 source can be only one of the following:
  "backup": string
  // End of list of possible types for union field source.
}
Trường
databaseId

string

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 cơ sở dữ liệu hiện có.

Giá trị này phải có 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à cuối cùng là một chữ cái hoặc một số. Không được giống với UUID /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/.

"(mặc định)" mã cơ sở dữ liệu cũng hợp lệ.

Trường kết hợp source.

source chỉ có thể là một trong những trạng thái sau đây:

backup

string

Từ bản sao lưu cần khôi phục. Phải thuộc cùng một dự án với dự án gốc.

Định dạng là: projects/{projectId}/locations/{location}/backups/{backup}

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 thực thể của Operation.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • 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ề việc xác thực.