Obtener eventos de Chaos
Obtiene el siguiente segmento de los eventos de Chaos basado en el token de continuación o en el intervalo de tiempo.
Para obtener el siguiente segmento de los eventos de Chaos, puede especificar el parámetro ContinuationToken. Para obtener el inicio de un nuevo segmento de eventos de Chaos, puede especificar el intervalo de tiempo a través de StartTimeUtc y EndTimeUtc. No se pueden especificar el parámetro ContinuationToken y el intervalo de tiempo en la misma llamada. Cuando hay más de 100 eventos de Chaos, estos eventos se devuelven en múltiples segmentos donde un segmento no contiene más de 100 eventos Chaos y, para obtener el siguiente segmento, se hace una llamada a esta API con el token de continuación.
Solicitud
Método | URI de solicitud |
---|---|
GET | /Tools/Chaos/Events?api-version=6.2&ContinuationToken={ContinuationToken}&StartTimeUtc={StartTimeUtc}&EndTimeUtc={EndTimeUtc}&MaxResults={MaxResults}&timeout={timeout} |
Parámetros
Nombre | Tipo | Requerido | Location |
---|---|---|---|
api-version |
string | Sí | Consultar |
ContinuationToken |
string | No | Consultar |
StartTimeUtc |
string | No | Consultar |
EndTimeUtc |
string | No | Consultar |
MaxResults |
entero (int64) | No | Consultar |
timeout |
entero (int64) | No | Consultar |
api-version
Tipo: cadena
Obligatoria: sí
Predeterminado:
La versión de la API. Este parámetro es necesario y su valor debe ser "6.2".
La versión de la API rest de Service Fabric se basa en la versión en tiempo de ejecución en la que se introdujo o se cambió la API. El entorno de ejecución de Service Fabric admite más de una versión de la API. Esta versión es la versión más reciente admitida de la API. Si se pasa una versión de API inferior, la respuesta devuelta puede ser diferente de la documentada en esta especificación.
Además, el tiempo de ejecución acepta cualquier versión superior a la versión admitida más reciente hasta la versión actual del entorno de ejecución. Por lo tanto, si la versión más reciente de la API es 6.0 y el runtime es 6.1, el entorno de ejecución aceptará la versión 6.1 para esa API. Sin embargo, el comportamiento de la API será según la versión 6.0 documentada.
ContinuationToken
Tipo: cadena
Obligatoria: no
El parámetro continuation token se utiliza para obtener el siguiente conjunto de resultados. Un token de continuación con un valor no vacío se incluye en la respuesta de la API cuando los resultados del sistema no caben en una única respuesta. Cuando este valor se pasa a la siguiente llamada de la API, la API devuelve el siguiente conjunto de resultados. Si no hay más resultados, el token de continuación no contiene ningún valor. El valor de este parámetro no debe ser la dirección URL codificada.
StartTimeUtc
Tipo: cadena
Obligatoria: no
El valor de hora del archivo de Windows que representa la hora de inicio del intervalo de tiempo para el que se genera un informe de Chaos. Consulte Método DateTime.ToFileTimeUtc para más información.
EndTimeUtc
Tipo: cadena
Obligatoria: no
El valor de hora del archivo de Windows que representa la hora de finalización del intervalo de tiempo para el que se genera un informe de Chaos. Consulte Método DateTime.ToFileTimeUtc para más información.
MaxResults
Tipo: entero (int64)
Obligatoria: no
Predeterminado:
InclusiveMinimum: 0
El número máximo de resultados que se devuelven como parte de las consultas paginadas. Este parámetro define el límite superior en el número de resultados devueltos. Los resultados devueltos pueden ser menos que el número máximo de resultados especificado si no caben en el mensaje según las restricciones del tamaño máximo del mensaje definidas en la configuración. Si este parámetro es cero o no se especifica, la consulta paginada incluye tantos resultados como quepan en el mensaje devuelto.
timeout
Tipo: entero (int64)
Obligatoria: no
Predeterminado:
InclusiveMaximum: 4294967295
InclusiveMinimum: 1
Tiempo de espera del servidor para realizar la operación en segundos. Este tiempo de espera especifica el tiempo que el cliente está dispuesto a esperar a que se complete la operación solicitada. El valor predeterminado para este parámetro es 60 segundos.
Respuestas
Código de estado HTTP | Descripción | Esquema de respuesta |
---|---|---|
200 (OK) | Siguiente segmento de eventos de Chaos. |
ChaosEventsSegment |
Todos los demás códigos de estado | Respuesta de error detallada. |
FabricError |
Ejemplos
Obtener eventos de Chaos según un intervalo de tiempo
En este ejemplo se muestra cómo obtener eventos chaos en un único mensaje de respuesta sin necesidad de paginar a través del parámetro ContinuationToken.
Request
GET http://localhost:19080/Tools/Chaos/Events?api-version=6.2&StartTimeUtc=0&EndTimeUtc=3155378975999999999
Respuesta 200
Cuerpo
{
"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"
]
}
}
]
}