Поделиться через

Запуск обновления конфигурации кластера

  • Статья

Запуск обновления конфигурации автономного кластера Service Fabric.

Проверка указанных параметров обновления поставляемой конфигурации и запуск обновления конфигурации кластера, если параметры действительны.

Запрос

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

Параметры

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

api-version

Тип: строка
Обязательный: да
По умолчанию: 6.0

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

Версия 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 секунд.

ClusterConfigurationUpgradeDescription

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

Параметры для обновления конфигурации автономного кластера.

Ответы

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

Примеры

Начало обновления конфигурации автономного кластера Service Fabric

В этом примере показано, как начать обновление конфигурации автономного кластера Service Fabric.

Запрос

POST http://localhost:19080/$/StartClusterConfigurationUpgrade?api-version=6.0
Текст
{
  "ClusterConfig": "<PutYourClusterConfigHere>",
  "ApplicationHealthPolicies": {
    "ApplicationHealthPolicyMap": [
      {
        "Key": "fabric:/samples/CalculatorApp",
        "Value": {
          "ConsiderWarningAsError": true,
          "MaxPercentUnhealthyDeployedApplications": "10",
          "DefaultServiceTypeHealthPolicy": {
            "MaxPercentUnhealthyPartitionsPerService": "0",
            "MaxPercentUnhealthyReplicasPerPartition": "0",
            "MaxPercentUnhealthyServices": "0"
          },
          "ServiceTypeHealthPolicyMap": [
            {
              "Key": "Svc1Type",
              "Value": {
                "MaxPercentUnhealthyPartitionsPerService": "0",
                "MaxPercentUnhealthyReplicasPerPartition": "0",
                "MaxPercentUnhealthyServices": "10"
              }
            }
          ]
        }
      }
    ]
  }
}

Ответ 202

Текст

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