

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用 AWS Ground Station 配置
<a name="how-it-works.config"></a>

 *配置*是用于定义联系人各个方面的参数的资源。 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)

## 跟踪配置
<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>

 您可在联络期间使用天线下行链路配置，以配置需要下行链路传输的天线。它们包括一个光谱配置，其中指定了下行联络期间应使用的频率、带宽和极化。

此配置表示数据流中的源节点。它负责对射频数据进行数字化。从该节点流出的数据将遵循信号 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)

## 天线下行传输解调解码配置
<a name="how-it-works.config-antenna-downlink-demod-decode"></a>

 天线下行链路演示解码配置是一种更复杂且可自定义的配置类型，可用于通过解调解码执行下行链路接触。 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) 

## 天线上行传输配置
<a name="how-it-works.config-antenna-uplink"></a>

 您可以在联络期间使用天线上行链路配置，以配置需要上行链路传输的天线。它们由包含频率、极化和目标有效各向同性辐射功率 (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)

## 天线上行传输回波配置
<a name="how-it-works.config-antenna-uplink-echo"></a>

 上行传输回波配置告诉天线如何执行上行传输回波。上行链路回声可用于验证发送到航天器的命令，并执行其他高级任务。这是通过记录 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)

## 数据流端点配置
<a name="how-it-works.core-config-dfe"></a>

**注意**  
 数据流端点配置仅用于向 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
<a name="how-it-works.config-s3-recording"></a>

**注意**  
 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 进行更新。

### 示例信任策略
<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 角色必须拥有 IAM policy，以允许该角色对存储桶执行 `s3:GetBucketLocation` 操作以及对存储桶对象执行 `s3:PutObject` 操作。如果 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}``{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
<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 角色必须有一个 IAM 策略，允许该角色在直播中执行`kinesis:DescribeStream`、`kinesis:PutRecord`和`kinesis:PutRecords`操作。有关示例，请参阅下面的[示例角色策略](#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、或 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) 