Iot Hub Resource - Get Endpoint Health
Obtenga el estado de los puntos de conexión de enrutamiento.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{iotHubName}/routingEndpointsHealth?api-version=2023-06-30
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
iot
|
path | True |
string |
|
resource
|
path | True |
string |
|
subscription
|
path | True |
string |
Identificador de la suscripción. |
api-version
|
query | True |
string |
Versión de la API. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
De acuerdo |
|
Other Status Codes |
DefaultErrorResponse |
Seguridad
azure_auth
Flujo de OAuth2 de Azure Active Directory
Tipo:
oauth2
Flujo:
implicit
Dirección URL de autorización:
https://login.microsoftonline.com/common/oauth2/authorize
Ámbitos
Nombre | Description |
---|---|
user_impersonation | suplantar la cuenta de usuario |
Ejemplos
IotHubResource_GetEndpointHealth
Solicitud de ejemplo
Respuesta de muestra
{
"value": [
{
"endpointId": "id1",
"healthStatus": "healthy",
"lastSuccessfulSendAttemptTime": "Wed, 13 Sep 2022 18:04:32 GMT",
"lastSendAttemptTime": "Wed, 13 Sep 2022 18:04:32 GMT"
},
{
"endpointId": "id2",
"healthStatus": "unknown"
},
{
"endpointId": "id3",
"healthStatus": "unhealthy",
"lastKnownError": "NotFound",
"lastKnownErrorTime": "Wed, 13 Sep 2022 18:04:32 GMT",
"lastSuccessfulSendAttemptTime": "Wed, 13 Sep 2022 18:04:32 GMT",
"lastSendAttemptTime": "Wed, 13 Sep 2022 18:04:32 GMT"
}
]
}
Definiciones
Nombre | Description |
---|---|
Endpoint |
Los datos de mantenimiento de un punto de conexión |
Endpoint |
Matriz serializada por JSON de objetos EndpointHealthData con un vínculo siguiente. |
Endpoint |
Los estados de mantenimiento tienen los significados siguientes. El estado "correcto" muestra que el punto de conexión acepta los mensajes según lo previsto. El estado "incorrecto" muestra que el punto de conexión no acepta los mensajes según lo esperado y IoT Hub vuelve a intentar enviar datos a este punto de conexión. El estado de un punto de conexión incorrecto se actualizará a correcto cuando IoT Hub haya establecido un estado de mantenimiento coherente. El estado "dead" muestra que el punto de conexión no acepta mensajes, después de que IoT Hub reintenta el envío de mensajes durante el período de reproceso. Consulte Métricas de IoT Hub para identificar errores y supervisar problemas con los puntos de conexión. El estado "desconocido" muestra que IoT Hub no ha establecido una conexión con el punto de conexión. No se han entregado ni rechazado mensajes desde este punto de conexión |
Error |
Detalles del error. |
EndpointHealthData
Los datos de mantenimiento de un punto de conexión
Nombre | Tipo | Description |
---|---|---|
endpointId |
string |
Identificador del punto de conexión |
healthStatus |
Los estados de mantenimiento tienen los significados siguientes. El estado "correcto" muestra que el punto de conexión acepta los mensajes según lo previsto. El estado "incorrecto" muestra que el punto de conexión no acepta los mensajes según lo esperado y IoT Hub vuelve a intentar enviar datos a este punto de conexión. El estado de un punto de conexión incorrecto se actualizará a correcto cuando IoT Hub haya establecido un estado de mantenimiento coherente. El estado "dead" muestra que el punto de conexión no acepta mensajes, después de que IoT Hub reintenta el envío de mensajes durante el período de reproceso. Consulte Métricas de IoT Hub para identificar errores y supervisar problemas con los puntos de conexión. El estado "desconocido" muestra que IoT Hub no ha establecido una conexión con el punto de conexión. No se han entregado ni rechazado mensajes desde este punto de conexión |
|
lastKnownError |
string |
Último error obtenido cuando no se pudo entregar un mensaje al centro de IoT |
lastKnownErrorTime |
string (date-time-rfc1123) |
Hora en la que se produjo el último error conocido |
lastSendAttemptTime |
string (date-time-rfc1123) |
Última vez que iot hub intentó enviar un mensaje al punto de conexión |
lastSuccessfulSendAttemptTime |
string (date-time-rfc1123) |
Última vez que iot Hub envió correctamente un mensaje al punto de conexión |
EndpointHealthDataListResult
Matriz serializada por JSON de objetos EndpointHealthData con un vínculo siguiente.
Nombre | Tipo | Description |
---|---|---|
nextLink |
string |
Vínculo a más resultados |
value |
Matriz serializada por JSON de datos de estado del punto de conexión |
EndpointHealthStatus
Los estados de mantenimiento tienen los significados siguientes. El estado "correcto" muestra que el punto de conexión acepta los mensajes según lo previsto. El estado "incorrecto" muestra que el punto de conexión no acepta los mensajes según lo esperado y IoT Hub vuelve a intentar enviar datos a este punto de conexión. El estado de un punto de conexión incorrecto se actualizará a correcto cuando IoT Hub haya establecido un estado de mantenimiento coherente. El estado "dead" muestra que el punto de conexión no acepta mensajes, después de que IoT Hub reintenta el envío de mensajes durante el período de reproceso. Consulte Métricas de IoT Hub para identificar errores y supervisar problemas con los puntos de conexión. El estado "desconocido" muestra que IoT Hub no ha establecido una conexión con el punto de conexión. No se han entregado ni rechazado mensajes desde este punto de conexión
Valor | Description |
---|---|
dead | |
degraded | |
healthy | |
unhealthy | |
unknown |
ErrorDetails
Detalles del error.
Nombre | Tipo | Description |
---|---|---|
code |
string |
Código de error. |
details |
string |
Detalles del error. |
httpStatusCode |
string |
Código de estado HTTP. |
message |
string |
Mensaje de error. |