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 Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
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 کاراکتر باشد. کاراکترهای معتبر /[az][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

برای اطلاعات بیشتر، به نمای کلی احراز هویت مراجعه کنید.