Condividi tramite


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

string

resourceGroupName
path True

string

subscriptionId
path True

string

L'identificatore della sottoscrizione.

api-version
query True

string

Versione dell'API.

Risposte

Nome Tipo Descrizione
200 OK

EndpointHealthDataListResult

Va bene

Other Status Codes

ErrorDetails

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

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

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
EndpointHealthData

Dati di integrità per un endpoint

EndpointHealthDataListResult

Matrice serializzata JSON di oggetti EndpointHealthData con un collegamento successivo.

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 messaggi come previsto e l'hub IoT sta ritentando l'invio di dati a questo endpoint. Lo stato di un endpoint non integro verrà aggiornato a integro quando l'hub IoT ha stabilito uno stato di integrità coerente. Lo stato "dead" indica che l'endpoint non accetta messaggi, dopo che l'hub IoT ha ritentato l'invio di messaggi per il periodo di ripetizione. Vedere Metriche dell'hub IoT per identificare gli errori e monitorare i problemi relativi agli endpoint. Lo stato "sconosciuto" indica che l'hub IoT non ha stabilito una connessione con l'endpoint. Nessun messaggio 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 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 messaggi come previsto e l'hub IoT sta ritentando l'invio di dati a questo endpoint. Lo stato di un endpoint non integro verrà aggiornato a integro quando l'hub IoT ha stabilito uno stato di integrità coerente. Lo stato "dead" indica che l'endpoint non accetta messaggi, dopo che l'hub IoT ha ritentato l'invio di messaggi per il periodo di ripetizione. Vedere Metriche dell'hub IoT per identificare gli errori e monitorare i problemi relativi agli endpoint. Lo stato "sconosciuto" indica che l'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 (date-time-rfc1123)

Ora in cui si è verificato l'ultimo errore noto

lastSendAttemptTime

string (date-time-rfc1123)

Ultima volta che l'hub iot ha tentato di inviare un messaggio all'endpoint

lastSuccessfulSendAttemptTime

string (date-time-rfc1123)

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

EndpointHealthData[]

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 messaggi come previsto e l'hub IoT sta ritentando l'invio di dati a questo endpoint. Lo stato di un endpoint non integro verrà aggiornato a integro quando l'hub IoT ha stabilito uno stato di integrità coerente. Lo stato "dead" indica che l'endpoint non accetta messaggi, dopo che l'hub IoT ha ritentato l'invio di messaggi per il periodo di ripetizione. Vedere Metriche dell'hub IoT per identificare gli errori e monitorare i problemi relativi agli endpoint. Lo stato "sconosciuto" indica che l'hub IoT non ha stabilito una connessione con l'endpoint. Nessun messaggio recapitato o rifiutato da questo endpoint

Valore Descrizione
dead
degraded
healthy
unhealthy
unknown

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.