

サポート終了通知: 2026 年 10 月 7 日、 AWS はサポートを終了します AWS IoT Greengrass Version 1。2026 年 10 月 7 日以降、 AWS IoT Greengrass V1 リソースにアクセスできなくなります。詳細については、[「 からの移行 AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html)」を参照してください。

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

# AWS IoT Greengrass ストリームマネージャーを設定する
<a name="configure-stream-manager"></a>

ストリームマネージャーは、 AWS IoT Greengrass IoT デバイスデータを保存、処理、エクスポートできます。ストリームマネージャーは、グループレベルのランタイム設定を設定するために使用するパラメータを提供します。これらの設定は、Greengrass コアのすべてのストリームに適用されます。 AWS IoT コンソールまたは AWS IoT Greengrass API を使用して、ストリームマネージャーの設定を構成できます。変更は、グループがデプロイされた後に有効になります。

**注記**  
ストリームマネージャーを設定したら、作成した IoT アプリケーションをデプロイし、Greengrass Core で実行してストリームマネージャーとやり取りすることができます。通常このような IoT アプリケーションは、ユーザー定義の Lambda 関数です。詳細については、「[ストリームを操作するために StreamManagerClient を使用する](work-with-streams.md)」を参照してください。

## ストリームマネージャーのパラメータ
<a name="stream-manager-parameters"></a>

ストリームマネージャーは、グループレベルの設定を定義するための次のパラメータを提供します。すべてのパラメータは省略可能です。

