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 Core ソフトウェアの一部です。これらは、コアデバイス上でローカルワーカープロセスとして実行され、メッセージルーティング、ローカルシャドウ同期、および自動 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 リクエストを送信します。port を IPC のポート番号に置き換えます。デフォルトは 8,000 です。

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 関数のヘルス情報をリクエストできます。