Получение списка сведений о развернутой реплике службы

  • Статья

Возвращает сведения о репликах, развернутых на узле Service Fabric.

Получает список, содержащий информацию о репликах, развернутых на узле Service Fabric. Информация включает в себя идентификатор раздела, идентификатор реплики, состояние реплики, имя службы, имя типа службы и другую информацию. Используйте параметры запроса PartitionId или ServiceManifestName для возврата информации о развернутых репликах, соответствующих указанным значениям для этих параметров.

Запрос

Метод Универсальный код ресурса (URI) запроса
GET /Nodes/{nodeName}/$/GetApplications/{applicationId}/$/GetReplicas?api-version=6.0&PartitionId={PartitionId}&ServiceManifestName={ServiceManifestName}&timeout={timeout}

Параметры

Имя Тип Обязательно Расположение
nodeName строка Да Путь
applicationId строка Да Путь
api-version строка Да Запрос
PartitionId строка (UUID) Нет Запрос
ServiceManifestName строка Нет Запрос
timeout целое число (int64) Нет Запрос

nodeName

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

Имя узла.

applicationId

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

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

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.

PartitionId

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

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

ServiceManifestName

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

Имя манифеста службы, зарегистрированное для типа приложения в кластере Service Fabric.

timeout

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

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

Ответы

Код состояния HTTP Описание схеме ответа.
200 OK; Успешная операция вернет код состояния 200 и список развернутых служб реплика сведения.
 Массив DeployedServiceReplicaInfo
204 (NoContent) Если указанный идентификатор applicationId не найден на указанном узле, возвращается пустой ответ. Пустой ответ также возвращается, если нет реплик, соответствующих заданным значениям фильтра для параметров запроса PartitionId или ServiceManifestName.
Все остальные коды состояния Подробный ответ об ошибке.
 FabricError