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，该 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 响应

此请求返回一组工作人员健康信息对象。

响应示例

以下示例响应列出了由 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 函数的运行状况信息：