Восстановление раздела

Активирует восстановление состояния секции с использованием указанного описания раздела восстановления.

Восстанавливает состояние сохраненной секции с отслеживанием состояния с помощью указанной точки резервного копирования. Если для секции уже выполняется периодическое резервное копирование, то по умолчанию точка резервного копирования ищется в хранилище, указанном в политике резервного копирования. Можно также переопределить то же самое, указав сведения о хранилище резервных копий в описании раздела восстановления в тексте. После запуска восстановления его ход выполнения можно отслеживать с помощью операции GetRestoreProgress. В случае истечения времени ожидания операции укажите большее значение времени ожидания восстановления в параметре запроса.

Запрос

Метод	Универсальный код ресурса (URI) запроса
POST	/Partitions/{partitionId}/$/Restore?RestoreTimeout={RestoreTimeout}&api-version=6.4&timeout={timeout}

Параметры

Имя	Тип	Обязательно	Расположение
partitionId	строка (UUID)	Да	Путь
RestoreTimeout	Целое число	Нет	Запрос
api-version	строка	Да	Запрос
timeout	integer (int64)	Нет	Запрос
RestorePartitionDescription	RestorePartitionDescription	да	Текст

---

partitionId

Тип: string (uuid)
Обязательный: да

Идентификатор секции.

---

RestoreTimeout

Тип: целое число
Обязательный: нет
По умолчанию: 10

Указывает максимальное время ожидания (в минутах) завершения операции восстановления. После этого операция возвращается с ошибкой времени ожидания. Однако в некоторых угловых случаях может быть выполнена операция восстановления, даже если она завершается с истечением времени ожидания. В случае ошибки времени ожидания рекомендуется снова вызвать эту операцию с большим значением времени ожидания. Значение по умолчанию для этого параметра равно 10 минутам.

---

api-version

Тип: string
Обязательный: да
По умолчанию: 6.4

Версия API. Этот параметр является обязательным и его значение должно быть "6,4".

Версия REST API Service Fabric основана на версии среды выполнения, в которой api был представлен или был изменен. Среда выполнения Service Fabric поддерживает несколько версий API. Эта версия является последней поддерживаемой версией API. Если передается более ранжная версия API, возвращаемый ответ может отличаться от ответа, описанного в этой спецификации.

Кроме того, среда выполнения принимает любую версию, которая выше последней поддерживаемой версии, вплоть до текущей версии среды выполнения. Поэтому если последняя версия API — 6.0, а среда выполнения — 6.1, среда выполнения будет принимать версию 6.1 для этого API. Однако поведение API будет выполняться в документе версии 6.0.

---

timeout

Тип: integer (int64)
Обязательный: нет
По умолчанию: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

Время ожидания сервера до выполнения операции в секундах. Время ожидания — промежуток времени, в течение которого клиент готов ждать выполнения запрошенной операции. Значение по умолчанию для этого параметра — 60 секунд.

---

RestorePartitionDescription

Тип: RestorePartitionDescription
Обязательный: да

Описывает параметры для восстановления секции.

Ответы

Код состояния HTTP	Описание	схеме ответа.
202 Accepted (принято).	Код состояния 202 указывает, что запрос операции был принят и будет инициировано восстановление. Используйте операцию GetPartitionRestoreProgress, чтобы получить состояние операции восстановления.
Все остальные коды состояния	Подробный ответ об ошибке.	FabricError

Примеры

Активация восстановления секции

В этом примере показано, как активировать восстановление секции, указав резервную копию, которая будет использоваться для восстановления.

Запрос

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Restore?api-version=6.4

Текст

{
  "BackupId": "3a056ac9-7206-43c3-8424-6f6103003eba",
  "BackupStorage": {
    "StorageKind": "AzureBlobStore",
    "ConnectionString": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<PutYourAccountKeyHere>",
    "ContainerName": "BackupContainer"
  },
  "BackupLocation": "CalcApp\\CalcService\\1daae3f5-7fd6-42e9-b1ba-8c05f873994d\\2018-01-01 09.00.55.zip"
}

Ответ 202

Текст

Текст ответа пуст.