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包含本機 HTTP API，可提供以下方式啟動之本機背景工作處理序目前狀態的快照集AWS IoT Greengrass。此快照包含使用者定義的 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 回應

此請求傳回的陣列工作者健康資訊物件。

回應範例

下列範例回應列出所有 Worker 處理序啟動的健康資訊物件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

範例請求

以下範例示範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 函數的健康狀態資訊：