

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

# AWS Ground Station Dataflow エンドポイントグループを使用する
<a name="how-it-works.dataflow-endpoint-group"></a>

 *データフローエンドポイント*は、コンタクト中にデータを同期的にストリーミングする場所を定義します。データフローエンドポイントは、常に*データフローエンドポイントグループ*の一部として作成されます。1 つのグループに複数のデータフローエンドポイントを含めることで、1 回のコンタクトで指定されたエンドポイントをすべて一緒に使用できることを断定できます。たとえば、コンタクトが 3 つの別々のデータフローエンドポイントにデータを送信する必要がある場合、1 つのデータフローエンドポイントグループに、ミッションプロファイルのデータフローエンドポイント設定と一致するエンドポイントが 3 つ必要です。

## Dataflow エンドポイントグループバージョン
<a name="how-it-works.dataflow-endpoint-group.versions"></a>

 AWS Ground Station は、次の 2 つのバージョンのデータフローエンドポイントグループをサポートしています。
+ **DataflowEndpointGroup** - [データフローエンドポイント](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DataflowEndpoint.html)を使用したアップリンクとダウンリンク、および[AWS Ground Station エージェントエンドポイント](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AwsGroundStationAgentEndpoint.html)のダウンリンクのみをサポートする元の実装
+ **DataflowEndpointGroupV2** - AWS Ground Station エージェントエンドポイントのアップリンクデータフローとダウンリンクデータフローの両方をサポートするバージョンが更新され、明確性と機能が向上しました。


**データフローエンドポイントグループの比較**  

| 機能 | DataflowEndpointGroup | DataflowEndpointGroupV2 | 
| --- | --- | --- | 
| サポートされているエンドポイントタイプ | DataflowEndpoint、AwsGroundStationAgentEndpoint | DownlinkAwsGroundStationAgentEndpoint、UplinkAwsGroundStationAgentEndpoint | 
| アップリンクをサポートするエンドポイント | DataflowEndpoint | UplinkAwsGroundStationAgentEndpoint | 
| ダウンリンクをサポートするエンドポイント | DataflowEndpoint、AwsGroundStationAgentEndpoint | DownlinkAwsGroundStationAgentEndpoint | 

 DataflowEndpointGroupV2 は、アップリンクデータフローをサポートし、データフローエンドポイントグループを囲む言語をより明確にするために作成されました。すべての新しいユースケースでは、DataflowEndpointGroupV2 で [UplinkAwsGroundStationAgentEndpoint](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UplinkAwsGroundStationAgentEndpoint.html) エンドポイントと [DownlinkAwsGroundStationAgentEndpoint](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DownlinkAwsGroundStationAgentEndpoint.html) エンドポイントを使用することをお勧めします。 [DataflowEndpointGroupV2](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateDataflowEndpointGroupV2.html) DataflowEndpointGroup は下位互換性のために引き続きサポートされていますが、DataflowEndpointGroupV2 は強化された機能とより明確な設定オプションを提供します。

**ヒント**  
 データフローエンドポイントは、問い合わせの実行時に選択した名前で識別されます。これらの名前は、アカウント全体で一意である必要はありません。これにより、同じミッションプロファイルを使用して、異なる衛星とアンテナ間で複数のコンタクトを同時に実行できます。これは、動作特性が同じ衛星の群れがある場合に便利です。データフローエンドポイントグループの数は、衛星の星座が必要とする同時コンタクトの最大数に合わせてスケールアップできます。

 データフローエンドポイントグループ内の 1 つ以上のリソースがコンタクトに使用されている場合、グループ全体がそのコンタクトの間リザーブされます。複数のコンタクトを同時に実行できますが、それらのコンタクトは異なるデータフローエンドポイントグループで実行する必要があります。

**重要**  
 データフローエンドポイントグループは、それらを使用するコンタクトをスケジュールするために `HEALTHY` 状態になっている必要があります。`HEALTHY` 状態ではないデータフローエンドポイントグループのトラブルシューティング方法については、「」を参照してください[DataflowEndpointGroups が正常でない状態のトラブルシューティング](troubleshooting-dfeg.md)。

 CloudFormation、、または AWS Ground Station API を使用してデータフローエンドポイントグループでオペレーションを実行する方法の詳細については AWS Command Line Interface、次のドキュメントを参照してください。
