Compartir a través de


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
iotHubName
path True

string

resourceGroupName
path True

string

subscriptionId
path True

string

Identificador de la suscripción.

api-version
query True

string

Versión de la API.

Respuestas

Nombre Tipo Description
200 OK

EndpointHealthDataListResult

De acuerdo

Other Status Codes

ErrorDetails

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

GET https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/IotHubs/testHub/routingEndpointsHealth?api-version=2023-06-30

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
EndpointHealthData

Los datos de mantenimiento de un punto de conexión

EndpointHealthDataListResult

Matriz serializada por JSON de objetos EndpointHealthData con un vínculo siguiente.

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

ErrorDetails

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

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

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

EndpointHealthData[]

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.