Iot Hub Resource - Get Endpoint Health
Ottenere l'integrità per gli endpoint di routing.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{iotHubName}/routingEndpointsHealth?api-version=2023-06-30
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
iot
|
path | True |
string |
|
resource
|
path | True |
string |
|
subscription
|
path | True |
string |
L'identificatore della sottoscrizione. |
api-version
|
query | True |
string |
Versione dell'API. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
DefaultErrorResponse |
Sicurezza
azure_auth
Flusso OAuth2 di Azure Active Directory
Tipo:
oauth2
Flow:
implicit
URL di autorizzazione:
https://login.microsoftonline.com/common/oauth2/authorize
Ambiti
Nome | Descrizione |
---|---|
user_impersonation | rappresentare l'account utente |
Esempio
IotHubResource_GetEndpointHealth
Esempio di richiesta
Risposta di esempio
{
"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"
}
]
}
Definizioni
Nome | Descrizione |
---|---|
Endpoint |
Dati di integrità per un endpoint |
Endpoint |
Matrice serializzata JSON di oggetti EndpointHealthData con un collegamento successivo. |
Endpoint |
Gli stati di integrità hanno significati seguenti. Lo stato "integro" indica che l'endpoint accetta i messaggi come previsto. Lo stato "non integro" indica che l'endpoint non accetta i messaggi come previsto e hub IoT sta ritentando di inviare dati a questo endpoint. Lo stato di un endpoint non integro verrà aggiornato a integro quando l'hub IoT avrà stabilito alla fine uno stato di integrità coerente. Lo stato "dead" indica che l'endpoint non accetta messaggi, dopo hub IoT ritentare l'invio dei messaggi per il periodo di ripetizione. Vedere hub IoT metriche per identificare gli errori e monitorare i problemi relativi agli endpoint. Lo stato 'unknown' indica che il hub IoT non ha stabilito una connessione con l'endpoint. Nessun messaggio recapitato o rifiutato da questo endpoint |
Error |
Dettagli errore. |
EndpointHealthData
Dati di integrità per un endpoint
Nome | Tipo | Descrizione |
---|---|---|
endpointId |
string |
ID dell'endpoint |
healthStatus |
Gli stati di integrità hanno significati seguenti. Lo stato "integro" indica che l'endpoint accetta i messaggi come previsto. Lo stato "non integro" indica che l'endpoint non accetta i messaggi come previsto e hub IoT sta ritentando di inviare dati a questo endpoint. Lo stato di un endpoint non integro verrà aggiornato a integro quando l'hub IoT avrà stabilito alla fine uno stato di integrità coerente. Lo stato "dead" indica che l'endpoint non accetta messaggi, dopo hub IoT ritentare l'invio dei messaggi per il periodo di ripetizione. Vedere hub IoT metriche per identificare gli errori e monitorare i problemi relativi agli endpoint. Lo stato 'unknown' indica che il hub IoT non ha stabilito una connessione con l'endpoint. Nessun messaggio recapitato o rifiutato da questo endpoint |
|
lastKnownError |
string |
Ultimo errore ottenuto quando non è stato possibile recapitare un messaggio all'hub iot |
lastKnownErrorTime |
string |
Ora in cui si è verificato l'ultimo errore noto |
lastSendAttemptTime |
string |
Ultima volta che l'hub iot ha tentato di inviare un messaggio all'endpoint |
lastSuccessfulSendAttemptTime |
string |
Ultima volta che l'hub iot ha inviato un messaggio all'endpoint |
EndpointHealthDataListResult
Matrice serializzata JSON di oggetti EndpointHealthData con un collegamento successivo.
Nome | Tipo | Descrizione |
---|---|---|
nextLink |
string |
Collegamento a altri risultati |
value |
Matrice serializzata JSON dei dati di integrità degli endpoint |
EndpointHealthStatus
Gli stati di integrità hanno significati seguenti. Lo stato "integro" indica che l'endpoint accetta i messaggi come previsto. Lo stato "non integro" indica che l'endpoint non accetta i messaggi come previsto e hub IoT sta ritentando di inviare dati a questo endpoint. Lo stato di un endpoint non integro verrà aggiornato a integro quando l'hub IoT avrà stabilito alla fine uno stato di integrità coerente. Lo stato "dead" indica che l'endpoint non accetta messaggi, dopo hub IoT ritentare l'invio dei messaggi per il periodo di ripetizione. Vedere hub IoT metriche per identificare gli errori e monitorare i problemi relativi agli endpoint. Lo stato 'unknown' indica che il hub IoT non ha stabilito una connessione con l'endpoint. Nessun messaggio recapitato o rifiutato da questo endpoint
Nome | Tipo | Descrizione |
---|---|---|
dead |
string |
|
degraded |
string |
|
healthy |
string |
|
unhealthy |
string |
|
unknown |
string |
ErrorDetails
Dettagli errore.
Nome | Tipo | Descrizione |
---|---|---|
code |
string |
Codice di errore. |
details |
string |
Dettagli dell'errore. |
httpStatusCode |
string |
Codice di stato HTTP. |
message |
string |
Messaggio di errore. |