Method: projects.databases.restore

Mevcut bir yedekten geri yükleyerek yeni veritabanı oluşturur.

Yeni veritabanı, mevcut yedekle aynı bulut bölgesinde veya çoklu bölge konumunda olmalıdır. Bu komut, [FirestoreAdmin.CreateDatabase][google.firestore.admin.v1.CreateDatabase] benzeridir; tek fark, yeni bir boş veritabanı oluşturmak yerine veritabanı türü, dizin yapılandırması ve mevcut bir yedekten dokümanlarla yeni bir veritabanı oluşturulmasıdır.

long-running operation, geri yükleme işleminin ilerlemesini izlemek için kullanılabilir. İşlemin metadata alan türü RestoreDatabaseMetadata olur. Geri yükleme başarılı olduysa response türü Database olur. LRO tamamlanana kadar yeni veritabanı okunamaz veya yazılamaz.

HTTP isteği

POST https://firestore.googleapis.com/v1/{parent=projects/*}/databases:restore

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
parent

string

Zorunlu. Veritabanının geri yükleneceği proje. Biçim: projects/{projectId}.

İstek içeriği

İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi
{
  "databaseId": string,

  // Union field source can be only one of the following:
  "backup": string
  // End of list of possible types for union field source.
}
Alanlar
databaseId

string

Zorunlu. Veritabanı için kullanılacak kimlik ve veritabanının kaynak adının son bileşeni haline gelir. Bu veritabanı kimliği, mevcut bir veritabanıyla ilişkili olmamalıdır.

Bu değer 4-63 karakter uzunluğunda olmalıdır. Geçerli karakterler /[a-z][0-9]-/ şeklindedir. İlk karakteri bir harf ve son karakteri bir harf veya bir rakamdır. UUID benzeri /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/ olmamalıdır.

"(varsayılan)" veri tabanı kimliği de geçerlidir.

Birleştirme alanı source.

source şunlardan yalnızca biri olabilir:

backup

string

Geri yüklenecek yedekleme. Üst kuruluşla aynı projeye ait olmalıdır.

Biçim: projects/{projectId}/locations/{location}/backups/{backup}

Yanıt gövdesi

Başarılı olursa yanıt gövdesi, Operation öğesinin bir örneğini içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/datastore
  • https://www.googleapis.com/auth/cloud-platform

Daha fazla bilgi için Kimlik Doğrulamaya Genel Bakış başlıklı makaleye bakın.