Iot Hub Resource - Get Endpoint Health
Obtenha o estado de funcionamento dos pontos finais de encaminhamento.
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 da subscrição. |
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
Fluxo OAuth2 do Azure Active Directory
Tipo:
oauth2
Fluxo:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Âmbitos
Name | Description |
---|---|
user_impersonation | representar 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 estado de funcionamento de um ponto final |
Endpoint |
A matriz serializada JSON de objetos EndpointHealthData com uma ligação seguinte. |
Endpoint |
Os estados de funcionamento têm significados seguintes. O estado "em bom estado de funcionamento" mostra que o ponto final está a aceitar mensagens conforme esperado. O estado "em mau estado de funcionamento" mostra que o ponto final não está a aceitar mensagens conforme esperado e Hub IoT está a tentar enviar dados para este ponto final. O estado de funcionamento de um ponto final em mau estado de funcionamento será atualizado para bom estado de funcionamento quando Hub IoT tiver estabelecido um estado de funcionamento eventualmente consistente. O estado "inativo" mostra que o ponto final não está a aceitar mensagens, depois de Hub IoT repetido o envio de mensagens para o período de novo julgamento. Veja Hub IoT métricas para identificar erros e monitorizar problemas com pontos finais. O estado "desconhecido" mostra que o Hub IoT não estabeleceu uma ligação com o ponto final. Não foram entregues ou rejeitadas mensagens a partir deste ponto final |
Error |
Detalhes do erro. |
EndpointHealthData
Os dados de estado de funcionamento de um ponto final
Name | Tipo | Description |
---|---|---|
endpointId |
string |
ID do ponto final |
healthStatus |
Os estados de funcionamento têm significados seguintes. O estado "em bom estado de funcionamento" mostra que o ponto final está a aceitar mensagens conforme esperado. O estado "em mau estado de funcionamento" mostra que o ponto final não está a aceitar mensagens conforme esperado e Hub IoT está a tentar enviar dados para este ponto final. O estado de funcionamento de um ponto final em mau estado de funcionamento será atualizado para bom estado de funcionamento quando Hub IoT tiver estabelecido um estado de funcionamento eventualmente consistente. O estado "inativo" mostra que o ponto final não está a aceitar mensagens, depois de Hub IoT repetido o envio de mensagens para o período de novo julgamento. Veja Hub IoT métricas para identificar erros e monitorizar problemas com pontos finais. O estado "desconhecido" mostra que o Hub IoT não estabeleceu uma ligação com o ponto final. Não foram entregues ou rejeitadas mensagens a partir deste ponto final |
|
lastKnownError |
string |
Último erro obtido quando uma mensagem não foi entregue no hub iot |
lastKnownErrorTime |
string |
Hora em que ocorreu o último erro conhecido |
lastSendAttemptTime |
string |
Última vez que o hub iot tentou enviar uma mensagem para o ponto final |
lastSuccessfulSendAttemptTime |
string |
Última vez que o hub iot enviou com êxito uma mensagem para o ponto final |
EndpointHealthDataListResult
A matriz serializada JSON de objetos EndpointHealthData com uma ligação seguinte.
Name | Tipo | Description |
---|---|---|
nextLink |
string |
Ligar a mais resultados |
value |
Matriz serializada JSON de dados de estado de funcionamento do Ponto Final |
EndpointHealthStatus
Os estados de funcionamento têm significados seguintes. O estado "em bom estado de funcionamento" mostra que o ponto final está a aceitar mensagens conforme esperado. O estado "em mau estado de funcionamento" mostra que o ponto final não está a aceitar mensagens conforme esperado e Hub IoT está a tentar enviar dados para este ponto final. O estado de funcionamento de um ponto final em mau estado de funcionamento será atualizado para bom estado de funcionamento quando Hub IoT tiver estabelecido um estado de funcionamento eventualmente consistente. O estado "inativo" mostra que o ponto final não está a aceitar mensagens, depois de Hub IoT repetido o envio de mensagens para o período de novo julgamento. Veja Hub IoT métricas para identificar erros e monitorizar problemas com pontos finais. O estado "desconhecido" mostra que o Hub IoT não estabeleceu uma ligação com o ponto final. Não foram entregues ou rejeitadas mensagens a partir deste ponto final
Name | Tipo | Description |
---|---|---|
dead |
string |
|
degraded |
string |
|
healthy |
string |
|
unhealthy |
string |
|
unknown |
string |
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 estado HTTP. |
message |
string |
A mensagem de erro. |