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

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