Partilhar via

Obter Lista de Eventos da Aplicação

  • Artigo

Obtém eventos relacionados com a aplicação.

A resposta é a lista de objetos ApplicationEvent.

Pedir

Método URI do pedido
GET /EventsStore/Applications/{applicationId}/$/Events?api-version=6.4&timeout={timeout}&StartTimeUtc={StartTimeUtc}&EndTimeUtc={EndTimeUtc}&EventsTypesFilter={EventsTypesFilter}&ExcludeAnalysisEvents={ExcludeAnalysisEvents}&SkipCorrelationLookup={SkipCorrelationLookup}

Parâmetros

Nome Tipo Necessário Localização
applicationId string Yes Caminho
api-version string Yes Consulta
timeout número inteiro (int64) No Consulta
StartTimeUtc string Yes Consulta
EndTimeUtc string Yes Consulta
EventsTypesFilter cadeia (de carateres) No Consulta
ExcludeAnalysisEvents boolean No Consulta
SkipCorrelationLookup boolean No Consulta

applicationId

Tipo: cadeia
Obrigatório: Sim

A identidade da aplicação. Normalmente, este é o nome completo da aplicação sem o esquema URI "fabric:". A partir da versão 6.0, os nomes hierárquicos são delimitados com o caráter "~". Por exemplo, se o nome da aplicação for "fabric:/myapp/app1", a identidade da aplicação será "myapp~app1" em 6.0+ e "myapp/app1" em versões anteriores.

api-version

Tipo: cadeia
Obrigatório: Sim
Predefinição: 6.4

A versão da API. Este parâmetro é obrigatório e o respetivo valor tem de ser "6,4".

A versão da API REST do Service Fabric baseia-se na versão de runtime na qual a API foi introduzida ou foi alterada. O runtime do Service Fabric suporta mais do que uma versão da API. Esta versão é a versão suportada mais recente da API. Se for transmitida uma versão da API inferior, a resposta devolvida poderá ser diferente da documentada nesta especificação.

Além disso, o runtime aceita qualquer versão superior à versão suportada mais recente até à versão atual do runtime. Por isso, se a versão mais recente da API for 6.0 e o runtime for 6.1, o runtime aceitará a versão 6.1 dessa API. No entanto, o comportamento da API será conforme a versão documentada 6.0.

timeout

Tipo: número inteiro (int64)
Obrigatório: Não
Predefinição: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

O tempo limite do servidor para executar a operação em segundos. Este tempo limite especifica a duração de tempo que o cliente está disposto a aguardar pela conclusão da operação pedida. O valor predefinido para este parâmetro é 60 segundos.

StartTimeUtc

Tipo: cadeia
Obrigatório: Sim

A hora de início de uma consulta de pesquisa em ISO UTC yyyy-MM-ddTHH:mm:ssZ.

EndTimeUtc

Tipo: cadeia
Obrigatório: Sim

A hora de fim de uma consulta de pesquisa em ISO UTC yyyy-MM-ddTHH:mm:ssZ.

EventsTypesFilter

Tipo: cadeia
Obrigatório: Não

Esta é uma cadeia separada por vírgulas que especifica os tipos de FabricEvents que só devem ser incluídos na resposta.

ExcludeAnalysisEvents

Tipo: booleano
Obrigatório: Não

Este parâmetro desativa a obtenção do AnalysisEvents se for transmitido true.

SkipCorrelationLookup

Tipo: booleano
Obrigatório: Não

Este parâmetro desativa a pesquisa de informações CorrelatedEvents se for transmitido true. caso contrário, os CorrelationEvents são processados e o campo HasCorrelatedEvents em cada FabricEvent é preenchido.

Respostas

Código de Estado HTTP Description Esquema de Resposta
200 (OK) Lista de objetos de eventos com o tipo base ApplicationEvent.
 matriz de ApplicationEvent
Todos os outros códigos de estado A resposta detalhada ao erro.
 FabricError

Exemplos

Este exemplo mostra como obter todos os eventos relacionados com a aplicação durante um determinado período de tempo.

Pedir

GET http://localhost:19080/EventsStore/Applications/app1/$/Events?api-version=6.4&StartTimeUtc=2018-04-03T18:00:00Z&EndTimeUtc=2018-04-04T18:00:00Z

Resposta 200

Corpo
[
  {
    "Kind": "ApplicationCreated",
    "ApplicationTypeName": "App1Type",
    "ApplicationTypeVersion": "1.0.1",
    "ApplicationDefinitionKind": "ServiceFabricApplicationDescription",
    "ApplicationId": "app1",
    "EventInstanceId": "8a7a0c42-67ca-4cd3-9160-edcdb822db10",
    "TimeStamp": "2018-04-03T20:21:23.5774199Z",
    "HasCorrelatedEvents": false
  }
]