+ [AWS::GroundStation::DataflowEndpointGroup CloudFormation リソースタイプ](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-groundstation-dataflowendpointgroup.html)
+ [データフローエンドポイントグループの AWS CLI リファレンス](https://docs.aws.amazon.com/cli/latest/reference/groundstation/create-dataflow-endpoint-group.html)
+ [cCreateDataflowEndpointGroup API リファレンス](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateDataflowEndpointGroup.html)

## データフローエンドポイント
<a name="how-it-works.dataflow-endpoint-group.endpoints"></a>

 データフローエンドポイントグループのメンバーは、データフローエンドポイントです。サポートされているエンドポイントタイプは、使用するデータフローエンドポイントグループのバージョンによって異なります。

### DataflowEndpointGroup エンドポイント
<a name="how-it-works.dataflow-endpoint-group.original-endpoints"></a>

 DataflowEndpointGroup は、[データフローエンドポイント](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DataflowEndpoint.html)を使用したアップリンクとダウンリンク、および[AWS Ground Station エージェントエンドポイント](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AwsGroundStationAgentEndpoint.html)のダウンリンクのみをサポートします。どちらのタイプのエンドポイントでも、データフローエンドポイントグループを作成する前に、サポートコンストラクト (IP アドレスなど) を作成します。使用するデータフローエンドポイントタイプと、サポートコンストラクトを設定する方法については、[データフローの使用](dataflows.md)「」を参照してください。

 以下のセクションでは、サポートされている両方のエンドポイントタイプについて説明します。

**重要**  
 単一のデータフローエンドポイントグループ内のすべてのデータフローエンドポイントは、同じタイプである必要があります。[AWS Ground Station エージェントエンドポイント](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AwsGroundStationAgentEndpoint.html)を同じグループの [Dataflow エンドポイント](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DataflowEndpoint.html)と混在させることはできません。ユースケースで両方のタイプのエンドポイントが必要な場合は、タイプごとに個別のデータフローエンドポイントグループを作成する必要があります。  
 DataflowEndpointGroupV2 の場合、[UplinkAwsGroundStationAgentEndpoint](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UplinkAwsGroundStationAgentEndpoint.html) と [DownlinkAwsGroundStationAgentEndpoint](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DownlinkAwsGroundStationAgentEndpoint.html) を同じグループに混在させることができます。

#### AWS Ground Station エージェントエンドポイント
<a name="how-it-works.dataflow-endpoint-group.agent"></a>

 AWS Ground Station エージェントエンドポイントは、 AWS Ground Station エージェントをソフトウェアコンポーネントとして使用して接続を終了します。 AWS Ground Station エージェントエンドポイントを作成するには、EndpointDetails の `AwsGroundStationAgentEndpoint`フィールドのみを入力します。 AWS Ground Station エージェントの詳細については、[AWS Ground Station 「 エージェントユーザーガイド](https://docs.aws.amazon.com/ground-station/latest/gs-agent-ug/)」を参照してください。

`AwsGroundStationAgentEndpoint` には以下の構成要素があります。
+ `Name` - データフローエンドポイント名。問い合わせがこのデータフローエンドポイントを使用するには、この名前がデータフローエンドポイント設定で使用されている名前と一致する必要があります。
+ `EgressAddress` - エージェントからのデータの出力に使用される IP アドレスとポートアドレス。
+ `IngressAddress` - エージェントへのデータの進入に使用される IP とポートアドレス。

#### データフローエンドポイント
<a name="how-it-works.dataflow-endpoint-group.dataflow-endpoint"></a>

 Dataflow Endpoint は、ネットワークアプリケーションをソフトウェアコンポーネントとして使用して接続を終了します。デジタル信号データのアップリンク、50MHz 未満のデジタル信号データのダウンリンク、または復調/復号された信号データのダウンリンクを行う場合は、データフローエンドポイントを使用します。Dataflow Endpoint を作成するには、EndpointDetails の `Endpoint`および `Security Details`フィールドに入力します。

`Endpoint` には以下の構成要素があります。
+ `Name` - データフローエンドポイント名。問い合わせがこのデータフローエンドポイントを使用するには、この名前がデータフローエンドポイント設定で使用されている名前と一致する必要があります。
+ `Address` - 使用される IP アドレスとポートアドレス。

`SecurityDetails` には以下の構成要素があります。
+ `roleArn` - VPC に Elastic Network Interface (ENIs) を作成するために AWS Ground Station が引き受けるロールの Amazon リソースネーム (ARN)。これらの ENI は、コンタクト中にストリーミングされるデータの入出力ポイントとなります。
+ `securityGroupIds` -Elastic Network Interface にアタッチするセキュリティグループ。
+  `subnetIds` - が インスタンスにストリームを送信するために Elastic Network Interface を配置 AWS Ground Station するサブネットのリスト。複数のサブネットを指定する場合は、相互にルーティング可能である必要があります。サブネットが異なるアベイラビリティーゾーン (AZs) にある場合、AZ 間のデータ転送料金が発生する可能性があります。

 `roleArn` に渡される IAM ロールには、`groundstation.amazonaws.com` サービスプリンシパルがロールを引き受けることを許可する信頼ポリシーが必要です。例については、以下の「[信頼ポリシーの例](#dataflow-endpoint-trust-policy-example)」を参照してください。エンドポイントの作成時にエンドポイントリソース ID は存在しないため、信頼ポリシーでは、{{your-endpoint-id}} の代わりにアスタリスク ({{\*}}) を使用する必要があります。作成後にエンドポイントリソース ID を使用してこれを更新し、信頼ポリシーをその特定のデータフローエンドポイントグループに絞り込むことができます。

 IAM ロールには、 が ENIs AWS Ground Station をセットアップできるようにする IAM ポリシーが必要です。例については、以下の「[ロールポリシーの例](#dataflow-endpoint-role-policy-example)」を参照してください。

##### 信頼ポリシーの例
<a name="dataflow-endpoint-trust-policy-example"></a>

 ロールの信頼ポリシーを更新する方法の詳細については、IAM ユーザーガイドの「[IAM ロールの管理](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage.html)」を参照してください。

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "groundstation.amazonaws.com"
            },
            "Action": "sts:AssumeRole",
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "{{999999999999}}"
                },
                "ArnLike": {
                    "aws:SourceArn": "arn:aws:groundstation:{{us-east-1}}:{{999999999999}}:dataflow-endpoint-group/{{your-endpoint-id}}"
                }
            }
        }
    ]
}
```

------

##### ロールポリシーの例
<a name="dataflow-endpoint-role-policy-example"></a>

 ロールポリシーを更新またはアタッチする方法の詳細については、IAM ユーザーガイドの「[IAM ポリシーを管理する](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage.html)」を参照してください。

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "ec2:CreateNetworkInterface",
        "ec2:DeleteNetworkInterface",
        "ec2:CreateNetworkInterfacePermission",
        "ec2:DeleteNetworkInterfacePermission",
        "ec2:DescribeSubnets",
        "ec2:DescribeVpcs",
        "ec2:DescribeSecurityGroups"
      ],
      "Resource": "*"
    }
  ]
}
```

