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=2026-11-01
Parametri dell'URI
| Nome | In | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
iot
|
path | True |
string |
|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nome del gruppo di risorse. Il nome non distingue tra maiuscole e minuscole. |
|
subscription
|
path | True |
string (uuid) |
ID della sottoscrizione di destinazione. Il valore deve essere un UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Versione dell'API da usare per questa operazione. |
Risposte
| Nome | Tipo | Descrizione |
|---|---|---|
| 200 OK |
L'operazione di Azure è stata completata correttamente. |
|
| Other Status Codes |
Risposta di errore imprevista. |
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 | impersonare il tuo account utente |
Esempio
IotHubResource_GetEndpointHealth
Esempio di richiesta
GET https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/IotHubs/testHub/routingEndpointsHealth?api-version=2026-11-01
Risposta di esempio
{
"value": [
{
"endpointId": "id1",
"healthStatus": "healthy",
"lastSendAttemptTime": "Wed, 13 Sep 2017 18:04:32 GMT",
"lastSuccessfulSendAttemptTime": "Wed, 13 Sep 2017 18:04:32 GMT"
},
{
"endpointId": "id2",
"healthStatus": "unknown"
},
{
"endpointId": "id3",
"healthStatus": "unhealthy",
"lastKnownError": "NotFound",
"lastKnownErrorTime": "Wed, 13 Sep 2017 18:04:32 GMT",
"lastSendAttemptTime": "Wed, 13 Sep 2017 18:04:32 GMT",
"lastSuccessfulSendAttemptTime": "Wed, 13 Sep 2017 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 salute hanno i seguenti significati. 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 l'hub IoT sta tentando di inviare nuovamente i dati a questo endpoint. Lo stato di un endpoint non integro verrà aggiornato a integro quando l'hub IoT avrà stabilito uno stato di integrità coerente finale. Lo stato "inattivo" indica che l'endpoint non accetta messaggi, dopo che l'hub IoT ha riprovato a inviare messaggi per il periodo di nuova prova. Vedere le metriche dell'hub IoT per identificare gli errori e monitorare i problemi con gli endpoint. Lo stato "sconosciuto" indica che l'hub IoT non ha stabilito una connessione con l'endpoint. Nessun messaggio è stato 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 salute hanno i seguenti significati. 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 l'hub IoT sta tentando di inviare nuovamente i dati a questo endpoint. Lo stato di un endpoint non integro verrà aggiornato a integro quando l'hub IoT avrà stabilito uno stato di integrità coerente finale. Lo stato "inattivo" indica che l'endpoint non accetta messaggi, dopo che l'hub IoT ha riprovato a inviare messaggi per il periodo di nuova prova. Vedere le metriche dell'hub IoT per identificare gli errori e monitorare i problemi con gli endpoint. Lo stato "sconosciuto" indica che l'hub IoT non ha stabilito una connessione con l'endpoint. Nessun messaggio è stato recapitato o rifiutato da questo endpoint |
|
| lastKnownError |
string |
Ultimo errore ottenuto quando un messaggio non è stato recapitato all'hub IoT |
| lastKnownErrorTime |
string (date-time-rfc7231) |
Ora in cui si è verificato l'ultimo errore noto |
| lastSendAttemptTime |
string (date-time-rfc7231) |
L'ultima volta che l'hub IoT ha tentato di inviare un messaggio all'endpoint |
| lastSuccessfulSendAttemptTime |
string (date-time-rfc7231) |
L'ultima volta che l'hub IoT ha inviato correttamente un messaggio all'endpoint |
EndpointHealthDataListResult
Matrice serializzata JSON di oggetti EndpointHealthData con un collegamento successivo.
| Nome | Tipo | Descrizione |
|---|---|---|
| nextLink |
string (uri) |
Collegamento alla pagina successiva di elementi |
| value |
Gli elementi EndpointHealthData presenti in questa pagina |
EndpointHealthStatus
Gli stati di salute hanno i seguenti significati. 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 l'hub IoT sta tentando di inviare nuovamente i dati a questo endpoint. Lo stato di un endpoint non integro verrà aggiornato a integro quando l'hub IoT avrà stabilito uno stato di integrità coerente finale. Lo stato "inattivo" indica che l'endpoint non accetta messaggi, dopo che l'hub IoT ha riprovato a inviare messaggi per il periodo di nuova prova. Vedere le metriche dell'hub IoT per identificare gli errori e monitorare i problemi con gli endpoint. Lo stato "sconosciuto" indica che l'hub IoT non ha stabilito una connessione con l'endpoint. Nessun messaggio è stato recapitato o rifiutato da questo endpoint
| Valore | Descrizione |
|---|---|
| unknown |
unknown |
| healthy |
sano |
| degraded |
degradato |
| unhealthy |
malsano |
| dead |
morto |
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. |