

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

# の AWS Ground Station 仕組み
<a name="how-it-works"></a>

 AWS Ground Station は地上アンテナを操作して*、**衛星*との通信を容易にします。アンテナが実行できる物理的な特性は抽象化され、*機能*と呼ばれます。アンテナの物理的な場所と現在の機能は、 [AWS Ground Station ロケーション](aws-ground-station-antenna-locations.md)セクションで参照できます。ユースケース[AWS Support Center Console](https://console.aws.amazon.com/support)に追加の機能、追加のロケーションサービス、またはより正確なアンテナロケーションが必要な場合は、 を通じてお問い合わせください。

 AWS Ground Station アンテナのいずれかを使用するには、特定の場所で時間を予約する必要があります。この予約は*問い合わせ*と呼ばれます。問い合わせを正常にスケジュールするには、 は成功するために追加のデータ AWS Ground Station を必要とします。
+  **衛星は 1 つ以上の場所にオンボードする必要があります**。これにより、リクエストされた場所でさまざまな機能を運用する承認が得られます。
+  **衛星には有効な*エフェメリス*が必要です**。これにより、アンテナの視線が確保され、コンタクト中に衛星を正確に指すことができます。
+  **有効な*ミッションプロファイル*が必要です。**これにより、衛星へのデータの受信方法や送信方法など、この問い合わせの動作をカスタマイズできます。同じ車両に複数のミッションプロファイルを使用して、発生するさまざまな運用体制やシナリオに合わせて異なるコンタクトを作成できます。

## 衛星オンボーディング
<a name="how-it-works.onboarding"></a>

 への衛星のオンボーディング AWS Ground Station は、データ収集、技術検証、スペクトルライセンス、統合とテストを含む複数ステップのプロセスです。ガイドの[「衛星オンボーディング](getting-started.step1.md)」セクションでは、このプロセスについて説明します。

## ミッションプロファイルの構成
<a name="how-it-works.mission-profile"></a>

 衛星周波数情報、[データプレーン](https://docs.aws.amazon.com/whitepapers/latest/aws-fault-isolation-boundaries/control-planes-and-data-planes.html)情報、およびその他の詳細は、ミッションプロファイルにカプセル化されます。ミッションプロファイルは、*設定*コンポーネントのコレクションです。これにより、ユースケースに応じて、さまざまなミッションプロファイル間で設定コンポーネントを再利用できます。ミッションプロファイルは個々の衛星を直接参照するのではなく、その技術的機能に関する情報しか持たないため、ミッションプロファイルは同じ設定の複数の衛星でも再利用できます。

 有効なミッションプロファイルには、*追跡設定*と 1 つ以上の*データフロー*があります。追跡設定は、問い合わせ中に追跡する設定を指定します。データフロー内の各設定ペアは、送信元と送信先を確立します。衛星とその運用モードに応じて、ミッションプロファイルのデータフローの正確な数は、アップリンクおよびダウンリンクの通信パスとデータ処理の側面を表すように異なります。
+  問い合わせ中に使用される Amazon VPC、Amazon S3、Amazon EC2 リソースの設定の詳細については、「」を参照してください[データフローの使用](dataflows.md)。
+  各設定の動作の詳細については、「」を参照してください[AWS Ground Station 設定を使用する](how-it-works.config.md)。
+  予想されるすべてのパラメータの詳細については、「」を参照してください[AWS Ground Station ミッションプロファイルを使用する](how-it-works-mission-profile.md)。
+  ユースケースをサポートするためにさまざまなミッションプロファイルを作成する方法の例については、「」を参照してください[ミッションプロファイル設定の例](examples.md)。

 次の図は、ミッションプロファイルの例と、必要な追加のリソースを示しています。この例では、柔軟性を示すために、このミッションプロファイルに必要のないデータフローエンドポイントである *unusedEndpoint* を示しています。この例では、次のデータフローをサポートしています。
+  管理する Amazon EC2 インスタンスへのデジタル中間周波数データの同期ダウンリンク。*digIfDownlink* という名前で表されます。
+  Amazon S3 バケットへのデジタル中間周波数データの非同期ダウンリンク。バケット名 *aws-groundstation-demo* で表されます。
+  管理する Amazon EC2 インスタンスへの復調および復号化されたデータの同期ダウンリンク。*demodDecodeDownlink* という名前で表されます。
+  管理する Amazon EC2 インスタンスから AWS Ground Station マネージドアンテナへのデータの同期アップリンク。*digIfUplink* という名前で表されます。

 ![\[An example mission profile and additional resources needed.\]](http://docs.aws.amazon.com/ja_jp/ground-station/latest/ug/images/mission-profile-composition.png) 

## 問い合わせのスケジューリング
<a name="how-it-works.contact-scheduling"></a>

 有効なミッションプロファイルを使用すると、オンボード衛星とのコンタクトをリクエストできます。問い合わせ予約リクエストは非同期であり、グローバルアンテナサービスが関連するすべての AWS リージョンで一貫したスケジュールを達成するための時間を確保します。このプロセス中、リクエストされた地上局の場所にあるさまざまなアンテナが評価され、それらが使用可能で、問い合わせを処理できるかどうかが判断されます。このプロセスでは、設定された*データフローエンドポイント*も評価され、可用性が判断されます。この評価の実行中、問い合わせステータスはスケジュール中になります。

 この非同期スケジューリングプロセスはリクエストから 5 分以内に終了しますが、通常は 1 分以内に終了します。スケジューリング中にイベントベースのモニタリング[イベント AWS Ground Station による自動化](monitoring.automating-events.md)を確認してください。

 ![\[The contact reservation request is asynchronous to allow time for the global antenna service to achieve a consistent schedule across all AWS Regions involved.\]](http://docs.aws.amazon.com/ja_jp/ground-station/latest/ug/images/scheduling.png) 

 実行でき、利用可能な問い合わせは*、スケジュールされた*問い合わせになります。スケジュールされたコンタクトでは、コンタクトの実行に必要なリソースは、ミッションプロファイルで定義されている必要な AWS リージョン全体で予約されています。実行できない問い合わせ、または使用できないパートがある場合、*FAILED\$1TO\$1SCHEDULE* 問い合わせが発生します。デバッグの詳細については[FAILED\$1TO\$1SCHEDULE コンタクトのトラブルシューティング](troubleshooting-failed-to-schedule-contacts.md)、「」を参照してください。

## 問い合わせの実行
<a name="how-it-works.contact-execution"></a>

 AWS Ground Station は、問い合わせ予約中に AWS マネージドリソースを自動的にオーケストレーションします。必要に応じて、ミッションプロファイルでデータフローエンドポイントとして定義された EC2 リソースをオーケストレーションする責任があります。 は、コストを削減するためにリソースのオーケストレーションを自動化するための [AWS EventBridge イベント](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) AWS Ground Station を提供します。詳細については、「[イベント AWS Ground Station による自動化](monitoring.automating-events.md)」を参照してください。

 問い合わせ中、問い合わせパフォーマンスに関するテレメトリが AWS CloudWatch に配信されます。実行中に問い合わせをモニタリングする方法については、「」を参照してください[によるモニタリングを理解する AWS Ground Station](monitoring.md)。

 次の図は、問い合わせ中にオーケストレーションされた同じリソースを表示することで、前の例を続行します。

**注記**  
 この例では、すべてのアンテナ機能が使用されたわけではありません。例えば、複数の周波数と偏波をサポートする多数のアンテナダウンリンク機能が各アンテナで利用できます。 AWS Ground Station アンテナで使用できる各機能タイプの数、およびサポートされている周波数と偏波の詳細については、「」を参照してください[AWS Ground Station サイト機能](locations.capabilities.md)。

 ![\[Resources from the previous example orchestrated during the contact.\]](http://docs.aws.amazon.com/ja_jp/ground-station/latest/ug/images/contact-orchestration-simplified.png) 

 問い合わせの終了時に、 AWS Ground Station は問い合わせのパフォーマンスを評価し、最終的な問い合わせステータスを決定します。エラーが検出されない問い合わせは、*完了済みの*問い合わせステータスになります。サービスエラーが原因で問い合わせ中にデータ配信の問題が発生した問い合わせは、*AWS\$1FAILED* ステータスになります。クライアントまたはユーザーのエラーによって問い合わせ中にデータ配信の問題が発生した問い合わせは、*失敗*ステータスになります。コンタクト時間外のエラー、つまりパス前またはパス後のエラーは、判定中に考慮されません。

 詳細については「[問い合わせのライフサイクルを理解する](contacts.lifecycle.md)」を参照してください。

## デジタルツイン
<a name="how-it-works.digital-twin"></a>

 のデジタルツイン機能 AWS Ground Station を使用すると、仮想地上局のロケーションに対してコンタクトをスケジュールできます。これらの仮想地上ステーションは、アンテナ機能、サイトマスク、実際の GPS 座標など、本番稼働用地上ステーションの正確なレプリカです。デジタルツイン機能を使用すると、コンタクトオーケストレーションワークフローを本番環境の地上局と比較してわずかなコストでテストできます。詳細については「[AWS Ground Station デジタルツイン機能を使用する](digital-twin.md)」を参照してください。

# AWS Ground Station コアコンポーネントを理解する
<a name="how-it-works.core"></a>

 このセクションでは、AWS Ground Station のコアコンポーネントの詳細定義について説明します。

 次の図は、 のコアコンポーネント AWS Ground Station とその相互関係を示しています。矢印は、各コンポーネントが依存関係を指すコンポーネント間の依存関係の方向を示します。

 ![\[Diagram showing the core components of AWS Ground Station and how they relate to each other.\]](http://docs.aws.amazon.com/ja_jp/ground-station/latest/ug/images/core-component-relationships.png) 

以下のトピックでは、 AWS Ground Station コアコンポーネントについて詳しく説明します。

**Topics**
+ [AWS Ground Station ミッションプロファイルを使用する](how-it-works-mission-profile.md)
+ [AWS Ground Station 設定を使用する](how-it-works.config.md)
+ [AWS Ground Station Dataflow エンドポイントグループを使用する](how-it-works.dataflow-endpoint-group.md)
+ [AWS Ground Station エージェントを使用する](how-it-works.gs-agent.md)

# AWS Ground Station ミッションプロファイルを使用する
<a name="how-it-works-mission-profile"></a>

ミッションプロファイルには、コンタクトの実行方法に関する設定とパラメータが含まれています。コンタクトを予約したり利用可能なコンタクトを検索したりするときには、使用する予定のミッションプロファイルを指定します。ミッションプロファイルはすべての設定を1つにまとめ、コンタクト中のアンテナの設定方法とデータの配信先を定義します。

 ミッションプロファイルは、同じ無線特性を共有する衛星間で共有できます。追加のデータフローエンドポイントグループを作成して、コンステレーションに対して実行する最大同時コンタクト数をバインドできます。

 追跡設定は、ミッションプロファイル内の一意のフィールドとして指定されます。追跡設定は、問い合わせ中にプログラム追跡と自動追跡を使用するための設定を指定するために使用されます。詳細については、「[追跡設定](how-it-works.config.md#how-it-works.config-tracking)」を参照してください。

 他のすべての設定は、ミッションプロファイルの `dataflowEdges`フィールドに含まれます。これらの設定は、データおよび関連する設定を送受信できる AWS Ground Station マネージドリソースをそれぞれ表すデータフローノードと考えることができます。`dataflowEdges` フィールドは、必要な送信元と送信先のデータフローノード (設定) を定義します。1 つのデータフローエッジは 2 つの設定 [Amazon リソースネーム (ARNs) のリストです](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html)。1 つ目は*ソース*設定、2 つ目は*宛先*設定です。2 つの設定間でデータフローエッジを指定することで、問い合わせ中にデータがどこ AWS Ground Station からどこへ流れるかを に指示します。詳細については、「[AWS Ground Station 設定を使用する](how-it-works.config.md)」を参照してください。

`contactPrePassDurationSeconds` と `contactPostPassDurationSeconds`を使用すると、CloudWatch イベント通知を受け取る問い合わせに関連する時間を指定できます。連絡先に関連するイベントのタイムラインについては、「」を参照してください[問い合わせのライフサイクルを理解する](contacts.lifecycle.md)。

ミッションプロファイルの `name` フィールドを確認すれば、作成したミッションプロファイルと区別できます。

`streamsKmsRole` および `streamsKmsKey`は、 AWS Ground Station エージェントによるデータ配信 AWS Ground Station に が使用する暗号化を定義するために使用されます。[の転送中のデータ暗号化 AWS Ground Station](security.encryption-during-transit.md) を参照してください。

`telemetrySinkConfigArn` フィールドはオプションで、コンタクト中に AWS Ground Station テレメトリを有効にできます。指定した場合、 はコンタクトの実行中にほぼリアルタイムのテレメトリデータをアカウントに AWS Ground Station ストリーミングします。テレメトリの設定と使用の詳細については、「」を参照してください[テレメトリの操作](telemetry.md)。

 ![\[Dataflow and configuration for a mission profile.\]](http://docs.aws.amazon.com/ja_jp/ground-station/latest/ug/images/mission-profile-core-component.png) 

 パラメータと例の完全なリストは、次のドキュメントに含まれています。
+ [AWS::GroundStation::MissionProfile CloudFormation リソースタイプ](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-groundstation-missionprofile.html)

# AWS Ground Station 設定を使用する
<a name="how-it-works.config"></a>

 *Configs* は、 AWS Ground Station が問い合わせの各側面のパラメータを定義するために使用するリソースです。希望する設定をミッションプロファイルに追加すると、コンタクトを実行する際にそのミッションプロファイルが使用されます。さまざまなタイプの設定を定義できます。設定は 3 つのカテゴリにグループ化できます。
+ 追跡設定
+ データフロー設定
+ テレメトリ設定

 *TrackingConfig* は、追跡設定の唯一のタイプです。これは、コンタクト中にアンテナの自動トラック設定を構成するために使用され、ミッションプロファイルで必要です。

 ミッションプロファイルのデータフローで使用できる設定は、それぞれがデータを送受信できる AWS Ground Station マネージドリソースを表すデータフローノードと考えることができます。ミッションプロファイルには、これらの設定の少なくとも 1 つのペアが必要です。1 つはデータソースを表し、もう 1 つは送信先を表します。これらの設定の概要を次の表に示します。


| 設定名 | データソース/送信先 | 
| --- | --- | 
|  AntennaDownlinkConfig  |  ソース  | 
|  AntennaDownlinkDemodDecodeConfig  |  ソース  | 
|  UplinkEchoConfig  |  ソース  | 
|  S3RecordingConfig  |  目的地  | 
|  AntennaUplinkConfig  |  目的地  | 
|  DataflowEndpointConfig  |  送信元および/または送信先  | 

 *TelemetrySinkConfig* はテレメトリ設定の唯一のタイプです。これは、コンタクト中にテレメトリデータが配信される場所を設定するために使用され、ミッションプロファイルではオプションです。含まれている場合、 はコンタクトの実行中にほぼリアルタイムのテレメトリをアカウントに AWS Ground Station ストリーミングします。

 CloudFormation、、または AWS Ground Station API を使用して設定でオペレーションを実行する方法の詳細については AWS Command Line Interface、次のドキュメントを参照してください。特定の設定タイプのドキュメントへのリンクも以下に記載されています。
+ [AWS::GroundStation::Config CloudFormation リソースタイプ](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-groundstation-config.html)
+ [Config AWS CLI リファレンス](https://docs.aws.amazon.com/cli/latest/reference/groundstation/create-config.html)
+ [CreateConfig API リファレンス](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateConfig.html)

## 追跡設定
<a name="how-it-works.config-tracking"></a>

 ミッションプロファイルの追跡設定を使用して、コンタクト中に自動追跡を有効にする必要があるかどうかを決定できます。この設定には単一のパラメータ、`autotrack` があります。この `autotrack` パラメータには以下の値があります。
+ `REQUIRED` -コンタクトに自動追跡が必要。
+ `PREFERRED` -コンタクトに自動追跡が好ましいが、自動追跡がなくてもコンタクトを実行できる。
+ `REMOVED` - コンタクトに自動追跡が使用されるべきではない。

AWS Ground Station は、自動トラックが使用されていない場合にエフェメリスに基づいてポイントするプログラムによる追跡を利用します。エフェメリスの構築方法の詳細については[がエフェメリス AWS Ground Station を使用する方法を理解する](ephemeris.md)、「」を参照してください。

Autotrack は、予想されるシグナルが見つかるまでプログラム追跡を使用します。これが発生すると、シグナルの強度に基づいて引き続き追跡されます。

 CloudFormation、、または AWS Ground Station API を使用して 設定の追跡オペレーションを実行する方法の詳細については AWS Command Line Interface、次のドキュメントを参照してください。
+ [AWS::GroundStation::Config TrackingConfig CloudFormation プロパティ](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-groundstation-config-trackingconfig.html)
+ [Config AWS CLI リファレンス](https://docs.aws.amazon.com/cli/latest/reference/groundstation/create-config.html) (`trackingConfig -> (structure)`「」セクションを参照)
+ [TrackingConfig API リファレンス](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TrackingConfig.html)

## アンテナダウンリンク設定
<a name="how-it-works.config-antenna-downlink"></a>

 アンテナダウンリンク設定を使用してコンタクト中のダウンリンク用のアンテナを設定できます。これらは、ダウンリンクコンタクト中に使用すべき周波数、帯域幅、および偏波を指定するスペクトル設定で構成されています。

この設定は、データフロー内のソースノードを表します。無線周波数データのデジタル化を担当します。このノードからストリーミングされたデータは、シグナルデータ/IP 形式に従います。この設定でデータフローを構築する方法の詳細については、「」を参照してください。 [データフローの使用](dataflows.md)

ダウンリンクのユースケースで復調や復号が必要な場合は、「[アンテナダウンリンク復調デコード設定](#how-it-works.config-antenna-downlink-demod-decode)」を参照してください。

 CloudFormation、、または AWS Ground Station API を使用してアンテナダウンリンク設定でオペレーションを実行する方法の詳細については AWS Command Line Interface、次のドキュメントを参照してください。
+ [AWS::GroundStation::Config AntennaDownlinkConfig CloudFormation プロパティ](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-groundstation-config-antennadownlinkconfig.html)
+ [Config AWS CLI リファレンス](https://docs.aws.amazon.com/cli/latest/reference/groundstation/create-config.html) (`antennaDownlinkConfig -> (structure)`「」セクションを参照)
+ [AntennaDownlinkConfig API リファレンス](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AntennaDownlinkConfig.html)

## アンテナダウンリンク復調デコード設定
<a name="how-it-works.config-antenna-downlink-demod-decode"></a>

 アンテナダウンリンクデモデコード設定は、復調やデコードでダウンリンクコンタクトを実行するために使用できる、より複雑でカスタマイズ可能な設定タイプです。これらのタイプの問い合わせの実行に関心がある場合は、 を通じて AWS サポート チケットを開いてください[AWS Support Center Console](https://console.aws.amazon.com/support)。ユースケースに適した設定とミッションプロファイルを定義するお手伝いをします。

 この設定は、データフロー内のソースノードを表します。無線周波数データをデジタル化し、指定されたとおりに復調とデコードを実行します。このノードからストリーミングされたデータは、復調/復号化されたデータ/IP 形式に従います。この設定でデータフローを構築する方法の詳細については、「」を参照してください。 [データフローの使用](dataflows.md)

 CloudFormation、、または AWS Ground Station API を使用してアンテナダウンリンクデモデコード設定でオペレーションを実行する方法の詳細については AWS Command Line Interface、次のドキュメントを参照してください。
+  [ AWS::GroundStation::Config AntennaDownlinkDemodDecodeConfig CloudFormation プロパティ ](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-groundstation-config-antennadownlinkdemoddecodeconfig.html) 
+  [ Config AWS CLI リファレンス ](https://docs.aws.amazon.com/cli/latest/reference/groundstation/create-config.html) (`antennaDownlinkDemodDecodeConfig -> (structure)`「」セクションを参照) 
+  [ AntennaDownlinkDemodDecodeConfig API リファレンス ](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AntennaDownlinkDemodDecodeConfig.html) 

## アンテナアップリンク設定
<a name="how-it-works.config-antenna-uplink"></a>

 アンテナアップリンク設定を使用してコンタクト中のアップリンクのアンテナを設定できます。これらは、周波数、偏波、および目標実効等方輻射電力 (EIRP) を含むスペクトル設定で構成されています。アップリンクループバックのコンタクトを設定する方法については、「[アンテナアップリンクエコー設定](#how-it-works.config-antenna-uplink-echo)」を参照してください。

この設定は、データフローの送信先ノードを表します。提供されたデジタル無線周波数データ信号をアナログ信号に変換し、衛星が受信できるように出力します。このノードにストリーミングされるデータは、シグナルデータ/IP 形式を満たすことが期待されます。この設定でデータフローを構築する方法の詳細については、「」を参照してください。 [データフローの使用](dataflows.md)

 CloudFormation、、または AWS Ground Station API を使用してアンテナアップリンク設定でオペレーションを実行する方法の詳細については AWS Command Line Interface、次のドキュメントを参照してください。
+ [AWS::GroundStation::Config AntennaUplinkConfig CloudFormation プロパティ](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-groundstation-config-antennauplinkconfig.html)
+ [Config AWS CLI リファレンス](https://docs.aws.amazon.com/cli/latest/reference/groundstation/create-config.html) (`antennaUplinkConfig -> (structure)`「」セクションを参照)
+ [AntAntennaUplinkConfig API リファレンス](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AntennaUplinkConfig.html)

## アンテナアップリンクエコー設定
<a name="how-it-works.config-antenna-uplink-echo"></a>

 アップリンクエコー設定は、アップリンクエコーを実行する方法をアンテナに伝えます。アップリンクエコーを使用して、宇宙機に送信されたコマンドを検証し、その他の高度なタスクを実行できます。これは、 AWS Ground Station アンテナ (アップリンク) によって送信された実際の信号を記録することで実現されます。これにより、アンテナによって送信された信号がデータフローエンドポイントにエコーされ、送信された信号と一致する必要があります。アップリンクエコー設定には、アップリンク設定の ARN が含まれています。アンテナは、アップリンクエコーを実行する際に ARN により指定されたアップリンク設定からのパラメータを使用します。

 この設定は、データフロー内のソースノードを表します。このノードからストリーミングされたデータは、シグナルデータ/IP 形式を満たします。この設定でデータフローを構築する方法の詳細については、「」を参照してください。 [データフローの使用](dataflows.md)

 CloudFormation、、または AWS Ground Station API を使用してアップリンクエコー設定でオペレーションを実行する方法の詳細については AWS Command Line Interface、次のドキュメントを参照してください。
+ [AWS::GroundStation::Config UplinkEchoConfig CloudFormation プロパティ](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-groundstation-config-uplinkechoconfig.html)
+ [Config AWS CLI リファレンス](https://docs.aws.amazon.com/cli/latest/reference/groundstation/create-config.html) (`uplinkEchoConfig -> (structure)`「」セクションを参照)
+ [UplinkEchoConfig API リファレンス](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UplinkEchoConfig.html)

## データフローエンドポイント設定
<a name="how-it-works.core-config-dfe"></a>

**注記**  
 データフローエンドポイント設定は、Amazon EC2 へのデータ配信にのみ使用され、Amazon S3 へのデータ配信には使用されません。

 データフローエンドポイント設定を使用して、コンタクト中にデータのフローを行う[データフローエンドポイントグループ](how-it-works.dataflow-endpoint-group.md)内のデータフローエンドポイントを指定します。データフローエンドポイント設定の 2 つのパラメータは、データフローエンドポイントの名前とリージョンを指定します。コンタクトを予約すると、 AWS Ground Station は指定した[ミッションプロファイル](how-it-works-mission-profile.md)を分析し、ミッションプロファイルに含まれるデータフローエンドポイント*設定*で指定されたすべてのデータフロー*エンドポイント*を含む AWS リージョン内のデータフローエンドポイント*グループ*を検索しようとします。適切なデータフローエンドポイント*グループ*が見つかった場合、問い合わせステータスは SCHEDULED になり、それ以外の場合は FAILED\$1TO\$1SCHEDULE になります。問い合わせのステータスの詳細については、「」を参照してください[AWS Ground Station 問い合わせステータス](contacts.lifecycle.md#contact-statuses)。

 データフローエンドポイント設定の `dataflowEndpointName` プロパティは、コンタクト中にデータのフローを行うデータフローエンドポイントグループ内のデータフローエンドポイントを指定します。

 `dataflowEndpointRegion` プロパティは、データフローエンドポイントが存在するリージョンを指定します。データフローエンドポイント設定でリージョンが指定されている場合、 は指定されたリージョン内のデータフローエンドポイント AWS Ground Station を検索します。リージョンが指定されていない場合、 AWS Ground Station はデフォルトで問い合わせの地上局リージョンになります。データフローエンドポイントのリージョンがコンタクトの地上ステーションリージョンと同じでない場合、コンタクトはクロスリージョンデータ配信コンタクトとみなされます。クロスリージョンデータフローの詳細については、[データフローの使用](dataflows.md)「」を参照してください。

 データフローのさまざまな命名スキームがユースケースにどのように役立つかに関するヒント[AWS Ground Station Dataflow エンドポイントグループを使用する](how-it-works.dataflow-endpoint-group.md)については、「」を参照してください。

 この設定でデータフローを構築する方法の詳細については、「」を参照してください。 [データフローの使用](dataflows.md)

 CloudFormation、、または AWS Ground Station API を使用してデータフローエンドポイント設定でオペレーションを実行する方法の詳細については AWS Command Line Interface、次のドキュメントを参照してください。
+ [AWS::GroundStation::Config DataflowEndpointConfig CloudFormation プロパティ](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-groundstation-config-dataflowendpointconfig.html)
+ [Config AWS CLI リファレンス](https://docs.aws.amazon.com/cli/latest/reference/groundstation/create-config.html) (`dataflowEndpointConfig -> (structure)`「」セクションを参照)
+ [DataflowEndpointConfig API リファレンス](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DataflowEndpointConfig.html)

## Amazon S3 録画設定
<a name="how-it-works.config-s3-recording"></a>

**注記**  
 Amazon S3 記録設定はAmazon S3、Amazon EC2 へのデータ配信には使用されません。

 この設定は、データフローの送信先ノードを表します。このノードは、データフローのソースノードからの受信データを pcap データにカプセル化します。この設定でデータフローを構築する方法の詳細については、「」を参照してください。 [データフローの使用](dataflows.md)

 S3 記録設定を使用して、ダウンリンクされたデータを配信する Amazon S3 バケットと、使用する命名規則を指定できます。以下に、これらのパラメータに関する制限と詳細を指定します。
+ Amazon S3 バケットの名前は、`aws-groundstation` で始まる必要があります。
+  IAM ロールには、`groundstation.amazonaws.com` サービスプリンシパルがロールを引き受けることを許可する信頼ポリシーが必要です。例については、以下の「[信頼ポリシーの例](#s3-trust-policy-example)」を参照してください。構成の作成時に、構成リソース ID は存在しません。信頼ポリシーでは、*your-config-id* の代わりにアスタリスク (*\$1*) を使用して、設定リソース ID を作成した後に更新することがでｋます。

### 信頼ポリシーの例
<a name="s3-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:config/s3-recording/your-config-id"
                }
            }
        }
    ]
}
```

------
+  IAM ロールには、バケット上ので `s3:GetBucketLocation` アクションとバケットのオブジェクト上での `s3:PutObject` の実行を許可する IAM ポリシーが必要です。Amazon S3 バケットにバケットポリシーがある場合、バケットポリシーは IAM ロールでこれらのアクションの実行を許可する必要があります。例については、以下の「[ロールポリシーの例](#s3-role-policy-example)」を参照してください。

### ロールポリシーの例
<a name="s3-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": [
        "s3:GetBucketLocation"
      ],
      "Resource": [
        "arn:aws:s3:::your-bucket-name"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "s3:PutObject"
      ],
      "Resource": [
        "arn:aws:s3:::your-bucket-name/*"
      ]
    }
  ]
}
```

------
+  プレフィックスは、S3 データオブジェクトに名前を付けるときに使用されます。代替するオプションのキーを指定できます。これらの値は、連絡先情報の対応する情報に置き換えられます。たとえば、 のプレフィックス`{satellite_id}/{year}/{month}/{day}`は置き換えられ、次のような出力になります。 `fake_satellite_id/2021/01/10`

   *置換のオプションキー*: `{satellite_id}` \$1 \$1 `{config-name}` `{config-id}` \$1 `{year}` \$1 `{month}` \$1 `{day}` \$1 

 CloudFormation、、または AWS Ground Station API を使用して S3 記録設定でオペレーションを実行する方法の詳細については AWS Command Line Interface、次のドキュメントを参照してください。
+ [AWS::GroundStation::Config S3RecordingConfig CloudFormation property](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-groundstation-config-s3recordingconfig.html)
+ [Config AWS CLI リファレンス](https://docs.aws.amazon.com/cli/latest/reference/groundstation/create-config.html) (`s3RecordingConfig -> (structure)`「」セクションを参照)
+ [S3RecordingConfig API リファレンス](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_S3RecordingConfig.html)

## テレメトリシンク設定
<a name="how-it-works.config-telemetry-sink"></a>

 テレメトリシンク設定を使用して、衛星コンタクト中にテレメトリデータを配信する場所を指定できます。テレメトリシンクの設定はオプションであり、テレメトリ対応コンタクトをスケジュールするためにミッションプロファイルに追加されます。以下に、これらのパラメータに関する制限と詳細を指定します。
+  IAM ロールには、`groundstation.amazonaws.com` サービスプリンシパルがロールを引き受けることを許可する信頼ポリシーが必要です。例については、以下の「[信頼ポリシーの例](#telemetry-config-trust-policy-example)」を参照してください。

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

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

```
{
  "Version": "2012-10-17", 		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "groundstation.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}
```
+  IAM ロールには、ロールがストリームで `kinesis:DescribeStream`、、`kinesis:PutRecord`および `kinesis:PutRecords`アクションを実行できるようにする IAM ポリシーが必要です。例については、以下の「[ロールポリシーの例](#telemetry-config-role-policy-example)」を参照してください。

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

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

```
{
  "Version": "2012-10-17", 		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "kinesis:DescribeStream",
        "kinesis:PutRecord",
        "kinesis:PutRecords"
      ],
      "Resource": "arn:aws:kinesis:us-east-2:999999999999:stream/your-stream-name"
    }
  ]
}
```

 ミッションプロファイルにテレメトリシンク設定を含めると、 AWS Ground Station はコンタクト中にテレメトリデータをアカウントにストリーミングします。テレメトリタイプ、データ形式、および必要な AWS リソースの設定の詳細については、「」を参照してください[テレメトリの操作](telemetry.md)。

 CloudFormation、、または AWS Ground Station API を使用してテレメトリシンク設定でオペレーションを実行する方法の詳細については AWS Command Line Interface、次のドキュメントを参照してください。
+  [ AWS::GroundStation::Config TelemetrySinkConfig CloudFormation プロパティ](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-groundstation-config-telemetrysinkconfig.html) 
+  [ Config AWS CLI リファレンス](https://docs.aws.amazon.com/cli/latest/reference/groundstation/create-config.html) (`telemetrySinkConfig -> (structure)`「」セクションを参照) 
+  [ TelemetrySinkConfig API リファレンス](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TelemetrySinkConfig.html) 

# 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* の代わりにアスタリスク (*\$1*) を使用する必要があります。作成後にエンドポイントリソース 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)。

# AWS Ground Station エージェントを使用する
<a name="how-it-works.gs-agent"></a>

 AWS Ground Station エージェントを使用すると、AWS Ground Station のコンタクト中に同期広帯域デジタル中間周波数 (DigIF) データフローを受信 (ダウンリンク) できます。

## 仕組み
<a name="how-it-works.gs-agent.what-is-gs-agent"></a>

 データ配信には 2 つのオプションを選択できます。

1. **EC2 インスタンスへのデータ配信** - 所有する EC2 インスタンスへのデータ配信。 AWS Ground Station エージェントを管理します。このオプションは、ほぼリアルタイムのデータ処理が必要な場合に最適です。EC2 データ配信の詳細については、[データフローの使用](dataflows.md)「」セクションを参照してください。

1. **S3 バケットへのデータ配信** - AWS S3 バケットへのデータ配信は、 によって完全に管理されます AWS Ground Station。S3 データ配信の詳細については、「[はじめに](getting-started.md)ガイド」を参照してください。

 どちらのデータ配信モードでも、一連の AWS リソースを作成する必要があります。CloudFormation を使用して AWS リソースを作成することを強くお勧めします。信頼性、正確性、およびサポート性を確保します。各コンタクトは EC2 または S3 のいずれかにのみデータを配信でき、両方に同時に配信することはできません。

 次の図は、 Software-Defined Radio (SDR) または同様のリスナーを使用して AWS Ground Station 、アンテナリージョンから EC2 インスタンスへの DigIF データフローを示しています。

 ![\[DigIF dataflow from an AWS Ground Station antennna region.\]](http://docs.aws.amazon.com/ja_jp/ground-station/latest/ug/images/digif-data-delivery-overview.png) 

## 追加情報
<a name="how-it-works.gs-agent.more-info"></a>

詳細については、[AWS Ground Station 「 エージェントユーザーガイド](https://docs.aws.amazon.com/ground-station/latest/gs-agent-ug)」を参照してください。