翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# シャドウマネージャー
<a name="shadow-manager-component"></a>

シャドウマネージャーコンポーネント (`aws.greengrass.ShadowManager`) を使用すると、コアデバイスでローカルシャドウサービスを有効にできます。ローカルシャドウサービスを使用すると、コンポーネントはプロセス間通信を使用して[ローカルシャドウとやり取りする](ipc-local-shadows.md)ことができます。シャドウマネージャーコンポーネントは、ローカルシャドウドキュメントのストレージを管理し、ローカルシャドウ状態の AWS IoT Device Shadow サービスとの同期も処理します。

Greengrass コアデバイスがシャドウとやり取りする方法の詳細については、「[デバイスシャドウとやり取り](interact-with-shadows.md)」を参照してください。

**Topics**
+ [バージョン](#shadow-manager-component-versions)
+ [タイプ](#shadow-manager-component-type)
+ [オペレーティングシステム](#shadow-manager-component-os-support)
+ [要件](#shadow-manager-component-requirements)
+ [依存関係](#shadow-manager-component-dependencies)
+ [設定](#shadow-manager-component-configuration)
+ [ローカルログファイル](#shadow-manager-component-log-file)
+ [変更ログ](#shadow-manager-component-changelog)

## バージョン
<a name="shadow-manager-component-versions"></a>

このコンポーネントには、次のバージョンがあります。
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2.0.x

## タイプ
<a name="shadow-manager-component-type"></a>

<a name="public-component-type-plugin-para1"></a>このコンポーネントはプラグインコンポーネント (`aws.greengrass.plugin`) です。[Greengrass nucleus](greengrass-nucleus-component.md) は、nucleus と同じ Java バーチャルマシン (JVM) でこのコンポーネントを実行します。コアデバイスでこのコンポーネントのバージョンを変更するとき、nucleus が再起動します。

<a name="public-component-type-plugin-para2"></a>このコンポーネントは、Greengrass nucleus と同じログファイルを使用します。詳細については、「[AWS IoT Greengrass ログのモニタリング](monitor-logs.md)」を参照してください。

<a name="public-component-type-more-information"></a>詳細については、「[コンポーネントタイプ](develop-greengrass-components.md#component-types)」を参照してください。

## オペレーティングシステム
<a name="shadow-manager-component-os-support"></a>

このコンポーネントは、次のオペレーティングシステムを実行するコアデバイスにインストールできます。
+ Linux
+ Server 

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

このコンポーネントには次の要件があります。
+ (オプション) シャドウを AWS IoT Device Shadow サービスに同期するには、Greengrass AWS IoT Core コアデバイスの AWS IoT ポリシーで次のシャドウポリシーアクションを許可する必要があります。
  + `iot:GetThingShadow`
  + `iot:UpdateThingShadow`
  + `iot:DeleteThingShadow`

  これらの AWS IoT Core ポリシーの詳細については、「 *AWS IoT デベロッパーガイド*」の[AWS IoT Core 「ポリシーアクション](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policy-actions.html)」を参照してください。

  最小 AWS IoT ポリシーの詳細については、「」を参照してください。 [AWS IoT Greengrass V2 コアデバイスの最小 AWS IoT ポリシー](device-auth.md#greengrass-core-minimal-iot-policy)
+ シャドウマネージャーコンポーネントは、VPC で実行できるようにサポートされています。

## 依存関係
<a name="shadow-manager-component-dependencies"></a>

コンポーネントをデプロイすると、 は互換性のあるバージョンの依存関係 AWS IoT Greengrass もデプロイします。つまり、コンポーネントを正常にデプロイするには、コンポーネントとその依存関係のすべての要件を満たす必要があります。このセクションでは、このコンポーネントの[リリースされたバージョン](#shadow-manager-component-changelog)の依存関係と、各依存関係に対するコンポーネントのバージョンを定義するセマンティックバージョン制約をリスト表示しています。コンポーネントの各バージョンの依存関係は、[AWS IoT Greengrass コンソール](https://console.aws.amazon.com//greengrass)でも確認できます。コンポーネントの詳細ページで **[Dependencies]** (依存関係) リストを確認します。

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

次の表に、このコンポーネントのバージョン 2.3.13 の依存関係を示します。


| 依存関係 | 互換性のあるバージョン | 依存関係タイプ | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.5.0 <2.17.0 | ソフト | 

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

次の表に、このコンポーネントのバージョン 2.3.12 の依存関係を示します。


| 依存関係 | 互換性のあるバージョン | 依存関係タイプ | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.5.0 <2.17.0 | ソフト | 

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

次の表に、このコンポーネントのバージョン 2.3.11 の依存関係を示します。


| 依存関係 | 互換性のあるバージョン | 依存関係タイプ | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.5.0 <2.16.0 | ソフト | 

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

次の表に、このコンポーネントのバージョン 2.3.10 の依存関係を示します。


| 依存関係 | 互換性のあるバージョン | 依存関係タイプ | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.5.0 <2.15.0 | ソフト | 

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

次の表に、このコンポーネントのバージョン 2.3.9 の依存関係を示します。


| 依存関係 | 互換性のあるバージョン | 依存関係タイプ | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.5.0 <2.14.0 | ソフト | 

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

次の表に、このコンポーネントのバージョン 2.3.5 から 2.3.8 までの依存関係を示します。


| 依存関係 | 互換性のあるバージョン | 依存関係タイプ | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.5.0 <2.13.0 | ソフト | 

------
#### [ 2.3.3 and 2.3.4 ]

次の表に、このコンポーネントのバージョン 2.3.3 および 2.3.4 の依存関係を示します。


| 依存関係 | 互換性のあるバージョン | 依存関係タイプ | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.5.0 <2.12.0 | ソフト | 

------
#### [ 2.3.2 ]

次の表に、このコンポーネントのバージョン 2.3.2 の依存関係を示します。


| 依存関係 | 互換性のあるバージョン | 依存関係タイプ | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.5.0 <2.11.0 | ソフト | 

------
#### [ 2.3.0 and 2.3.1 ]

次の表に、このコンポーネントのバージョン 2.3.0 および 2.3.1 の依存関係を示します。


| 依存関係 | 互換性のあるバージョン | 依存関係タイプ | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.5.0 <2.10.0 | ソフト | 

------
#### [ 2.2.3 and 2.2.4 ]

次の表に、このコンポーネントのバージョン 2.2.3 および 2.2.4 の依存関係を示します。


| 依存関係 | 互換性のあるバージョン | 依存関係タイプ | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.2.0 <3.0.0 | ソフト | 

------
#### [ 2.2.2 ]

次の表に、このコンポーネントのバージョン 2.2.2 の依存関係を示します。


| 依存関係 | 互換性のあるバージョン | 依存関係タイプ | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.2.0 <2.9.0 | ソフト | 

------
#### [ 2.2.1 ]

次の表に、このコンポーネントのバージョン 2.2.1 の依存関係を示します。


| 依存関係 | 互換性のあるバージョン | 依存関係タイプ | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.2.0 <2.8.0 | ソフト | 

------
#### [ 2.1.1 and 2.2.0 ]

次の表に、このコンポーネントのバージョン 2.1.1 および 2.2.0 の依存関係を示します。


| 依存関係 | 互換性のあるバージョン | 依存関係タイプ | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.2.0 <2.7.0 | ソフト | 

------
#### [ 2.0.5 - 2.1.0 ]

次の表に、このコンポーネントのバージョン 2.0.5 から 2.1.0 までの依存関係を示します。


| 依存関係 | 互換性のあるバージョン | 依存関係タイプ | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.2.0 <2.6.0 | ソフト | 

------
#### [ 2.0.3 and 2.0.4 ]

次の表に、このコンポーネントのバージョン 2.0.3 および 2.0.4 の依存関係を示します。


| 依存関係 | 互換性のあるバージョン | 依存関係タイプ | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.2.0 <2.5.0 | ソフト | 

------
#### [ 2.0.1 and 2.0.2 ]

次の表に、このコンポーネントのバージョン 2.0.1 および 2.0.2 の依存関係を示します。


| 依存関係 | 互換性のあるバージョン | 依存関係タイプ | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.2.0 <2.4.0 | ソフト | 

------
#### [ 2.0.0 ]

次の表に、このコンポーネントのバージョン 2.0.0 の依存関係を示します。


| 依存関係 | 互換性のあるバージョン | 依存関係タイプ | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.2.0 <2.3.0 | ソフト | 

------

コンポーネントの依存関係の詳細については、「[コンポーネント recipe のリファレンス](component-recipe-reference.md#recipe-reference-component-dependencies)」を参照してください。

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

このコンポーネントには、コンポーネントのデプロイ時にカスタマイズできる次の設定パラメータが用意されています。

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

`strategy`  <a name="shadow-manager-component-configuration-strategy"></a>
(オプション) このコンポーネントが AWS IoT Core とコアデバイスの間でシャドウを同期するために使用する戦略。  
このオブジェクトには、次の情報が含まれます。    
`type`  
(オプション) このコンポーネントが AWS IoT Core とコアデバイス間でシャドウを同期させるために使用する戦略のタイプ。次のオプションから選択します。  
+ `realTime` – シャドウの更新が発生する AWS IoT Core たびに、シャドウを と同期します。
+ `periodic` – `delay`設定パラメータ AWS IoT Core で指定した定期的な間隔でシャドウを と同期します。
デフォルト: `realTime`  
`delay`  
(オプション) `periodic` 同期戦略を指定した場合に、このコンポーネントがシャドウを AWS IoT Coreと同期する間隔 (秒単位)。  
`periodic` 同期戦略を指定する場合、このパラメータは必須です。

`synchronize`  <a name="shadow-manager-component-configuration-synchronize"></a>
<a name="shadow-manager-component-configuration-strategy-description"></a>(オプション) シャドウを AWS クラウドと同期する方法を決定する同期設定。  
シャドウを AWS クラウドと同期させるには、このプロパティを使用して設定アップデートを作成する必要があります。
このオブジェクトには、次の情報が含まれます。    
`coreThing`  <a name="shadow-manager-component-configuration-synchronize-core-thing"></a>
(オプション) 同期するコアデバイスシャドウ。このオブジェクトには、次の情報が含まれます。    
`classic`  
(オプション) デフォルトでは、シャドウマネージャーはコアデバイスのクラシックシャドウのローカル状態を AWS クラウドと同期させます。クラシックデバイスシャドウを同期しない場合は、これを `false` に設定します。  
デフォルト: `true`  
`namedShadows`  
(オプション) 同期する名前付きコアデバイスシャドウのリスト。シャドウの正確な名前を指定する必要があります。  
この AWS IoT Greengrass サービスは、`AWSManagedGreengrassV2Deployment`名前付きシャドウを使用して、個々のコアデバイスをターゲットとするデプロイを管理します。この名前付きシャドウは、 AWS IoT Greengrass サービスで使用するために予約されています。この名前付きシャドウを更新または削除しないでください。  
`shadowDocumentsMap`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents-map"></a>
(オプション) 同期する追加のデバイスシャドウ。この構成パラメータを使用すると、シャドウドキュメントの指定が簡単になります。`shadowDocuments` オブジェクトの代わりに、このパラメータを使用することをお勧めします。  
`shadowDocumentsMap` オブジェクトを指定する場合は、`shadowDocuments` オブジェクトを指定しないでください。
各オブジェクトには、次の情報が含まれます:    
*`thingName`*  
このシャドウ構成の *[thingName]* のシャドウ設定。    
`classic`  
(オプション) `thingName` デバイスのクラシックデバイスシャドウを同期しない場合は、これを `false` に設定します。  
`namedShadows`  
同期する名前付きシャドウのリスト。シャドウの正確な名前を指定する必要があります。  
`shadowDocuments`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents"></a>
(オプション) 同期する追加のデバイスシャドウのリスト。代わりに `shadowDocumentsMap` パラメータを使用することをお勧めします。  
`shadowDocuments` オブジェクトを指定する場合は、`shadowDocumentsMap` オブジェクトを指定しないでください。
このリストの各オブジェクトには、次の情報が含まれます。    
`thingName`  
シャドウを同期するデバイスのモノの名前。  
`classic`  
(オプション) `thingName` デバイスのクラシックデバイスシャドウを同期しない場合は、これを `false` に設定します。  
デフォルト: `true`  
`namedShadows`  
(オプション) 同期する名前付きデバイスシャドウのリスト。シャドウの正確な名前を指定する必要があります。  
`direction`  
(オプション) ローカルシャドウサービスと AWS クラウドの間でシャドウを同期させる方向。このオプションを設定すると、 AWS クラウドへの帯域幅と接続数を低減できます。次のオプションから選択します。  
+ `betweenDeviceAndCloud` – ローカルシャドウサービスと AWS クラウドを同期させる。
+ `deviceToCloud` – ローカルシャドウサービスから にシャドウ更新を送信し AWS クラウド、 からシャドウ更新を無視します AWS クラウド。
+ `cloudToDevice` – AWS クラウドからシャドウアップデートを受信し、ローカルシャドウサービスから AWS クラウドにシャドウアップデートを送信しない。
デフォルト: `BETWEEN_DEVICE_AND_CLOUD`

`rateLimits`  <a name="shadow-manager-component-configuration-rate-limits"></a>
(オプション) シャドウサービス要求のレート制限を決定する設定。  
このオブジェクトには、次の情報が含まれます。    
`maxOutboundSyncUpdatesPerSecond`  
(オプション) デバイスが送信する 1 秒あたりの同期要求の最大数。  
デフォルト: 100 要求/秒  
`maxTotalLocalRequestsRate`  
(オプション) コアデバイスに送信される 1 秒あたりのローカル IPC 要求の最大数。  
デフォルト: 200 要求/秒  
`maxLocalRequestsPerSecondPerThing`  
(オプション) 接続された IoT モノごとに送信される 1 秒あたりのローカル IPC 要求の最大数。  
デフォルト: 1 件につき 20 要求/秒
これらのレート制限パラメータは、ローカルシャドウサービスの 1 秒あたりの最大要求数を定義します。 AWS IoT Device Shadow サービスに対する 1 秒あたりのリクエストの最大数は、 によって異なります AWS リージョン。詳細については、「*Amazon Web Services 全般のリファレンス*」の「[AWS IoT Device Shadow Service API](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits)」の制限を参照してください。

`shadowDocumentSizeLimitBytes`  <a name="shadow-manager-component-configuration-shadow-document-size-limit-bytes"></a>
(オプション) ローカルシャドウの各 JSON 状態ドキュメントの最大許容サイズ。  
この値を大きくすると、クラウドシャドウの JSON 状態ドキュメントのリソース制限も増やす必要があります。詳細については、「*Amazon Web Services 全般のリファレンス*」の「[AWS IoT Device Shadow Service API](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits)」の制限を参照してください。  
デフォルト: 8,192 バイト  
最大: 30720 バイト

**Example 例: 設定マージの更新**  
次の例は、シャドウマネージャーコンポーネントで利用可能なすべての設定パラメータを使用した設定マージ更新のサンプルを示しています。  

```
{
   "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>
(オプション) このコンポーネントが AWS IoT Core とコアデバイスの間でシャドウを同期するために使用する戦略。  
このオブジェクトには、次の情報が含まれます。    
`type`  
(オプション) このコンポーネントが AWS IoT Core とコアデバイス間でシャドウを同期させるために使用する戦略のタイプ。次のオプションから選択します。  
+ `realTime` – シャドウの更新が発生する AWS IoT Core たびに、シャドウを と同期します。
+ `periodic` – `delay`設定パラメータ AWS IoT Core で指定した定期的な間隔でシャドウを と同期します。
デフォルト: `realTime`  
`delay`  
(オプション) `periodic` 同期戦略を指定した場合に、このコンポーネントがシャドウを AWS IoT Coreと同期する間隔 (秒単位)。  
`periodic` 同期戦略を指定する場合、このパラメータは必須です。

`synchronize`  <a name="shadow-manager-component-configuration-synchronize"></a>
<a name="shadow-manager-component-configuration-strategy-description"></a>(オプション) シャドウを AWS クラウドと同期する方法を決定する同期設定。  
シャドウを AWS クラウドと同期させるには、このプロパティを使用して設定アップデートを作成する必要があります。
このオブジェクトには、次の情報が含まれます。    
`coreThing`  <a name="shadow-manager-component-configuration-synchronize-core-thing"></a>
(オプション) 同期するコアデバイスシャドウ。このオブジェクトには、次の情報が含まれます。    
`classic`  
(オプション) デフォルトでは、シャドウマネージャーはコアデバイスのクラシックシャドウのローカル状態を AWS クラウドと同期させます。クラシックデバイスシャドウを同期しない場合は、これを `false` に設定します。  
デフォルト: `true`  
`namedShadows`  
(オプション) 同期する名前付きコアデバイスシャドウのリスト。シャドウの正確な名前を指定する必要があります。  
この AWS IoT Greengrass サービスは、`AWSManagedGreengrassV2Deployment`名前付きシャドウを使用して、個々のコアデバイスをターゲットとするデプロイを管理します。この名前付きシャドウは、 AWS IoT Greengrass サービスで使用するために予約されています。この名前付きシャドウを更新または削除しないでください。  
`shadowDocumentsMap`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents-map"></a>
(オプション) 同期する追加のデバイスシャドウ。この構成パラメータを使用すると、シャドウドキュメントの指定が簡単になります。`shadowDocuments` オブジェクトの代わりに、このパラメータを使用することをお勧めします。  
`shadowDocumentsMap` オブジェクトを指定する場合は、`shadowDocuments` オブジェクトを指定しないでください。
各オブジェクトには、次の情報が含まれます:    
*`thingName`*  
このシャドウ構成の *[thingName]* のシャドウ設定。    
`classic`  
(オプション) `thingName` デバイスのクラシックデバイスシャドウを同期しない場合は、これを `false` に設定します。  
`namedShadows`  
同期する名前付きシャドウのリスト。シャドウの正確な名前を指定する必要があります。  
`shadowDocuments`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents"></a>
(オプション) 同期する追加のデバイスシャドウのリスト。代わりに `shadowDocumentsMap` パラメータを使用することをお勧めします。  
`shadowDocuments` オブジェクトを指定する場合は、`shadowDocumentsMap` オブジェクトを指定しないでください。
このリストの各オブジェクトには、次の情報が含まれます。    
`thingName`  
シャドウを同期するデバイスのモノの名前。  
`classic`  
(オプション) `thingName` デバイスのクラシックデバイスシャドウを同期しない場合は、これを `false` に設定します。  
デフォルト: `true`  
`namedShadows`  
(オプション) 同期する名前付きデバイスシャドウのリスト。シャドウの正確な名前を指定する必要があります。  
`direction`  
(オプション) ローカルシャドウサービスと AWS クラウドの間でシャドウを同期させる方向。このオプションを設定すると、 AWS クラウドへの帯域幅と接続数を低減できます。次のオプションから選択します。  
+ `betweenDeviceAndCloud` – ローカルシャドウサービスと AWS クラウドを同期させる。
+ `deviceToCloud` – ローカルシャドウサービスから にシャドウ更新を送信し AWS クラウド、 からシャドウ更新を無視します AWS クラウド。
+ `cloudToDevice` – AWS クラウドからシャドウアップデートを受信し、ローカルシャドウサービスから AWS クラウドにシャドウアップデートを送信しない。
デフォルト: `BETWEEN_DEVICE_AND_CLOUD`

`rateLimits`  <a name="shadow-manager-component-configuration-rate-limits"></a>
(オプション) シャドウサービス要求のレート制限を決定する設定。  
このオブジェクトには、次の情報が含まれます。    
`maxOutboundSyncUpdatesPerSecond`  
(オプション) デバイスが送信する 1 秒あたりの同期要求の最大数。  
デフォルト: 100 要求/秒  
`maxTotalLocalRequestsRate`  
(オプション) コアデバイスに送信される 1 秒あたりのローカル IPC 要求の最大数。  
デフォルト: 200 要求/秒  
`maxLocalRequestsPerSecondPerThing`  
(オプション) 接続された IoT モノごとに送信される 1 秒あたりのローカル IPC 要求の最大数。  
デフォルト: 1 件につき 20 要求/秒
これらのレート制限パラメータは、ローカルシャドウサービスの 1 秒あたりの最大要求数を定義します。 AWS IoT Device Shadow サービスに対する 1 秒あたりのリクエストの最大数は、 によって異なります AWS リージョン。詳細については、「*Amazon Web Services 全般のリファレンス*」の「[AWS IoT Device Shadow Service API](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits)」の制限を参照してください。

`shadowDocumentSizeLimitBytes`  <a name="shadow-manager-component-configuration-shadow-document-size-limit-bytes"></a>
(オプション) ローカルシャドウの各 JSON 状態ドキュメントの最大許容サイズ。  
この値を大きくすると、クラウドシャドウの JSON 状態ドキュメントのリソース制限も増やす必要があります。詳細については、「*Amazon Web Services 全般のリファレンス*」の「[AWS IoT Device Shadow Service API](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits)」の制限を参照してください。  
デフォルト: 8,192 バイト  
最大: 30720 バイト

**Example 例: 設定マージの更新**  
次の例は、シャドウマネージャーコンポーネントで利用可能なすべての設定パラメータを使用した設定マージ更新のサンプルを示しています。  

```
{
   "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>
(オプション) このコンポーネントが AWS IoT Core とコアデバイスの間でシャドウを同期するために使用する戦略。  
このオブジェクトには、次の情報が含まれます。    
`type`  
(オプション) このコンポーネントが AWS IoT Core とコアデバイス間でシャドウを同期させるために使用する戦略のタイプ。次のオプションから選択します。  
+ `realTime` – シャドウの更新が発生する AWS IoT Core たびに、シャドウを と同期します。
+ `periodic` – `delay`設定パラメータ AWS IoT Core で指定した定期的な間隔でシャドウを と同期します。
デフォルト: `realTime`  
`delay`  
(オプション) `periodic` 同期戦略を指定した場合に、このコンポーネントがシャドウを AWS IoT Coreと同期する間隔 (秒単位)。  
`periodic` 同期戦略を指定する場合、このパラメータは必須です。

`synchronize`  <a name="shadow-manager-component-configuration-synchronize"></a>
<a name="shadow-manager-component-configuration-strategy-description"></a>(オプション) シャドウを AWS クラウドと同期する方法を決定する同期設定。  
シャドウを AWS クラウドと同期させるには、このプロパティを使用して設定アップデートを作成する必要があります。
このオブジェクトには、次の情報が含まれます。    
`coreThing`  <a name="shadow-manager-component-configuration-synchronize-core-thing"></a>
(オプション) 同期するコアデバイスシャドウ。このオブジェクトには、次の情報が含まれます。    
`classic`  
(オプション) デフォルトでは、シャドウマネージャーはコアデバイスのクラシックシャドウのローカル状態を AWS クラウドと同期させます。クラシックデバイスシャドウを同期しない場合は、これを `false` に設定します。  
デフォルト: `true`  
`namedShadows`  
(オプション) 同期する名前付きコアデバイスシャドウのリスト。シャドウの正確な名前を指定する必要があります。  
この AWS IoT Greengrass サービスは、`AWSManagedGreengrassV2Deployment`名前付きシャドウを使用して、個々のコアデバイスをターゲットとするデプロイを管理します。この名前付きシャドウは、 AWS IoT Greengrass サービスで使用するために予約されています。この名前付きシャドウを更新または削除しないでください。  
`shadowDocumentsMap`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents-map"></a>
(オプション) 同期する追加のデバイスシャドウ。この構成パラメータを使用すると、シャドウドキュメントの指定が簡単になります。`shadowDocuments` オブジェクトの代わりに、このパラメータを使用することをお勧めします。  
`shadowDocumentsMap` オブジェクトを指定する場合は、`shadowDocuments` オブジェクトを指定しないでください。
各オブジェクトには、次の情報が含まれます:    
*`thingName`*  
このシャドウ構成の *[thingName]* のシャドウ設定。    
`classic`  
(オプション) `thingName` デバイスのクラシックデバイスシャドウを同期しない場合は、これを `false` に設定します。  
`namedShadows`  
同期する名前付きシャドウのリスト。シャドウの正確な名前を指定する必要があります。  
`shadowDocuments`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents"></a>
(オプション) 同期する追加のデバイスシャドウのリスト。代わりに `shadowDocumentsMap` パラメータを使用することをお勧めします。  
`shadowDocuments` オブジェクトを指定する場合は、`shadowDocumentsMap` オブジェクトを指定しないでください。
このリストの各オブジェクトには、次の情報が含まれます。    
`thingName`  
シャドウを同期するデバイスのモノの名前。  
`classic`  
(オプション) `thingName` デバイスのクラシックデバイスシャドウを同期しない場合は、これを `false` に設定します。  
デフォルト: `true`  
`namedShadows`  
(オプション) 同期する名前付きデバイスシャドウのリスト。シャドウの正確な名前を指定する必要があります。

`rateLimits`  <a name="shadow-manager-component-configuration-rate-limits"></a>
(オプション) シャドウサービス要求のレート制限を決定する設定。  
このオブジェクトには、次の情報が含まれます。    
`maxOutboundSyncUpdatesPerSecond`  
(オプション) デバイスが送信する 1 秒あたりの同期要求の最大数。  
デフォルト: 100 要求/秒  
`maxTotalLocalRequestsRate`  
(オプション) コアデバイスに送信される 1 秒あたりのローカル IPC 要求の最大数。  
デフォルト: 200 要求/秒  
`maxLocalRequestsPerSecondPerThing`  
(オプション) 接続された IoT モノごとに送信される 1 秒あたりのローカル IPC 要求の最大数。  
デフォルト: 1 件につき 20 要求/秒
これらのレート制限パラメータは、ローカルシャドウサービスの 1 秒あたりの最大要求数を定義します。 AWS IoT Device Shadow サービスに対する 1 秒あたりのリクエストの最大数は、 によって異なります AWS リージョン。詳細については、「*Amazon Web Services 全般のリファレンス*」の「[AWS IoT Device Shadow Service API](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits)」の制限を参照してください。

`shadowDocumentSizeLimitBytes`  <a name="shadow-manager-component-configuration-shadow-document-size-limit-bytes"></a>
(オプション) ローカルシャドウの各 JSON 状態ドキュメントの最大許容サイズ。  
この値を大きくすると、クラウドシャドウの JSON 状態ドキュメントのリソース制限も増やす必要があります。詳細については、「*Amazon Web Services 全般のリファレンス*」の「[AWS IoT Device Shadow Service API](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits)」の制限を参照してください。  
デフォルト: 8,192 バイト  
最大: 30720 バイト

**Example 例: 設定マージの更新**  
次の例は、シャドウマネージャーコンポーネントで利用可能なすべての設定パラメータを使用した設定マージ更新のサンプルを示しています。  

```
{
   "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>(オプション) シャドウを AWS クラウドと同期する方法を決定する同期設定。  
シャドウを AWS クラウドと同期させるには、このプロパティを使用して設定アップデートを作成する必要があります。
このオブジェクトには、次の情報が含まれます。    
`coreThing`  <a name="shadow-manager-component-configuration-synchronize-core-thing"></a>
(オプション) 同期するコアデバイスシャドウ。このオブジェクトには、次の情報が含まれます。    
`classic`  
(オプション) デフォルトでは、シャドウマネージャーはコアデバイスのクラシックシャドウのローカル状態を AWS クラウドと同期させます。クラシックデバイスシャドウを同期しない場合は、これを `false` に設定します。  
デフォルト: `true`  
`namedShadows`  
(オプション) 同期する名前付きコアデバイスシャドウのリスト。シャドウの正確な名前を指定する必要があります。  
この AWS IoT Greengrass サービスは、`AWSManagedGreengrassV2Deployment`名前付きシャドウを使用して、個々のコアデバイスをターゲットとするデプロイを管理します。この名前付きシャドウは、 AWS IoT Greengrass サービスで使用するために予約されています。この名前付きシャドウを更新または削除しないでください。  
`shadowDocumentsMap`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents-map"></a>
(オプション) 同期する追加のデバイスシャドウ。この構成パラメータを使用すると、シャドウドキュメントの指定が簡単になります。`shadowDocuments` オブジェクトの代わりに、このパラメータを使用することをお勧めします。  
`shadowDocumentsMap` オブジェクトを指定する場合は、`shadowDocuments` オブジェクトを指定しないでください。
各オブジェクトには、次の情報が含まれます:    
*`thingName`*  
このシャドウ構成の *[thingName]* のシャドウ設定。    
`classic`  
(オプション) `thingName` デバイスのクラシックデバイスシャドウを同期しない場合は、これを `false` に設定します。  
`namedShadows`  
同期する名前付きシャドウのリスト。シャドウの正確な名前を指定する必要があります。  
`shadowDocuments`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents"></a>
(オプション) 同期する追加のデバイスシャドウのリスト。代わりに `shadowDocumentsMap` パラメータを使用することをお勧めします。  
`shadowDocuments` オブジェクトを指定する場合は、`shadowDocumentsMap` オブジェクトを指定しないでください。
このリストの各オブジェクトには、次の情報が含まれます。    
`thingName`  
シャドウを同期するデバイスのモノの名前。  
`classic`  
(オプション) `thingName` デバイスのクラシックデバイスシャドウを同期しない場合は、これを `false` に設定します。  
デフォルト: `true`  
`namedShadows`  
(オプション) 同期する名前付きデバイスシャドウのリスト。シャドウの正確な名前を指定する必要があります。

`rateLimits`  <a name="shadow-manager-component-configuration-rate-limits"></a>
(オプション) シャドウサービス要求のレート制限を決定する設定。  
このオブジェクトには、次の情報が含まれます。    
`maxOutboundSyncUpdatesPerSecond`  
(オプション) デバイスが送信する 1 秒あたりの同期要求の最大数。  
デフォルト: 100 要求/秒  
`maxTotalLocalRequestsRate`  
(オプション) コアデバイスに送信される 1 秒あたりのローカル IPC 要求の最大数。  
デフォルト: 200 要求/秒  
`maxLocalRequestsPerSecondPerThing`  
(オプション) 接続された IoT モノごとに送信される 1 秒あたりのローカル IPC 要求の最大数。  
デフォルト: 1 件につき 20 要求/秒
これらのレート制限パラメータは、ローカルシャドウサービスの 1 秒あたりの最大要求数を定義します。 AWS IoT Device Shadow サービスに対する 1 秒あたりのリクエストの最大数は、 によって異なります AWS リージョン。詳細については、「*Amazon Web Services 全般のリファレンス*」の「[AWS IoT Device Shadow Service API](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits)」の制限を参照してください。

`shadowDocumentSizeLimitBytes`  <a name="shadow-manager-component-configuration-shadow-document-size-limit-bytes"></a>
(オプション) ローカルシャドウの各 JSON 状態ドキュメントの最大許容サイズ。  
この値を大きくすると、クラウドシャドウの JSON 状態ドキュメントのリソース制限も増やす必要があります。詳細については、「*Amazon Web Services 全般のリファレンス*」の「[AWS IoT Device Shadow Service API](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits)」の制限を参照してください。  
デフォルト: 8,192 バイト  
最大: 30720 バイト

**Example 例: 設定マージの更新**  
次の例は、シャドウマネージャーコンポーネントで利用可能なすべての設定パラメータを使用した設定マージ更新のサンプルを示しています。  

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

------

## ローカルログファイル
<a name="shadow-manager-component-log-file"></a>

このコンポーネントは、[Greengrass nucleus](greengrass-nucleus-component.md) コンポーネントと同じログファイルを使用します。

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

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

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

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

------

**このコンポーネントのログを確認するには**
+ コアデバイスに次のコマンドを実行して、このコンポーネントのログファイルをリアルタイムに確認します。`/greengrass/v2` または *C:\$1greengrass\$1v2* を AWS IoT Greengrass ルートフォルダへのパスに置き換えます。

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

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

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

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

------

## 変更ログ
<a name="shadow-manager-component-changelog"></a>

次の表は、コンポーネントの各バージョンにおける変更を示します。


|  バージョン  |  変更  | 
| --- | --- | 
|  2.3.13  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.3.12  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.3.11  | Greengrass nucleus バージョン 2.15.0 リリース用にバージョンが更新されました。 | 
|  2.3.10  | Greengrass nucleus バージョン 2.14.0 リリース用にバージョンが更新されました。 | 
|  2.3.9  | Greengrass nucleus バージョン 2.13.0 のリリース用にバージョンが更新されました。 | 
|  2.3.8  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.3.7  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.3.6  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.3.5  | Greengrass nucleus バージョン 2.12.0 のリリース用にバージョンが更新されました。 | 
|  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/ja_jp/greengrass/v2/developerguide/shadow-manager-component.html)  | 
|  2.3.3  | Greengrass nucleus バージョン 2.11.0 のリリース用にバージョンが更新されました。 | 
|  2.3.2  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.3.1  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.3.0  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.2.4  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.2.3  | Greengrass nucleus バージョン 2.9.0 のリリース用にバージョンが更新されました。 | 
|  2.2.2  | Greengrass nucleus バージョン 2.8.0 のリリース用にバージョンが更新されました。 | 
|  2.2.1  |  Greengrass nucleus バージョン 2.7.0 のリリース用にバージョンが更新されました。  | 
|  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/ja_jp/greengrass/v2/developerguide/shadow-manager-component.html)  | 
|  2.1.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/greengrass/v2/developerguide/shadow-manager-component.html)  | 
|  2.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/greengrass/v2/developerguide/shadow-manager-component.html)  | 
|  2.0.6  |  このバージョンには、バグ修正と機能向上が含まれています。  | 
|  2.0.5  |  Greengrass nucleus バージョン 2.5.0 のリリース用にバージョンが更新されました。  | 
|  2.0.4  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/greengrass/v2/developerguide/shadow-manager-component.html)  | 
|  2.0.3  |  Greengrass nucleus バージョン 2.4.0 のリリース用にバージョンが更新されました。  | 
|  2.0.2  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/greengrass/v2/developerguide/shadow-manager-component.html)  | 
|  2.0.1  |  Greengrass nucleus バージョン 2.3.0 のリリース用にバージョンが更新されました。  | 
|  2.0.0  |  当初のバージョン  |