**[Storage directory]** (ストレージディレクトリ)  <a name="STREAM_MANAGER_STORE_ROOT_DIR"></a>
パラメータ名: `STREAM_MANAGER_STORE_ROOT_DIR`  
ストリームを保存するために使用されるローカルディレクトリの絶対パス。この値は、スラッシュ (`/data` など) で開始する必要があります。  
ストリームデータのセキュリティ保護については、「[ローカルデータセキュリティ](stream-manager.md#stream-manager-security-stream-data)」を参照してください。  
最小 AWS IoT Greengrass Core バージョン: 1.10.0

**Server port**  
パラメータ名: `STREAM_MANAGER_SERVER_PORT`  
ストリームマネージャーとの通信に使用されるローカルポート番号。デフォルトは `8088` です。  
最小 AWS IoT Greengrass Core バージョン: 1.10.0

**クライアントを認証する**  <a name="STREAM_MANAGER_AUTHENTICATE_CLIENT"></a>
パラメータ名: `STREAM_MANAGER_AUTHENTICATE_CLIENT`  
ストリームマネージャーと対話するためにクライアントを認証する必要があるかどうかを示します。クライアントとストリームマネージャー間のすべてのやり取りは、 AWS IoT Greengrass Core SDK によって制御されます。このパラメータは、ストリームを操作するために AWS IoT Greengrass Core SDK を呼び出すことができるクライアントを決定します。詳細については、「[クライアント承認](stream-manager.md#stream-manager-security-client-authentication)」を参照してください。  
有効な値は `true` または `false` です。デフォルトは `true` (推奨) です。  
+ `true`。Greengrass Lambda 関数のみをクライアントとして許可します。Lambda 関数クライアントは、内部 AWS IoT Greengrass コアプロトコルを使用して AWS IoT Greengrass Core SDK で認証します。
+ `false`。 AWS IoT Greengrass コアで実行されるすべてのプロセスをクライアントに許可します。ビジネスケースで要求されない限り、`false` に設定しないでください。例えば、Core デバイスの非 Lambda プロセスがストリームマネージャと直接通信する必要がある (コアで動作する [Docker コンテナ](docker-app-connector.md)のような) 場合にのみ、この値を `false` に設定します。
最小 AWS IoT Greengrass Core バージョン: 1.10.0

**最大帯域幅**  
パラメータ名: `STREAM_MANAGER_EXPORTER_MAX_BANDWIDTH`  
データのエクスポートに使用できる平均最大帯域幅 (キロビット/秒)。デフォルトでは、使用可能な帯域幅を無制限に使用することができます。  
最小 AWS IoT Greengrass Core バージョン: 1.10.0

**スレッドプールサイズ**  
パラメータ名: `STREAM_MANAGER_EXPORTER_THREAD_POOL_SIZE`  
データのエクスポートに使用できるアクティブなスレッドの最大数。デフォルトは `5` です。  
最適なサイズは、ハードウェア、ストリームボリューム、予定されているエクスポートストリームの数によって異なります。エクスポート速度が遅い場合は、この設定を調整して、ハードウェアとビジネスケースに最適なサイズを見つけることができます。コアデバイスハードウェアの CPU とメモリは、制限要因です。開始するには、この値をデバイスのプロセッサコアの数と同じ値に設定してみてください。  
ハードウェアがサポートできるサイズよりも大きいサイズを設定しないように注意してください。各ストリームはハードウェアリソースを消費するため、制約のあるデバイス上のエクスポートストリームの数を制限する必要があります。  
最小 AWS IoT Greengrass Core バージョン: 1.10.0

**JVM の引数**  
パラメータ名: `JVM_ARGS`  
起動時にストリームマネージャーに渡すカスタム Java 仮想マシン引数。複数の引数はスペースで区切る必要があります。  
このパラメータは、JVM で使用されるデフォルト設定を上書きする必要がある場合にのみ使用します。例えば、大量のストリームをエクスポートする場合は、デフォルトのヒープサイズを大きくする必要があります。  
最小 AWS IoT Greengrass Core バージョン: 1.10.0

**[Read-only input file directories]** (読み取り専用入力ファイルディレクトリ)  <a name="stream-manager-read-only-directories"></a>
パラメータ名: `STREAM_MANAGER_READ_ONLY_DIRS`  
入力ファイルを格納するルートファイルシステム外のディレクトリを指す絶対パスを、カンマで区切ったリスト。ストリームマネージャーは、読み込んだファイルを Amazon S3 にアップロードし、ディレクトリを読み取り専用でマウントします。Amazon S3 へのエクスポートの詳細については、「[Amazon S3 オブジェクト](stream-export-configurations.md#export-to-s3)」を参照してください。  
このパラメータは、次の条件に当てはまる場合にのみ使用してください。  
+ ストリームを介して Amazon S3 にエクスポートする入力ファイルディレクトリが、次のいずれかの場所にある。
  + ルートファイルシステム以外のパーティション。
  + ルートファイルシステム配下の `/tmp`。
+ Greengrass グループの[デフォルトのコンテナ化](lambda-group-config.md#lambda-containerization-groupsettings)が **[Greengrass container]** (Greengrass コンテナ) である。
値の例: `/mnt/directory-1,/mnt/directory-2,/tmp`  
最小 AWS IoT Greengrass Core バージョン: 1.11.0

**マルチパートアップロードの最小サイズ**  <a name="stream-manager-minimum-part-size"></a>
パラメータ名: `STREAM_MANAGER_EXPORTER_S3_DESTINATION_MULTIPART_UPLOAD_MIN_PART_SIZE_BYTES`  
Amazon S3 へのマルチパートアップロードにおけるパートの最小サイズ (バイト単位)。ストリームマネージャーはこの設定と入力ファイルのサイズを基に、マルチパート PUT リクエストのデータをバッチ処理する方法を決定します。デフォルトの最小値は `5242880` バイト (5 MB) です。  
ストリームマネージャーはストリームの `sizeThresholdForMultipartUploadBytes` プロパティを基に、Amazon S3 へのエクスポートをシングルアップロードで行うか、マルチパートアップロードで行うかを決定します。ユーザー定義の Lambda 関数は、Amazon S3 にエクスポートするストリームを作成する際にこのしきい値を設定します。デフォルトのしきい値は 5 MB です。
最小 AWS IoT Greengrass Core バージョン: 1.11.0

## ストリームマネージャーの設定 (コンソール)
<a name="configure-stream-manager-console"></a>

 AWS IoT コンソールは、次の管理タスクに使用できます。
+ [ストリームマネージャーが有効になっているかどうかを確認する](#check-stream-manager-console)
+ [グループ作成時のストリームマネージャーを有効または無効にする](#enable-stream-manager-console-new-group)
+ [既存のグループのストリームマネージャーを有効または無効にする](#enable-stream-manager-console-existing-group)
+ [ストリームマネージャー設定の変更](#change-stream-manager-console)

変更は、Greengrass グループがデプロイされた後に有効になります。ストリームマネージャーとの通信に使用する Lambda 関数が格納された Greengrass グループを、チュートリアル形式でデプロイする方法については、「[データストリームを にエクスポートする AWS クラウド (コンソール)](stream-manager-console.md)」を参照してください。

**注記**  <a name="ggstreammanager-function-config-console"></a>
コンソールを使用してストリームマネージャーを有効にし、グループをデプロイすると、ストリームマネージャーのメモリサイズはデフォルトで 4194304 KB (4 GB) に設定されます。メモリのサイズは 128000 KB 以上に設定することをお勧めします。

 

### ストリームマネージャーが有効になっているかどうかを確認するには (コンソール)
<a name="check-stream-manager-console"></a>

1. <a name="console-gg-groups"></a> AWS IoT コンソールナビゲーションペインの**「管理**」で **Greengrass デバイス**を展開し、**「グループ (V1)**」を選択します。

1. <a name="group-choose-target-group"></a>ターゲットグループを選択します。

1. **[Lambda functions]** (Lambda 関数) タブを選択します。

1. **[System Lambda functions]** (システム Lambda 関数) で、**[Stream manager]** (ストリームマネージャー)、**[Edit]** (編集) の順に選択します。

1. 有効または無効のステータスを確認します。設定されているカスタムストリームマネージャー設定も表示されます。

 

### グループの作成中にストリームマネージャーを有効または無効にするには (コンソール)
<a name="enable-stream-manager-console-new-group"></a>

1. <a name="console-gg-groups"></a> AWS IoT コンソールナビゲーションペインの**「管理**」で **Greengrass デバイス**を展開し、**「グループ (V1)**」を選択します。

1. **グループを作成** を選択します。次のページで選択すると、グループのストリームマネージャーの設定方法が決まります。

1. **[Name your Group]** (グループに名前を付ける) から **[Greengrass core]** (Greengrass コア) ページを選択します。

1. **[グループの作成]** を選択してください。

1. グループ設定ページで、**[Lambda functions]** (Lambda 関数) タブを選択し、**[Stream manager]** (ストリームマネージャー)、**[Edit]** (編集) の順に選択します。
   + デフォルト設定でストリームマネージャーを有効にするには、**[Use defaults]** (デフォルトを使用) を選択します。

      
   + カスタム設定でストリームマネージャーを有効にするには、[**Customize settings (設定をカスタマイズ)**] を選択します。

     1. **[Configure stream manager]** (ストリームマネージャーの設定) ページで、**[Enable with custom settings]** (カスタム設定で有効にする) を選択します。

     1. [**Custom settings (カスタム設定)**] で、ストリームマネージャーパラメータの値を入力します。詳細については、「[ストリームマネージャーのパラメータ](#stream-manager-parameters)」を参照してください。がデフォルト値を使用できるようにするには、フィールド AWS IoT Greengrass を空のままにします。

         
   + ストリームマネージャーを無効にするには、**[Disable]** (無効化) を選択します。

     1. [**Configure stream manager (ストリームマネージャーの設定)**] ページで、[**Disable (無効にする)**] を選択します。

         

1. **[保存]** を選択します。

1. <a name="continue-create-group"></a>残りのページに進み、グループを作成します。

1. **[Client devices]** (クライアントデバイス) ページで、セキュリティリソースをダウンロードし、情報を確認して、**[Finish]** (完了) を選択します。
**注記**  
ストリームマネージャーが有効になっている場合、グループをデプロイする前に、コアデバイスに [Java 8 ランタイムをインストールする](stream-manager.md#stream-manager-requirements)必要があります。

 

### 既存のグループのストリームマネージャーを有効または無効にするには (コンソール)
<a name="enable-stream-manager-console-existing-group"></a>

1. <a name="console-gg-groups"></a> AWS IoT コンソールナビゲーションペインの**「管理**」で **Greengrass デバイス**を展開し、**「グループ (V1)**」を選択します。

1. <a name="group-choose-target-group"></a>ターゲットグループを選択します。

1. **[Lambda functions]** (Lambda 関数) タブを選択します。

1. **[System Lambda functions]** (システム Lambda 関数) で、**[Stream manager]** (ストリームマネージャー)、**[Edit]** (編集) の順に選択します。

1. 有効または無効のステータスを確認します。設定されているカスタムストリームマネージャー設定も表示されます。

 

### ストリームマネージャーの設定を変更するには (コンソール)
<a name="change-stream-manager-console"></a>

1. <a name="console-gg-groups"></a> AWS IoT コンソールナビゲーションペインの**「管理**」で **Greengrass デバイス**を展開し、**「グループ (V1)**」を選択します。

1. <a name="group-choose-target-group"></a>ターゲットグループを選択します。

1. **[Lambda functions]** (Lambda 関数) タブを選択します。

1. **[System Lambda functions]** (システム Lambda 関数) で、**[Stream manager]** (ストリームマネージャー)、**[Edit]** (編集) の順に選択します。

1. 有効または無効のステータスを確認します。設定されているカスタムストリームマネージャー設定も表示されます。

1. **[保存]** を選択します。

## ストリームマネージャーの設定 (CLI)
<a name="configure-stream-manager-cli"></a>

で AWS CLI、システム `GGStreamManager` Lambda 関数を使用してストリームマネージャーを設定します。System Lambda 関数は AWS IoT Greengrass Core ソフトウェアのコンポーネントです。ストリームマネージャーおよびその他のシステム Lambda 関数の一部では、Greengrass の各種機能に対応する Greengrass グループの `Function` オブジェクトや `FunctionDefinitionVersion` オブジェクトを管理することで、Greengrass の機能を設定できます。詳細については、「[AWS IoT Greengrass グループオブジェクトモデルの概要](deployments.md#api-overview)」を参照してください。

API は以下の管理タスクに使用できます。このセクションの例では、 の使用方法を示していますが AWS CLI、 AWS IoT Greengrass API を直接呼び出すことも、 SDK AWS を使用することもできます。
+ [ストリームマネージャーが有効になっているかどうかを確認する](#check-stream-manager-cli)
+ [ストリームマネージャーの有効化、無効化、設定](#enable-stream-manager-cli)

変更は、グループがデプロイされた後に有効になります。ストリームマネージャーとのやり取りに使用する Lambda 関数が格納された Greengrass グループを、チュートリアル形式でデプロイする方法については、「[データストリームを AWS クラウド (CLI) にエクスポートする](stream-manager-cli.md)」を参照してください。

**ヒント**  
ストリームマネージャーが有効で実行されているかどうかを Core デバイスから確認するには、そのデバイスのターミナルで次のコマンドを実行します。  

```
ps aux | grep -i 'streammanager'
```

 

### ストリームマネージャーが有効になっているかどうかを確認するには (CLI)
<a name="check-stream-manager-cli"></a>

デプロイされた関数定義バージョンにシステム `GGStreamManager` Lambda 関数が含まれている場合、ストリームマネージャーが有効になります。確認するには、次の手順を実行します。

1. <a name="get-group-id-latestversion"></a>ターゲットの Greengrass グループとグループバージョンの ID を取得します。この手順では、これが最新のグループおよびグループのバージョンであると仮定します。次のクエリは、最後に作成されたグループを返します。

   ```
   aws greengrass list-groups --query "reverse(sort_by(Groups, &CreationTimestamp))[0]"
   ```

   または、名前でクエリを実行することもできます。グループ名は一意である必要はないため、複数のグループが返されることがあります。

   ```
   aws greengrass list-groups --query "Groups[?Name=='MyGroup']"
   ```
**注記**  
<a name="find-group-ids-console"></a>これらの値は AWS IoT コンソールでも確認できます。グループ ID は、グループの [**設定**] ページに表示されます。グループバージョン ID は、グループの **[デプロイ]** タブに表示されます。

1. <a name="copy-group-id-latestversion"></a>出力からターゲットグループの `Id` 値と `LatestVersion` 値をコピーします。

1. <a name="get-latest-group-version"></a>最新のグループバージョンを取得します。
   + *group-id* は、コピーした `Id` に置き換えます。
   + *latest-group-version-id* は、コピーした `LatestVersion` に置き換えます。

   ```
   aws greengrass get-group-version \
   --group-id group-id \
   --group-version-id latest-group-version-id
   ```

1. 出力の `FunctionDefinitionVersionArn` で、関数定義の ID と関数定義のバージョンを取得します。
   + 関数定義 ID は、Amazon リソースネーム (ARN) の `functions` セグメントに続く GUID です。
   + 関数定義のバージョン ID は、ARN の `versions` セグメントに続く GUID です。

   ```
   arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/function-definition-id/versions/function-definition-version-id
   ```

1. 関数定義バージョンの ID。
   + *function-definition-id* を関数定義 ID に置き換えます。
   + *function-definition-version-id* ID を関数定義バージョン ID に置き換えます。

   ```
   aws greengrass get-function-definition-version \
   --function-definition-id function-definition-id \
   --function-definition-version-id function-definition-version-id
   ```

出力内の `functions` 配列に `GGStreamManager` 関数が含まれている場合、ストリームマネージャーが有効になります。関数に定義された環境変数は、ストリームマネージャーのカスタム設定を表します。

### ストリームマネージャー (CLI) を有効化、無効化、設定するには
<a name="enable-stream-manager-cli"></a>

で AWS CLI、システム `GGStreamManager` Lambda 関数を使用してストリームマネージャーを設定します。変更は、グループをデプロイした後に有効になります。
+ ストリームマネージャーを有効にするには、関数定義バージョンの `functions` 配列に `GGStreamManager` を含めます。カスタム設定を設定するには、対応する[ストリームマネージャーのパラメータ](#stream-manager-parameters)の環境変数を定義します。
+ ストリームマネージャーを無効にするには、関数定義バージョンの `functions` 配列から `GGStreamManager` を削除します。

**デフォルト設定のストリームマネージャー**  
次の設定例では、デフォルト設定でストリームマネージャーを有効にします。任意の関数 ID を `streamManager` に設定します。  

```
{
    "FunctionArn": "arn:aws:lambda:::function:GGStreamManager:1",
    "FunctionConfiguration": {
        "MemorySize": 4194304,
        "Pinned": true,
        "Timeout": 3
    },
    "Id": "streamManager"
}
```
`FunctionConfiguration` プロパティについては、次の点に留意してください。  
+ `MemorySize` はデフォルト設定では 4194304 KB (4 GB) に設定されています。この値は、いつでも変更できます。`MemorySize` は 128000 KB 以上に設定することをお勧めします。
+ `Pinned` を `true` に設定する必要があります。
+ `Timeout` は関数定義バージョンで必要ですが、`GGStreamManager` は使用しません。

**カスタム設定のストリームマネージャー**  <a name="enable-stream-manager-custom-settings"></a>
以下の設定例では、ストレージディレクトリ、サーバーポート、スレッドプールサイズの各種パラメータにカスタム値を使用した上で、ストリームマネージャーを有効にします。  

```
{
    "FunctionArn": "arn:aws:lambda:::function:GGStreamManager:1",
    "FunctionConfiguration": {
        "Environment": {
            "Variables": {
                "STREAM_MANAGER_STORE_ROOT_DIR": "/data",
                "STREAM_MANAGER_SERVER_PORT": "1234",
                "STREAM_MANAGER_EXPORTER_THREAD_POOL_SIZE": "4"
            }
        },
        "MemorySize": 4194304,
        "Pinned": true,
        "Timeout": 3
    },
    "Id": "streamManager"
}
```
AWS IoT Greengrass は、環境変数として指定されていない[ストリームマネージャーパラメータ](#stream-manager-parameters)のデフォルト値を使用します。

**ストリームマネージャーに Amazon S3 のエクスポート用カスタム設定を適用する**  <a name="enable-stream-manager-custom-settings-s3"></a>
以下の設定例では、アップロードディレクトリやマルチポートアップロードの最小サイズにカスタム値を使用した上で、ストリームマネージャーを有効にします。  

```
{
    "FunctionArn": "arn:aws:lambda:::function:GGStreamManager:1",
    "FunctionConfiguration": {
        "Environment": {
            "Variables": {
                "STREAM_MANAGER_READ_ONLY_DIRS": "/mnt/directory-1,/mnt/directory-2,/tmp",
                "STREAM_MANAGER_EXPORTER_S3_DESTINATION_MULTIPART_UPLOAD_MIN_PART_SIZE_BYTES": "10485760"
            }
        },
        "MemorySize": 4194304,
        "Pinned": true,
        "Timeout": 3
    },
    "Id": "streamManager"
}
```

 

**ストリームマネージャー (CLI) を有効化、無効化、設定するには**

1. <a name="get-group-id-latestversion"></a>ターゲットの Greengrass グループとグループバージョンの ID を取得します。この手順では、これが最新のグループおよびグループのバージョンであると仮定します。次のクエリは、最後に作成されたグループを返します。

   ```
   aws greengrass list-groups --query "reverse(sort_by(Groups, &CreationTimestamp))[0]"
   ```

   または、名前でクエリを実行することもできます。グループ名は一意である必要はないため、複数のグループが返されることがあります。

   ```
   aws greengrass list-groups --query "Groups[?Name=='MyGroup']"
   ```
**注記**  
<a name="find-group-ids-console"></a>これらの値は AWS IoT コンソールでも確認できます。グループ ID は、グループの [**設定**] ページに表示されます。グループバージョン ID は、グループの **[デプロイ]** タブに表示されます。

1. <a name="copy-group-id-latestversion"></a>出力からターゲットグループの `Id` 値と `LatestVersion` 値をコピーします。

1. <a name="get-latest-group-version"></a>最新のグループバージョンを取得します。
   + *group-id* は、コピーした `Id` に置き換えます。
   + *latest-group-version-id* は、コピーした `LatestVersion` に置き換えます。

   ```
   aws greengrass get-group-version \
   --group-id group-id \
   --group-version-id latest-group-version-id
   ```

1. `CoreDefinitionVersionArn` と、その他の出力されたすべてのバージョン ARN をコピーします。ただし、`FunctionDefinitionVersionArn` は対象外です。上記の値は、後ほどグループバージョンを作成する時に使用します。

1. <a name="parse-function-def-id"></a>出力の `FunctionDefinitionVersionArn` から、関数定義の ID をコピーします。ID は、次の例に示すように、ARN の `functions` セグメントに続く GUID です。

   ```
   arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/bcfc6b49-beb0-4396-b703-6dEXAMPLEcu5/versions/0f7337b4-922b-45c5-856f-1aEXAMPLEsf6
   ```
**注記**  
または、[https://docs.aws.amazon.com/cli/latest/reference/greengrass/create-function-definition.html](https://docs.aws.amazon.com/cli/latest/reference/greengrass/create-function-definition.html) コマンドを実行して関数定義を作成し、出力から ID をコピーすることもできます。

1. <a name="enable-stream-manager-function-definition-version"></a>関数定義に関数定義バージョンを追加します。
   + *function-definition-id* は、コピーした関数定義の `Id` に置き換えます。
   + `functions` 配列には、Greengrass Core で使用できるようにする他のすべての関数を含めます。`get-function-definition-version` コマンドを使用して、既存の関数のリストを取得できます。

      
**デフォルト設定でストリームマネージャーを有効にする**  
次の例では、`functions` 配列に `GGStreamManager` 関数を含めることで、ストリームマネージャーを有効にします。この例では、[ストリームマネージャーのパラメータ](#stream-manager-parameters)にデフォルト値を使用します。  

   ```
   aws greengrass create-function-definition-version \
   --function-definition-id function-definition-id \
   --functions '[
           {
               "FunctionArn": "arn:aws:lambda:::function:GGStreamManager:1",
               "FunctionConfiguration": {
                   "MemorySize":  4194304,
                   "Pinned": true,
                   "Timeout": 3
               },
               "Id": "streamManager"
           },
           {    
               "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:MyLambdaFunction:MyAlias",
               "FunctionConfiguration": {
                   "Executable": "myLambdaFunction.function_handler",
                   "MemorySize": 16000,
                   "Pinned": true,
                   "Timeout": 5
               },
               "Id": "myLambdaFunction"
           },
           ... more user-defined functions
       ]
   }'
   ```
例の `myLambdaFunction` 関数は、ユーザー定義 Lambda 関数の 1 つを表します。  
**カスタム設定でストリームマネージャーを有効にする**  
次の例では、`functions` 配列に `GGStreamManager` 関数を含めることで、ストリームマネージャーを有効にします。デフォルト値を変更しない限り、すべてのストリームマネージャー設定はオプションです。この例では、環境変数を使用してカスタム値を設定する方法を示します。  

   ```
   aws greengrass create-function-definition-version \
   --function-definition-id function-definition-id \
   --functions '[
           {
               "FunctionArn": "arn:aws:lambda:::function:GGStreamManager:1",
               "FunctionConfiguration": {
                   "Environment": {
                       "Variables": {
                           "STREAM_MANAGER_STORE_ROOT_DIR": "/data",
                           "STREAM_MANAGER_SERVER_PORT": "1234",
                           "STREAM_MANAGER_EXPORTER_THREAD_POOL_SIZE": "4"
                       }
                   },
                   "MemorySize":  4194304,
                   "Pinned": true,
                   "Timeout": 3
               },
               "Id": "streamManager"
           },
           {    
               "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:MyLambdaFunction:MyAlias",
               "FunctionConfiguration": {
                   "Executable": "myLambdaFunction.function_handler",
                   "MemorySize": 16000,
                   "Pinned": true,
                   "Timeout": 5
               },
               "Id": "myLambdaFunction"
           },
           ... more user-defined functions
       ]
   }'
   ```
`FunctionConfiguration` プロパティについては、次の点に留意してください。  
   + `MemorySize` はデフォルト設定では 4194304 KB (4 GB) に設定されています。この値は、いつでも変更できます。`MemorySize` は 128000 KB 以上に設定することをお勧めします。
   + `Pinned` を `true` に設定する必要があります。
   + `Timeout` は関数定義バージョンで必要ですが、`GGStreamManager` は使用しません。  
**ストリームマネージャーを無効にする**  
次の例では、ストリームマネージャーを無効にする `GGStreamManager` 関数を省略しています。  

   ```
   aws greengrass create-function-definition-version \
   --function-definition-id function-definition-id \
   --functions '[
           {       
               "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:MyLambdaFunction:MyAlias",
               "FunctionConfiguration": {
                   "Executable": "myLambdaFunction.function_handler",
                   "MemorySize": 16000,
                   "Pinned": true,
                   "Timeout": 5
               },
               "Id": "myLambdaFunction"
           },
           ... more user-defined functions
       ]
   }'
   ```
Lambda 関数をデプロイしない場合は、関数定義バージョンを完全に省略できます。

1. <a name="copy-function-def-version-arn"></a>出力から関数定義バージョンの `Arn` をコピーします。

1. <a name="create-group-version-with-sys-lambda"></a>システムの Lambda 関数が含まれているグループバージョンを作成します。
   + *group-id* は、グループの `Id` に置き換えます。
   + *core-definition-version-arn* は、最新のグループバージョンからコピーした `CoreDefinitionVersionArn` に置き換えます。
   + *function-definition-version-arn* は、コピーした新しい関数定義バージョンの `Arn` に置き換えます。
   + 他のグループコンポーネントの ARN (`SubscriptionDefinitionVersionArn` や `DeviceDefinitionVersionArn` など) は、最新のグループバージョンからコピーしたものに置き換えます。
   + 使用されていないパラメータをすべて削除します。例えば、グループバージョンにリソースがない場合は、`--resource-definition-version-arn` を削除します。

   ```
   aws greengrass create-group-version \
   --group-id group-id \
   --core-definition-version-arn core-definition-version-arn \
   --function-definition-version-arn function-definition-version-arn \
   --device-definition-version-arn device-definition-version-arn \
   --logger-definition-version-arn logger-definition-version-arn \
   --resource-definition-version-arn resource-definition-version-arn \
   --subscription-definition-version-arn subscription-definition-version-arn
   ```

1. <a name="copy-group-version-id"></a>出力から `Version` をコピーします。これは新しいグループバージョンの ID です。

1. <a name="create-group-deployment"></a>新しいグループバージョンでグループをデプロイします。
   + *group-id* は、コピーしたグループの `Id` に置き換えます。
   + *group-version-id* は、コピーした新しいグループバージョンの `Version` に置き換えます。

   ```
   aws greengrass create-deployment \
   --group-id group-id \
   --group-version-id group-version-id \
   --deployment-type NewDeployment
   ```

 

ストリームマネージャーの設定を後でもう一度編集する場合は、この手順に沿って行ってください。これらの設定を更新するには、更新された設定の `GGStreamManager` 関数を含む関数定義バージョンを作成します。グループのバージョンは、コアにデプロイするすべてのコンポーネントバージョン ARN を参照する必要があります。変更は、グループがデプロイされた後に有効になります。

## 関連情報
<a name="configure-stream-manager-see-also"></a>
+ [AWS IoT Greengrass コアでデータストリームを管理する](stream-manager.md)
+ [ストリームを操作するために StreamManagerClient を使用する](work-with-streams.md)
+ [サポートされている AWS クラウド 送信先のエクスポート設定](stream-export-configurations.md)
+ [データストリームを にエクスポートする AWS クラウド (コンソール)](stream-manager-console.md)
+ [データストリームを AWS クラウド (CLI) にエクスポートする](stream-manager-cli.md)