Obter Eventos de Caos
Obtém o segmento seguinte dos eventos Chaos com base no token de continuação ou no intervalo de tempo.
Para obter o segmento seguinte dos eventos Chaos, pode especificar ContinuationToken. Para começar um novo segmento de eventos chaos, pode especificar o intervalo de tempo através de StartTimeUtc e EndTimeUtc. Não pode especificar o ContinuationToken e o intervalo de tempo na mesma chamada. Quando existem mais de 100 eventos chaos, os eventos chaos são devolvidos em vários segmentos em que um segmento não contém mais de 100 eventos chaos e para obter o segmento seguinte, faça uma chamada a esta API com o token de continuação.
Pedir
| Método | URI do pedido |
|---|---|
| GET | /Tools/Chaos/Events?api-version=6.2&ContinuationToken={ContinuationToken}&StartTimeUtc={StartTimeUtc}&EndTimeUtc={EndTimeUtc}&MaxResults={MaxResults}&timeout={timeout} |
Parâmetros
| Nome | Tipo | Necessário | Localização |
|---|---|---|---|
api-version |
string | Yes | Consulta |
ContinuationToken |
cadeia (de carateres) | No | Consulta |
StartTimeUtc |
cadeia (de carateres) | No | Consulta |
EndTimeUtc |
cadeia (de carateres) | No | Consulta |
MaxResults |
número inteiro (int64) | No | Consulta |
timeout |
número inteiro (int64) | No | Consulta |
api-version
Tipo: cadeia
Obrigatório: Sim
Predefinição: 6.2
A versão da API. Este parâmetro é obrigatório e o respetivo valor tem de ser "6.2".
A versão da API REST do Service Fabric baseia-se na versão de runtime na qual a API foi introduzida ou 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 inferior da API, 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 a 6.0 e o runtime for 6.1, o runtime aceitará a versão 6.1 para essa API. No entanto, o comportamento da API será de acordo com a versão 6.0 documentada.
ContinuationToken
Tipo: cadeia
Obrigatório: Não
O parâmetro do token de continuação é utilizado para obter o próximo conjunto de resultados. Um token de continuação com um valor não vazio é incluído na resposta da API quando os resultados do sistema não cabem numa única resposta. Quando este valor é transmitido para a próxima chamada à API, a API devolve o próximo conjunto de resultados. Se não existirem mais resultados, o token de continuação não contém um valor. O valor deste parâmetro não deve ser codificado por URL.
StartTimeUtc
Tipo: cadeia
Obrigatório: Não
A hora do ficheiro do Windows que representa a hora de início do intervalo de tempo para o qual será gerado um relatório Chaos. Consulte o Método DateTime.ToFileTimeUtc para obter detalhes.
EndTimeUtc
Tipo: cadeia
Obrigatório: Não
O tempo de ficheiro do Windows que representa a hora de fim do intervalo de tempo para o qual será gerado um relatório Chaos. Consulte o Método DateTime.ToFileTimeUtc para obter detalhes.
MaxResults
Tipo: número inteiro (int64)
Obrigatório: Não
Predefinição: 0
InclusiveMinimum: 0
O número máximo de resultados a devolver como parte das consultas paginadas. Este parâmetro define o limite superior no número de resultados devolvidos. Os resultados devolvidos podem ser inferiores aos resultados máximos especificados se não caberem na mensagem de acordo com as restrições de tamanho máximo de mensagens definidas na configuração. Se este parâmetro for zero ou não for especificado, a consulta paginada inclui o maior número possível de resultados que cabem na mensagem de retorno.
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 que a operação pedida seja concluída. O valor predefinido para este parâmetro é 60 segundos.
Respostas
| Código de Estado HTTP | Description | Esquema de Resposta |
|---|---|---|
| 200 (OK) | Segmento seguinte dos eventos chaos. |
ChaosEventsSegment |
| Todos os outros códigos de estado | A resposta detalhada ao erro. |
FabricError |
Exemplos
Obter eventos do Caos com um intervalo de tempo
Este exemplo mostra como obter eventos chaos numa única mensagem de resposta sem a necessidade de paginação através do parâmetro ContinuationToken.
Pedir
GET http://localhost:19080/Tools/Chaos/Events?api-version=6.2&StartTimeUtc=0&EndTimeUtc=3155378975999999999
Resposta 200
Corpo
{
"ContinuationToken": "",
"History": [
{
"ChaosEvent": {
"Kind": "Started",
"TimeStampUtc": "2017-04-14T04:27:19.049Z",
"ChaosParameters": {
"MaxClusterStabilizationTimeoutInSeconds": "30",
"MaxConcurrentFaults": "3",
"WaitTimeBetweenIterationsInSeconds": "10",
"WaitTimeBetweenFaultsInSeconds": "1",
"TimeToRunInSeconds": "3600",
"EnableMoveReplicaFaults": true,
"ClusterHealthPolicy": {
"ConsiderWarningAsError": true,
"MaxPercentUnhealthyNodes": "0",
"MaxPercentUnhealthyApplications": "10",
"ApplicationTypeHealthPolicyMap": [
{
"Key": "myapp",
"Value": "3"
}
]
},
"Context": {
"Map": {
"k1": "v1",
"k2": "v2",
"k3": "v5"
}
}
}
}
},
{
"ChaosEvent": {
"Kind": "ExecutingFaults",
"TimeStampUtc": "2017-04-14T04:27:20.667Z",
"Faults": [
"ActionType: RestartReplica, ServiceUri: fabric:/TestApp1/PersistServ_6R_1, PartitionId: 6a91b09a-bd76-45da-afaa-ed0fd9bfe7d2, ReplicaId: 131366172775684622",
"ActionType: CodePackageRestart, NodeName: N0050, ApplicationName: fabric:/TestApp1, ServiceManifestName: SP1, ServiceManifestName: , CodePackageName: CP1.",
"ActionType: RestartReplica, ServiceUri: fabric:/TestApp1/PersistServ_6R_3, PartitionId: baa3a51e-5c42-435e-89d3-6e97b2164661, ReplicaId: 131366172988968762"
]
}
}
]
}