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

ต้องระบุ รหัสที่จะใช้สำหรับฐานข้อมูล ซึ่งจะกลายเป็นองค์ประกอบสุดท้ายของชื่อทรัพยากรของฐานข้อมูล รหัสฐานข้อมูลนี้ต้องไม่เชื่อมโยงกับฐานข้อมูลที่มีอยู่

ค่านี้ควรมีความยาว 4-63 อักขระ อักขระที่ถูกต้องคือ /[a-z][0-9]-/ โดยมีอักขระตัวแรกและมีอักขระตัวสุดท้ายหรือตัวเลข ต้องไม่เหมือน UUID /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/

รหัสฐานข้อมูล "(ค่าเริ่มต้น)" ก็ถูกต้องเช่นกัน

ฟิลด์สหภาพ 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

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมการตรวจสอบสิทธิ์