

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

 *組態*是 資源， AWS Ground Station 用來定義聯絡人每個層面的參數。將您想要的組態新增至任務設定檔，然後執行接收時，即會使用該任務設定檔。您可以定義多種不同類型的組態。組態可分為三個類別：
+ 追蹤組態
+ Dataflow 組態
+ 遙測組態

 *TrackingConfig* 是唯一的追蹤組態類型。它用於在聯絡期間設定天線的自動追蹤設定，在任務設定檔中是必要的。

 可在任務設定檔資料流程中使用的組態可視為資料流程節點，每個節點代表可傳送或接收資料的 AWS Ground Station 受管資源。任務描述檔需要至少一對這些組態，一個代表資料來源，另一個代表目的地。這些組態摘要如下表所示。


| 組態名稱 | 資料流程來源/目的地 | 
| --- | --- | 
|  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)
+ [Config 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 將利用程式設計追蹤，當未使用自動追蹤時，該追蹤會根據您的暫時性變化來指向。如需如何建構 ephemeris 的詳細資訊[了解 AWS Ground Station 如何使用 ephemeride](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)
+ [組態 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 Command Line Interface、 或 AWS Ground Station API 在天線下行組態上執行操作的詳細資訊，請參閱下列文件。
+ [AWS::GroundStation::Config AntennaDownlinkConfig CloudFormation 屬性](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-groundstation-config-antennadownlinkconfig.html)
+ [組態 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) 

 如需如何使用 AWS Command Line Interface、 或 AWS Ground Station API 在天線下行示範解碼組態上執行操作的詳細資訊 CloudFormation，請參閱下列文件。
+  [ AWS::GroundStation::Config AntennaDownlinkDemodDecodeConfig CloudFormation 屬性 ](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-groundstation-config-antennadownlinkdemoddecodeconfig.html) 
+  [ 組態 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 Command Line Interface、 或 AWS Ground Station API 在天線上行組態上執行操作的詳細資訊，請參閱下列文件。
+ [AWS::GroundStation::Config AntennaUplinkConfig CloudFormation 屬性](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-groundstation-config-antennauplinkconfig.html)
+ [組態 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 指向之上行組態的參數。

 此組態代表資料流程中的來源節點。從此節點串流的資料將符合訊號資料/IP 格式。如需如何使用此組態建構資料流程的詳細資訊，請參閱 [使用資料流程](dataflows.md) 

 如需如何使用 AWS Command Line Interface、 或 AWS Ground Station API 在上行回應組態上執行操作的詳細資訊 CloudFormation，請參閱下列文件。
+ [AWS::GroundStation::Config UplinkEchoConfig CloudFormation 屬性](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-groundstation-config-uplinkechoconfig.html)
+ [組態 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>

**注意**  
 Dataflow 端點組態僅用於將資料交付至 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 Dataflow 端點群組](how-it-works.dataflow-endpoint-group.md)秘訣，請參閱 。

 如需如何使用此組態建構資料流程的詳細資訊，請參閱 [使用資料流程](dataflows.md) 

 如需如何使用 AWS Command Line Interface、 或 AWS Ground Station API 在資料流程端點組態上執行操作的詳細資訊 CloudFormation，請參閱下列文件。
+ [AWS::GroundStation::Config DataflowEndpointConfig CloudFormation 屬性](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-groundstation-config-dataflowendpointconfig.html)
+ [組態 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 不存在，信任政策必須使用星號 (*\$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 政策，允許角色對儲存貯體執行 `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}` \$1 `{config-name}` \$1 `{config-id}` \$1 `{year}` `{month}` \$1 \$1 `{day}` \$1 

 如需如何使用 CloudFormation AWS Command Line Interface、 或 AWS Ground Station API 在 S3 錄製組態上執行操作的詳細資訊，請參閱下列文件。
+ [AWS::GroundStation::Config S3RecordingConfig CloudFormation 屬性](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-groundstation-config-s3recordingconfig.html)
+ [組態 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 Command Line Interface、 或 AWS Ground Station API 在遙測接收器組態上執行操作的詳細資訊，請參閱下列文件。
+  [ AWS::GroundStation::Config TelemetrySinkConfig CloudFormation 屬性](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-groundstation-config-telemetrysinkconfig.html) 
+  [ 組態 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) 