Partilhar via


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

string

resourceGroupName
path True

string

subscriptionId
path True

string

O identificador de assinatura.

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

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

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 integridade de um ponto de extremidade

EndpointHealthDataListResult

A matriz serializada por JSON de objetos EndpointHealthData com um próximo link.

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

ErrorDetails

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

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

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

EndpointHealthData[]

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.