기본 제공 직접 메서드를 사용하여 여 edgeAgent와 통신

적용 대상: IoT Edge 1.5

IoT Edge 에이전트 모듈의 직접 메서드를 사용하여 IoT Edge 배포를 모니터링하고 관리합니다. 직접 메서드는 디바이스에서 구현되며 클라우드에서 호출할 수 있습니다. IoT Edge 에이전트에는 IoT Edge 디바이스를 원격으로 모니터링하고 관리하는 직접 메서드가 포함되어 있습니다.

직접 메서드, 그 사용 방법 및 사용자 고유의 모듈에서 이를 구현하는 방법에 대한 자세한 내용은 IoT Hub에서의 직접 메서드 인식 및 호출을 참조하세요.

이러한 직접 메서드의 이름은 대/소문자를 구분하지 않습니다.

핑

ping 메서드는 디바이스에서 IoT Edge가 실행 중인지 또는 디바이스에 IoT Hub에 대한 열린 연결이 있는지 확인합니다. 이 메서드를 사용하여 IoT Edge 에이전트를 ping하고 해당 상태를 확인합니다. 성공적인 ping은 빈 페이로드와 "상태": 200을 반환합니다.

예시:

az iot hub invoke-module-method --method-name 'ping' -n <hub name> -d <device name> -m '$edgeAgent'

Azure Portal에서 메서드 이름과 ping 빈 JSON 페이로드 {}를 사용하여 메서드를 호출합니다.

모듈 다시 시작

RestartModule 메서드를 사용하면 IoT Edge 디바이스에서 실행되는 모듈을 원격으로 관리할 수 있습니다. 모듈이 실패한 상태 또는 비정상 동작을 보고하는 경우 IoT Edge 에이전트를 트리거하여 다시 시작합니다. 다시 시작 명령이 성공하면 "status"가 200인 빈 페이로드가 반환됩니다.

RestartModule 메서드는 IoT Edge 버전 1.0.9부터 사용할 수 있습니다.

edgeAgent 모듈을 포함하여 IoT Edge 디바이스에서 실행되는 모든 모듈에서 RestartModule 직접 메서드를 사용합니다. 이 직접 메서드를 사용하여 edgeAgent를 종료하는 경우 모듈을 다시 시작하는 동안 연결이 중단되므로 성공 결과가 표시되지 않습니다.

예시:

az iot hub invoke-module-method --method-name 'RestartModule' -n <hub name> -d <device name> -m '$edgeAgent' --method-payload \
'
    {
        "schemaVersion": "1.0",
        "id": "<module name>"
    }
'

Azure Portal에서 다음 JSON 페이로드와 함께 메서드 이름을 RestartModule 사용합니다.

{
    "schemaVersion": "1.0",
    "id": "<module name>"
}

진단 직접 메서드

• GetModuleLogs: 직접 메서드의 응답에서 모듈 로그를 검색합니다.
• UploadModuleLogs: 모듈 로그를 검색하고 Azure Blob Storage에 업로드합니다.
• UploadSupportBundle: 지원 번들로 모듈 로그를 검색하고 Azure Blob Storage에 zip 파일을 업로드합니다.
• GetTaskStatus: 업로드 로그 또는 지원 번들 요청의 상태를 확인합니다.

1.0.10 릴리스부터 진단 직접 메서드를 사용할 수 있습니다.

다음 단계

IoT Edge 에이전트 및 IoT Edge 허브 모듈 쌍의 속성