Läs på engelska

Dela via


Iot Hub Resource - Get Endpoint Health

Hämta hälsotillståndet för routningsslutpunkter.

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

URI-parametrar

Name I Obligatorisk Typ Description
iotHubName
path True

string

resourceGroupName
path True

string

subscriptionId
path True

string

Prenumerationsidentifieraren.

api-version
query True

string

Versionen av API:et.

Svar

Name Typ Description
200 OK

EndpointHealthDataListResult

OK

Other Status Codes

ErrorDetails

DefaultErrorResponse

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

IotHubResource_GetEndpointHealth

Exempelbegäran

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

Exempelsvar

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

Definitioner

Name Description
EndpointHealthData

Hälsodata för en slutpunkt

EndpointHealthDataListResult

Den JSON-serialiserade matrisen med EndpointHealthData-objekt med en nästa länk.

EndpointHealthStatus

Hälsostatusar har följande betydelser. Statusen "felfri" visar att slutpunkten accepterar meddelanden som förväntat. Statusen "inte felfri" visar att slutpunkten inte accepterar meddelanden som förväntat och att IoT Hub försöker skicka data till den här slutpunkten igen. Statusen för en felfri slutpunkt uppdateras till felfri när IoT Hub har etablerat ett så småningom konsekvent hälsotillstånd. Statusen "död" visar att slutpunkten inte accepterar meddelanden, efter att IoT Hub har försökt skicka meddelanden igen för omprövningsperioden. Se IoT Hub-mått för att identifiera fel och övervaka problem med slutpunkter. Statusen "okänd" visar att IoT Hub inte har upprättat någon anslutning till slutpunkten. Inga meddelanden har levererats till eller avvisats från den här slutpunkten

ErrorDetails

Felinformation.

EndpointHealthData

Hälsodata för en slutpunkt

Name Typ Description
endpointId

string

ID för slutpunkten

healthStatus

EndpointHealthStatus

Hälsostatusar har följande betydelser. Statusen "felfri" visar att slutpunkten accepterar meddelanden som förväntat. Statusen "inte felfri" visar att slutpunkten inte accepterar meddelanden som förväntat och att IoT Hub försöker skicka data till den här slutpunkten igen. Statusen för en felfri slutpunkt uppdateras till felfri när IoT Hub har etablerat ett så småningom konsekvent hälsotillstånd. Statusen "död" visar att slutpunkten inte accepterar meddelanden, efter att IoT Hub har försökt skicka meddelanden igen för omprövningsperioden. Se IoT Hub-mått för att identifiera fel och övervaka problem med slutpunkter. Statusen "okänd" visar att IoT Hub inte har upprättat någon anslutning till slutpunkten. Inga meddelanden har levererats till eller avvisats från den här slutpunkten

lastKnownError

string

Det senaste felet som erhölls när ett meddelande inte kunde levereras till iot Hub

lastKnownErrorTime

string (date-time-rfc1123)

Tidpunkt då det senast kända felet inträffade

lastSendAttemptTime

string (date-time-rfc1123)

Senaste gången iot Hub försökte skicka ett meddelande till slutpunkten

lastSuccessfulSendAttemptTime

string (date-time-rfc1123)

Senaste gången iot Hub skickade ett meddelande till slutpunkten

EndpointHealthDataListResult

Den JSON-serialiserade matrisen med EndpointHealthData-objekt med en nästa länk.

Name Typ Description
nextLink

string

Länka till fler resultat

value

EndpointHealthData[]

JSON-serialiserad matris med slutpunktshälsodata

EndpointHealthStatus

Hälsostatusar har följande betydelser. Statusen "felfri" visar att slutpunkten accepterar meddelanden som förväntat. Statusen "inte felfri" visar att slutpunkten inte accepterar meddelanden som förväntat och att IoT Hub försöker skicka data till den här slutpunkten igen. Statusen för en felfri slutpunkt uppdateras till felfri när IoT Hub har etablerat ett så småningom konsekvent hälsotillstånd. Statusen "död" visar att slutpunkten inte accepterar meddelanden, efter att IoT Hub har försökt skicka meddelanden igen för omprövningsperioden. Se IoT Hub-mått för att identifiera fel och övervaka problem med slutpunkter. Statusen "okänd" visar att IoT Hub inte har upprättat någon anslutning till slutpunkten. Inga meddelanden har levererats till eller avvisats från den här slutpunkten

Värde Description
dead
degraded
healthy
unhealthy
unknown

ErrorDetails

Felinformation.

Name Typ Description
code

string

Felkoden.

details

string

Felinformationen.

httpStatusCode

string

HTTP-statuskoden.

message

string

Felmeddelandet.