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
iotHubName
path True

string

resourceGroupName
path True

string

subscriptionId
path True

string

O identificador da subscrição.

api-version
query True

string

A versão da API.

Respostas

Name Tipo Description
200 OK

EndpointHealthDataListResult

OK

Other Status Codes

ErrorDetails

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

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

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
EndpointHealthData

Os dados de estado de funcionamento de um ponto final

EndpointHealthDataListResult

A matriz serializada JSON de objetos EndpointHealthData com uma ligação seguinte.

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

ErrorDetails

Detalhes do erro.

EndpointHealthData

Os dados de estado de funcionamento de um ponto final

Name Tipo Description
endpointId

string

ID do ponto final

healthStatus

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

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

EndpointHealthData[]

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.