Получение списка событий реплики секции

  • Статья

Показывает все события, связанные с Репликой раздела.

Ответ представляет собой список объектов ReplicaEvent.

Запрос

Метод Универсальный код ресурса (URI) запроса
GET /EventsStore/Partitions/{partitionId}/$/Replicas/{replicaId}/$/Events?api-version=6.4&timeout={timeout}&StartTimeUtc={StartTimeUtc}&EndTimeUtc={EndTimeUtc}&EventsTypesFilter={EventsTypesFilter}&ExcludeAnalysisEvents={ExcludeAnalysisEvents}&SkipCorrelationLookup={SkipCorrelationLookup}

Параметры

Имя Тип Обязательно Расположение
partitionId строка (UUID) Да Путь
replicaId строка Да Путь
api-version строка Да Запрос
timeout целое число (int64) Нет Запрос
StartTimeUtc строка Да Запрос
EndTimeUtc строка Да Запрос
EventsTypesFilter строка Нет Запрос
ExcludeAnalysisEvents Логическое Нет Запрос
SkipCorrelationLookup Логическое Нет Запрос

partitionId

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

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

replicaId

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

Идентификатор реплики.

api-version

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

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

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

StartTimeUtc

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

Время начала поискового запроса в формате UTC в соответствии с ISO гггг-ММ-ддТЧЧ:мм:ssZ.

EndTimeUtc

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

Время окончания поискового запроса в формате UTC в соответствии с ISO гггг-ММ-ддТЧЧ:мм:ssZ.

EventsTypesFilter

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

Эта строка с разделителями-запятыми определяет только типы FabricEvents, которые должны быть включены в ответ.

ExcludeAnalysisEvents

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

Этот параметр отключает получение AnalysisEvents, если передается значение True.

SkipCorrelationLookup

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

Этот параметр отключает поиск сведений об CorrelatedEvents, если передается значение True. в противном случае выполняется обработка CorrelationEvents и заполняется поле HasCorrelatedEvents в каждом FabricEvent.

Ответы

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

Примеры

В этом примере показано, как получить все события, связанные с реплика, в течение определенного периода времени.

Запрос

GET http://localhost:19080/EventsStore/Partitions/f2a6a893-39be-4c7d-b07f-72bc2d36de89/$/Replicas/131672608994209140/$/Events?api-version=6.4&StartTimeUtc=2018-04-03T18:00:00Z&EndTimeUtc=2018-04-04T18:00:00Z

Ответ 200

Текст
[
  {
    "Kind": "StatefulReplicaNewHealthReport",
    "ReplicaInstanceId": "131672608994209140",
    "SourceId": "TestSource",
    "Property": "",
    "HealthState": "Error",
    "TimeToLiveMs": "922337203685477",
    "SequenceNumber": "131672654189677800",
    "Description": "",
    "RemoveWhenExpired": false,
    "SourceUtcTimestamp": "2018-04-03T21:43:38Z",
    "PartitionId": "f2a6a893-39be-4c7d-b07f-72bc2d36de89",
    "ReplicaId": "131672608994209140",
    "EventInstanceId": "b2684da3-df81-4add-8baa-201f73e9195d",
    "TimeStamp": "2018-04-03T21:43:38.8904013Z",
    "HasCorrelatedEvents": false
  }
]