本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 使用 AWS Ground Station Dataflow 端點群組 *Dataflow 端點*會定義您希望在聯絡期間同步串流資料的位置。資料流程端點一律建立為*資料流程端點群組*的一部分。透過將多個資料流程端點包含在一個群組中，您宣告可在單一接收中一起使用全部的指定端點。例如，如果接收需要將資料分別傳送到三個資料流程端點，您必須在符合任務設定檔資料流程端點組態的單一資料流程端點群組中有三個端點。 ## Dataflow 端點群組版本 AWS Ground Station 支援兩個版本的資料流程端點群組： + **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 客服人員端點的上行和下行資料流程，並改善清晰度和功能 **Dataflow 端點群組比較** | 功能 | DataflowEndpointGroup | DataflowEndpointGroupV2 | | --- | --- | --- | | 支援的端點類型 | DataflowEndpoint，AwsGroundStationAgentEndpoint | DownlinkAwsGroundStationAgentEndpoint、UplinkAwsGroundStationAgentEndpoint | | 支援上行的端點 | DataflowEndpoint | UplinkAwsGroundStationAgentEndpoint | | 支援下行的端點 | DataflowEndpoint，AwsGroundStationAgentEndpoint | DownlinkAwsGroundStationAgentEndpoint | 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 提供增強功能和更清晰的組態選項。 **提示** 執行聯絡人時，資料流程端點會以您選擇的名稱識別。這些名稱在帳戶中不需要是唯一的名稱。這允許使用相同的任務設定檔同時執行不同衛星和天線的多個聯絡人。如果您有具有相同操作特性的衛星星座，這會很有用。您可以擴展資料流程端點群組的數量，以符合衛星星座所需的同時聯絡數目上限。 當資料流程端點群組中的一或多項資源正為某項接收使用時，整個群組在接收期間會為該接收保留。您可以同時執行多個聯絡人，但這些聯絡人必須在不同的資料流程端點群組上執行。 **重要** Dataflow 端點群組必須處於 `HEALTHY` 狀態，才能使用它們排程聯絡人。如需如何對未處於 `HEALTHY` 狀態的資料流程端點群組進行故障診斷的資訊，請參閱 [針對未處於 HEALTHY 狀態的 DataflowEndpointGroups 進行故障診斷](troubleshooting-dfeg.md)。 如需如何使用 CloudFormation AWS Command Line Interface、 或 AWS Ground Station API 在資料流程端點群組上執行操作的詳細資訊，請參閱下列文件。 + [AWS::GroundStation::DataflowEndpointGroup CloudFormation 資源類型](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-groundstation-dataflowendpointgroup.html) + [Dataflow 端點群組 AWS CLI 參考](https://docs.aws.amazon.com/cli/latest/reference/groundstation/create-dataflow-endpoint-group.html) + [Dataflow 端點群組 API 參考](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateDataflowEndpointGroup.html) ## 資料流程端點 資料流程端點群組的成員是資料流程端點。支援的端點類型取決於您使用的資料流程端點群組版本。 ### DataflowEndpointGroup 端點 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 代理程式端點 Agent AWS Ground Station Endpoint 利用 AWS Ground Station Agent 做為軟體元件來終止連線。若要建構 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 和連接埠地址。 #### Dataflow 端點 Dataflow 端點利用聯網應用程式做為軟體元件來終止連線。當您想要上行數位訊號資料、下行小於 50MHz 的數位訊號資料，或下行解調/解碼訊號資料時，請使用資料流程端點。若要建構 Dataflow 端點，您將填入 EndpointDetails 的 `Endpoint`和 `Security Details` 欄位。 `Endpoint`包含下列項目： + `Name` - 資料流程端點名稱。若要讓聯絡人使用此資料流程端點，此名稱必須符合資料流程端點組態中使用的名稱。 + `Address` - 使用的 IP 和連接埠地址。 `SecurityDetails`包含下列項目： + `roleArn` - AWS Ground Station 將擔任在 VPC 中建立彈性網路界面 (ENIs) 之角色的 Amazon Resource Name (ARN)。這些 ENI 可做為聯絡期間串流之資料的傳入和傳出點。 + `securityGroupIds` - 要連接到彈性網路界面的安全群組。 + `subnetIds` - 子網路清單，其中 AWS Ground Station 可能會放置彈性網路介面，以將串流傳送至您的執行個體。如果指定多個子網路，它們必須可以彼此路由。如果子網路位於不同的可用區域 (AZs)，您可能會產生跨可用區域資料傳輸費用。 傳入 的 IAM 角色`roleArn`必須具有信任政策，允許`groundstation.amazonaws.com`服務主體擔任該角色。如需範例，[請參閱以下範例信任政策](#dataflow-endpoint-trust-policy-example)一節。在端點建立期間，端點資源 ID 不存在，因此信任政策必須使用星號 ({{\*}}) {{your-endpoint-id}}。這可以在建立後更新為使用端點資源 ID，以便將信任政策範圍限定於該特定資料流程端點群組。 IAM 角色必須具有允許 AWS Ground Station 設定 ENIs的 IAM 政策。如需範例，[請參閱以下的範例角色政策](#dataflow-endpoint-role-policy-example)一節。 ##### 範例信任政策 如需如何更新角色信任政策的詳細資訊，請參閱《[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}}" } } } ] } ``` ------ ##### 範例角色政策 如需如何更新或連接角色政策的詳細資訊，請參閱《[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 端點 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 代理程式端點 [UplinkAwsGroundStationAgentEndpoint](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UplinkAwsGroundStationAgentEndpoint.html) 專為上行資料流程而設計，並提供更清晰的組態選項。當您需要將資料提供給 AWS Ground Station 以上行至衛星時，請使用此端點類型。 `UplinkAwsGroundStationAgentEndpoint`包含下列項目： + `Name` - 資料流程端點名稱。若要讓聯絡人使用此資料流程端點，此名稱必須符合資料流程端點組態中使用的名稱。 + `IngressAddressAndPort` - 單一 IP 和連接埠地址，用於向代理程式輸入資料 + `AgentIpAndPortAddress` - 代理程式通訊的連接埠範圍 #### 下行 AWS Ground Station 代理程式端點 [DownlinkAwsGroundStationAgentEndpoint](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DownlinkAwsGroundStationAgentEndpoint.html) 已針對下行資料流程進行最佳化，包括窄頻下行、寬頻解調/解碼，以及上行回聲案例。 `DownlinkAwsGroundStationAgentEndpoint`包含下列項目： + `Name` - 資料流程端點名稱。若要讓聯絡人使用此資料流程端點，此名稱必須符合資料流程端點組態中使用的名稱。 + `EgressAddressAndPort` - 代理程式資料輸出的單一 IP 和連接埠地址 + `AgentIpAndPortAddress` - 代理程式通訊的連接埠範圍 ## 建立資料流程端點群組 您可以使用下列任一版本建立資料流程端點群組： ### CreateDataflowEndpointGroup 使用 [CreateDataflowEndpointGroup](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateDataflowEndpointGroup.html) 實現回溯相容性，或當您需要使用一般 [AwsGroundStationAgentEndpoint](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AwsGroundStationAgentEndpoint.html) 或 [DataflowEndpoint](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DataflowEndpoint.html) 類型時。 ### CreateDataflowEndpointGroupV2 針對新實作使用 [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)。 ## 遷移考量事項 如果您目前正在使用 DataflowEndpointGroup，則可以繼續使用現有的組態，而無需變更。 AWS Ground Station 會維持完整的回溯相容性。 如果您想要遷移以使用新的 DataflowEndpointGroupV2，且目前正在搭配 Dataflow Endpoint Application 使用 [DataflowEndpoint](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DataflowEndpoint.html) 來接收資料，則需要遷移以改用 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) 1. 建立新的任務描述檔，將資料流程端點組態參考為資料流程邊緣 1. 使用新的任務設定檔來排程聯絡人 1. 在部署到生產環境之前測試您的組態 如需完整工作流程的詳細資訊，請參閱 [了解 AWS Ground Station 核心元件](how-it-works.core.md)和 [建立組態](getting-started.step3.md)。