Udostępnij za pośrednictwem


Iot Hub Resource - Get Endpoint Health

Uzyskaj kondycję punktów końcowych routingu.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{iotHubName}/routingEndpointsHealth?api-version=2023-06-30

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
iotHubName
path True

string

resourceGroupName
path True

string

subscriptionId
path True

string

Identyfikator subskrypcji.

api-version
query True

string

Wersja interfejsu API.

Odpowiedzi

Nazwa Typ Opis
200 OK

EndpointHealthDataListResult

OK

Other Status Codes

ErrorDetails

DefaultErrorResponse

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

IotHubResource_GetEndpointHealth

Przykładowe żądanie

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

Przykładowa odpowiedź

{
  "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"
    }
  ]
}

Definicje

Nazwa Opis
EndpointHealthData

Dane kondycji punktu końcowego

EndpointHealthDataListResult

Tablica serializowana w formacie JSON obiektów EndpointHealthData z następnym linkiem.

EndpointHealthStatus

Stany kondycji mają następujące znaczenie. Stan "w dobrej kondycji" pokazuje, że punkt końcowy akceptuje komunikaty zgodnie z oczekiwaniami. Stan "w złej kondycji" pokazuje, że punkt końcowy nie akceptuje komunikatów zgodnie z oczekiwaniami, a usługa IoT Hub ponowi próbę wysłania danych do tego punktu końcowego. Stan punktu końcowego w złej kondycji zostanie zaktualizowany do dobrej kondycji, gdy usługa IoT Hub ustanowiła ostatecznie spójny stan kondycji. Stan "martwy" pokazuje, że punkt końcowy nie akceptuje komunikatów po ponowieniu próby wysłania komunikatów przez usługę IoT Hub w okresie ponawiania próby. Zobacz Metryki usługi IoT Hub, aby zidentyfikować błędy i monitorować problemy z punktami końcowymi. Stan "nieznany" pokazuje, że usługa IoT Hub nie nawiązała połączenia z punktem końcowym. Żadne komunikaty nie zostały dostarczone do tego punktu końcowego ani odrzucone

ErrorDetails

Szczegóły błędu.

EndpointHealthData

Dane kondycji punktu końcowego

Nazwa Typ Opis
endpointId

string

Identyfikator punktu końcowego

healthStatus

EndpointHealthStatus

Stany kondycji mają następujące znaczenie. Stan "w dobrej kondycji" pokazuje, że punkt końcowy akceptuje komunikaty zgodnie z oczekiwaniami. Stan "w złej kondycji" pokazuje, że punkt końcowy nie akceptuje komunikatów zgodnie z oczekiwaniami, a usługa IoT Hub ponowi próbę wysłania danych do tego punktu końcowego. Stan punktu końcowego w złej kondycji zostanie zaktualizowany do dobrej kondycji, gdy usługa IoT Hub ustanowiła ostatecznie spójny stan kondycji. Stan "martwy" pokazuje, że punkt końcowy nie akceptuje komunikatów po ponowieniu próby wysłania komunikatów przez usługę IoT Hub w okresie ponawiania próby. Zobacz Metryki usługi IoT Hub, aby zidentyfikować błędy i monitorować problemy z punktami końcowymi. Stan "nieznany" pokazuje, że usługa IoT Hub nie nawiązała połączenia z punktem końcowym. Żadne komunikaty nie zostały dostarczone do tego punktu końcowego ani odrzucone

lastKnownError

string

Ostatni błąd uzyskany, gdy nie można dostarczyć komunikatu do centrum iot

lastKnownErrorTime

string (date-time-rfc1123)

Godzina wystąpienia ostatniego znanego błędu

lastSendAttemptTime

string (date-time-rfc1123)

Podczas ostatniej próby wysłania komunikatu do punktu końcowego centrum iot

lastSuccessfulSendAttemptTime

string (date-time-rfc1123)

Usługa iot Hub po raz ostatnio pomyślnie wysłała komunikat do punktu końcowego

EndpointHealthDataListResult

Tablica serializowana w formacie JSON obiektów EndpointHealthData z następnym linkiem.

Nazwa Typ Opis
nextLink

string

Łącze do większej liczby wyników

value

EndpointHealthData[]

Serializowana tablica danych kondycji punktu końcowego w formacie JSON

EndpointHealthStatus

Stany kondycji mają następujące znaczenie. Stan "w dobrej kondycji" pokazuje, że punkt końcowy akceptuje komunikaty zgodnie z oczekiwaniami. Stan "w złej kondycji" pokazuje, że punkt końcowy nie akceptuje komunikatów zgodnie z oczekiwaniami, a usługa IoT Hub ponowi próbę wysłania danych do tego punktu końcowego. Stan punktu końcowego w złej kondycji zostanie zaktualizowany do dobrej kondycji, gdy usługa IoT Hub ustanowiła ostatecznie spójny stan kondycji. Stan "martwy" pokazuje, że punkt końcowy nie akceptuje komunikatów po ponowieniu próby wysłania komunikatów przez usługę IoT Hub w okresie ponawiania próby. Zobacz Metryki usługi IoT Hub, aby zidentyfikować błędy i monitorować problemy z punktami końcowymi. Stan "nieznany" pokazuje, że usługa IoT Hub nie nawiązała połączenia z punktem końcowym. Żadne komunikaty nie zostały dostarczone do tego punktu końcowego ani odrzucone

Wartość Opis
dead
degraded
healthy
unhealthy
unknown

ErrorDetails

Szczegóły błędu.

Nazwa Typ Opis
code

string

Kod błędu.

details

string

Szczegóły błędu.

httpStatusCode

string

Kod stanu HTTP.

message

string

Komunikat o błędzie.