Перемещение экземпляра

Статья
07/19/2023

Перемещает экземпляр секции службы без отслеживания состояния.

Эта команда перемещает экземпляр секции службы без отслеживания состояния с учетом всех ограничений. Для перемещения экземпляра необходимо указать идентификатор секции и имя службы. CurrentNodeName при указании определяет перемещенный экземпляр. Если этот параметр не указан, случайный экземпляр будет перемещен Новое имя узла можно опустить, и в этом случае экземпляр перемещается на случайный узел. Если параметр IgnoreConstraints задан и имеет значение true, экземпляр будет перемещен независимо от ограничений.

Запрос

Метод	Универсальный код ресурса (URI) запроса
POST	`/Services/{serviceId}/$/GetPartitions/{partitionId}/$/MoveInstance?api-version=8.0&CurrentNodeName={CurrentNodeName}&NewNodeName={NewNodeName}&IgnoreConstraints={IgnoreConstraints}&timeout={timeout}`

Параметры

Имя	Тип	Обязательно	Расположение
`serviceId`	строка	Да	Путь
`partitionId`	строка (UUID)	Да	Путь
`api-version`	строка	Да	Запрос
`CurrentNodeName`	строка	Нет	Запрос
`NewNodeName`	строка	Нет	Запрос
`IgnoreConstraints`	Логическое	Нет	Запрос
`timeout`	целое число (int64)	Нет	Запрос

`serviceId`

Тип: строка
Обязательный: да

Идентификатор службы. Обычно он содержит полное имя службы из URI службы без указания схемы "fabric:". Начиная с версии 6.0, иерархические имена разделяются знаком "~". Например, если имя службы — "fabric:/myapp/app1/svc1", то в версии 6.0 и более поздних версиях идентификатором службы будет "myapp~app1~svc1", а в предыдущих версиях идентификатором был бы "myapp/app1/svc1".

`partitionId`

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

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

`api-version`

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

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

Версия REST API Service Fabric основана на версии среды выполнения, в которой api был представлен или изменен. Среда выполнения Service Fabric поддерживает несколько версий API. Эта версия является последней поддерживаемой версией API. Если передается более ранжная версия API, возвращаемый ответ может отличаться от той, что описано в этой спецификации.

Кроме того, среда выполнения принимает любую версию, которая выше последней поддерживаемой версии, вплоть до текущей версии среды выполнения. Поэтому, если последняя версия API — 6.0, а среда выполнения — 6.1, среда выполнения примет версию 6.1 для этого API. Однако поведение API будет выполняться согласно описанной версии 6.0.

`CurrentNodeName`

Тип: строка
Обязательный: нет

Имя исходного узла для перемещения экземпляра. Если не указано, экземпляр перемещается из случайного узла.

`NewNodeName`

Тип: строка
Обязательный: нет

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

`IgnoreConstraints`

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

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

`timeout`

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

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

Ответы

Код состояния HTTP	Описание	схеме ответа.
200 OK;	При успешном выполнении запроса операции возвращается код состояния 200.
Все остальные коды состояния	Подробный ответ об ошибке.	FabricError

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