Раздел резервного копирования

  • Статья

Активирует резервное копирование состояния секции.

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

Запрос

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

Параметры

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

partitionId

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

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

BackupTimeout

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

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

api-version

Тип: строка
Обязательный: да
По умолчанию: 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 секунд.

BackupPartitionDescription

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

Описание параметров для резервного копирования секции. Если они отсутствуют, операция резервного копирования использует параметры по умолчанию из текущей политики резервного копирования, связанной с этой секцией.

Ответы

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

Примеры

Раздел резервного копирования

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

Запрос

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4
Текст
{}

Ответ 202

Текст

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

Резервное копирование секции в определенную учетную запись хранения Azure

В этом примере показано, как запустить резервное копирование секции и сохранить ее в определенной учетной записи хранения BLOB-объектов Azure.

Запрос

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4
Текст
{
  "BackupStorage": {
    "StorageKind": "AzureBlobStore",
    "ConnectionString": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<PutYourAccountKeyHere>",
    "ContainerName": "BackupContainer"
  }
}

Ответ 202

Текст

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

Резервное копирование секции в определенное расположение хранилища Azure, доступ к которым осуществляется с помощью управляемого удостоверения

В этом примере показано, как активировать резервное копирование секции сейчас и сохранить резервную копию в определенной учетной записи хранения BLOB-объектов Azure с помощью управляемого удостоверения.

Запрос

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4
Текст
{
  "BackupStorage": {
    "StorageKind": "ManagedIdentityAzureBlobStore",
    "BlobServiceUri": "https://managedidentitytest.blob.core.windows.net/",
    "ContainerName": "BackupContainer",
    "ManagedIdentityType": "Cluster"
  }
}

Ответ 202

Текст

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

Резервное копирование секции в определенную локальную общую папку

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

Запрос

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4
Текст
{
  "BackupStorage": {
    "StorageKind": "FileShare",
    "Path": "\\\\myshare\\backupshare",
    "PrimaryUserName": "mydomain\\backupaccount",
    "PrimaryPassword": "abcd1234"
  }
}

Ответ 202

Текст

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

Резервное копирование секции в определенное расположение хранилища Azure dsms

В этом примере показано, как запустить резервное копирование секции и сохранить резервную копию в определенном расположении хранилища BLOB-объектов Azure dsms.

Запрос

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4
Текст
{
  "BackupStorage": {
    "StorageKind": "DsmsAzureBlobStore",
    "StorageCredentialsSourceLocation": "https://sample-dsms.dsms.core.winows.net/dsms/samplecredentiallocation/storageaccounts/samplestorageac/servicefabricbackup/samplebackup",
    "ContainerName": "BackupContainer"
  }
}

Ответ 202

Текст

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