AWS IoT Greengrass Version 1 memasuki fase umur panjang pada 30 Juni 2023. Untuk informasi selengkapnya, lihat kebijakan AWS IoT Greengrass V1 pemeliharaan. Setelah tanggal ini, tidak AWS IoT Greengrass V1 akan merilis pembaruan yang menyediakan fitur, penyempurnaan, perbaikan bug, atau patch keamanan. Perangkat yang berjalan AWS IoT Greengrass V1 tidak akan terganggu dan akan terus beroperasi dan terhubung ke cloud. Kami sangat menyarankan Anda bermigrasi ke AWS IoT Greengrass Version 2, yang menambahkan fitur baru yang signifikan dan dukungan untuk platform tambahan.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Memanggil API pemeriksaan kondisi lokal

AWS IoT Greengrass berisi API HTTP lokal yang menyediakan snapshot dari keadaan saat ini dari proses pekerja lokal yang dimulai oleh AWS IoT Greengrass. Snapshot ini mencakup fungsi Lambda yang ditetapkan pengguna dan fungsi Lambda sistem. Fungsi Lambda sistem adalah bagian dari perangkat lunak AWS IoT Greengrass core. Mereka berjalan sebagai pekerja lokal yang memproses pada perangkat core dan mengelola operasi seperti perutean pesan, sinkronisasi bayangan lokal, dan deteksi alamat IP otomatis.

API pemeriksaan kondisi support permintaan berikut:

Permintaan dikirim secara lokal memalui perangkat dan tidak memerlukan koneksi internet.

Dapatkan informasi kondisi untuk semua pekerja

Mengirim GET permintaan untuk mendapatkan informasi kondisi tentang semua pekerja yang sedang bekerja.

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

Contoh Permintaan

Contoh permintaan curl berikut untuk mendapatkan informasi kondisi dari semua pekerja.

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

Tanggapan JSON

Permintaan ini mengembalikan array dari objek informasi kondisi pekerja ini.

Contoh tanggapan

Contoh respons berikut mencantumkan informasi kondisi objek dari semua proses pekerja yang dimulai oleh 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"
    },
    ...
]

Dapatkan informasi kondisi tentang pekerja tertentu

Mengirim permintaan POST untuk mendapatkan informasi kondisi dari pekerja tertentu. Ganti Port dengan nomor port IPC. Default-nya adalah 8000.

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

Contoh Permintaan

Contoh permintaan berikut curl untuk mendapatkan informasi kondisi dari pekerja tertentu.

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

Inilah contoh body.json isi permintaan:

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

Isi permintaan berisi FuncArns array.

Tanggapan JSON

Permintaan ini mengembalikan Workers array dan InvalidArns array.

Contoh tanggapan

Berikut daftar contoh respons objek informasi kondisi untuk pekerja tertentu.

{ 
    "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"
    ]
}

Permintaan ini mengembalikan error berikut:

Informasi kondisi pekerja

Objek informasi kondisi berisi properti berikut:

Fungsi Lambda sistem

Anda dapat meminta informasi kondisi untuk fungsi Lambda sistem berikut: