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

# Pengelola bayangan
<a name="shadow-manager-component"></a>

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](ipc-local-shadows.md). 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](interact-with-shadows.md)

**Topics**
+ [Versi](#shadow-manager-component-versions)
+ [Tipe](#shadow-manager-component-type)
+ [Sistem operasi](#shadow-manager-component-os-support)
+ [Persyaratan](#shadow-manager-component-requirements)
+ [Dependensi](#shadow-manager-component-dependencies)
+ [Konfigurasi](#shadow-manager-component-configuration)
+ [Berkas log lokal](#shadow-manager-component-log-file)
+ [Changelog](#shadow-manager-component-changelog)

## Versi
<a name="shadow-manager-component-versions"></a>

Komponen ini memiliki versi berikut:
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2.0.x

## Tipe
<a name="shadow-manager-component-type"></a>

<a name="public-component-type-plugin-para1"></a>Komponen ini adalah komponen plugin (`aws.greengrass.plugin`). [Inti Greengrass](greengrass-nucleus-component.md) menjalankan komponen plugin dalam Java Virtual Machine (JVM) yang sama sebagai inti. Nukleus dimulai ulang saat Anda mengubah versi komponen ini di perangkat inti.

<a name="public-component-type-plugin-para2"></a>Komponen plugin menggunakan file log yang sama seperti inti Greengrass. Untuk informasi selengkapnya, lihat [Memantau AWS IoT Greengrass log](monitor-logs.md).

<a name="public-component-type-more-information"></a>Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types).

## Sistem operasi
<a name="shadow-manager-component-os-support"></a>

Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut:
+ Linux
+ Windows

## Persyaratan
<a name="shadow-manager-component-requirements"></a>

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](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policy-actions.html) di *Panduan AWS IoT Pengembang*.

  Untuk informasi selengkapnya tentang AWS IoT kebijakan minimal, lihat [AWS IoT Kebijakan minimal untuk perangkat AWS IoT Greengrass V2 inti](device-auth.md#greengrass-core-minimal-iot-policy)
+ Komponen shadow manager didukung untuk berjalan di VPC.

## Dependensi
<a name="shadow-manager-component-dependencies"></a>

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](#shadow-manager-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**.

------
#### [ 2.3.13 ]

Tabel berikut mencantumkan dependensi untuk versi 2.3.13 dari komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.17.0 | Lunak | 

------
#### [ 2.3.12 ]

Tabel berikut mencantumkan dependensi untuk versi 2.3.12 komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.17.0 | Lunak | 

------
#### [ 2.3.11 ]

Tabel berikut mencantumkan dependensi untuk versi 2.3.11 komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.16.0 | Lunak | 

------
#### [ 2.3.10 ]

Tabel berikut mencantumkan dependensi untuk versi 2.3.10 dari komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.15.0 | Lunak | 

------
#### [ 2.3.9 ]

Tabel berikut mencantumkan dependensi untuk versi 2.3.9 komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.14.0 | Lunak | 

------
#### [ 2.3.5 – 2.3.8 ]

Tabel berikut mencantumkan dependensi untuk versi 2.3.5 hingga 2.3.8 dari komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=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](greengrass-nucleus-component.md) | >=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](greengrass-nucleus-component.md) | >=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](greengrass-nucleus-component.md) | >=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](greengrass-nucleus-component.md) | >=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](greengrass-nucleus-component.md) | >=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](greengrass-nucleus-component.md) | >=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](greengrass-nucleus-component.md) | >=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](greengrass-nucleus-component.md) | >=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](greengrass-nucleus-component.md) | >=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](greengrass-nucleus-component.md) | >=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](greengrass-nucleus-component.md) | >=2.2.0 <2.3.0 | Lunak | 

------

Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies).

## Konfigurasi
<a name="shadow-manager-component-configuration"></a>

Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen.

------
#### [ 2.3.x ]

`strategy`  <a name="shadow-manager-component-configuration-strategy"></a>
(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`  <a name="shadow-manager-component-configuration-synchronize"></a>
<a name="shadow-manager-component-configuration-strategy-description"></a>(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`  <a name="shadow-manager-component-configuration-synchronize-core-thing"></a>
(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`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents-map"></a>
(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 *thingName* untuk konfigurasi bayangan ini.    
`classic`  
(Opsional) Jika Anda tidak ingin menyinkronkan bayangan perangkat klasik untuk `thingName` perangkat, setel ini ke`false`.  
`namedShadows`  
Daftar bayangan bernama yang ingin Anda sinkronkan. Anda harus menentukan nama yang tepat dari bayangan.  
`shadowDocuments`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents"></a>
(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 ke`false`.  
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`  <a name="shadow-manager-component-configuration-rate-limits"></a>
(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 requests/second untuk setiap hal
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](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) di *Referensi Umum Amazon Web*.

`shadowDocumentSizeLimitBytes`  <a name="shadow-manager-component-configuration-shadow-document-size-limit-bytes"></a>
(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](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) di *Referensi Umum Amazon Web*.  
Default: 8192 byte  
Maksimum: 30720 byte

**Example 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`  <a name="shadow-manager-component-configuration-strategy"></a>
(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`  <a name="shadow-manager-component-configuration-synchronize"></a>
<a name="shadow-manager-component-configuration-strategy-description"></a>(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`  <a name="shadow-manager-component-configuration-synchronize-core-thing"></a>
(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`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents-map"></a>
(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 *thingName* untuk konfigurasi bayangan ini.    
`classic`  
(Opsional) Jika Anda tidak ingin menyinkronkan bayangan perangkat klasik untuk `thingName` perangkat, setel ini ke`false`.  
`namedShadows`  
Daftar bayangan bernama yang ingin Anda sinkronkan. Anda harus menentukan nama yang tepat dari bayangan.  
`shadowDocuments`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents"></a>
(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 ke`false`.  
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`  <a name="shadow-manager-component-configuration-rate-limits"></a>
(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 requests/second untuk setiap hal
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](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) di *Referensi Umum Amazon Web*.

`shadowDocumentSizeLimitBytes`  <a name="shadow-manager-component-configuration-shadow-document-size-limit-bytes"></a>
(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](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) di *Referensi Umum Amazon Web*.  
Default: 8192 byte  
Maksimum: 30720 byte

**Example 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`  <a name="shadow-manager-component-configuration-strategy"></a>
(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`  <a name="shadow-manager-component-configuration-synchronize"></a>
<a name="shadow-manager-component-configuration-strategy-description"></a>(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`  <a name="shadow-manager-component-configuration-synchronize-core-thing"></a>
(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`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents-map"></a>
(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 *thingName* untuk konfigurasi bayangan ini.    
`classic`  
(Opsional) Jika Anda tidak ingin menyinkronkan bayangan perangkat klasik untuk `thingName` perangkat, setel ini ke`false`.  
`namedShadows`  
Daftar bayangan bernama yang ingin Anda sinkronkan. Anda harus menentukan nama yang tepat dari bayangan.  
`shadowDocuments`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents"></a>
(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 ke`false`.  
Default: `true`  
`namedShadows`  
(Opsional) Daftar bayangan perangkat bernama yang ingin Anda sinkronkan. Anda harus menentukan nama yang tepat dari bayangan.

`rateLimits`  <a name="shadow-manager-component-configuration-rate-limits"></a>
(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 requests/second untuk setiap hal
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](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) di *Referensi Umum Amazon Web*.

`shadowDocumentSizeLimitBytes`  <a name="shadow-manager-component-configuration-shadow-document-size-limit-bytes"></a>
(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](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) di *Referensi Umum Amazon Web*.  
Default: 8192 byte  
Maksimum: 30720 byte

**Example 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`  <a name="shadow-manager-component-configuration-synchronize"></a>
<a name="shadow-manager-component-configuration-strategy-description"></a>(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`  <a name="shadow-manager-component-configuration-synchronize-core-thing"></a>
(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`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents-map"></a>
(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 *thingName* untuk konfigurasi bayangan ini.    
`classic`  
(Opsional) Jika Anda tidak ingin menyinkronkan bayangan perangkat klasik untuk `thingName` perangkat, setel ini ke`false`.  
`namedShadows`  
Daftar bayangan bernama yang ingin Anda sinkronkan. Anda harus menentukan nama yang tepat dari bayangan.  
`shadowDocuments`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents"></a>
(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 ke`false`.  
Default: `true`  
`namedShadows`  
(Opsional) Daftar bayangan perangkat bernama yang ingin Anda sinkronkan. Anda harus menentukan nama yang tepat dari bayangan.

`rateLimits`  <a name="shadow-manager-component-configuration-rate-limits"></a>
(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 requests/second untuk setiap hal
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](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) di *Referensi Umum Amazon Web*.

`shadowDocumentSizeLimitBytes`  <a name="shadow-manager-component-configuration-shadow-document-size-limit-bytes"></a>
(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](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) di *Referensi Umum Amazon Web*.  
Default: 8192 byte  
Maksimum: 30720 byte

**Example 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
<a name="shadow-manager-component-log-file"></a>

Komponen ini menggunakan file log yang sama dengan komponen inti [Greengrass](greengrass-nucleus-component.md).

------
#### [ Linux ]

```
/greengrass/v2/logs/greengrass.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\greengrass.log
```

------

**Untuk melihat log komponen ini**
+ Jalankan perintah berikut pada perangkat inti untuk melihat file log komponen ini secara real time. Ganti `/greengrass/v2` atau *C:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/greengrass.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="shadow-manager-component-changelog"></a>

Tabel berikut menjelaskan perubahan dalam setiap versi komponen.


|  Versi  |  Perubahan  | 
| --- | --- | 
|  2.3.13  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.3.12  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.3.11  | Versi diperbarui untuk Greengrass nucleus versi 2.15.0 rilis. | 
|  2.3.10  | Versi diperbarui untuk Greengrass nucleus versi 2.14.0 rilis. | 
|  2.3.9  | Versi diperbarui untuk Greengrass nucleus versi 2.13.0 rilis. | 
|  2.3.8  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.3.7  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.3.6  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.3.5  | Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. | 
|  2.3.4  |  <a name="changelog-shadow-manager-2.3.4"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/shadow-manager-component.html)  | 
|  2.3.3  | Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. | 
|  2.3.2  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.3.1  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.3.0  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.2.4  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  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  |  <a name="changelog-shadow-manager-2.2.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/shadow-manager-component.html)  | 
|  2.1.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/shadow-manager-component.html)  | 
|  2.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/shadow-manager-component.html)  | 
|  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  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/shadow-manager-component.html)  | 
|  2.0.3  |  Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis.  | 
|  2.0.2  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/shadow-manager-component.html)  | 
|  2.0.1  |  Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0.  | 
|  2.0.0  |  Versi awal.  |