サポート終了通知: 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)」を参照してください。

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

# IoT イーサネット IP プロトコルアダプタコネクタ
<a name="ethernet-ip-connector"></a>

IoT イーサネット IP プロトコルアダプタ[コネクタ](connectors.md)は、イーサネットプロトコルや IP プロトコルを使用してローカルデバイスからデータを収集します。このコネクタを使用して、複数のデバイスからデータを収集し、`StreamManager` メッセージストリームに発行できます。

このコネクタは、IoT SiteWise コネクタや IoT SiteWise ゲートウェイと共に使用することもできます。ゲートウェイは、コネクタの設定を提供する必要があります。詳細については、「IoT SiteWise ユーザーガイド」の「[Configure an Ethernet/IP (EIP) source](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-eip-source.html)」(イーサネット/IP (EIP) ソースを設定する) を参照してください。

**注記**  
このコネクタは[コンテナ分離なし](lambda-group-config.md#no-container-mode)モードで実行されるため、Docker コンテナで実行されている AWS IoT Greengrass グループにデプロイできます。

このコネクタには、次のバージョンがあります。


| バージョン | ARN | 
| --- | --- | 
| 2 (推奨) | `arn:aws:greengrass:{{region}}::/connectors/IoTEIPProtocolAdaptor/versions/2` | 
| 1 | `arn:aws:greengrass:{{region}}::/connectors/IoTEIPProtocolAdaptor/versions/1` | 

バージョンの変更については、「[Changelog](#ethernet-ip-connector-changelog)」を参照してください。

## 要件
<a name="ethernet-ip-connector-req"></a>

このコネクタには以下の要件があります。

------
#### [ Version 1 and 2 ]
+ AWS IoT Greengrass Core ソフトウェア v1.10.2 以降。
+  AWS IoT Greengrass グループで有効になっているストリームマネージャー。
+ Java 8 が Core デバイスにインストールされ、`PATH` 環境変数に追加されている。
+ 最低 256 MB の追加 RAM。この要件は Core AWS IoT Greengrass メモリ要件に追加されます。

**注記**  
 このコネクタは、次のリージョンでのみ利用できます。  
cn-north-1
ap-southeast-1
ap-southeast-2
eu-central-1
eu-west-1
us-east-1
us-west-2

------

## コネクタパラメータ
<a name="ethernet-ip-connector-param"></a>

このコネクタでは、以下のパラメータがサポートされています。

`LocalStoragePath`  
IoT SiteWise コネクタが永続データを書き込むことができる AWS IoT Greengrass ホスト上のディレクトリ。デフォルトのディレクトリは `/var/sitewise` です。  
 AWS IoT コンソールでの名前の表示: **ローカルストレージパス**  
必須: `false`  
型: `string`  
有効なパターン: `^\s*$|\/.`

`ProtocolAdapterConfiguration`  
コネクタのデータ収集先または接続先となるイーサネット/IP コレクタの一連の設定。空のリストを指定できます。  
 AWS IoT コンソールの表示名: **Protocol Adapter の設定**  
必須: `true`  
タイプ: サポートされているフィードバック設定のセットを定義する正しい形式の JSON 文字列。

 次は、`ProtocolAdapterConfiguration` の例です。

```
{
    "sources": [
        {
            "type": "EIPSource",
            "name": "TestSource",
            "endpoint": {
                "ipAddress": "52.89.2.42",
                "port": 44818
            },
            "destination": {
                "type": "StreamManager",
                "streamName": "MyOutput_Stream",
                "streamBufferSize": 10
            },
            "destinationPathPrefix": "EIPSource_Prefix",
            "propertyGroups": [
                {
                    "name": "DriveTemperatures",
                    "scanMode": {
                        "type": "POLL",
                        "rate": 10000
                    },
                    "tagPathDefinitions": [
                        {
                            "type": "EIPTagPath",
                            "path": "arrayREAL[0]",
                            "dstDataType": "double"
                        }
                    ]
                }
            ]
        }
    ]
}
```

### サンプルコネクタを作成する (AWS CLI)
<a name="eip-connector-create"></a>

以下の CLI コマンドを実行すると、IoT イーサネット IP プロトコルアダプタコネクタを含む初期バージョンで `ConnectorDefinition` を作成します。

```
aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version 
'{
    "Connectors": [
        {
            "Id": "MyIoTEIPProtocolConnector",
            "ConnectorArn": "arn:aws:greengrass:region::/connectors/IoTEIPProtocolAdaptor/versions/2",
            "Parameters": {
                "ProtocolAdaptorConfiguration": "{ \"sources\": [{ \"type\": \"EIPSource\", \"name\": \"Source1\", \"endpoint\": { \"ipAddress\": \"54.245.77.218\", \"port\": 44818 }, \"destinationPathPrefix\": \"EIPConnector_Prefix\", \"propertyGroups\": [{ \"name\": \"Values\", \"scanMode\": { \"type\": \"POLL\", \"rate\": 2000 }, \"tagPathDefinitions\": [{ \"type\": \"EIPTagPath\", \"path\": \"arrayREAL[0]\", \"dstDataType\": \"double\" }]}]}]}",
                "LocalStoragePath": "/var/MyIoTEIPProtocolConnectorState"
            }
        }
    ]
}'
```

**注記**  
このコネクタの Lambda 関数には[存続期間の長い](lambda-functions.md#lambda-lifecycle)ライフサイクルがあります。

## 入力データ
<a name="ethernet-ip-connector-data-input"></a>

このコネクタは MQTT メッセージを入力データとして受け入れません。

## 出力データ
<a name="ethernet-ip-connector-data-output"></a>

このコネクタは、`StreamManager` にデータを発行します。宛先メッセージストリームを設定する必要があります。出力メッセージは以下の構造になります。

```
{
    "alias": "string",
    "messages": [
        {
            "name": "string",
            "value": boolean|double|integer|string,
            "timestamp": number,
            "quality": "string"
        }
    ]
}
```

## ライセンス
<a name="ethernet-ip-connector-license"></a>

IoT イーサネット IP プロトコルアダプタコネクタには、以下のサードパーティーのソフトウェアおよびライセンスが含まれています。
+ [イーサネット/IP クライアント](https://github.com/digitalpetri/ethernet-ip/blob/master/LICENSE)
+ [MapDB](https://github.com/jankotek/mapdb/blob/master/LICENSE.txt)
+ [Elsa](https://github.com/jankotek/elsa/blob/master/LICENSE.txt)

このコネクタは、[Greengrass Core ソフトウェアライセンス契約](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf)に従ってリリースされます。

## 変更ログ
<a name="ethernet-ip-connector-changelog"></a>

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


| バージョン | 変更 | 日付 | 
| --- | --- | --- | 
| 2 | このバージョンには、バグ修正が含まれています。 | 2021 年 12 月 23 日 | 
| 1 | 初回リリース。 | 2020 年 12 月 15 日 | 

<a name="one-conn-version"></a>Greengrass グループには、一度に 1 つのバージョンのコネクタしか含めることができません。コネクタのバージョンのアップグレードについては、「[コネクタのバージョンのアップグレード](connectors.md#upgrade-connector-versions)」を参照してください。

## 関連情報
<a name="ethernet-ip-connector-see-also"></a>
+ [Greengrass コネクタを使用したサービスおよびプロトコルとの統合](connectors.md)
+ [Greengrass コネクタの開始方法 (コンソール)](connectors-console.md)
+ [Greengrass コネクタの開始方法 (CLI)](connectors-cli.md)