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 do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
iot
|
path | True |
string |
|
resource
|
path | True |
string |
|
subscription
|
path | True |
string |
O identificador de assinatura. |
api-version
|
query | True |
string |
A versão da API. |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
DefaultErrorResponse |
Segurança
azure_auth
Azure Ative Directory OAuth2 Flow
Tipo:
oauth2
Fluxo:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Âmbitos
Name | Description |
---|---|
user_impersonation | personificar a sua conta de utilizador |
Exemplos
IotHubResource_GetEndpointHealth
Pedido de amostra
Resposta da amostra
{
"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
Name | 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 estados de saúde 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 novamente enviar dados para esse ponto de extremidade. O status de um ponto de extremidade não íntegro será atualizado para íntegro quando o Hub IoT tiver estabelecido 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 tentou enviar mensagens novamente durante o período de nova avaliação. Consulte as métricas do Hub IoT para identificar erros e monitorar problemas com endpoints. 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 a partir deste ponto de extremidade |
Error |
Detalhes do erro. |
EndpointHealthData
Os dados de integridade de um ponto de extremidade
Name | Tipo | Description |
---|---|---|
endpointId |
string |
Identificação do parâmetro de avaliação |
healthStatus |
Os estados de saúde 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 novamente enviar dados para esse ponto de extremidade. O status de um ponto de extremidade não íntegro será atualizado para íntegro quando o Hub IoT tiver estabelecido 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 tentou enviar mensagens novamente durante o período de nova avaliação. Consulte as métricas do Hub IoT para identificar erros e monitorar problemas com endpoints. 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 a partir deste ponto de extremidade |
|
lastKnownError |
string |
Último erro obtido quando uma mensagem não pôde ser entregue ao hub iot |
lastKnownErrorTime |
string (date-time-rfc1123) |
Hora em que ocorreu o último erro conhecido |
lastSendAttemptTime |
string (date-time-rfc1123) |
Da última vez que o hub iot tentou enviar uma mensagem para o endpoint |
lastSuccessfulSendAttemptTime |
string (date-time-rfc1123) |
Última vez que o hub iot enviou com êxito uma mensagem para o endpoint |
EndpointHealthDataListResult
A matriz serializada por JSON de objetos EndpointHealthData com um próximo link.
Name | Tipo | Description |
---|---|---|
nextLink |
string |
Link para mais resultados |
value |
Matriz serializada por JSON de dados de integridade do Endpoint |
EndpointHealthStatus
Os estados de saúde 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 novamente enviar dados para esse ponto de extremidade. O status de um ponto de extremidade não íntegro será atualizado para íntegro quando o Hub IoT tiver estabelecido 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 tentou enviar mensagens novamente durante o período de nova avaliação. Consulte as métricas do Hub IoT para identificar erros e monitorar problemas com endpoints. 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 a partir deste ponto de extremidade
Valor | Description |
---|---|
dead | |
degraded | |
healthy | |
unhealthy | |
unknown |
ErrorDetails
Detalhes do erro.
Name | 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. |