다음을 통해 공유


Iot Hub Resource - Get Endpoint Health

라우팅 엔드포인트에 대한 상태를 가져옵니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{iotHubName}/routingEndpointsHealth?api-version=2023-06-30

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
iotHubName
path True

string

resourceGroupName
path True

string

subscriptionId
path True

string

구독 식별자입니다.

api-version
query True

string

API 버전입니다.

응답

Name 형식 Description
200 OK

EndpointHealthDataListResult

정상

Other Status Codes

ErrorDetails

DefaultErrorResponse

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

IotHubResource_GetEndpointHealth

샘플 요청

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

샘플 응답

{
  "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"
    }
  ]
}

정의

Name Description
EndpointHealthData

엔드포인트의 상태 데이터

EndpointHealthDataListResult

다음 링크가 있는 EndpointHealthData 개체의 JSON 직렬화된 배열입니다.

EndpointHealthStatus

상태의 의미는 다음과 같습니다. '정상' 상태 엔드포인트가 예상대로 메시지를 수락하고 있음을 보여줍니다. '비정상' 상태 엔드포인트가 예상대로 메시지를 수락하지 않고 IoT Hub 이 엔드포인트로 데이터를 보내려고 다시 시도 중임을 보여줍니다. IoT Hub가 최종적으로 일관된 상태를 설정하면 비정상 엔드포인트의 상태가 정상으로 업데이트됩니다. 'dead' 상태 재심 기간 동안 메시지를 보내는 IoT Hub 다시 시도한 후 엔드포인트가 메시지를 수락하지 않음을 보여줍니다. 오류를 식별하고 엔드포인트 문제를 모니터링하려면 IoT Hub 메트릭을 참조하세요. '알 수 없는' 상태 IoT Hub 엔드포인트와의 연결을 설정하지 않은 것으로 표시됩니다. 이 엔드포인트에 배달되거나 거부된 메시지가 없습니다.

ErrorDetails

오류 세부 정보입니다.

EndpointHealthData

엔드포인트의 상태 데이터

Name 형식 Description
endpointId

string

엔드포인트의 ID

healthStatus

EndpointHealthStatus

상태의 의미는 다음과 같습니다. '정상' 상태 엔드포인트가 예상대로 메시지를 수락하고 있음을 보여줍니다. '비정상' 상태 엔드포인트가 예상대로 메시지를 수락하지 않고 IoT Hub 이 엔드포인트로 데이터를 보내려고 다시 시도 중임을 보여줍니다. IoT Hub가 최종적으로 일관된 상태를 설정하면 비정상 엔드포인트의 상태가 정상으로 업데이트됩니다. 'dead' 상태 재심 기간 동안 메시지를 보내는 IoT Hub 다시 시도한 후 엔드포인트가 메시지를 수락하지 않음을 보여줍니다. 오류를 식별하고 엔드포인트 문제를 모니터링하려면 IoT Hub 메트릭을 참조하세요. '알 수 없는' 상태 IoT Hub 엔드포인트와의 연결을 설정하지 않은 것으로 표시됩니다. 이 엔드포인트에 배달되거나 거부된 메시지가 없습니다.

lastKnownError

string

IoT Hub에 메시지를 배달하지 못한 경우 얻은 마지막 오류

lastKnownErrorTime

string

마지막으로 알려진 오류가 발생한 시간

lastSendAttemptTime

string

마지막으로 iot Hub가 엔드포인트에 메시지를 보내려고 했습니다.

lastSuccessfulSendAttemptTime

string

마지막으로 iot Hub가 엔드포인트에 메시지를 성공적으로 보냈습니다.

EndpointHealthDataListResult

다음 링크가 있는 EndpointHealthData 개체의 JSON 직렬화된 배열입니다.

Name 형식 Description
nextLink

string

더 많은 결과에 연결

value

EndpointHealthData[]

엔드포인트 상태 데이터의 JSON 직렬화된 배열

EndpointHealthStatus

상태의 의미는 다음과 같습니다. '정상' 상태 엔드포인트가 예상대로 메시지를 수락하고 있음을 보여줍니다. '비정상' 상태 엔드포인트가 예상대로 메시지를 수락하지 않고 IoT Hub 이 엔드포인트로 데이터를 보내려고 다시 시도 중임을 보여줍니다. IoT Hub가 최종적으로 일관된 상태를 설정하면 비정상 엔드포인트의 상태가 정상으로 업데이트됩니다. 'dead' 상태 재심 기간 동안 메시지를 보내는 IoT Hub 다시 시도한 후 엔드포인트가 메시지를 수락하지 않음을 보여줍니다. 오류를 식별하고 엔드포인트 문제를 모니터링하려면 IoT Hub 메트릭을 참조하세요. '알 수 없는' 상태 IoT Hub 엔드포인트와의 연결을 설정하지 않은 것으로 표시됩니다. 이 엔드포인트에 배달되거나 거부된 메시지가 없습니다.

Name 형식 Description
dead

string

degraded

string

healthy

string

unhealthy

string

unknown

string

ErrorDetails

오류 세부 정보입니다.

Name 형식 Description
code

string

오류 코드입니다.

details

string

오류 세부 정보입니다.

httpStatusCode

string

HTTP 상태 코드입니다.

message

string

오류 메시지입니다.