Переход на начальный узел

  • Статья

Запускает или останавливает узел кластера.

Запускает или останавливает узел кластера. Узел кластера — это процесс, а не экземпляр операционной системы. Для запуска узла передайте значение "Start" в параметр NodeTransitionType. Для остановки узла передайте в параметр NodeTransitionType значение "Stop". Этот API начнет операцию. Когда API вернется, возможно, узел еще не завершит переход. Вызовите GetNodeTransitionProgress с тем же значением OperationId, чтобы узнать ход выполнения операции.

Запрос

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

Параметры

Имя Тип Обязательно Расположение
nodeName строка Да Путь
api-version строка Да Запрос
OperationId строка (UUID) Да Запрос
NodeTransitionType string (перечисление) Да Запрос
NodeInstanceId строка Да Запрос
StopDurationInSeconds integer (int32) Да Запрос
timeout integer (int64) Нет Запрос

nodeName

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

Имя узла.

api-version

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

OperationId

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

Идентификатор GUID, определяющий вызов этого API. Он передается в соответствующий API GetProgress.

NodeTransitionType

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

Указывает тип выполняемого перехода. NodeTransitionType.Start запускает остановленный узел. NodeTransitionType.Stop останавливает работающий узел. Возможные значения: Invalid, Start, Stop.

NodeInstanceId

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

Идентификатор экземпляра целевого узла. Его можно определить с помощью API GetNodeInfo.

StopDurationInSeconds

Тип: integer (int32)
Обязательный: да
InclusiveMinimum: 0

Длительность остановки узла в секундах. Минимальное значение равно 600, а максимальное — 14400. После истечения этого времени узел автоматически возобновляет работу.

timeout

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

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

Ответы

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