------

### DataflowEndpointGroupV2 エンドポイント
<a name="how-it-works.dataflow-endpoint-group.v2-endpoints"></a>

 DataflowEndpointGroupV2 には、より明確な設定と機能拡張を提供する特殊なエンドポイントタイプが導入されています。
+ **[UplinkAwsGroundStationAgentEndpoint](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UplinkAwsGroundStationAgentEndpoint.html)** - アップリンクデータフロー用に最適化
+ **[DownlinkAwsGroundStationAgentEndpoint](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DownlinkAwsGroundStationAgentEndpoint.html)** - ダウンリンクデータフロー用に最適化

 これらの特殊なエンドポイントは、汎用 [AwsGroundStationAgentEndpoint](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AwsGroundStationAgentEndpoint.html) を、データフローの設定と管理を容易にする方向固有の設定に置き換えます。

#### アップリンク AWS Ground Station エージェントエンドポイント
<a name="how-it-works.dataflow-endpoint-group.uplink-agent-v2"></a>

 [UplinkAwsGroundStationAgentEndpoint](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UplinkAwsGroundStationAgentEndpoint.html) はアップリンクデータフロー専用に設計されており、より明確な設定オプションを提供します。衛星にアップリンク AWS Ground Station するために にデータを提供する必要がある場合は、このエンドポイントタイプを使用します。

`UplinkAwsGroundStationAgentEndpoint` には以下の構成要素があります。
+ `Name` - データフローエンドポイント名。問い合わせがこのデータフローエンドポイントを使用するには、この名前がデータフローエンドポイント設定で使用されている名前と一致する必要があります。
+ `IngressAddressAndPort` - エージェントへのデータ入力用の単一の IP アドレスとポートアドレス
+ `AgentIpAndPortAddress` - エージェント通信のポート範囲

