AWS IoT Greengrass Version 1더 이상 기능 업데이트를 받지 않으며 2023년 6월 30일까지 보안 패치와 버그 수정만 받게 됩니다. 자세한 내용은 AWS IoT Greengrass V1유지 관리 정책을 참조하세요. 중요한 새 기능을 추가하고 추가 플랫폼을 지원하는 로AWS IoT Greengrass Version 2 마이그레이션하는 것이 좋습니다.

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

로컬 상태 확인 API 호출

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

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

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

모든 근로자에 대한 건강 정보 얻기

전송 대상GET실행중인 모든 근로자에 대한 건강 정보를 얻도록 요청합니다.

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

요청 예

다음 예제는curlrequest는 모든 근로자의 건강 정보를 가져옵니다.

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지정된 근로자에 대한 건강 정보를 얻도록 요청합니다. Replace포트IPC의 포트 번호 포함. 기본값은 8000입니다.

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

요청 예

다음 예제는curlrequest는 지정된 작업자에 대한 건강 정보를 가져옵니다.

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 응답

이 요청은 a를 반환합니다.Workers어레이 및 anInvalidArns어레이.

응답의 예

다음은 응답 목록 예제입니다.건강 정보 객체지정된 워커의 경우.

{ 
    "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 함수에 대한 상태 정보를 요청할 수 있습니다.