Создать политику архивации

  • Статья

Создает политику резервного копирования.

Создает политику резервного копирования, которая впоследствии может быть связана с приложением Service Fabric, службой или секцией для периодического резервного копирования.

Запрос

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

Параметры

Имя Тип Обязательно Расположение
api-version строка Да Запрос
timeout integer (int64) Нет Запрос
ValidateConnection Логическое Нет Запрос
BackupPolicyDescription BackupPolicyDescription да Текст

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 секунд.

ValidateConnection

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

Указывает, следует ли проверять подключение к хранилищу и учетные данные перед созданием или обновлением политик резервного копирования.

BackupPolicyDescription

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

Описывает политику резервного копирования.

Ответы

Код состояния HTTP Описание схеме ответа.
201 Created (создано); Успешная операция возвращает код состояния 201 и создает новую политику резервного копирования.
Все остальные коды состояния Подробный ответ об ошибке.
 FabricError

Примеры

Создание политики резервного копирования на основе времени с помощью Azure в качестве расположения резервного копирования

В этом примере показано, как создать политику резервного копирования, которая дважды ежедневно в 9:00 и 17:00 (UTC) удаляется через 3 месяца с хранилищем BLOB-объектов Azure в качестве расположения резервной копии.

Запрос

POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4
Текст
{
  "Name": "DailyAzureBackupPolicy",
  "AutoRestoreOnDataLoss": false,
  "MaxIncrementalBackups": "3",
  "Schedule": {
    "ScheduleKind": "TimeBased",
    "ScheduleFrequencyType": "Daily",
    "RunTimes": [
      "0001-01-01T09:00:00Z",
      "0001-01-01T17:00:00Z"
    ]
  },
  "Storage": {
    "StorageKind": "AzureBlobStore",
    "FriendlyName": "Azure_storagesample",
    "ConnectionString": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<PutYourAccountKeyHere>",
    "ContainerName": "BackupContainer"
  },
  "RetentionPolicy": {
    "RetentionPolicyType": "Basic",
    "MinimumNumberOfBackups": "20",
    "RetentionDuration": "P3M"
  }
}

Ответ 201

Текст

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

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

В этом примере показано, как создать политику резервного копирования, которая дважды ежедневно в 9:00 и 17:00 (UTC) удаляется через 3 месяца с хранилищем BLOB-объектов Azure в качестве расположения резервного копирования с помощью управляемого удостоверения.

Запрос

POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4
Текст
{
  "Name": "DailyAzureMIBackupPolicy",
  "AutoRestoreOnDataLoss": false,
  "MaxIncrementalBackups": "3",
  "Schedule": {
    "ScheduleKind": "TimeBased",
    "ScheduleFrequencyType": "Daily",
    "RunTimes": [
      "0001-01-01T09:00:00Z",
      "0001-01-01T17:00:00Z"
    ]
  },
  "Storage": {
    "StorageKind": "ManagedIdentityAzureBlobStore",
    "FriendlyName": "AzureMI_storagesample",
    "BlobServiceUri": "https://managedidentitytest.blob.core.windows.net/",
    "ContainerName": "BackupContainer",
    "ManagedIdentityType": "Cluster"
  },
  "RetentionPolicy": {
    "RetentionPolicyType": "Basic",
    "MinimumNumberOfBackups": "20",
    "RetentionDuration": "P3M"
  }
}

Ответ 201

Текст

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

Создание политики резервного копирования на основе частоты с общей папкой в качестве расположения резервного копирования

В этом примере показано, как создать политику резервного копирования, которая выполняет резервное копирование каждые 10 минут и удаляется через 20 дней с общей папкой в качестве расположения резервного копирования.

Запрос

POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4
Текст
{
  "Name": "FileShare10MinBackupPolicy",
  "AutoRestoreOnDataLoss": false,
  "MaxIncrementalBackups": "3",
  "Schedule": {
    "ScheduleKind": "FrequencyBased",
    "Interval": "PT10M"
  },
  "Storage": {
    "StorageKind": "FileShare",
    "FriendlyName": "FileShare_myshare",
    "Path": "\\\\myshare\\backupshare",
    "PrimaryUserName": "backupaccount",
    "PrimaryPassword": "abcd1234"
  },
  "RetentionPolicy": {
    "RetentionPolicyType": "Basic",
    "MinimumNumberOfBackups": "20",
    "RetentionDuration": "P20D"
  }
}

Ответ 201

Текст

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

Создание политики резервного копирования на основе времени с dsms Azure в качестве расположения резервного копирования

В этом примере показано, как создать политику резервного копирования, которая выполняет резервное копирование в два раза каждый день в 9:00 и 17:00 (UTC), которая будет удалена через 3 месяца с хранилищем BLOB-объектов Azure dsms в качестве расположения резервного копирования.

Запрос

POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4
Текст
{
  "Name": "SampleDsmsBackupPolicy",
  "AutoRestoreOnDataLoss": false,
  "MaxIncrementalBackups": "3",
  "Schedule": {
    "ScheduleKind": "TimeBased",
    "ScheduleFrequencyType": "Daily",
    "RunTimes": [
      "0001-01-01T09:00:00Z",
      "0001-01-01T17:00:00Z"
    ]
  },
  "Storage": {
    "StorageKind": "DsmsAzureBlobStore",
    "FriendlyName": "DsmsAzure_storagesample",
    "StorageCredentialsSourceLocation": "https://sample-dsms.dsms.core.winows.net/dsms/samplecredentiallocation/storageaccounts/samplestorageac/servicefabricbackup/samplebackup",
    "ContainerName": "BackupContainer"
  },
  "RetentionPolicy": {
    "RetentionPolicyType": "Basic",
    "MinimumNumberOfBackups": "20",
    "RetentionDuration": "P3M"
  }
}

Ответ 201

Текст

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