Sdílet prostřednictvím


Iot Hub Resource - Get Endpoint Health

Získejte stav koncových bodů směrování.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
iotHubName
path True

string

resourceGroupName
path True

string

subscriptionId
path True

string

Identifikátor předplatného.

api-version
query True

string

Verze rozhraní API.

Odpovědi

Name Typ Description
200 OK

EndpointHealthDataListResult

OK

Other Status Codes

ErrorDetails

DefaultErrorResponse

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

IotHubResource_GetEndpointHealth

Ukázkový požadavek

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

Ukázková odpověď

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

Definice

Name Description
EndpointHealthData

Data o stavu koncového bodu

EndpointHealthDataListResult

Serializované pole JSON objektů EndpointHealthData s dalším odkazem.

EndpointHealthStatus

Zdravotní stavy mají následující významy. Stav v pořádku ukazuje, že koncový bod přijímá zprávy podle očekávání. Stav Není v pořádku ukazuje, že koncový bod nepřijímá zprávy podle očekávání a IoT Hub se pokouší do tohoto koncového bodu odesílat data znovu. Stav koncového bodu, který není v pořádku, se aktualizuje na v pořádku, když služba IoT Hub naváže nakonec konzistentní stav. Stav "mrtvý" ukazuje, že koncový bod nepřijímá zprávy po opakovaném odeslání zpráv služby IoT Hub po dobu opakování. Informace o identifikaci chyb a monitorování problémů s koncovými body najdete v metrikách služby IoT Hub. Stav Neznámý ukazuje, že IoT Hub nenaváže připojení ke koncovému bodu. Z tohoto koncového bodu nebyly doručeny ani odmítnuty žádné zprávy.

ErrorDetails

Podrobnosti o chybě

EndpointHealthData

Data o stavu koncového bodu

Name Typ Description
endpointId

string

ID koncového bodu

healthStatus

EndpointHealthStatus

Zdravotní stavy mají následující významy. Stav v pořádku ukazuje, že koncový bod přijímá zprávy podle očekávání. Stav Není v pořádku ukazuje, že koncový bod nepřijímá zprávy podle očekávání a IoT Hub se pokouší do tohoto koncového bodu odesílat data znovu. Stav koncového bodu, který není v pořádku, se aktualizuje na v pořádku, když služba IoT Hub naváže nakonec konzistentní stav. Stav "mrtvý" ukazuje, že koncový bod nepřijímá zprávy po opakovaném odeslání zpráv služby IoT Hub po dobu opakování. Informace o identifikaci chyb a monitorování problémů s koncovými body najdete v metrikách služby IoT Hub. Stav Neznámý ukazuje, že IoT Hub nenaváže připojení ke koncovému bodu. Z tohoto koncového bodu nebyly doručeny ani odmítnuty žádné zprávy.

lastKnownError

string

Poslední chyba získaná v případě, že se nepodařilo doručit zprávu do iot Hubu

lastKnownErrorTime

string (date-time-rfc1123)

Čas, kdy došlo k poslední známé chybě

lastSendAttemptTime

string (date-time-rfc1123)

Čas posledního pokusu iot Hubu o odeslání zprávy do koncového bodu

lastSuccessfulSendAttemptTime

string (date-time-rfc1123)

Čas posledního úspěšného odeslání zprávy iot Hubu do koncového bodu

EndpointHealthDataListResult

Serializované pole JSON objektů EndpointHealthData s dalším odkazem.

Name Typ Description
nextLink

string

Odkaz na další výsledky

value

EndpointHealthData[]

Serializované pole json dat o stavu koncového bodu

EndpointHealthStatus

Zdravotní stavy mají následující významy. Stav v pořádku ukazuje, že koncový bod přijímá zprávy podle očekávání. Stav Není v pořádku ukazuje, že koncový bod nepřijímá zprávy podle očekávání a IoT Hub se pokouší do tohoto koncového bodu odesílat data znovu. Stav koncového bodu, který není v pořádku, se aktualizuje na v pořádku, když služba IoT Hub naváže nakonec konzistentní stav. Stav "mrtvý" ukazuje, že koncový bod nepřijímá zprávy po opakovaném odeslání zpráv služby IoT Hub po dobu opakování. Informace o identifikaci chyb a monitorování problémů s koncovými body najdete v metrikách služby IoT Hub. Stav Neznámý ukazuje, že IoT Hub nenaváže připojení ke koncovému bodu. Z tohoto koncového bodu nebyly doručeny ani odmítnuty žádné zprávy.

Hodnota Description
dead
degraded
healthy
unhealthy
unknown

ErrorDetails

Podrobnosti o chybě

Name Typ Description
code

string

Kód chyby.

details

string

Podrobnosti o chybě.

httpStatusCode

string

Stavový kód HTTP.

message

string

Chybová zpráva.