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 символов. Допустимые символы: /[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

Для получения дополнительной информации см. Обзор аутентификации .