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 |
---|---|---|---|---|
iot
|
path | True |
string |
|
resource
|
path | True |
string |
|
subscription
|
path | True |
string |
구독 식별자입니다. |
api-version
|
query | True |
string |
API 버전입니다. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
정상 |
|
Other Status Codes |
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
샘플 요청
샘플 응답
{
"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 |
---|---|
Endpoint |
엔드포인트의 상태 데이터 |
Endpoint |
다음 링크가 있는 EndpointHealthData 개체의 JSON 직렬화된 배열입니다. |
Endpoint |
상태의 의미는 다음과 같습니다. '정상' 상태 엔드포인트가 예상대로 메시지를 수락하고 있음을 보여줍니다. '비정상' 상태 엔드포인트가 예상대로 메시지를 수락하지 않고 IoT Hub 이 엔드포인트로 데이터를 보내려고 다시 시도 중임을 보여줍니다. IoT Hub가 최종적으로 일관된 상태를 설정하면 비정상 엔드포인트의 상태가 정상으로 업데이트됩니다. 'dead' 상태 재심 기간 동안 메시지를 보내는 IoT Hub 다시 시도한 후 엔드포인트가 메시지를 수락하지 않음을 보여줍니다. 오류를 식별하고 엔드포인트 문제를 모니터링하려면 IoT Hub 메트릭을 참조하세요. '알 수 없는' 상태 IoT Hub 엔드포인트와의 연결을 설정하지 않은 것으로 표시됩니다. 이 엔드포인트에 배달되거나 거부된 메시지가 없습니다. |
Error |
오류 세부 정보입니다. |
EndpointHealthData
엔드포인트의 상태 데이터
Name | 형식 | Description |
---|---|---|
endpointId |
string |
엔드포인트의 ID |
healthStatus |
상태의 의미는 다음과 같습니다. '정상' 상태 엔드포인트가 예상대로 메시지를 수락하고 있음을 보여줍니다. '비정상' 상태 엔드포인트가 예상대로 메시지를 수락하지 않고 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 |
엔드포인트 상태 데이터의 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 |
오류 메시지입니다. |