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

string

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nome del gruppo di risorse. Il nome non distingue tra maiuscole e minuscole.

subscriptionId
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

EndpointHealthDataListResult

L'operazione di Azure è stata completata correttamente.

Other Status Codes

ErrorDetails

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
EndpointHealthData

Dati di integrità per un endpoint

EndpointHealthDataListResult

Matrice serializzata JSON di oggetti EndpointHealthData con un collegamento successivo.

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

ErrorDetails

Dettagli errore.

EndpointHealthData

Dati di integrità per un endpoint

Nome Tipo Descrizione
endpointId

string

ID dell'endpoint

healthStatus

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

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

EndpointHealthData[]

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.