Iot Hub Resource - Get Endpoint Health
Obtenha a integridade dos pontos de extremidade de roteamento.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{iotHubName}/routingEndpointsHealth?api-version=2023-06-30
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
iot
|
path | True |
string |
|
resource
|
path | True |
string |
|
subscription
|
path | True |
string |
O identificador da assinatura. |
api-version
|
query | True |
string |
A versão da API. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
OKEY |
|
Other Status Codes |
DefaultErrorResponse |
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory
Tipo:
oauth2
Flow:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Escopos
Nome | Description |
---|---|
user_impersonation | representar sua conta de usuário |
Exemplos
IotHubResource_GetEndpointHealth
Solicitação de exemplo
Resposta de exemplo
{
"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"
}
]
}
Definições
Nome | Description |
---|---|
Endpoint |
Os dados de integridade de um ponto de extremidade |
Endpoint |
A matriz serializada por JSON de objetos EndpointHealthData com um próximo link. |
Endpoint |
Os status de integridade têm os seguintes significados. O status 'íntegro' mostra que o ponto de extremidade está aceitando mensagens conforme o esperado. O status 'não íntegro' mostra que o ponto de extremidade não está aceitando mensagens conforme o esperado e o Hub IoT está tentando enviar dados novamente para esse ponto de extremidade. O status de um ponto de extremidade não íntegro será atualizado para íntegro quando o Hub IoT estabelecer um estado de integridade eventualmente consistente. O status 'morto' mostra que o ponto de extremidade não está aceitando mensagens, depois que o Hub IoT repetiu o envio de mensagens para o período de novo julgamento. Consulte as métricas do Hub IoT para identificar erros e monitorar problemas com pontos de extremidade. O status 'desconhecido' mostra que o Hub IoT não estabeleceu uma conexão com o ponto de extremidade. Nenhuma mensagem foi entregue ou rejeitada deste ponto de extremidade |
Error |
Detalhes do erro. |
EndpointHealthData
Os dados de integridade de um ponto de extremidade
Nome | Tipo | Description |
---|---|---|
endpointId |
string |
ID do ponto de extremidade |
healthStatus |
Os status de integridade têm os seguintes significados. O status 'íntegro' mostra que o ponto de extremidade está aceitando mensagens conforme o esperado. O status 'não íntegro' mostra que o ponto de extremidade não está aceitando mensagens conforme o esperado e o Hub IoT está tentando enviar dados novamente para esse ponto de extremidade. O status de um ponto de extremidade não íntegro será atualizado para íntegro quando o Hub IoT estabelecer um estado de integridade eventualmente consistente. O status 'morto' mostra que o ponto de extremidade não está aceitando mensagens, depois que o Hub IoT repetiu o envio de mensagens para o período de novo julgamento. Consulte as métricas do Hub IoT para identificar erros e monitorar problemas com pontos de extremidade. O status 'desconhecido' mostra que o Hub IoT não estabeleceu uma conexão com o ponto de extremidade. Nenhuma mensagem foi entregue ou rejeitada deste ponto de extremidade |
|
lastKnownError |
string |
Último erro obtido quando uma mensagem não foi entregue ao hub iot |
lastKnownErrorTime |
string (date-time-rfc1123) |
Hora em que o último erro conhecido ocorreu |
lastSendAttemptTime |
string (date-time-rfc1123) |
Última vez que o hub iot tentou enviar uma mensagem para o ponto de extremidade |
lastSuccessfulSendAttemptTime |
string (date-time-rfc1123) |
Última vez que o hub iot enviou com êxito uma mensagem para o ponto de extremidade |
EndpointHealthDataListResult
A matriz serializada por JSON de objetos EndpointHealthData com um próximo link.
Nome | Tipo | Description |
---|---|---|
nextLink |
string |
Vincular a mais resultados |
value |
Matriz serializada JSON de dados de integridade do Ponto de Extremidade |
EndpointHealthStatus
Os status de integridade têm os seguintes significados. O status 'íntegro' mostra que o ponto de extremidade está aceitando mensagens conforme o esperado. O status 'não íntegro' mostra que o ponto de extremidade não está aceitando mensagens conforme o esperado e o Hub IoT está tentando enviar dados novamente para esse ponto de extremidade. O status de um ponto de extremidade não íntegro será atualizado para íntegro quando o Hub IoT estabelecer um estado de integridade eventualmente consistente. O status 'morto' mostra que o ponto de extremidade não está aceitando mensagens, depois que o Hub IoT repetiu o envio de mensagens para o período de novo julgamento. Consulte as métricas do Hub IoT para identificar erros e monitorar problemas com pontos de extremidade. O status 'desconhecido' mostra que o Hub IoT não estabeleceu uma conexão com o ponto de extremidade. Nenhuma mensagem foi entregue ou rejeitada deste ponto de extremidade
Valor | Description |
---|---|
dead | |
degraded | |
healthy | |
unhealthy | |
unknown |
ErrorDetails
Detalhes do erro.
Nome | Tipo | Description |
---|---|---|
code |
string |
O código de erro. |
details |
string |
Os detalhes do erro. |
httpStatusCode |
string |
O código de status HTTP. |
message |
string |
A mensagem de erro. |