Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Pengelola bayangan
Komponen shadow manager (aws.greengrass.ShadowManager) memungkinkan layanan bayangan lokal pada perangkat inti Anda. Layanan bayangan lokal memungkinkan komponen untuk menggunakan komunikasi antar proses untuk berinteraksi dengan bayangan lokal. Komponen shadow manager mengelola penyimpanan dokumen bayangan lokal, dan juga menangani sinkronisasi status bayangan lokal dengan layanan AWS IoT Device Shadow.
Untuk informasi selengkapnya tentang bagaimana perangkat inti Greengrass dapat berinteraksi dengan bayangan, lihat. Berinteraksilah dengan bayangan perangkat
Versi
Komponen ini memiliki versi berikut:
Tipe
Komponen ini adalah komponen plugin (aws.greengrass.plugin). Inti Greengrass menjalankan komponen plugin dalam Java Virtual Machine (JVM) yang sama sebagai inti. Nukleus dimulai ulang saat Anda mengubah versi komponen ini di perangkat inti.
Komponen plugin menggunakan file log yang sama seperti inti Greengrass. Untuk informasi selengkapnya, lihat Memantau AWS IoT Greengrass log.
Untuk informasi selengkapnya, lihat Jenis komponen.
Sistem operasi
Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut:
Persyaratan
Komponen ini memiliki persyaratan sebagai berikut:
-
(Opsional) Untuk menyinkronkan bayangan ke layanan AWS IoT Device Shadow, kebijakan perangkat inti Greengrass harus mengizinkan AWS IoT tindakan kebijakan bayangan berikut: AWS IoT Core
-
iot:GetThingShadow
-
iot:UpdateThingShadow
-
iot:DeleteThingShadow
Untuk informasi selengkapnya tentang AWS IoT Core kebijakan ini, lihat tindakan AWS IoT Core kebijakan di Panduan AWS IoT Pengembang.
Untuk informasi selengkapnya tentang AWS IoT kebijakan minimal, lihat Kebijakan AWS IoT minimal untuk perangkat inti AWS IoT Greengrass V2
-
Komponen shadow manager didukung untuk berjalan di VPC.
Dependensi
Saat Anda menerapkan komponen, gunakan AWS IoT Greengrass juga versi dependensinya yang kompatibel. Ini berarti bahwa Anda harus memenuhi persyaratan untuk komponen dan semua dependensinya untuk berhasil men-deploy komponen. Bagian ini berisi daftar dependensi untuk versi yang dirilis dari komponen ini dan kendala versi semantik yang menentukan versi komponen untuk setiap dependensi. Anda juga dapat melihat dependensi untuk setiap versi komponen di konsol AWS IoT Greengrass tersebut. Pada halaman detail komponen, cari daftar Dependensi.
- 2.3.5 – 2.3.7
-
Tabel berikut mencantumkan dependensi untuk versi 2.3.5 hingga 2.3.7 dari komponen ini.
| Dependensi |
Versi yang kompatibel |
Jenis dependensi |
| Inti Greengrass |
>=2.5.0 <2.13.0 |
Lunak |
- 2.3.3 and 2.3.4
-
Tabel berikut mencantumkan dependensi untuk versi 2.3.3 dan 2.3.4 dari komponen ini.
| Dependensi |
Versi yang kompatibel |
Jenis dependensi |
| Inti Greengrass |
>=2.5.0 <2.12.0 |
Lunak |
- 2.3.2
-
Tabel berikut mencantumkan dependensi untuk versi 2.3.2 dari komponen ini.
| Dependensi |
Versi yang kompatibel |
Jenis dependensi |
| Inti Greengrass |
>=2.5.0 <2.11.0 |
Lunak |
- 2.3.0 and 2.3.1
-
Tabel berikut mencantumkan dependensi untuk versi 2.3.0 dan 2.3.1 dari komponen ini.
| Dependensi |
Versi yang kompatibel |
Jenis dependensi |
| Inti Greengrass |
>=2.5.0 <2.10.0 |
Lunak |
- 2.2.3 and 2.2.4
-
Tabel berikut mencantumkan dependensi untuk versi 2.2.3 dan 2.2.4 dari komponen ini.
| Dependensi |
Versi yang kompatibel |
Jenis dependensi |
| Inti Greengrass |
>=2.2.0 <3.0.0 |
Lunak |
- 2.2.2
-
Tabel berikut mencantumkan dependensi untuk versi 2.2.2 dari komponen ini.
| Dependensi |
Versi yang kompatibel |
Jenis dependensi |
| Inti Greengrass |
>=2.2.0 <2.9.0 |
Lunak |
- 2.2.1
-
Tabel berikut mencantumkan dependensi untuk versi 2.2.1 komponen ini.
| Dependensi |
Versi yang kompatibel |
Jenis dependensi |
| Inti Greengrass |
>=2.2.0 <2.8.0 |
Lunak |
- 2.1.1 and 2.2.0
-
Tabel berikut mencantumkan dependensi untuk versi 2.1.1 dan 2.2.0 dari komponen ini.
| Dependensi |
Versi yang kompatibel |
Jenis dependensi |
| Inti Greengrass |
>=2.2.0 <2.7.0 |
Lunak |
- 2.0.5 - 2.1.0
-
Tabel berikut mencantumkan dependensi untuk versi 2.0.5 hingga 2.1.0 dari komponen ini.
| Dependensi |
Versi yang kompatibel |
Jenis dependensi |
| Inti Greengrass |
>=2.2.0 <2.6.0 |
Lunak |
- 2.0.3 and 2.0.4
-
Tabel berikut mencantumkan dependensi untuk versi 2.0.3 dan 2.0.4 dari komponen ini.
| Dependensi |
Versi yang kompatibel |
Jenis dependensi |
| Inti Greengrass |
>=2.2.0 <2.5.0 |
Lunak |
- 2.0.1 and 2.0.2
-
Tabel berikut mencantumkan dependensi untuk versi 2.0.1 dan 2.0.2 dari komponen ini.
| Dependensi |
Versi yang kompatibel |
Jenis dependensi |
| Inti Greengrass |
>=2.2.0 <2.4.0 |
Lunak |
- 2.0.0
-
Tabel berikut mencantumkan dependensi untuk versi 2.0.0 komponen ini.
| Dependensi |
Versi yang kompatibel |
Jenis dependensi |
| Inti Greengrass |
>=2.2.0 <2.3.0 |
Lunak |
Untuk informasi selengkapnya tentang dependensi komponen, lihat referensi resep komponen.
Konfigurasi
Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen.
- 2.3.x
-
strategy-
(Opsional) Strategi yang digunakan komponen ini untuk menyinkronkan bayangan antara AWS IoT Core dan perangkat inti.
Objek ini berisi informasi berikut.
type-
(Opsional) Jenis strategi yang digunakan komponen ini untuk menyinkronkan bayangan antara AWS IoT Core dan perangkat inti. Pilih dari salah satu pilihan berikut:
-
realTime— Sinkronkan bayangan dengan AWS IoT Core setiap kali pembaruan bayangan terjadi.
-
periodic— Sinkronkan bayangan dengan AWS IoT Core interval reguler yang Anda tentukan dengan parameter delay konfigurasi.
Default: realTime
delay-
(Opsional) Interval dalam detik di mana komponen ini menyinkronkan bayangan dengan AWS IoT Core, saat Anda menentukan strategi periodic sinkronisasi.
Parameter ini diperlukan jika Anda menentukan strategi periodic sinkronisasi.
synchronize-
(Opsional) Pengaturan sinkronisasi yang menentukan bagaimana bayangan disinkronkan dengan AWS Cloud.
Anda harus membuat pembaruan konfigurasi dengan properti ini untuk menyinkronkan bayangan dengan AWS Cloud.
Objek ini berisi informasi berikut.
coreThing-
(Opsional) Bayangan perangkat inti untuk disinkronkan. Objek ini berisi informasi berikut.
classic-
(Opsional) Secara default, pengelola bayangan menyinkronkan status lokal bayangan klasik untuk perangkat inti Anda dengan. AWS Cloud Jika Anda tidak ingin menyinkronkan bayangan perangkat klasik, atur ini ke false.
Default: true
namedShadows-
(Opsional) Daftar bayangan perangkat inti bernama untuk disinkronkan. Anda harus menentukan nama yang tepat dari bayangan.
AWS IoT Greengrass Layanan ini menggunakan bayangan AWSManagedGreengrassV2Deployment bernama untuk mengelola penerapan yang menargetkan perangkat inti individual. Bayangan bernama ini dicadangkan untuk digunakan oleh AWS IoT Greengrass layanan. Jangan perbarui atau hapus bayangan bernama ini.
shadowDocumentsMap-
(Opsional) Bayangan perangkat tambahan untuk disinkronkan. Menggunakan parameter konfigurasi ini memudahkan untuk menentukan dokumen bayangan. Kami menyarankan Anda menggunakan parameter ini alih-alih shadowDocuments objek.
Jika Anda menentukan shadowDocumentsMap objek, Anda tidak harus menentukan shadowDocuments objek.
Setiap objek berisi informasi berikut.
thingName-
Konfigurasi bayangan untuk ThingName untuk konfigurasi bayangan ini.
classic-
(Opsional) Jika Anda tidak ingin menyinkronkan bayangan perangkat klasik untuk thingName perangkat, setel ini kefalse.
namedShadows-
Daftar bayangan bernama yang ingin Anda sinkronkan. Anda harus menentukan nama yang tepat dari bayangan.
shadowDocuments-
(Opsional) Daftar bayangan perangkat tambahan untuk disinkronkan. Kami menyarankan Anda menggunakan shadowDocumentsMap parameter sebagai gantinya.
Jika Anda menentukan shadowDocuments objek, Anda tidak harus menentukan shadowDocumentsMap objek.
Setiap objek dalam daftar ini berisi informasi berikut.
thingName-
Nama objek perangkat untuk menyinkronkan bayangan.
classic-
(Opsional) Jika Anda tidak ingin menyinkronkan bayangan perangkat klasik untuk thingName perangkat, setel ini kefalse.
Default: true
namedShadows-
(Opsional) Daftar bayangan perangkat bernama yang ingin Anda sinkronkan. Anda harus menentukan nama yang tepat dari bayangan.
direction-
(Opsional) Arah untuk menyinkronkan bayangan antara layanan bayangan lokal dan AWS Cloud. Anda dapat mengonfigurasi opsi ini untuk mengurangi bandwidth dan koneksi ke file AWS Cloud. Pilih dari salah satu pilihan berikut:
-
betweenDeviceAndCloud— Sinkronisasi bayangan antara layanan bayangan lokal dan. AWS Cloud
-
deviceToCloud— Kirim pembaruan bayangan dari layanan bayangan lokal ke AWS Cloud, dan abaikan pembaruan bayangan dari AWS Cloud.
-
cloudToDevice— Terima pembaruan bayangan dari AWS Cloud, dan jangan mengirim pembaruan bayangan dari layanan bayangan lokal ke AWS Cloud.
Default: BETWEEN_DEVICE_AND_CLOUD
rateLimits-
(Opsional) Pengaturan yang menentukan batas tarif untuk permintaan layanan bayangan.
Objek ini berisi informasi berikut.
maxOutboundSyncUpdatesPerSecond-
(Opsional) Jumlah maksimum permintaan sinkronisasi per detik yang ditransmisikan perangkat.
Default: 100 permintaan/detik
maxTotalLocalRequestsRate-
(Opsional) Jumlah maksimum permintaan IPC lokal per detik yang dikirim ke perangkat inti.
Default: 200 permintaan/detik
maxLocalRequestsPerSecondPerThing-
(Opsional) Jumlah maksimum permintaan IPC lokal per detik yang dikirim untuk setiap hal IoT yang terhubung.
Default: 20 permintaan/detik untuk setiap objek
Parameter batas tingkat ini menentukan jumlah maksimum permintaan per detik untuk layanan bayangan lokal. Jumlah maksimum permintaan per detik untuk layanan AWS IoT Device Shadow tergantung pada Anda Wilayah AWS. Untuk informasi selengkapnya, lihat batasan untuk AWS IoT Device Shadow Service API di Referensi Umum Amazon Web.
shadowDocumentSizeLimitBytes-
(Opsional) Ukuran maksimum yang diizinkan dari setiap dokumen status JSON untuk bayangan lokal.
Jika Anda meningkatkan nilai ini, Anda juga harus meningkatkan batas sumber daya untuk dokumen keadaan JSON untuk bayangan cloud. Untuk informasi selengkapnya, lihat batasan untuk AWS IoT
Device Shadow Service API di Referensi Umum Amazon Web.
Default: 8192 byte
Maksimum: 30720 byte
contoh Contoh: Pembaruan gabungan konfigurasi
Contoh berikut menunjukkan pembaruan gabungan konfigurasi sampel dengan semua parameter konfigurasi yang tersedia untuk komponen manajer bayangan.
{
"strategy":{
"type":"periodic",
"delay":300
},
"synchronize":{
"shadowDocumentsMap":{
"MyDevice1":{
"classic":false,
"namedShadows":[
"MyShadowA",
"MyShadowB"
]
},
"MyDevice2":{
"classic":true,
"namedShadows":[]
}
},
"direction":"betweenDeviceAndCloud"
},
"rateLimits":{
"maxOutboundSyncUpdatesPerSecond":100,
"maxTotalLocalRequestsRate":200,
"maxLocalRequestsPerSecondPerThing":20
},
"shadowDocumentSizeLimitBytes":8192
}
- 2.2.x
-
strategy-
(Opsional) Strategi yang digunakan komponen ini untuk menyinkronkan bayangan antara AWS IoT Core dan perangkat inti.
Objek ini berisi informasi berikut.
type-
(Opsional) Jenis strategi yang digunakan komponen ini untuk menyinkronkan bayangan antara AWS IoT Core dan perangkat inti. Pilih dari salah satu pilihan berikut:
-
realTime— Sinkronkan bayangan dengan AWS IoT Core setiap kali pembaruan bayangan terjadi.
-
periodic— Sinkronkan bayangan dengan AWS IoT Core interval reguler yang Anda tentukan dengan parameter delay konfigurasi.
Default: realTime
delay-
(Opsional) Interval dalam detik di mana komponen ini menyinkronkan bayangan dengan AWS IoT Core, saat Anda menentukan strategi periodic sinkronisasi.
Parameter ini diperlukan jika Anda menentukan strategi periodic sinkronisasi.
synchronize-
(Opsional) Pengaturan sinkronisasi yang menentukan bagaimana bayangan disinkronkan dengan AWS Cloud.
Anda harus membuat pembaruan konfigurasi dengan properti ini untuk menyinkronkan bayangan dengan AWS Cloud.
Objek ini berisi informasi berikut.
coreThing-
(Opsional) Bayangan perangkat inti untuk disinkronkan. Objek ini berisi informasi berikut.
classic-
(Opsional) Secara default, pengelola bayangan menyinkronkan status lokal bayangan klasik untuk perangkat inti Anda dengan. AWS Cloud Jika Anda tidak ingin menyinkronkan bayangan perangkat klasik, atur ini ke false.
Default: true
namedShadows-
(Opsional) Daftar bayangan perangkat inti bernama untuk disinkronkan. Anda harus menentukan nama yang tepat dari bayangan.
AWS IoT Greengrass Layanan ini menggunakan bayangan AWSManagedGreengrassV2Deployment bernama untuk mengelola penerapan yang menargetkan perangkat inti individual. Bayangan bernama ini dicadangkan untuk digunakan oleh AWS IoT Greengrass layanan. Jangan perbarui atau hapus bayangan bernama ini.
shadowDocumentsMap-
(Opsional) Bayangan perangkat tambahan untuk disinkronkan. Menggunakan parameter konfigurasi ini memudahkan untuk menentukan dokumen bayangan. Kami menyarankan Anda menggunakan parameter ini alih-alih shadowDocuments objek.
Jika Anda menentukan shadowDocumentsMap objek, Anda tidak harus menentukan shadowDocuments objek.
Setiap objek berisi informasi berikut.
thingName-
Konfigurasi bayangan untuk ThingName untuk konfigurasi bayangan ini.
classic-
(Opsional) Jika Anda tidak ingin menyinkronkan bayangan perangkat klasik untuk thingName perangkat, setel ini kefalse.
namedShadows-
Daftar bayangan bernama yang ingin Anda sinkronkan. Anda harus menentukan nama yang tepat dari bayangan.
shadowDocuments-
(Opsional) Daftar bayangan perangkat tambahan untuk disinkronkan. Kami menyarankan Anda menggunakan shadowDocumentsMap parameter sebagai gantinya.
Jika Anda menentukan shadowDocuments objek, Anda tidak harus menentukan shadowDocumentsMap objek.
Setiap objek dalam daftar ini berisi informasi berikut.
thingName-
Nama objek perangkat untuk menyinkronkan bayangan.
classic-
(Opsional) Jika Anda tidak ingin menyinkronkan bayangan perangkat klasik untuk thingName perangkat, setel ini kefalse.
Default: true
namedShadows-
(Opsional) Daftar bayangan perangkat bernama yang ingin Anda sinkronkan. Anda harus menentukan nama yang tepat dari bayangan.
direction-
(Opsional) Arah untuk menyinkronkan bayangan antara layanan bayangan lokal dan AWS Cloud. Anda dapat mengonfigurasi opsi ini untuk mengurangi bandwidth dan koneksi ke file AWS Cloud. Pilih dari salah satu pilihan berikut:
-
betweenDeviceAndCloud— Sinkronisasi bayangan antara layanan bayangan lokal dan. AWS Cloud
-
deviceToCloud— Kirim pembaruan bayangan dari layanan bayangan lokal ke AWS Cloud, dan abaikan pembaruan bayangan dari AWS Cloud.
-
cloudToDevice— Terima pembaruan bayangan dari AWS Cloud, dan jangan mengirim pembaruan bayangan dari layanan bayangan lokal ke AWS Cloud.
Default: BETWEEN_DEVICE_AND_CLOUD
rateLimits-
(Opsional) Pengaturan yang menentukan batas tarif untuk permintaan layanan bayangan.
Objek ini berisi informasi berikut.
maxOutboundSyncUpdatesPerSecond-
(Opsional) Jumlah maksimum permintaan sinkronisasi per detik yang ditransmisikan perangkat.
Default: 100 permintaan/detik
maxTotalLocalRequestsRate-
(Opsional) Jumlah maksimum permintaan IPC lokal per detik yang dikirim ke perangkat inti.
Default: 200 permintaan/detik
maxLocalRequestsPerSecondPerThing-
(Opsional) Jumlah maksimum permintaan IPC lokal per detik yang dikirim untuk setiap hal IoT yang terhubung.
Default: 20 permintaan/detik untuk setiap objek
Parameter batas tingkat ini menentukan jumlah maksimum permintaan per detik untuk layanan bayangan lokal. Jumlah maksimum permintaan per detik untuk layanan AWS IoT Device Shadow tergantung pada Anda Wilayah AWS. Untuk informasi selengkapnya, lihat batasan untuk AWS IoT Device Shadow Service API di Referensi Umum Amazon Web.
shadowDocumentSizeLimitBytes-
(Opsional) Ukuran maksimum yang diizinkan dari setiap dokumen status JSON untuk bayangan lokal.
Jika Anda meningkatkan nilai ini, Anda juga harus meningkatkan batas sumber daya untuk dokumen keadaan JSON untuk bayangan cloud. Untuk informasi selengkapnya, lihat batasan untuk AWS IoT
Device Shadow Service API di Referensi Umum Amazon Web.
Default: 8192 byte
Maksimum: 30720 byte
contoh Contoh: Pembaruan gabungan konfigurasi
Contoh berikut menunjukkan pembaruan gabungan konfigurasi sampel dengan semua parameter konfigurasi yang tersedia untuk komponen manajer bayangan.
{
"strategy":{
"type":"periodic",
"delay":300
},
"synchronize":{
"shadowDocumentsMap":{
"MyDevice1":{
"classic":false,
"namedShadows":[
"MyShadowA",
"MyShadowB"
]
},
"MyDevice2":{
"classic":true,
"namedShadows":[]
}
},
"direction":"betweenDeviceAndCloud"
},
"rateLimits":{
"maxOutboundSyncUpdatesPerSecond":100,
"maxTotalLocalRequestsRate":200,
"maxLocalRequestsPerSecondPerThing":20
},
"shadowDocumentSizeLimitBytes":8192
}
- 2.1.x
-
strategy-
(Opsional) Strategi yang digunakan komponen ini untuk menyinkronkan bayangan antara AWS IoT Core dan perangkat inti.
Objek ini berisi informasi berikut.
type-
(Opsional) Jenis strategi yang digunakan komponen ini untuk menyinkronkan bayangan antara AWS IoT Core dan perangkat inti. Pilih dari salah satu pilihan berikut:
-
realTime— Sinkronkan bayangan dengan AWS IoT Core setiap kali pembaruan bayangan terjadi.
-
periodic— Sinkronkan bayangan dengan AWS IoT Core interval reguler yang Anda tentukan dengan parameter delay konfigurasi.
Default: realTime
delay-
(Opsional) Interval dalam detik di mana komponen ini menyinkronkan bayangan dengan AWS IoT Core, saat Anda menentukan strategi periodic sinkronisasi.
Parameter ini diperlukan jika Anda menentukan strategi periodic sinkronisasi.
synchronize-
(Opsional) Pengaturan sinkronisasi yang menentukan bagaimana bayangan disinkronkan dengan AWS Cloud.
Anda harus membuat pembaruan konfigurasi dengan properti ini untuk menyinkronkan bayangan dengan AWS Cloud.
Objek ini berisi informasi berikut.
coreThing-
(Opsional) Bayangan perangkat inti untuk disinkronkan. Objek ini berisi informasi berikut.
classic-
(Opsional) Secara default, pengelola bayangan menyinkronkan status lokal bayangan klasik untuk perangkat inti Anda dengan. AWS Cloud Jika Anda tidak ingin menyinkronkan bayangan perangkat klasik, atur ini ke false.
Default: true
namedShadows-
(Opsional) Daftar bayangan perangkat inti bernama untuk disinkronkan. Anda harus menentukan nama yang tepat dari bayangan.
AWS IoT Greengrass Layanan ini menggunakan bayangan AWSManagedGreengrassV2Deployment bernama untuk mengelola penerapan yang menargetkan perangkat inti individual. Bayangan bernama ini dicadangkan untuk digunakan oleh AWS IoT Greengrass layanan. Jangan perbarui atau hapus bayangan bernama ini.
shadowDocumentsMap-
(Opsional) Bayangan perangkat tambahan untuk disinkronkan. Menggunakan parameter konfigurasi ini memudahkan untuk menentukan dokumen bayangan. Kami menyarankan Anda menggunakan parameter ini alih-alih shadowDocuments objek.
Jika Anda menentukan shadowDocumentsMap objek, Anda tidak harus menentukan shadowDocuments objek.
Setiap objek berisi informasi berikut.
thingName-
Konfigurasi bayangan untuk ThingName untuk konfigurasi bayangan ini.
classic-
(Opsional) Jika Anda tidak ingin menyinkronkan bayangan perangkat klasik untuk thingName perangkat, setel ini kefalse.
namedShadows-
Daftar bayangan bernama yang ingin Anda sinkronkan. Anda harus menentukan nama yang tepat dari bayangan.
shadowDocuments-
(Opsional) Daftar bayangan perangkat tambahan untuk disinkronkan. Kami menyarankan Anda menggunakan shadowDocumentsMap parameter sebagai gantinya.
Jika Anda menentukan shadowDocuments objek, Anda tidak harus menentukan shadowDocumentsMap objek.
Setiap objek dalam daftar ini berisi informasi berikut.
thingName-
Nama objek perangkat untuk menyinkronkan bayangan.
classic-
(Opsional) Jika Anda tidak ingin menyinkronkan bayangan perangkat klasik untuk thingName perangkat, setel ini kefalse.
Default: true
namedShadows-
(Opsional) Daftar bayangan perangkat bernama yang ingin Anda sinkronkan. Anda harus menentukan nama yang tepat dari bayangan.
rateLimits-
(Opsional) Pengaturan yang menentukan batas tarif untuk permintaan layanan bayangan.
Objek ini berisi informasi berikut.
maxOutboundSyncUpdatesPerSecond-
(Opsional) Jumlah maksimum permintaan sinkronisasi per detik yang ditransmisikan perangkat.
Default: 100 permintaan/detik
maxTotalLocalRequestsRate-
(Opsional) Jumlah maksimum permintaan IPC lokal per detik yang dikirim ke perangkat inti.
Default: 200 permintaan/detik
maxLocalRequestsPerSecondPerThing-
(Opsional) Jumlah maksimum permintaan IPC lokal per detik yang dikirim untuk setiap hal IoT yang terhubung.
Default: 20 permintaan/detik untuk setiap objek
Parameter batas tingkat ini menentukan jumlah maksimum permintaan per detik untuk layanan bayangan lokal. Jumlah maksimum permintaan per detik untuk layanan AWS IoT Device Shadow tergantung pada Anda Wilayah AWS. Untuk informasi selengkapnya, lihat batasan untuk AWS IoT Device Shadow Service API di Referensi Umum Amazon Web.
shadowDocumentSizeLimitBytes-
(Opsional) Ukuran maksimum yang diizinkan dari setiap dokumen status JSON untuk bayangan lokal.
Jika Anda meningkatkan nilai ini, Anda juga harus meningkatkan batas sumber daya untuk dokumen keadaan JSON untuk bayangan cloud. Untuk informasi selengkapnya, lihat batasan untuk AWS IoT
Device Shadow Service API di Referensi Umum Amazon Web.
Default: 8192 byte
Maksimum: 30720 byte
contoh Contoh: Pembaruan gabungan konfigurasi
Contoh berikut menunjukkan pembaruan gabungan konfigurasi sampel dengan semua parameter konfigurasi yang tersedia untuk komponen manajer bayangan.
{
"strategy":{
"type":"periodic",
"delay":300
},
"synchronize":{
"shadowDocumentsMap":{
"MyDevice1":{
"classic":false,
"namedShadows":[
"MyShadowA",
"MyShadowB"
]
},
"MyDevice2":{
"classic":true,
"namedShadows":[]
}
},
"direction":"betweenDeviceAndCloud"
},
"rateLimits":{
"maxOutboundSyncUpdatesPerSecond":100,
"maxTotalLocalRequestsRate":200,
"maxLocalRequestsPerSecondPerThing":20
},
"shadowDocumentSizeLimitBytes":8192
}
- 2.0.x
-
synchronize-
(Opsional) Pengaturan sinkronisasi yang menentukan bagaimana bayangan disinkronkan dengan AWS Cloud.
Anda harus membuat pembaruan konfigurasi dengan properti ini untuk menyinkronkan bayangan dengan AWS Cloud.
Objek ini berisi informasi berikut.
coreThing-
(Opsional) Bayangan perangkat inti untuk disinkronkan. Objek ini berisi informasi berikut.
classic-
(Opsional) Secara default, pengelola bayangan menyinkronkan status lokal bayangan klasik untuk perangkat inti Anda dengan. AWS Cloud Jika Anda tidak ingin menyinkronkan bayangan perangkat klasik, atur ini ke false.
Default: true
namedShadows-
(Opsional) Daftar bayangan perangkat inti bernama untuk disinkronkan. Anda harus menentukan nama yang tepat dari bayangan.
AWS IoT Greengrass Layanan ini menggunakan bayangan AWSManagedGreengrassV2Deployment bernama untuk mengelola penerapan yang menargetkan perangkat inti individual. Bayangan bernama ini dicadangkan untuk digunakan oleh AWS IoT Greengrass layanan. Jangan perbarui atau hapus bayangan bernama ini.
shadowDocumentsMap-
(Opsional) Bayangan perangkat tambahan untuk disinkronkan. Menggunakan parameter konfigurasi ini memudahkan untuk menentukan dokumen bayangan. Kami menyarankan Anda menggunakan parameter ini alih-alih shadowDocuments objek.
Jika Anda menentukan shadowDocumentsMap objek, Anda tidak harus menentukan shadowDocuments objek.
Setiap objek berisi informasi berikut.
thingName-
Konfigurasi bayangan untuk ThingName untuk konfigurasi bayangan ini.
classic-
(Opsional) Jika Anda tidak ingin menyinkronkan bayangan perangkat klasik untuk thingName perangkat, setel ini kefalse.
namedShadows-
Daftar bayangan bernama yang ingin Anda sinkronkan. Anda harus menentukan nama yang tepat dari bayangan.
shadowDocuments-
(Opsional) Daftar bayangan perangkat tambahan untuk disinkronkan. Kami menyarankan Anda menggunakan shadowDocumentsMap parameter sebagai gantinya.
Jika Anda menentukan shadowDocuments objek, Anda tidak harus menentukan shadowDocumentsMap objek.
Setiap objek dalam daftar ini berisi informasi berikut.
thingName-
Nama objek perangkat untuk menyinkronkan bayangan.
classic-
(Opsional) Jika Anda tidak ingin menyinkronkan bayangan perangkat klasik untuk thingName perangkat, setel ini kefalse.
Default: true
namedShadows-
(Opsional) Daftar bayangan perangkat bernama yang ingin Anda sinkronkan. Anda harus menentukan nama yang tepat dari bayangan.
rateLimits-
(Opsional) Pengaturan yang menentukan batas tarif untuk permintaan layanan bayangan.
Objek ini berisi informasi berikut.
maxOutboundSyncUpdatesPerSecond-
(Opsional) Jumlah maksimum permintaan sinkronisasi per detik yang ditransmisikan perangkat.
Default: 100 permintaan/detik
maxTotalLocalRequestsRate-
(Opsional) Jumlah maksimum permintaan IPC lokal per detik yang dikirim ke perangkat inti.
Default: 200 permintaan/detik
maxLocalRequestsPerSecondPerThing-
(Opsional) Jumlah maksimum permintaan IPC lokal per detik yang dikirim untuk setiap hal IoT yang terhubung.
Default: 20 permintaan/detik untuk setiap objek
Parameter batas tingkat ini menentukan jumlah maksimum permintaan per detik untuk layanan bayangan lokal. Jumlah maksimum permintaan per detik untuk layanan AWS IoT Device Shadow tergantung pada Anda Wilayah AWS. Untuk informasi selengkapnya, lihat batasan untuk AWS IoT Device Shadow Service API di Referensi Umum Amazon Web.
shadowDocumentSizeLimitBytes-
(Opsional) Ukuran maksimum yang diizinkan dari setiap dokumen status JSON untuk bayangan lokal.
Jika Anda meningkatkan nilai ini, Anda juga harus meningkatkan batas sumber daya untuk dokumen keadaan JSON untuk bayangan cloud. Untuk informasi selengkapnya, lihat batasan untuk AWS IoT
Device Shadow Service API di Referensi Umum Amazon Web.
Default: 8192 byte
Maksimum: 30720 byte
contoh Contoh: Pembaruan gabungan konfigurasi
Contoh berikut menunjukkan pembaruan gabungan konfigurasi sampel dengan semua parameter konfigurasi yang tersedia untuk komponen manajer bayangan.
{
"synchronize": {
"coreThing": {
"classic": true,
"namedShadows": [
"MyCoreShadowA",
"MyCoreShadowB"
]
},
"shadowDocuments": [
{
"thingName": "MyDevice1",
"classic": false,
"namedShadows": [
"MyShadowA",
"MyShadowB"
]
},
{
"thingName": "MyDevice2",
"classic": true,
"namedShadows": []
}
]
},
"rateLimits": {
"maxOutboundSyncUpdatesPerSecond": 100,
"maxTotalLocalRequestsRate": 200,
"maxLocalRequestsPerSecondPerThing": 20
},
"shadowDocumentSizeLimitBytes": 8192
}
Berkas log lokal
Komponen ini menggunakan file log yang sama dengan komponen inti Greengrass.
- Linux
-
/greengrass/v2
- Windows
-
C:\greengrass\v2\logs\greengrass.log
Untuk melihat log komponen ini
Changelog
Tabel berikut menjelaskan perubahan dalam setiap versi komponen.
|
Versi
|
Perubahan
|
|
2.3.7
|
- Perbaikan bug dan peningkatan
-
|
|
2.3.6
|
- Perbaikan bug dan peningkatan
-
|
|
2.3.5
|
Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. |
|
2.3.4
|
- Perbaikan bug dan peningkatan
-
|
|
2.3.3
|
Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. |
|
2.3.2
|
- Perbaikan bug dan peningkatan
-
|
|
2.3.1
|
- Perbaikan bug dan peningkatan
-
-
Memperbaiki kondisi yang dapat mencegah pembaruan cloud shadow dari sinkronisasi.
-
Memperbaiki masalah di mana perubahan konfigurasi sinkronisasi bayangan bernama hanya berlaku untuk satu bayangan bernama.
|
|
2.3.0
|
- Perbaikan bug dan peningkatan
-
|
|
2.2.4
|
- Perbaikan bug dan peningkatan
-
-
Memperbaiki masalah ketika validasi ukuran bayangan tidak konsisten dengan cloud saat memperbarui dokumen bayangan lokal.
-
Memperbaiki masalah saat pengelola bayangan berhenti mendengarkan pembaruan konfigurasi jika penerapan melakukan a RESET pada node konfigurasi.
|
|
2.2.3
|
Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis. |
|
2.2.2
|
Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. |
|
2.2.1
|
Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis.
|
|
2.2.0
|
- Fitur baru
-
-
Menambahkan dukungan untuk layanan bayangan lokal melalui antarmuka penerbitan/berlangganan lokal. Anda sekarang dapat berkomunikasi dengan broker pesan penerbitan/berlangganan lokal pada topik bayangan MQTT untuk mendapatkan, memperbarui, dan menghapus bayangan pada perangkat inti. Fitur ini memungkinkan Anda untuk menghubungkan perangkat klien ke layanan bayangan lokal dengan menggunakan jembatan MQTT untuk menyampaikan pesan tentang topik bayangan antara perangkat klien dan antarmuka penerbitan/berlangganan lokal.
Fitur ini membutuhkan v2.6.0 atau yang lebih baru dari komponen inti Greengrass. Untuk menghubungkan perangkat klien ke layanan bayangan lokal, Anda juga harus menggunakan v2.2.0 atau yang lebih baru dari komponen jembatan MQTT.
-
Menambahkan direction opsi yang dapat Anda konfigurasikan untuk menyesuaikan arah untuk menyinkronkan bayangan antara layanan bayangan lokal dan AWS Cloud. Anda dapat mengonfigurasi opsi ini untuk mengurangi bandwidth dan koneksi ke file AWS Cloud.
|
|
2.1.1
|
- Perbaikan bug dan peningkatan
-
-
Memperbaiki masalah di mana kedalaman maksimum dalam desired dan reported bagian dokumen status bayangan perangkat JSON adalah 4 level, bukan 5 level.
-
Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis.
|
|
2.1.0
|
|
|
2.0.6
|
Versi ini berisi perbaikan bug dan perbaikan.
|
|
2.0.5
|
Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis.
|
|
2.0.4
|
- Perbaikan bug dan peningkatan
-
-
Memperbaiki masalah yang menyebabkan shadow manager menghapus versi yang baru dibuat dari bayangan apa pun yang sebelumnya dihapus.
-
Memperbarui operasi DeleteThingShadow IPC untuk menambah versi bayangan saat dipanggil.
|
|
2.0.3
|
Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis.
|
|
2.0.2
|
- Perbaikan bug dan peningkatan
-
-
Memperbaiki masalah yang menyebabkan manajer bayangan tidak mengenali properti delta ketika menyinkronkan bayangan keadaan dari AWS IoT Core.
-
Memperbaiki masalah yang terkadang menyebabkan permintaan sinkronisasi agar bayangan digabung secara tidak tepat.
|
|
2.0.1
|
Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0.
|
|
2.0.0
|
Versi awal.
|
