AWS IoT Greengrass Version 1 2023년 6월 30일에 수명 연장 단계에 들어갔습니다. AWS IoT Greengrass V1 관리형 정책에 대한 자세한 정보는 섹션을 참조하세요. 이 날짜 이후에는 기능, 개선 사항, 버그 수정 또는 보안 패치를 제공하는 업데이트가 AWS IoT Greengrass V1 릴리스되지 않습니다. 에서 실행되는 기기는 AWS IoT Greengrass V1 중단되지 않으며 계속 작동하고 클라우드에 연결됩니다. 새로운 기능이 크게 추가되고 추가 플랫폼에 대한 지원이 추가되는 으로 마이그레이션하는 AWS IoT Greengrass Version 2 것이 좋습니다.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

로컬 상태 확인 API 직접 호출

AWS IoT Greengrass에는 AWS IoT Greengrass에서 시작된 로컬 작업자 프로세스의 현재 상태를 스냅샷으로 제공하는 로컬 HTTP API가 포함되어 있습니다. 이 스냅샷에는 사용자 정의 Lambda 함수와 시스템 Lambda 함수가 포함되어 있습니다. 시스템 Lambda 함수는 AWS IoT Greengrass 코어 소프트웨어의 구성 요소입니다. 코어 디바이스에서 로컬 작업자 프로세스로 실행되며 메시지 라우팅, 로컬 섀도 동기화, 자동 IP 주소 감지와 같은 작업을 관리합니다.

상태 확인 API는 다음 요청을 지원합니다.

요청은 디바이스에서 로컬로 전송되며 인터넷 연결이 필요하지 않습니다.

모든 작업자의 상태 정보를 확인하세요.

GET 요청을 보내 실행 중인 모든 작업자의 상태 정보를 받아보세요.

GET http://localhost:port/2016-11-01/health/workers

요청 예제

다음 예제 curl 요청은 모든 작업자의 상태 정보를 가져옵니다.

curl http://localhost:8000/2016-11-01/health/workers

JSON 응답

이 요청은 작업자 상태 정보 개체 배열을 반환합니다.

응답의 예

다음 예제 응답에는 AWS IoT Greengrass에서 시작한 모든 작업자 프로세스의 상태 정보 개체가 나열되어 있습니다.

[
    {
      "FuncArn": "arn:aws:lambda:::function:GGShadowService:1",
      "WorkerId" : "65515053-2f70-43dc-7cc0-1712bEXAMPLE",
      "ProcessId": "1234",
      "WorkerState": "Waiting"
    },
    {
      "FuncArn": "arn:aws:lambda:::function:GGSecretManager:1",
      "WorkerId": "a9916cc2-1b4d-4f0e-4b12-b1872EXAMPLE",
      "ProcessId": "9798",
      "WorkerState": "Waiting"
    },
    {
      "FuncArn": "arn:aws:lambda:us-west-2:123456789012:function:my-lambda-function:3",
      "WorkerId": "2e6f785e-66a5-42c9-67df-42073EXAMPLE",
      "ProcessId": "11837",
      "WorkerState": "Waiting"
    },
    ...
]

지정된 작업자에 대한 상태 정보를 얻으십시오.

POST 요청을 보내 지정된 작업자의 상태 정보를 받아보세요. 포트를 IPC의 포트 번호로 바꾸십시오. 기본값은 8000입니다.

POST http://localhost:port/2016-11-01/health/workers

요청 예제

다음 예제 curl 요청은 지정된 작업자의 상태 정보를 가져옵니다.

curl --data "@body.json" http://localhost:8000/2016-11-01/health/workers

다음은 body.json 요청 본문의 예제입니다.

{
    "FuncArns": [
        "arn:aws:lambda:::function:GGShadowService:1",
        "arn:aws:lambda:us-west-2:123456789012:function:my-lambda-function:3"
    ]
}

요청 본문에는 FuncArns 배열이 들어 있습니다.

JSON 응답

이 요청은 Workers 배열과 InvalidArns 배열을 반환합니다.

응답의 예

다음 예제 응답에는 지정된 작업자의 상태 정보 개체가 나열되어 있습니다.

{ 
    "Workers": [
        {
            "FuncArn": "arn:aws:lambda:::function:GGShadowService:1",
            "WorkerId" : "65515053-2f70-43dc-7cc0-1712bEXAMPLE",
            "ProcessId": "1234",
            "WorkerState": "Waiting"
        },
        {
            "FuncArn": "arn:aws:lambda:us-west-2:123456789012:function:my-lambda-function:3",
            "WorkerId": "2e6f785e-66a5-42c9-67df-42073ESAMPLE",
            "ProcessId": "11837",
            "WorkerState": "Waiting"
        }
    ],
    "InvalidArns" : [
        "some-malformed-arn", 
        "arn:aws:lambda:us-west-2:123456789012:function:some-unknown-function:1"
    ]
}

이 요청은 다음 오류를 반환합니다.

작업자 상태 정보

정상 정보 객체는 다음 속성을 포함하고 있습니다.

시스템 Lambda 함수

다음 시스템 Lambda 함수에 대한 상태 정보를 요청할 수 있습니다.