#### ダウンリンク AWS Ground Station エージェントエンドポイント
<a name="how-it-works.dataflow-endpoint-group.downlink-agent-v2"></a>

 [DownlinkAwsGroundStationAgentEndpoint](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DownlinkAwsGroundStationAgentEndpoint.html) は、ナローバンドダウンリンク、ワイドバンド復調/デコード、アップリンクエコーシナリオなどのダウンリンクデータフロー用に最適化されています。

`DownlinkAwsGroundStationAgentEndpoint` には以下の構成要素があります。
+ `Name` - データフローエンドポイント名。問い合わせがこのデータフローエンドポイントを使用するには、この名前がデータフローエンドポイント設定で使用されている名前と一致する必要があります。
+ `EgressAddressAndPort` - エージェントからのデータ出力用の単一の IP アドレスとポートアドレス
+ `AgentIpAndPortAddress` - エージェント通信のポート範囲

## データフローエンドポイントグループの作成
<a name="how-it-works.dataflow-endpoint-group.creating"></a>

 データフローエンドポイントグループは、次のいずれかのバージョンを使用して作成できます。

### CreateDataflowEndpointGroup
<a name="how-it-works.dataflow-endpoint-group.creating-original"></a>

 下位互換性のため、または汎用 [AwsGroundStationAgentEndpoint](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AwsGroundStationAgentEndpoint.html) または DataflowEndpoint タイプを使用する必要がある場合は、[CreateDataflowEndpointGroup](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateDataflowEndpointGroup.html) を使用します。 [DataflowEndpoint](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DataflowEndpoint.html) 

### CreateDataflowEndpointGroupV2
<a name="how-it-works.dataflow-endpoint-group.creating-v2"></a>

 [CreateDataflowEndpointGroupV2](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateDataflowEndpointGroupV2.html) を新しい実装に使用して、アップリンクとダウンリンクの両方のデータフローをサポートする特殊なエンドポイントタイプを活用します。この API は、[UplinkAwsGroundStationAgentEndpoint](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UplinkAwsGroundStationAgentEndpoint.html) と [DownlinkAwsGroundStationAgentEndpoint](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DownlinkAwsGroundStationAgentEndpoint.html) のみをサポートします。

## 移行に関する考慮事項
<a name="how-it-works.dataflow-endpoint-group.migration"></a>

 現在 DataflowEndpointGroup を使用している場合は、変更することなく既存の設定を引き続き使用できます。 は完全な下位互換性 AWS Ground Station を維持します。

 新しい DataflowEndpointGroupV2 を使用するように移行する場合、現在 [DataflowEndpoint](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DataflowEndpoint.html) と Dataflow Endpoint Application を使用してデータを受信している場合は、代わりに AWS Ground Station エージェントを使用するように移行する必要があります。ダウンリンクに AWS Ground Station エージェントを既に使用している場合は、アップリンクにも同じエージェントインスタンスを使用できます。追加のエージェントインスタンスは必要ありません。

 DataflowEndpointGroupV2 に移行するには: 

1. DataflowEndpoint から移行する場合は、 AWS Ground Station 「 エージェント[AWS Ground Station ユーザーガイド](https://docs.aws.amazon.com/ground-station/latest/gs-agent-ug/)」に従って エージェントを設定します。

1. データフローの方向を特定し、適切なエンドポイントタイプ ([UplinkAwsGroundStationAgentEndpoint](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UplinkAwsGroundStationAgentEndpoint.html) または [DownlinkAwsGroundStationAgentEndpoint](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DownlinkAwsGroundStationAgentEndpoint.html)) を作成します。

1. これらのエンドポイントを参照する [DataflowEndpointGroupV2](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateDataflowEndpointGroupV2.html) を作成する

1. 新しい [DataflowEndpointGroupV2 を名前で参照する新しいデータフローエンドポイント設定](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateConfig.html)を作成する DataflowEndpointGroupV2 

1. データフローエンドポイント設定をデータフローエッジとして参照する新しいミッションプロファイルを作成する

1. 新しいミッションプロファイルを使用してコンタクトをスケジュールする

1. 本番環境にデプロイする前に設定をテストする

 ワークフローの詳細については、[AWS Ground Station コアコンポーネントを理解する](how-it-works.core.md)「」および「」を参照してください[設定の作成](getting-started.step3.md)。