本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 如何 AWS Ground Station 运作
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 需要其他数据才能确保联系成功。
+ **您的卫星必须登载到一个或多个地点** — 这样可以确保您获得在请求的地点操作各种功能的许可。
+ **您的卫星必须具有有效的星*历——这样可以***确保天线具有视线，并且在接触过程中可以准确地指向您的卫星。
+ **您必须拥有有效的*任务配置文件*** — 这允许您自定义此联系人的行为，包括如何接收和向卫星发送数据。您可以为同一辆车使用多个任务配置文件来创建不同的触点，以适应您遇到的不同操作姿势或场景。
## 卫星上线
将卫星载入 AWS Ground Station 是一个多步骤的过程，包括数据收集、技术验证、频谱许可，以及集成和测试。本指南的 “[卫星入门](getting-started.step1.md)” 部分将引导您完成此过程。
## 任务概况构成
卫星频率信息、[数据平面](https://docs.aws.amazon.com/whitepapers/latest/aws-fault-isolation-boundaries/control-planes-and-data-planes.html)信息和其他详细信息封装在任务配置文件中。任务配置文件是*配置*组件的集合。这使您可以根据自己的用例在不同的任务配置文件中重复使用配置组件。由于任务概况不直接引用单个卫星，而只包含有关其技术能力的信息，因此具有相同配置的多颗卫星也可以重复使用任务配置文件。
有效的任务配置文件将包含*跟踪配置*和一个或多个*数据流*。跟踪配置将指定您在联系期间的跟踪偏好。数据流中的每个配置对都会建立源和目标。根据您的卫星及其运行模式，任务配置文件中数据流的确切数量将有所不同，以代表您的上行和下行链路通信路径以及任何数据处理方面。
+ 有关配置将在联系期间使用的 Amazon VPC、Amazon S3 和亚马逊 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/zh_cn/ground-station/latest/ug/images/mission-profile-composition.png)
## 联系人日程安排
有了有效的任务配置文件，您就可以请求联系您的机载卫星。联系人预约请求是异步的，以便全球天线服务有时间在所有相关 AWS 地区实现一致的时间表。在此过程中，将对所请求的地面站位置的各种天线进行评估，以确定它们是否可用并能够处理接触。在此过程中，还将评估您配置*的数据流端点*以确定其可用性。评估进行期间，联系人状态将处于 “排程” 状态。
此异步调度过程将在请求发出后的五分钟内完成，但通常在一分钟内完成。请在安排[利用事件 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/zh_cn/ground-station/latest/ug/images/scheduling.png)
可以执行且有空闲的联系会导致已*安排*的联系人。通过定期接触，您的任务概况所定义的 AWS 区域中已预留了执行联系所需的资源。无法执行或部件不可用的联系将导致 FAILED\$1TO *\$1SCHEDULE 联系失败*。有关调试[排查计划失败的联系人故障](troubleshooting-failed-to-schedule-contacts.md)的详细信息，请参阅。
## 联系人执行
AWS Ground Station 将在您的联系预约期间自动编排您的 AWS 托管资源。如果适用，您负责协调任务配置文件中定义为数据流端点的 EC2 资源。 AWS Ground Station 提供 [AWS Ev EventBridge en](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) ts，用于自动编排资源以降低成本。有关更多信息，请参阅[利用事件 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/zh_cn/ground-station/latest/ug/images/contact-orchestration-simplified.png)
在联系结束时， AWS Ground Station 将评估您的联系表现，并确定最终的联系状态。未检测到错误的联系人将变为 “*已完成*” 联系状态。在联系期间服务错误导致数据传输问题的联系人将进入*AWS\$1FAILED*状态。在联系过程中，如果客户或用户错误导致数据传输问题，则联系人将进入*失败*状态。在裁决期间，不考虑接触时间以外的错误，即通过前或通过后的错误。
请参阅[了解联系人生命周期](contacts.lifecycle.md)了解更多信息。
## 数字双胞胎
的数字双胞胎功能 AWS Ground Station 允许您根据虚拟地面站位置安排接触。这些虚拟地面站是生产地面站的精确复制品，包括天线功能、场地掩码和实际的 GPS 坐标。与生产地面站相比，数字双胞胎功能使您能够以低廉的成本测试联系人编排工作流程。参阅 [使用 AWS Ground Station 数字双胞胎功能](digital-twin.md) 了解更多信息。
# 了解 AWS Ground Station 核心组件
本节提供了 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/zh_cn/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 数据流终端节点组](how-it-works.dataflow-endpoint-group.md)
+ [使用 AWS Ground Station 代理](how-it-works.gs-agent.md)
# 使用 AWS Ground Station 任务档案
任务配置文件包含的配置和参数说明了如何执行联络。预留联络或搜索可用联络时，您提供打算使用的任务配置文件。任务配置文件将您的所有配置集合在一起，并定义了在联络期间数据将去往何处。
任务概况可以在具有相同无线电特性的卫星之间共享。您可以创建其他 Dataflow 端点组，以限制您要为星座执行的最大同时接触次数。
跟踪配置被指定为任务配置文件中的一个唯一字段。跟踪配置用于指定您在联系期间使用节目跟踪和自动跟踪的偏好。有关更多信息，请参阅 [跟踪配置](how-it-works.config.md#how-it-works.config-tracking)。
所有其他配置都包含在任务配置文件`dataflowEdges`字段中。这些配置可以看作是数据流节点，每个节点都代表可以发送或接收数据的 AWS Ground Station 托管资源及其相关配置。该`dataflowEdges`字段定义了需要哪些源和目标数据流节点（配置）。单个数据流边缘是两个配置 A [mazon 资源名称 (ARNs)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 的列表，第一个是*源*配置，第二个是*目标*配置。通过在两个配置之间指定数据流边缘，您可以分辨出联系期间数据应 AWS Ground Station 从何处流向何处。有关更多信息，请参阅 [使用 AWS Ground Station 配置](how-it-works.config.md)。
`contactPrePassDurationSeconds`和`contactPostPassDurationSeconds`允许您指定与联系人相关的接收 CloudWatch 事件通知的时间。有关与您的联系人相关的事件的时间表，请阅读[了解联系人生命周期](contacts.lifecycle.md)。
任务配置文件的 `name` 字段有助于区分您创建的任务配置文件。
`streamsKmsRole`和`streamsKmsKey`用于定义通过 A AWS Ground Station gent 传输数据时使用的 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/zh_cn/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 配置
*配置*是用于定义联系人各个方面的参数的资源。 AWS Ground Station 将您想要的配置添加到任务配置文件中，然后在执行联络时使用该任务配置文件。您可以定义几种不同类型的配置。这些配置可以分为三类：
+ 跟踪配置
+ 数据流配置
+ 遥测配置
A *TrackingConfig*是唯一的跟踪配置类型。它用于在接触期间配置天线的自动跟踪设置，并且在任务配置文件中是必需的。
可以在任务配置文件数据流中使用的配置可以看作是数据流节点，每个节点都代表可以发送或接收数据的 AWS Ground Station 托管资源。任务配置文件至少需要一对这样的配置，其中一个代表数据源，一个代表目的地。下表汇总了这些配置。
| Config 名称 | 数据流源/目的地 |
| --- | --- |
| AntennaDownlinkConfig | 来源 |
| AntennaDownlinkDemodDecodeConfig | 来源 |
| UplinkEchoConfig | 来源 |
| S3 RecordingConfig | 目标位置 |
| AntennaUplinkConfig | 目标位置 |
| DataflowEndpointConfig | 源 and/or 目的地 |
A *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)
+ [配置 API 参考](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateConfig.html)
## 跟踪配置
您可以使用任务配置文件中的跟踪配置来确定是否应在您的联络期间启用自动跟踪。此配置只有一个参数：`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)
## 天线下行传输配置
您可在联络期间使用天线下行链路配置，以配置需要下行链路传输的天线。它们包括一个光谱配置，其中指定了下行联络期间应使用的频率、带宽和极化。
此配置表示数据流中的源节点。它负责对射频数据进行数字化。从该节点流出的数据将遵循信号 Data/IP 格式。有关如何使用此配置构造数据流的更多详细信息，请参阅 [使用数据流](dataflows.md)
如果您的下行传输用例需要解调或解码，请参阅 [天线下行传输解调解码配置](#how-it-works.config-antenna-downlink-demod-decode)。
有关如何使用 CloudFormation、或 API 对天线下行链路配置执行操作的更多信息，请参阅以下文档。 AWS Command Line Interface AWS Ground Station
+ [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)
## 天线下行传输解调解码配置
天线下行链路演示解码配置是一种更复杂且可自定义的配置类型，可用于通过解调解码执行下行链路接触。 and/or 如果您有兴趣执行这些类型的联系人， AWS 支持 请通过 [AWS Support Center Console](https://console.aws.amazon.com/support). 我们将帮助您确定适合您的用例的正确配置和任务配置文件。
此配置表示数据流中的源节点。它负责对射频数据进行数字化处理，并按照规定执行解调和解码。从该节点流出的数据将遵循 Demodulated/Decoded 数据/IP 格式。有关如何使用此配置构造数据流的更多详细信息，请参阅 [使用数据流](dataflows.md)
有关如何使用、或 API 对天线下行链路演示解码配置执行操作的更多信息 CloudFormation，请参阅以下文档。 AWS Command Line Interface AWS Ground Station
+ [ 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)
## 天线上行传输配置
您可以在联络期间使用天线上行链路配置，以配置需要上行链路传输的天线。它们由包含频率、极化和目标有效各向同性辐射功率 (EIRP) 的频谱配置组成。有关如何配置上行回波的信息，请参阅 [天线上行传输回波配置](#how-it-works.config-antenna-uplink-echo)。
此配置表示数据流中的目标节点。它会将提供的数字化射频数据信号转换为模拟信号，然后将其发射给您的卫星接收。流向该节点的数据预计将符合信号 Data/IP 格式。有关如何使用此配置构造数据流的更多详细信息，请参阅 [使用数据流](dataflows.md)
有关如何使用 CloudFormation、或 API 对天线上行链路配置执行操作的更多信息，请参阅以下文档。 AWS Command Line Interface AWS Ground Station
+ [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)`部分）
+ [AntennaUplinkConfig API 参考](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AntennaUplinkConfig.html)
## 天线上行传输回波配置
上行传输回波配置告诉天线如何执行上行传输回波。上行链路回声可用于验证发送到航天器的命令，并执行其他高级任务。这是通过记录 AWS Ground Station 天线（即上行链路）传输的实际信号来实现的。这会回声天线发送回您的数据流端点的信号，并且应该与传输的信号相匹配。上行传输回波配置包含上行传输配置的 ARN。天线使用在执行上行传输回波时 ARN 指向的上行传输配置中的参数。
此配置表示数据流中的源节点。从该节点流出的数据将符合信号 Data/IP 格式。有关如何使用此配置构造数据流的更多详细信息，请参阅 [使用数据流](dataflows.md)
有关如何使用 CloudFormation、或 API 对上行链路 echo 配置执行操作的更多信息，请参阅以下文档。 AWS Command Line Interface AWS Ground Station
+ [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)
## 数据流端点配置
**注意**
数据流端点配置仅用于向 Amazon EC2 传输数据，不用于向 Amazon S3 传输数据。
您可以使用数据流端点配置来指定联络期间从[数据流端点组](how-it-works.dataflow-endpoint-group.md)中的哪个数据流端点流入或流向哪个数据流端点。数据流端点配置的两个参数指定数据流端点的名称和区域。预订联系人时， AWS Ground Station 会分析您指定的[任务配置文件](how-it-works-mission-profile.md)并尝试在 AWS 区域内找到一个数据流端点*组*，该组包含任务配置文件中包含的数据流*端点**配置*所指定的所有数据流端点。如果找到了合适的数据流端点*组*，则联系状态将变为 “已计划”，否则将变为 FAILED\$1TO\$1SCHEDULE。有关联系人可能的状态的更多信息，请参阅[AWS Ground Station 联系人状态](contacts.lifecycle.md#contact-statuses)。
数据流端点配置的 `dataflowEndpointName` 属性指定联络期间从数据流端点组中的哪个数据流端点流入或流向哪个数据流端点。
`dataflowEndpointRegion` 属性指定数据流端点所在的区域。如果在您的数据流终端节点配置中指定了区域，则会在指定区域中 AWS Ground Station 查找数据流终端节点。如果未指定区域， AWS Ground Station 则默认为联系人的地面站区域。如果您的数据流端点的区域与联络的地面站区域不同，则该联络被视为跨区域数据传输联络。[使用数据流](dataflows.md)有关跨区域数据流的更多信息，请参阅。
有关数据流[使用 AWS Ground Station 数据流终端节点组](how-it-works.dataflow-endpoint-group.md)的不同命名方案如何使您的用例受益的提示，请参阅。
有关如何使用此配置构造数据流的更多详细信息，请参阅 [使用数据流](dataflows.md)
有关如何使用、或 API 对数据流端点配置执行操作的更多信息 CloudFormation，请参阅以下文档。 AWS Command Line Interface AWS Ground Station
+ [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)
## 亚马逊 S3 录音 Config
**注意**
Amazon S3 记录配置仅用于向亚马逊 S3 传输数据，不用于向亚马逊 EC2 传输数据。
此配置表示数据流中的目标节点。该节点会将来自数据流源节点的传入数据封装到 pcap 数据中。有关如何使用此配置构造数据流的更多详细信息，请参阅 [使用数据流](dataflows.md)
您可以使用 S3 记录配置来指定要将下行链接数据以及使用的命名约定传送到的 Amazon S3 存储桶。以下内容指定了有关这些参数的限制和详细信息：
+ Amazon S3 存储桶的名称必须以 `aws-groundstation` 开始。
+ IAM 角色必须拥有信任策略，以允许 `groundstation.amazonaws.com` 服务主体承担该角色。有关示例，请参阅下面的[示例信任策略](#s3-trust-policy-example)部分。在配置创建过程中，配置资源 ID 不存在，信任策略必须使用星号 (*\$1*) 代替，*your-config-id*并且可以在创建后使用配置资源 ID 进行更新。
### 示例信任策略
有关如何更新角色的信任策略的更多信息，请参阅 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 角色必须拥有 IAM policy，以允许该角色对存储桶执行 `s3:GetBucketLocation` 操作以及对存储桶对象执行 `s3:PutObject` 操作。如果 Amazon S3 存储桶拥有存储桶策略，则该存储桶策略还必须允许 IAM 角色执行这些操作。有关示例，请参阅下面的[示例角色策略](#s3-role-policy-example)部分。
### 示例角色策略
有关如何更新或附加角色策略的更多信息，请参阅 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}``{config-name}`\$1 `{config-id}` \$1 \$1 `{year}` \$1 `{month}` \$1 `{day}` \$1
有关如何使用 CloudFormation、或 AWS Ground Station API 对 S3 录制配置执行操作的更多信息，请参阅以下文档。 AWS Command Line Interface
+ [AWS::GroundStation::Config S3 RecordingConfig CloudFormation 属性](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)`部分）
+ [S3 RecordingConfig API 参考](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_S3RecordingConfig.html)
## 遥测接收器 Config
您可以使用遥测接收器配置来指定在卫星接触期间要将遥测数据传送到何处。遥测接收器配置是可选的，已添加到您的任务配置文件中，用于安排支持遥测的联系人。以下内容指定了有关这些参数的限制和详细信息：
+ IAM 角色必须拥有信任策略，以允许 `groundstation.amazonaws.com` 服务主体承担该角色。有关示例，请参阅下面的[示例信任策略](#telemetry-config-trust-policy-example)部分。
### 示例信任策略
有关如何更新角色的信任策略的更多信息，请参阅 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 角色必须有一个 IAM 策略，允许该角色在直播中执行`kinesis:DescribeStream`、`kinesis:PutRecord`和`kinesis:PutRecords`操作。有关示例，请参阅下面的[示例角色策略](#telemetry-config-role-policy-example)部分。
### 示例角色策略
有关如何更新或附加角色策略的更多信息，请参阅 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、或 API 对遥测接收器配置执行操作的更多信息，请参阅以下文档。 AWS Command Line Interface AWS Ground Station
+ [ 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 端点*定义了您希望在联系期间同步流入或流出数据的位置。数据流终端节点总是作为*数据流终端节点组*的一部分创建的。在组中包括多个数据流终端节点，即表示您主张那些指定的终端节点都可以在单次联络中一起使用。例如，如果联络需要向三个独立的数据流端点发送数据，则单个数据流端点组中必须有三个端点与您的任务配置文件中的数据流端点配置相匹配。
## 数据流终端节点组版本
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 代理端点的上行链路和下行链路数据流，提高了清晰度和功能性
**数据流终端节点组比较**
| 功能 | 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)，我们建议使用带有 [DataflowEndpointGroupV2](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateDataflowEndpointGroupV2.html) 的和[DownlinkAwsGroundStationAgentEndpoint](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DownlinkAwsGroundStationAgentEndpoint.html)终端节点。 DataflowEndpointGroup 仍然支持向后兼容，但是 DataflowEndpointGroup V2 提供了增强的功能和更清晰的配置选项。
**提示**
执行联系人时，数据流端点由您选择的名称标识。这些名称在整个账户中不必是唯一的。这允许使用相同的任务配置文件在不同的卫星和天线上同时执行多个接触。如果您拥有一组具有相同运行特性的卫星，这可能会很有用。您可以向上扩展 Dataflow 端点组的数量，以适应您的卫星星座所需的最大同步联系数量。
当数据流终端节点组中的一个或多个资源正用于某个联络时，在该次联络期间整个组都予以保留。您可以同时执行多个联络，但这些联络必须在不同的数据流端点组中执行。
**重要**
数据流端点组必须处于 `HEALTHY` 状态，才能用于安排联络。有关如何对未处于`HEALTHY`状态的数据流终端节点组进行故障排除的信息，请参阅。[排除 DataflowEndpointGroups 未处于正常状态的故障](troubleshooting-dfeg.md)
有关如何使用 CloudFormation、或 API 对数据流终端节点组执行操作的更多信息，请参阅以下文档。 AWS Command Line Interface AWS Ground Station
+ [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)
+ [数据流端点组 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)对于这两种类型的端点，您将在创建 dataflow 端点组之前创建支持结构（例如 IP 地址）。[使用数据流](dataflows.md)有关使用哪种 dataflow 端点类型以及如何设置支持结构的建议，请参阅。
以下各节描述了两种支持的端点类型。
**重要**
单个数据流终端节点组中的所有数据流端点必须属于同一类型。您不能在同一个组中将[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)混合使用。如果您的用例需要两种类型的终端节点，则必须为每种类型创建单独的 dataflow 端点组。
对于 DataflowEndpointGroup V2，您可以将[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 代理端点
AWS Ground Station 代理端点使用 AWS Ground Station 代理作为软件组件来终止连接。要构造 AWS Ground Station 代理终端节点，您只需要填充的`AwsGroundStationAgentEndpoint` EndpointDetails字段。有关 AWS Ground Station 代理的更多信息，请参阅完整的《[AWS Ground Station 代理用户指南》](https://docs.aws.amazon.com/ground-station/latest/gs-agent-ug/)。
`AwsGroundStationAgentEndpoint` 由以下内容组成：
+ `Name`-数据流端点名称。要使联系人使用此数据流端点，此名称必须与您的数据流端点配置中使用的名称相匹配。
+ `EgressAddress`-用于从代理输出数据的 IP 和端口地址。
+ `IngressAddress`-用于将数据传入代理的 IP 和端口地址。
#### 数据流端点
Dataflow Endpoint 使用网络应用程序作为软件组件来终止连接。如果要上行传输数字信号数据、下行链路少于 50% MHz 的数字信号数据或下行链路信号数据，请使用 Dataflow Endpoint。 Demodulated/Decoded 要构建 Dataflow Endpoint，您需要填充`Endpoint`和`Security Details`字段。 EndpointDetails
`Endpoint` 由以下内容组成：
+ `Name`-数据流端点名称。要使联系人使用此数据流端点，此名称必须与您的数据流端点配置中使用的名称相匹配。
+ `Address`-使用的 IP 和端口地址。
`SecurityDetails` 由以下内容组成：
+ `roleArn`- AWS Ground Station 将担任在您的 VPC 中创建弹性网络接口 () 的角色的亚马逊资源名称 (ARNENIs)。它们 ENIs 充当联系期间流式传输的数据的入口和输出点。
+ `securityGroupIds`：附加到弹性网络接口的安全组。
+ `subnetIds`- AWS Ground Station 可能放置弹性网络接口以向您的实例发送流的子网列表。如果指定了多个子网，则它们必须可以相互路由。如果子网位于不同的可用区 (AZs)，则可能会产生跨可用区数据传输费用。
传递到 `roleArn` 的 IAM 角色必须拥有信任策略，以允许 `groundstation.amazonaws.com` 服务主体代入该角色。有关示例，请参阅下面的[示例信任策略](#dataflow-endpoint-trust-policy-example)部分。在创建端点期间，端点资源 ID 不存在，因此信任策略必须使用星号 (*\$1*) 代替。*your-endpoint-id*这可以在创建后进行更新以使用端点资源 ID，从而将信任策略的范围限定为该特定的数据流端点组。
IAM 角色必须具有 AWS Ground Station 允许设置的 IAM 策略 ENIs。有关示例，请参阅下面的[示例角色策略](#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 保持完全的向后兼容性。
如果您想迁移以使用新的 DataflowEndpointGroup V2，并且目前正在使用[DataflowEndpoint](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DataflowEndpoint.html)带有 Dataflow Endpoint 应用程序的应用程序来接收数据，则需要迁移以改用代理。 AWS Ground Station 如果您已经在使用 AWS Ground Station 代理进行下行链路，则也可以将相同的代理实例用于上行链路，无需其他代理实例。
要迁移到 DataflowEndpointGroup V2，请执行以下操作：
1. 如果从中迁移 DataflowEndpoint，请按照《 AWS Ground Station [AWS Ground Station 代理用户指南》](https://docs.aws.amazon.com/ground-station/latest/gs-agent-ug/)设置代理
1. 确定您的数据流方向并创建相应的端点类型（或）[UplinkAwsGroundStationAgentEndpoint[DownlinkAwsGroundStationAgentEndpoint](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DownlinkAwsGroundStationAgentEndpoint.html)](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UplinkAwsGroundStationAgentEndpoint.html)
1. 创建引用这些端点的 [DataflowEndpointGroupV2](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateDataflowEndpointGroupV2.html)
1. 创建一个按名称引用新 DataflowEndpointGroup V2 的新[数据流端点配置](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)。
# 使用 AWS Ground Station 代理
AWS Ground Station 代理使您能够在 AWS Ground Station 联系期间接收（下行链路）同步宽带数字中频 (digiF) 数据流。
## 工作方式
您可以选择两个数据传输选项：
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 传输数据，但不能同时向两者传送数据。
下图显示了使用软件定义无线电 (SDR) 或类似监听器从 AWS Ground Station 天线区域到您的 EC2 实例的 digiF 数据流。
![\[DigIF dataflow from an AWS Ground Station antennna region.\]](http://docs.aws.amazon.com/zh_cn/ground-station/latest/ug/images/digif-data-delivery-overview.png)
## 其他信息
有关更多详细信息，请参阅完整的《[AWS Ground Station 代理用户指南》](https://docs.aws.amazon.com/ground-station/latest/gs-agent-ug)。