Configs
Configs are resources that AWS Ground Station uses to define the parameters for each aspect of your contact. Add the configs you want to a mission profile, and then that mission profile will be used when executing the contact. You can define several different types of configs.
See the following documentation for more information about how to perform operations on configs using AWS CloudFormation, the AWS Command Line Interface, or the AWS Ground Station API. Links to documentation for specific config types are also provided below.
Dataflow Endpoint Config
Note
Dataflow endpoint configs are only used for data delivery to Amazon EC2 and are not used for data delivery to Amazon S3.
You can use dataflow endpoint configs to specify which dataflow endpoint in a dataflow endpoint group from which or to which you want data to flow during a contact. The two parameters of a dataflow endpoint config specify the name and region of the dataflow endpoint. When reserving a contact, AWS Ground Station analyzes the mission profile you specified and attempts to find a dataflow endpoint group that contains all of the dataflow endpoints specified by the dataflow endpoint configs contained in your mission profile.
The dataflowEndpointName
property of a dataflow endpoint config specifies which dataflow endpoint in a dataflow endpoint group to which or from which data will flow during a contact.
The dataflowEndpointRegion
property specifies which region the dataflow endpoint resides in.
If a region is specified in your dataflow endpoint config, AWS Ground Station looks for a dataflow endpoint in the region specified.
If no region is specified, AWS Ground Station will default to the contact's ground station region.
A contact is considered a cross region data delivery contact if your dataflow endpoint's region is not the same as the contact's ground station region.
See the following documentation for more information about how to perform operations on dataflow endpoint configs using AWS CloudFormation, the AWS Command Line Interface, or the AWS Ground Station API.
AWS::GroundStation::Config DataflowEndpointConfig CloudFormation property
Config AWS CLI reference (see the
dataflowEndpointConfig -> (structure)
section)
S3 Recording Config
Note
S3 recording configs are only used for data delivery to Amazon S3 and are not used for data delivery to Amazon EC2.
You can use S3 recording configs to specify an Amazon S3 bucket to which you want downlinked data delivered. The two parameters of an S3 recording config specify the Amazon S3 bucket and IAM role for AWS Ground Station to assume when delivering the data to your Amazon S3 bucket. The IAM role and Amazon S3 bucket specified must meet the following criteria:
The Amazon S3 bucket's name must begin with
aws-groundstation
.-
The IAM role must have a trust policy that allows the
groundstation.amazonaws.com
service principal to assume the role. See the Example Trust Policy section below for an example. During config creation the config resource id does not exist, the trust policy must use an asterisk (*
) in place ofyour-config-id
and can be updated after creation with the config resource id. -
The IAM role must have an IAM policy that allows the role to perform the
s3:GetBucketLocation
action on the bucket ands3:PutObject
action on the bucket's objects. If the Amazon S3 bucket has a bucket policy, then the bucket policy must also allow the IAM role to perform these actions. See the Example Role Policy section below for an example.
For more information on how to update a role's trust policy, see Managing IAM roles in the IAM User Guide.
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "groundstation.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "aws:SourceAccount": "
your-account-id
" }, "ArnLike": { "aws:SourceArn": "arn:aws:groundstation:config-region
:your-account-id
:config/s3-recording/your-config-id
" } } } ] }
For more information on how to update or attach a role policy, see Managing IAM policies in the IAM User Guide.
{ "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
/*" ] } ] }
See the following documentation for more information about how to perform operations on S3 recording configs using AWS CloudFormation, the AWS Command Line Interface, or the AWS Ground Station API.
AWS::GroundStation::Config S3RecordingConfig CloudFormation property
Config AWS CLI reference (see the
s3RecordingConfig -> (structure)
section)
Tracking Config
You can use tracking configs in the mission profile to determine whether autotrack should be enabled during your contacts.
This config has a single parameter: autotrack
. The autotrack
parameter can have the following values:
REQUIRED
- Autotrack is required for your contacts.PREFERRED
- Autotrack is preferred for contacts, but contacts can still be executed without autotrack.REMOVED
- No autotrack should be used for your contacts.
See the following documentation for more information about how to perform operations on tracking configs using AWS CloudFormation, the AWS Command Line Interface, or the AWS Ground Station API.
AWS::GroundStation::Config TrackingConfig CloudFormation property
Config AWS CLI reference (see the
trackingConfig -> (structure)
section)
Antenna Downlink Config
You can use antenna downlink configs to configure the antenna for downlink during your contact. They consist of a spectrum config that specifies the frequency, bandwidth, and polarization that should be used during your downlink contact. If your downlink use case requires demodulation or decoding, see the Antenna Downlink Demod Decode Config.
See the following documentation for more information about how to perform operations on antenna downlink configs using AWS CloudFormation, the AWS Command Line Interface, or the AWS Ground Station API.
AWS::GroundStation::Config AntennaDownlinkConfig CloudFormation property
Config AWS CLI reference (see the
antennaDownlinkConfig -> (structure)
section)
Antenna Downlink Demod Decode Config
Antenna downlink demod decode configs are a more complex and customizable config type that you can use to execute downlink contacts with demod or decode. If you're interested in executing these types of contacts, contact the AWS Ground Station team. We'll help you define the right config and mission profile for your use case.
See the following documentation for more information about how to perform operations on antenna downlink demod decode configs using AWS CloudFormation, the AWS Command Line Interface, or the AWS Ground Station API.
AWS::GroundStation::Config AntennaDownlinkDemodDecodeConfig CloudFormation property
Config AWS CLI reference (see the
antennaDownlinkDemodDecodeConfig -> (structure)
section)
Antenna Uplink Config
You can use antenna uplink configs to configure the antenna for uplink during your contact. They consist of a spectrum config with frequency, polarization, and target effective isotropic radiated power (EIRP). For information about how to configure a contact for uplink loopback, see Uplink Echo Config.
See the following documentation for more information about how to perform operations on antenna uplink configs using AWS CloudFormation, the AWS Command Line Interface, or the AWS Ground Station API.
AWS::GroundStation::Config AntennaUplinkConfig CloudFormation property
Config AWS CLI reference (see the
antennaUplinkConfig -> (structure)
section)
Uplink Echo Config
Uplink echo configs tell the antenna how to execute an uplink echo. This echoes the signal sent by the antenna back to your dataflow endpoint. An uplink echo config contains the ARN of an uplink config. The antenna uses the parameters from the uplink config pointed to by the ARN when executing an uplink echo.
See the following documentation for more information about how to perform operations on uplink echo configs using AWS CloudFormation, the AWS Command Line Interface, or the AWS Ground Station API.
AWS::GroundStation::Config UplinkEchoConfig CloudFormation property
Config AWS CLI reference (see the
uplinkEchoConfig -> (structure)
section)