Переход на начальный узел
Запускает или останавливает узел кластера.
Запускает или останавливает узел кластера. Узел кластера — это процесс, а не экземпляр операционной системы. Для запуска узла передайте значение "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 |