A low-level client representing AWS Ground Station
Welcome to the AWS Ground Station API Reference. AWS Ground Station is a fully managed service that enables you to control satellite communications, downlink and process satellite data, and scale your satellite operations efficiently and cost-effectively without having to build or manage your own ground station infrastructure.
client = session.create_client('groundstation')
These are the available methods:
Check if an operation can be paginated.
operation_name (string) – The operation name. This is the same name
as the method name on the client. For example, if the
method name is create_foo, and you’d normally invoke the
operation as client.create_foo(**kwargs), if the
create_foo operation can be paginated, you can use the
call client.get_paginator("create_foo").
True if the operation can be paginated,
False otherwise.
Cancels a contact with a specified contact ID.
See also: AWS API Documentation
Request Syntax
response = client.cancel_contact(
contactId='string'
)
contactId (string) –
[REQUIRED]
UUID of a contact.
dict
Response Syntax
{
'contactId': 'string'
}
Response Structure
(dict) –
contactId (string) –
UUID of a contact.
Exceptions
Creates a Config with the specified configData parameters.
Only one type of configData can be specified.
See also: AWS API Documentation
Request Syntax
response = client.create_config(
configData={
'antennaDownlinkConfig': {
'spectrumConfig': {
'bandwidth': {
'units': 'GHz'|'MHz'|'kHz',
'value': 123.0
},
'centerFrequency': {
'units': 'GHz'|'MHz'|'kHz',
'value': 123.0
},
'polarization': 'LEFT_HAND'|'NONE'|'RIGHT_HAND'
}
},
'antennaDownlinkDemodDecodeConfig': {
'decodeConfig': {
'unvalidatedJSON': 'string'
},
'demodulationConfig': {
'unvalidatedJSON': 'string'
},
'spectrumConfig': {
'bandwidth': {
'units': 'GHz'|'MHz'|'kHz',
'value': 123.0
},
'centerFrequency': {
'units': 'GHz'|'MHz'|'kHz',
'value': 123.0
},
'polarization': 'LEFT_HAND'|'NONE'|'RIGHT_HAND'
}
},
'antennaUplinkConfig': {
'spectrumConfig': {
'centerFrequency': {
'units': 'GHz'|'MHz'|'kHz',
'value': 123.0
},
'polarization': 'LEFT_HAND'|'NONE'|'RIGHT_HAND'
},
'targetEirp': {
'units': 'dBW',
'value': 123.0
},
'transmitDisabled': True|False
},
'dataflowEndpointConfig': {
'dataflowEndpointName': 'string',
'dataflowEndpointRegion': 'string'
},
's3RecordingConfig': {
'bucketArn': 'string',
'prefix': 'string',
'roleArn': 'string'
},
'trackingConfig': {
'autotrack': 'PREFERRED'|'REMOVED'|'REQUIRED'
},
'uplinkEchoConfig': {
'antennaUplinkConfigArn': 'string',
'enabled': True|False
}
},
name='string',
tags={
'string': 'string'
}
)
configData (dict) –
[REQUIRED]
Parameters of a Config .
antennaDownlinkConfig (dict) –
Information about how AWS Ground Station should configure an antenna for downlink during a contact.
spectrumConfig (dict) – [REQUIRED]
Object that describes a spectral Config .
bandwidth (dict) – [REQUIRED]
Bandwidth of a spectral Config . AWS Ground Station currently has the following bandwidth limitations:
For AntennaDownlinkDemodDecodeconfig , valid values are between 125 kHz to 650 MHz.
For AntennaDownlinkconfig valid values are between 10 kHz to 54 MHz.
For AntennaUplinkConfig , valid values are between 10 kHz to 54 MHz.
units (string) – [REQUIRED]
Frequency bandwidth units.
value (float) – [REQUIRED]
Frequency bandwidth value. AWS Ground Station currently has the following bandwidth limitations:
For AntennaDownlinkDemodDecodeconfig , valid values are between 125 kHz to 650 MHz.
For AntennaDownlinkconfig , valid values are between 10 kHz to 54 MHz.
For AntennaUplinkConfig , valid values are between 10 kHz to 54 MHz.
centerFrequency (dict) – [REQUIRED]
Center frequency of a spectral Config . Valid values are between 2200 to 2300 MHz and 7750 to 8400 MHz for downlink and 2025 to 2120 MHz for uplink.
units (string) – [REQUIRED]
Frequency units.
value (float) – [REQUIRED]
Frequency value. Valid values are between 2200 to 2300 MHz and 7750 to 8400 MHz for downlink and 2025 to 2120 MHz for uplink.
polarization (string) –
Polarization of a spectral Config . Capturing both "RIGHT_HAND" and "LEFT_HAND" polarization requires two separate configs.
antennaDownlinkDemodDecodeConfig (dict) –
Information about how AWS Ground Station should configure an antenna for downlink demod decode during a contact.
decodeConfig (dict) – [REQUIRED]
Information about the decode Config .
unvalidatedJSON (string) – [REQUIRED]
Unvalidated JSON of a decode Config .
demodulationConfig (dict) – [REQUIRED]
Information about the demodulation Config .
unvalidatedJSON (string) – [REQUIRED]
Unvalidated JSON of a demodulation Config .
spectrumConfig (dict) – [REQUIRED]
Information about the spectral Config .
bandwidth (dict) – [REQUIRED]
Bandwidth of a spectral Config . AWS Ground Station currently has the following bandwidth limitations:
For AntennaDownlinkDemodDecodeconfig , valid values are between 125 kHz to 650 MHz.
For AntennaDownlinkconfig valid values are between 10 kHz to 54 MHz.
For AntennaUplinkConfig , valid values are between 10 kHz to 54 MHz.
units (string) – [REQUIRED]
Frequency bandwidth units.
value (float) – [REQUIRED]
Frequency bandwidth value. AWS Ground Station currently has the following bandwidth limitations:
For AntennaDownlinkDemodDecodeconfig , valid values are between 125 kHz to 650 MHz.
For AntennaDownlinkconfig , valid values are between 10 kHz to 54 MHz.
For AntennaUplinkConfig , valid values are between 10 kHz to 54 MHz.
centerFrequency (dict) – [REQUIRED]
Center frequency of a spectral Config . Valid values are between 2200 to 2300 MHz and 7750 to 8400 MHz for downlink and 2025 to 2120 MHz for uplink.
units (string) – [REQUIRED]
Frequency units.
value (float) – [REQUIRED]
Frequency value. Valid values are between 2200 to 2300 MHz and 7750 to 8400 MHz for downlink and 2025 to 2120 MHz for uplink.
polarization (string) –
Polarization of a spectral Config . Capturing both "RIGHT_HAND" and "LEFT_HAND" polarization requires two separate configs.
antennaUplinkConfig (dict) –
Information about how AWS Ground Station should configure an antenna for uplink during a contact.
spectrumConfig (dict) – [REQUIRED]
Information about the uplink spectral Config .
centerFrequency (dict) – [REQUIRED]
Center frequency of an uplink spectral Config . Valid values are between 2025 to 2120 MHz.
units (string) – [REQUIRED]
Frequency units.
value (float) – [REQUIRED]
Frequency value. Valid values are between 2200 to 2300 MHz and 7750 to 8400 MHz for downlink and 2025 to 2120 MHz for uplink.
polarization (string) –
Polarization of an uplink spectral Config . Capturing both "RIGHT_HAND" and "LEFT_HAND" polarization requires two separate configs.
targetEirp (dict) – [REQUIRED]
EIRP of the target.
units (string) – [REQUIRED]
Units of an EIRP.
value (float) – [REQUIRED]
Value of an EIRP. Valid values are between 20.0 to 50.0 dBW.
transmitDisabled (boolean) –
Whether or not uplink transmit is disabled.
dataflowEndpointConfig (dict) –
Information about the dataflow endpoint Config .
dataflowEndpointName (string) – [REQUIRED]
Name of a dataflow endpoint.
dataflowEndpointRegion (string) –
Region of a dataflow endpoint.
s3RecordingConfig (dict) –
Information about an S3 recording Config .
bucketArn (string) – [REQUIRED]
ARN of the bucket to record to.
prefix (string) –
S3 Key prefix to prefice data files.
roleArn (string) – [REQUIRED]
ARN of the role Ground Station assumes to write data to the bucket.
trackingConfig (dict) –
Object that determines whether tracking should be used during a contact executed with this Config in the mission profile.
autotrack (string) – [REQUIRED]
Current setting for autotrack.
uplinkEchoConfig (dict) –
Information about an uplink echo Config .
Parameters from the AntennaUplinkConfig , corresponding to the specified AntennaUplinkConfigArn , are used when this UplinkEchoConfig is used in a contact.
antennaUplinkConfigArn (string) – [REQUIRED]
ARN of an uplink Config .
enabled (boolean) – [REQUIRED]
Whether or not an uplink Config is enabled.
name (string) –
[REQUIRED]
Name of a Config .
tags (dict) –
Tags assigned to a Config .
(string) –
(string) –
dict
Response Syntax
{
'configArn': 'string',
'configId': 'string',
'configType': 'antenna-downlink'|'antenna-downlink-demod-decode'|'antenna-uplink'|'dataflow-endpoint'|'tracking'|'uplink-echo'|'s3-recording'
}
Response Structure
(dict) –
configArn (string) –
ARN of a Config .
configId (string) –
UUID of a Config .
configType (string) –
Type of a Config .
Exceptions
Creates a DataflowEndpoint group containing the specified list of DataflowEndpoint objects.
The name field in each endpoint is used in your mission profile DataflowEndpointConfig to specify which endpoints to use during a contact.
When a contact uses multiple DataflowEndpointConfig objects, each Config must match a DataflowEndpoint in the same group.
See also: AWS API Documentation
Request Syntax
response = client.create_dataflow_endpoint_group(
endpointDetails=[
{
'endpoint': {
'address': {
'name': 'string',
'port': 123
},
'mtu': 123,
'name': 'string',
'status': 'created'|'creating'|'deleted'|'deleting'|'failed'
},
'securityDetails': {
'roleArn': 'string',
'securityGroupIds': [
'string',
],
'subnetIds': [
'string',
]
}
},
],
tags={
'string': 'string'
}
)
endpointDetails (list) –
[REQUIRED]
Endpoint details of each endpoint in the dataflow endpoint group.
(dict) –
Information about the endpoint details.
endpoint (dict) –
A dataflow endpoint.
address (dict) –
Socket address of a dataflow endpoint.
name (string) – [REQUIRED]
Name of a socket address.
port (integer) – [REQUIRED]
Port of a socket address.
mtu (integer) –
Maximum transmission unit (MTU) size in bytes of a dataflow endpoint.
name (string) –
Name of a dataflow endpoint.
status (string) –
Status of a dataflow endpoint.
securityDetails (dict) –
Endpoint security details.
roleArn (string) – [REQUIRED]
ARN to a role needed for connecting streams to your instances.
securityGroupIds (list) – [REQUIRED]
The security groups to attach to the elastic network interfaces.
(string) –
subnetIds (list) – [REQUIRED]
A list of subnets where AWS Ground Station places elastic network interfaces to send streams to your instances.
(string) –
tags (dict) –
Tags of a dataflow endpoint group.
(string) –
(string) –
dict
Response Syntax
{
'dataflowEndpointGroupId': 'string'
}
Response Structure
(dict) –
dataflowEndpointGroupId (string) –
UUID of a dataflow endpoint group.
Exceptions
Creates a mission profile.
dataflowEdgesis a list of lists of strings. Each lower level list of strings has two elements: a from ARN and a to ARN.
See also: AWS API Documentation
Request Syntax
response = client.create_mission_profile(
contactPostPassDurationSeconds=123,
contactPrePassDurationSeconds=123,
dataflowEdges=[
[
'string',
],
],
minimumViableContactDurationSeconds=123,
name='string',
tags={
'string': 'string'
},
trackingConfigArn='string'
)
contactPostPassDurationSeconds (integer) – Amount of time after a contact ends that you’d like to receive a CloudWatch event indicating the pass has finished.
contactPrePassDurationSeconds (integer) – Amount of time prior to contact start you’d like to receive a CloudWatch event indicating an upcoming pass.
dataflowEdges (list) –
[REQUIRED]
A list of lists of ARNs. Each list of ARNs is an edge, with a from Config and a to Config .
(list) –
(string) –
minimumViableContactDurationSeconds (integer) –
[REQUIRED]
Smallest amount of time in seconds that you’d like to see for an available contact. AWS Ground Station will not present you with contacts shorter than this duration.
name (string) –
[REQUIRED]
Name of a mission profile.
tags (dict) –
Tags assigned to a mission profile.
(string) –
(string) –
trackingConfigArn (string) –
[REQUIRED]
ARN of a tracking Config .
dict
Response Syntax
{
'missionProfileId': 'string'
}
Response Structure
(dict) –
missionProfileId (string) –
UUID of a mission profile.
Exceptions
Deletes a Config .
See also: AWS API Documentation
Request Syntax
response = client.delete_config(
configId='string',
configType='antenna-downlink'|'antenna-downlink-demod-decode'|'antenna-uplink'|'dataflow-endpoint'|'tracking'|'uplink-echo'|'s3-recording'
)
configId (string) –
[REQUIRED]
UUID of a Config .
configType (string) –
[REQUIRED]
Type of a Config .
dict
Response Syntax
{
'configArn': 'string',
'configId': 'string',
'configType': 'antenna-downlink'|'antenna-downlink-demod-decode'|'antenna-uplink'|'dataflow-endpoint'|'tracking'|'uplink-echo'|'s3-recording'
}
Response Structure
(dict) –
configArn (string) –
ARN of a Config .
configId (string) –
UUID of a Config .
configType (string) –
Type of a Config .
Exceptions
Deletes a dataflow endpoint group.
See also: AWS API Documentation
Request Syntax
response = client.delete_dataflow_endpoint_group(
dataflowEndpointGroupId='string'
)
dataflowEndpointGroupId (string) –
[REQUIRED]
UUID of a dataflow endpoint group.
dict
Response Syntax
{
'dataflowEndpointGroupId': 'string'
}
Response Structure
(dict) –
dataflowEndpointGroupId (string) –
UUID of a dataflow endpoint group.
Exceptions
Deletes a mission profile.
See also: AWS API Documentation
Request Syntax
response = client.delete_mission_profile(
missionProfileId='string'
)
missionProfileId (string) –
[REQUIRED]
UUID of a mission profile.
dict
Response Syntax
{
'missionProfileId': 'string'
}
Response Structure
(dict) –
missionProfileId (string) –
UUID of a mission profile.
Exceptions
Describes an existing contact.
See also: AWS API Documentation
Request Syntax
response = client.describe_contact(
contactId='string'
)
contactId (string) –
[REQUIRED]
UUID of a contact.
dict
Response Syntax
{
'contactId': 'string',
'contactStatus': 'AVAILABLE'|'AWS_CANCELLED'|'AWS_FAILED'|'CANCELLED'|'CANCELLING'|'COMPLETED'|'FAILED'|'FAILED_TO_SCHEDULE'|'PASS'|'POSTPASS'|'PREPASS'|'SCHEDULED'|'SCHEDULING',
'dataflowList': [
{
'destination': {
'configDetails': {
'antennaDemodDecodeDetails': {
'outputNode': 'string'
},
'endpointDetails': {
'endpoint': {
'address': {
'name': 'string',
'port': 123
},
'mtu': 123,
'name': 'string',
'status': 'created'|'creating'|'deleted'|'deleting'|'failed'
},
'securityDetails': {
'roleArn': 'string',
'securityGroupIds': [
'string',
],
'subnetIds': [
'string',
]
}
},
's3RecordingDetails': {
'bucketArn': 'string',
'keyTemplate': 'string'
}
},
'configId': 'string',
'configType': 'antenna-downlink'|'antenna-downlink-demod-decode'|'antenna-uplink'|'dataflow-endpoint'|'tracking'|'uplink-echo'|'s3-recording',
'dataflowDestinationRegion': 'string'
},
'errorMessage': 'string',
'source': {
'configDetails': {
'antennaDemodDecodeDetails': {
'outputNode': 'string'
},
'endpointDetails': {
'endpoint': {
'address': {
'name': 'string',
'port': 123
},
'mtu': 123,
'name': 'string',
'status': 'created'|'creating'|'deleted'|'deleting'|'failed'
},
'securityDetails': {
'roleArn': 'string',
'securityGroupIds': [
'string',
],
'subnetIds': [
'string',
]
}
},
's3RecordingDetails': {
'bucketArn': 'string',
'keyTemplate': 'string'
}
},
'configId': 'string',
'configType': 'antenna-downlink'|'antenna-downlink-demod-decode'|'antenna-uplink'|'dataflow-endpoint'|'tracking'|'uplink-echo'|'s3-recording',
'dataflowSourceRegion': 'string'
}
},
],
'endTime': datetime(2015, 1, 1),
'errorMessage': 'string',
'groundStation': 'string',
'maximumElevation': {
'unit': 'DEGREE_ANGLE'|'RADIAN',
'value': 123.0
},
'missionProfileArn': 'string',
'postPassEndTime': datetime(2015, 1, 1),
'prePassStartTime': datetime(2015, 1, 1),
'region': 'string',
'satelliteArn': 'string',
'startTime': datetime(2015, 1, 1),
'tags': {
'string': 'string'
}
}
Response Structure
(dict) –
contactId (string) –
UUID of a contact.
contactStatus (string) –
Status of a contact.
dataflowList (list) –
List describing source and destination details for each dataflow edge.
(dict) –
Information about a dataflow edge used in a contact.
destination (dict) –
Dataflow details for the destination side.
configDetails (dict) –
Additional details for a Config , if type is dataflow endpoint or antenna demod decode.
antennaDemodDecodeDetails (dict) –
Details for antenna demod decode Config in a contact.
outputNode (string) –
Name of an antenna demod decode output node used in a contact.
endpointDetails (dict) –
Information about the endpoint details.
endpoint (dict) –
A dataflow endpoint.
address (dict) –
Socket address of a dataflow endpoint.
name (string) –
Name of a socket address.
port (integer) –
Port of a socket address.
mtu (integer) –
Maximum transmission unit (MTU) size in bytes of a dataflow endpoint.
name (string) –
Name of a dataflow endpoint.
status (string) –
Status of a dataflow endpoint.
securityDetails (dict) –
Endpoint security details.
roleArn (string) –
ARN to a role needed for connecting streams to your instances.
securityGroupIds (list) –
The security groups to attach to the elastic network interfaces.
(string) –
subnetIds (list) –
A list of subnets where AWS Ground Station places elastic network interfaces to send streams to your instances.
(string) –
s3RecordingDetails (dict) –
Details for an S3 recording Config in a contact.
bucketArn (string) –
ARN of the bucket used.
keyTemplate (string) –
Template of the S3 key used.
configId (string) –
UUID of a Config .
configType (string) –
Type of a Config .
dataflowDestinationRegion (string) –
Region of a dataflow destination.
errorMessage (string) –
Error message for a dataflow.
source (dict) –
Dataflow details for the source side.
configDetails (dict) –
Additional details for a Config , if type is dataflow endpoint or antenna demod decode.
antennaDemodDecodeDetails (dict) –
Details for antenna demod decode Config in a contact.
outputNode (string) –
Name of an antenna demod decode output node used in a contact.
endpointDetails (dict) –
Information about the endpoint details.
endpoint (dict) –
A dataflow endpoint.
address (dict) –
Socket address of a dataflow endpoint.
name (string) –
Name of a socket address.
port (integer) –
Port of a socket address.
mtu (integer) –
Maximum transmission unit (MTU) size in bytes of a dataflow endpoint.
name (string) –
Name of a dataflow endpoint.
status (string) –
Status of a dataflow endpoint.
securityDetails (dict) –
Endpoint security details.
roleArn (string) –
ARN to a role needed for connecting streams to your instances.
securityGroupIds (list) –
The security groups to attach to the elastic network interfaces.
(string) –
subnetIds (list) –
A list of subnets where AWS Ground Station places elastic network interfaces to send streams to your instances.
(string) –
s3RecordingDetails (dict) –
Details for an S3 recording Config in a contact.
bucketArn (string) –
ARN of the bucket used.
keyTemplate (string) –
Template of the S3 key used.
configId (string) –
UUID of a Config .
configType (string) –
Type of a Config .
dataflowSourceRegion (string) –
Region of a dataflow source.
endTime (datetime) –
End time of a contact.
errorMessage (string) –
Error message for a contact.
groundStation (string) –
Ground station for a contact.
maximumElevation (dict) –
Maximum elevation angle of a contact.
unit (string) –
Elevation angle units.
value (float) –
Elevation angle value.
missionProfileArn (string) –
ARN of a mission profile.
postPassEndTime (datetime) –
Amount of time after a contact ends that you’d like to receive a CloudWatch event indicating the pass has finished.
prePassStartTime (datetime) –
Amount of time prior to contact start you’d like to receive a CloudWatch event indicating an upcoming pass.
region (string) –
Region of a contact.
satelliteArn (string) –
ARN of a satellite.
startTime (datetime) –
Start time of a contact.
tags (dict) –
Tags assigned to a contact.
(string) –
(string) –
Exceptions
Generate a presigned url given a client, its method, and arguments
ClientMethod (string) – The client method to presign for
Params (dict) – The parameters normally passed to
ClientMethod.
ExpiresIn (int) – The number of seconds the presigned url is valid for. By default it expires in an hour (3600 seconds)
HttpMethod (string) – The http method to use on the generated url. By default, the http method is whatever is used in the method’s model.
The presigned url
Returns Config information.
Only one Config response can be returned.
See also: AWS API Documentation
Request Syntax
response = client.get_config(
configId='string',
configType='antenna-downlink'|'antenna-downlink-demod-decode'|'antenna-uplink'|'dataflow-endpoint'|'tracking'|'uplink-echo'|'s3-recording'
)
configId (string) –
[REQUIRED]
UUID of a Config .
configType (string) –
[REQUIRED]
Type of a Config .
dict
Response Syntax
{
'configArn': 'string',
'configData': {
'antennaDownlinkConfig': {
'spectrumConfig': {
'bandwidth': {
'units': 'GHz'|'MHz'|'kHz',
'value': 123.0
},
'centerFrequency': {
'units': 'GHz'|'MHz'|'kHz',
'value': 123.0
},
'polarization': 'LEFT_HAND'|'NONE'|'RIGHT_HAND'
}
},
'antennaDownlinkDemodDecodeConfig': {
'decodeConfig': {
'unvalidatedJSON': 'string'
},
'demodulationConfig': {
'unvalidatedJSON': 'string'
},
'spectrumConfig': {
'bandwidth': {
'units': 'GHz'|'MHz'|'kHz',
'value': 123.0
},
'centerFrequency': {
'units': 'GHz'|'MHz'|'kHz',
'value': 123.0
},
'polarization': 'LEFT_HAND'|'NONE'|'RIGHT_HAND'
}
},
'antennaUplinkConfig': {
'spectrumConfig': {
'centerFrequency': {
'units': 'GHz'|'MHz'|'kHz',
'value': 123.0
},
'polarization': 'LEFT_HAND'|'NONE'|'RIGHT_HAND'
},
'targetEirp': {
'units': 'dBW',
'value': 123.0
},
'transmitDisabled': True|False
},
'dataflowEndpointConfig': {
'dataflowEndpointName': 'string',
'dataflowEndpointRegion': 'string'
},
's3RecordingConfig': {
'bucketArn': 'string',
'prefix': 'string',
'roleArn': 'string'
},
'trackingConfig': {
'autotrack': 'PREFERRED'|'REMOVED'|'REQUIRED'
},
'uplinkEchoConfig': {
'antennaUplinkConfigArn': 'string',
'enabled': True|False
}
},
'configId': 'string',
'configType': 'antenna-downlink'|'antenna-downlink-demod-decode'|'antenna-uplink'|'dataflow-endpoint'|'tracking'|'uplink-echo'|'s3-recording',
'name': 'string',
'tags': {
'string': 'string'
}
}
Response Structure
(dict) –
configArn (string) –
ARN of a Config
configData (dict) –
Data elements in a Config .
antennaDownlinkConfig (dict) –
Information about how AWS Ground Station should configure an antenna for downlink during a contact.
spectrumConfig (dict) –
Object that describes a spectral Config .
bandwidth (dict) –
Bandwidth of a spectral Config . AWS Ground Station currently has the following bandwidth limitations:
For AntennaDownlinkDemodDecodeconfig , valid values are between 125 kHz to 650 MHz.
For AntennaDownlinkconfig valid values are between 10 kHz to 54 MHz.
For AntennaUplinkConfig , valid values are between 10 kHz to 54 MHz.
units (string) –
Frequency bandwidth units.
value (float) –
Frequency bandwidth value. AWS Ground Station currently has the following bandwidth limitations:
For AntennaDownlinkDemodDecodeconfig , valid values are between 125 kHz to 650 MHz.
For AntennaDownlinkconfig , valid values are between 10 kHz to 54 MHz.
For AntennaUplinkConfig , valid values are between 10 kHz to 54 MHz.
centerFrequency (dict) –
Center frequency of a spectral Config . Valid values are between 2200 to 2300 MHz and 7750 to 8400 MHz for downlink and 2025 to 2120 MHz for uplink.
units (string) –
Frequency units.
value (float) –
Frequency value. Valid values are between 2200 to 2300 MHz and 7750 to 8400 MHz for downlink and 2025 to 2120 MHz for uplink.
polarization (string) –
Polarization of a spectral Config . Capturing both "RIGHT_HAND" and "LEFT_HAND" polarization requires two separate configs.
antennaDownlinkDemodDecodeConfig (dict) –
Information about how AWS Ground Station should configure an antenna for downlink demod decode during a contact.
decodeConfig (dict) –
Information about the decode Config .
unvalidatedJSON (string) –
Unvalidated JSON of a decode Config .
demodulationConfig (dict) –
Information about the demodulation Config .
unvalidatedJSON (string) –
Unvalidated JSON of a demodulation Config .
spectrumConfig (dict) –
Information about the spectral Config .
bandwidth (dict) –
Bandwidth of a spectral Config . AWS Ground Station currently has the following bandwidth limitations:
For AntennaDownlinkDemodDecodeconfig , valid values are between 125 kHz to 650 MHz.
For AntennaDownlinkconfig valid values are between 10 kHz to 54 MHz.
For AntennaUplinkConfig , valid values are between 10 kHz to 54 MHz.
units (string) –
Frequency bandwidth units.
value (float) –
Frequency bandwidth value. AWS Ground Station currently has the following bandwidth limitations:
For AntennaDownlinkDemodDecodeconfig , valid values are between 125 kHz to 650 MHz.
For AntennaDownlinkconfig , valid values are between 10 kHz to 54 MHz.
For AntennaUplinkConfig , valid values are between 10 kHz to 54 MHz.
centerFrequency (dict) –
Center frequency of a spectral Config . Valid values are between 2200 to 2300 MHz and 7750 to 8400 MHz for downlink and 2025 to 2120 MHz for uplink.
units (string) –
Frequency units.
value (float) –
Frequency value. Valid values are between 2200 to 2300 MHz and 7750 to 8400 MHz for downlink and 2025 to 2120 MHz for uplink.
polarization (string) –
Polarization of a spectral Config . Capturing both "RIGHT_HAND" and "LEFT_HAND" polarization requires two separate configs.
antennaUplinkConfig (dict) –
Information about how AWS Ground Station should configure an antenna for uplink during a contact.
spectrumConfig (dict) –
Information about the uplink spectral Config .
centerFrequency (dict) –
Center frequency of an uplink spectral Config . Valid values are between 2025 to 2120 MHz.
units (string) –
Frequency units.
value (float) –
Frequency value. Valid values are between 2200 to 2300 MHz and 7750 to 8400 MHz for downlink and 2025 to 2120 MHz for uplink.
polarization (string) –
Polarization of an uplink spectral Config . Capturing both "RIGHT_HAND" and "LEFT_HAND" polarization requires two separate configs.
targetEirp (dict) –
EIRP of the target.
units (string) –
Units of an EIRP.
value (float) –
Value of an EIRP. Valid values are between 20.0 to 50.0 dBW.
transmitDisabled (boolean) –
Whether or not uplink transmit is disabled.
dataflowEndpointConfig (dict) –
Information about the dataflow endpoint Config .
dataflowEndpointName (string) –
Name of a dataflow endpoint.
dataflowEndpointRegion (string) –
Region of a dataflow endpoint.
s3RecordingConfig (dict) –
Information about an S3 recording Config .
bucketArn (string) –
ARN of the bucket to record to.
prefix (string) –
S3 Key prefix to prefice data files.
roleArn (string) –
ARN of the role Ground Station assumes to write data to the bucket.
trackingConfig (dict) –
Object that determines whether tracking should be used during a contact executed with this Config in the mission profile.
autotrack (string) –
Current setting for autotrack.
uplinkEchoConfig (dict) –
Information about an uplink echo Config .
Parameters from the AntennaUplinkConfig , corresponding to the specified AntennaUplinkConfigArn , are used when this UplinkEchoConfig is used in a contact.
antennaUplinkConfigArn (string) –
ARN of an uplink Config .
enabled (boolean) –
Whether or not an uplink Config is enabled.
configId (string) –
UUID of a Config .
configType (string) –
Type of a Config .
name (string) –
Name of a Config .
tags (dict) –
Tags assigned to a Config .
(string) –
(string) –
Exceptions
Returns the dataflow endpoint group.
See also: AWS API Documentation
Request Syntax
response = client.get_dataflow_endpoint_group(
dataflowEndpointGroupId='string'
)
dataflowEndpointGroupId (string) –
[REQUIRED]
UUID of a dataflow endpoint group.
dict
Response Syntax
{
'dataflowEndpointGroupArn': 'string',
'dataflowEndpointGroupId': 'string',
'endpointsDetails': [
{
'endpoint': {
'address': {
'name': 'string',
'port': 123
},
'mtu': 123,
'name': 'string',
'status': 'created'|'creating'|'deleted'|'deleting'|'failed'
},
'securityDetails': {
'roleArn': 'string',
'securityGroupIds': [
'string',
],
'subnetIds': [
'string',
]
}
},
],
'tags': {
'string': 'string'
}
}
Response Structure
(dict) –
dataflowEndpointGroupArn (string) –
ARN of a dataflow endpoint group.
dataflowEndpointGroupId (string) –
UUID of a dataflow endpoint group.
endpointsDetails (list) –
Details of a dataflow endpoint.
(dict) –
Information about the endpoint details.
endpoint (dict) –
A dataflow endpoint.
address (dict) –
Socket address of a dataflow endpoint.
name (string) –
Name of a socket address.
port (integer) –
Port of a socket address.
mtu (integer) –
Maximum transmission unit (MTU) size in bytes of a dataflow endpoint.
name (string) –
Name of a dataflow endpoint.
status (string) –
Status of a dataflow endpoint.
securityDetails (dict) –
Endpoint security details.
roleArn (string) –
ARN to a role needed for connecting streams to your instances.
securityGroupIds (list) –
The security groups to attach to the elastic network interfaces.
(string) –
subnetIds (list) –
A list of subnets where AWS Ground Station places elastic network interfaces to send streams to your instances.
(string) –
tags (dict) –
Tags assigned to a dataflow endpoint group.
(string) –
(string) –
Exceptions
Returns the number of minutes used by account.
See also: AWS API Documentation
Request Syntax
response = client.get_minute_usage(
month=123,
year=123
)
month (integer) –
[REQUIRED]
The month being requested, with a value of 1-12.
year (integer) –
[REQUIRED]
The year being requested, in the format of YYYY.
dict
Response Syntax
{
'estimatedMinutesRemaining': 123,
'isReservedMinutesCustomer': True|False,
'totalReservedMinuteAllocation': 123,
'totalScheduledMinutes': 123,
'upcomingMinutesScheduled': 123
}
Response Structure
(dict) –
estimatedMinutesRemaining (integer) –
Estimated number of minutes remaining for an account, specific to the month being requested.
isReservedMinutesCustomer (boolean) –
Returns whether or not an account has signed up for the reserved minutes pricing plan, specific to the month being requested.
totalReservedMinuteAllocation (integer) –
Total number of reserved minutes allocated, specific to the month being requested.
totalScheduledMinutes (integer) –
Total scheduled minutes for an account, specific to the month being requested.
upcomingMinutesScheduled (integer) –
Upcoming minutes scheduled for an account, specific to the month being requested.
Exceptions
Returns a mission profile.
See also: AWS API Documentation
Request Syntax
response = client.get_mission_profile(
missionProfileId='string'
)
missionProfileId (string) –
[REQUIRED]
UUID of a mission profile.
dict
Response Syntax
{
'contactPostPassDurationSeconds': 123,
'contactPrePassDurationSeconds': 123,
'dataflowEdges': [
[
'string',
],
],
'minimumViableContactDurationSeconds': 123,
'missionProfileArn': 'string',
'missionProfileId': 'string',
'name': 'string',
'region': 'string',
'tags': {
'string': 'string'
},
'trackingConfigArn': 'string'
}
Response Structure
(dict) –
contactPostPassDurationSeconds (integer) –
Amount of time after a contact ends that you’d like to receive a CloudWatch event indicating the pass has finished.
contactPrePassDurationSeconds (integer) –
Amount of time prior to contact start you’d like to receive a CloudWatch event indicating an upcoming pass.
dataflowEdges (list) –
A list of lists of ARNs. Each list of ARNs is an edge, with a from Config and a to Config .
(list) –
(string) –
minimumViableContactDurationSeconds (integer) –
Smallest amount of time in seconds that you’d like to see for an available contact. AWS Ground Station will not present you with contacts shorter than this duration.
missionProfileArn (string) –
ARN of a mission profile.
missionProfileId (string) –
UUID of a mission profile.
name (string) –
Name of a mission profile.
region (string) –
Region of a mission profile.
tags (dict) –
Tags assigned to a mission profile.
(string) –
(string) –
trackingConfigArn (string) –
ARN of a tracking Config .
Exceptions
Create a paginator for an operation.
operation_name (string) – The operation name. This is the same name
as the method name on the client. For example, if the
method name is create_foo, and you’d normally invoke the
operation as client.create_foo(**kwargs), if the
create_foo operation can be paginated, you can use the
call client.get_paginator("create_foo").
OperationNotPageableError – Raised if the operation is not
pageable. You can use the client.can_paginate method to
check if an operation is pageable.
L{botocore.paginate.Paginator}
A paginator object.
Returns a satellite.
See also: AWS API Documentation
Request Syntax
response = client.get_satellite(
satelliteId='string'
)
satelliteId (string) –
[REQUIRED]
UUID of a satellite.
dict
Response Syntax
{
'groundStations': [
'string',
],
'noradSatelliteID': 123,
'satelliteArn': 'string',
'satelliteId': 'string'
}
Response Structure
(dict) –
groundStations (list) –
A list of ground stations to which the satellite is on-boarded.
(string) –
noradSatelliteID (integer) –
NORAD satellite ID number.
satelliteArn (string) –
ARN of a satellite.
satelliteId (string) –
UUID of a satellite.
Exceptions
Returns an object that can wait for some condition.
waiter_name (str) – The name of the waiter to get. See the waiters section of the service docs for a list of available waiters.
The specified waiter object.
botocore.waiter.Waiter
Returns a list of Config objects.
See also: AWS API Documentation
Request Syntax
response = client.list_configs(
maxResults=123,
nextToken='string'
)
maxResults (integer) – Maximum number of Configs returned.
nextToken (string) – Next token returned in the request of a previous ListConfigs call. Used to get the next page of results.
dict
Response Syntax
{
'configList': [
{
'configArn': 'string',
'configId': 'string',
'configType': 'antenna-downlink'|'antenna-downlink-demod-decode'|'antenna-uplink'|'dataflow-endpoint'|'tracking'|'uplink-echo'|'s3-recording',
'name': 'string'
},
],
'nextToken': 'string'
}
Response Structure
(dict) –
configList (list) –
List of Config items.
(dict) –
An item in a list of Config objects.
configArn (string) –
ARN of a Config .
configId (string) –
UUID of a Config .
configType (string) –
Type of a Config .
name (string) –
Name of a Config .
nextToken (string) –
Next token returned in the response of a previous ListConfigs call. Used to get the next page of results.
Exceptions
Returns a list of contacts.
If statusList contains AVAILABLE, the request must include groundStation , missionprofileArn , and satelliteArn .
See also: AWS API Documentation
Request Syntax
response = client.list_contacts(
endTime=datetime(2015, 1, 1),
groundStation='string',
maxResults=123,
missionProfileArn='string',
nextToken='string',
satelliteArn='string',
startTime=datetime(2015, 1, 1),
statusList=[
'AVAILABLE'|'AWS_CANCELLED'|'AWS_FAILED'|'CANCELLED'|'CANCELLING'|'COMPLETED'|'FAILED'|'FAILED_TO_SCHEDULE'|'PASS'|'POSTPASS'|'PREPASS'|'SCHEDULED'|'SCHEDULING',
]
)
endTime (datetime) –
[REQUIRED]
End time of a contact.
groundStation (string) – Name of a ground station.
maxResults (integer) – Maximum number of contacts returned.
missionProfileArn (string) – ARN of a mission profile.
nextToken (string) – Next token returned in the request of a previous ListContacts call. Used to get the next page of results.
satelliteArn (string) – ARN of a satellite.
startTime (datetime) –
[REQUIRED]
Start time of a contact.
statusList (list) –
[REQUIRED]
Status of a contact reservation.
(string) –
dict
Response Syntax
{
'contactList': [
{
'contactId': 'string',
'contactStatus': 'AVAILABLE'|'AWS_CANCELLED'|'AWS_FAILED'|'CANCELLED'|'CANCELLING'|'COMPLETED'|'FAILED'|'FAILED_TO_SCHEDULE'|'PASS'|'POSTPASS'|'PREPASS'|'SCHEDULED'|'SCHEDULING',
'endTime': datetime(2015, 1, 1),
'errorMessage': 'string',
'groundStation': 'string',
'maximumElevation': {
'unit': 'DEGREE_ANGLE'|'RADIAN',
'value': 123.0
},
'missionProfileArn': 'string',
'postPassEndTime': datetime(2015, 1, 1),
'prePassStartTime': datetime(2015, 1, 1),
'region': 'string',
'satelliteArn': 'string',
'startTime': datetime(2015, 1, 1),
'tags': {
'string': 'string'
}
},
],
'nextToken': 'string'
}
Response Structure
(dict) –
contactList (list) –
List of contacts.
(dict) –
Data describing a contact.
contactId (string) –
UUID of a contact.
contactStatus (string) –
Status of a contact.
endTime (datetime) –
End time of a contact.
errorMessage (string) –
Error message of a contact.
groundStation (string) –
Name of a ground station.
maximumElevation (dict) –
Maximum elevation angle of a contact.
unit (string) –
Elevation angle units.
value (float) –
Elevation angle value.
missionProfileArn (string) –
ARN of a mission profile.
postPassEndTime (datetime) –
Amount of time after a contact ends that you’d like to receive a CloudWatch event indicating the pass has finished.
prePassStartTime (datetime) –
Amount of time prior to contact start you’d like to receive a CloudWatch event indicating an upcoming pass.
region (string) –
Region of a contact.
satelliteArn (string) –
ARN of a satellite.
startTime (datetime) –
Start time of a contact.
tags (dict) –
Tags assigned to a contact.
(string) –
(string) –
nextToken (string) –
Next token returned in the response of a previous ListContacts call. Used to get the next page of results.
Exceptions
Returns a list of DataflowEndpoint groups.
See also: AWS API Documentation
Request Syntax
response = client.list_dataflow_endpoint_groups(
maxResults=123,
nextToken='string'
)
maxResults (integer) – Maximum number of dataflow endpoint groups returned.
nextToken (string) – Next token returned in the request of a previous ListDataflowEndpointGroups call. Used to get the next page of results.
dict
Response Syntax
{
'dataflowEndpointGroupList': [
{
'dataflowEndpointGroupArn': 'string',
'dataflowEndpointGroupId': 'string'
},
],
'nextToken': 'string'
}
Response Structure
(dict) –
dataflowEndpointGroupList (list) –
A list of dataflow endpoint groups.
(dict) –
Item in a list of DataflowEndpoint groups.
dataflowEndpointGroupArn (string) –
ARN of a dataflow endpoint group.
dataflowEndpointGroupId (string) –
UUID of a dataflow endpoint group.
nextToken (string) –
Next token returned in the response of a previous ListDataflowEndpointGroups call. Used to get the next page of results.
Exceptions
Returns a list of ground stations.
See also: AWS API Documentation
Request Syntax
response = client.list_ground_stations(
maxResults=123,
nextToken='string',
satelliteId='string'
)
maxResults (integer) – Maximum number of ground stations returned.
nextToken (string) – Next token that can be supplied in the next call to get the next page of ground stations.
satelliteId (string) – Satellite ID to retrieve on-boarded ground stations.
dict
Response Syntax
{
'groundStationList': [
{
'groundStationId': 'string',
'groundStationName': 'string',
'region': 'string'
},
],
'nextToken': 'string'
}
Response Structure
(dict) –
groundStationList (list) –
List of ground stations.
(dict) –
Information about the ground station data.
groundStationId (string) –
UUID of a ground station.
groundStationName (string) –
Name of a ground station.
region (string) –
Ground station Region.
nextToken (string) –
Next token that can be supplied in the next call to get the next page of ground stations.
Exceptions
Returns a list of mission profiles.
See also: AWS API Documentation
Request Syntax
response = client.list_mission_profiles(
maxResults=123,
nextToken='string'
)
maxResults (integer) – Maximum number of mission profiles returned.
nextToken (string) – Next token returned in the request of a previous ListMissionProfiles call. Used to get the next page of results.
dict
Response Syntax
{
'missionProfileList': [
{
'missionProfileArn': 'string',
'missionProfileId': 'string',
'name': 'string',
'region': 'string'
},
],
'nextToken': 'string'
}
Response Structure
(dict) –
missionProfileList (list) –
List of mission profiles.
(dict) –
Item in a list of mission profiles.
missionProfileArn (string) –
ARN of a mission profile.
missionProfileId (string) –
UUID of a mission profile.
name (string) –
Name of a mission profile.
region (string) –
Region of a mission profile.
nextToken (string) –
Next token returned in the response of a previous ListMissionProfiles call. Used to get the next page of results.
Exceptions
Returns a list of satellites.
See also: AWS API Documentation
Request Syntax
response = client.list_satellites(
maxResults=123,
nextToken='string'
)
maxResults (integer) – Maximum number of satellites returned.
nextToken (string) – Next token that can be supplied in the next call to get the next page of satellites.
dict
Response Syntax
{
'nextToken': 'string',
'satellites': [
{
'groundStations': [
'string',
],
'noradSatelliteID': 123,
'satelliteArn': 'string',
'satelliteId': 'string'
},
]
}
Response Structure
(dict) –
nextToken (string) –
Next token that can be supplied in the next call to get the next page of satellites.
satellites (list) –
List of satellites.
(dict) –
Item in a list of satellites.
groundStations (list) –
A list of ground stations to which the satellite is on-boarded.
(string) –
noradSatelliteID (integer) –
NORAD satellite ID number.
satelliteArn (string) –
ARN of a satellite.
satelliteId (string) –
UUID of a satellite.
Exceptions
Returns a list of tags for a specified resource.
See also: AWS API Documentation
Request Syntax
response = client.list_tags_for_resource(
resourceArn='string'
)
resourceArn (string) –
[REQUIRED]
ARN of a resource.
dict
Response Syntax
{
'tags': {
'string': 'string'
}
}
Response Structure
(dict) –
tags (dict) –
Tags assigned to a resource.
(string) –
(string) –
Exceptions
Reserves a contact using specified parameters.
See also: AWS API Documentation
Request Syntax
response = client.reserve_contact(
endTime=datetime(2015, 1, 1),
groundStation='string',
missionProfileArn='string',
satelliteArn='string',
startTime=datetime(2015, 1, 1),
tags={
'string': 'string'
}
)
endTime (datetime) –
[REQUIRED]
End time of a contact.
groundStation (string) –
[REQUIRED]
Name of a ground station.
missionProfileArn (string) –
[REQUIRED]
ARN of a mission profile.
satelliteArn (string) –
[REQUIRED]
ARN of a satellite
startTime (datetime) –
[REQUIRED]
Start time of a contact.
tags (dict) –
Tags assigned to a contact.
(string) –
(string) –
dict
Response Syntax
{
'contactId': 'string'
}
Response Structure
(dict) –
contactId (string) –
UUID of a contact.
Exceptions
Assigns a tag to a resource.
See also: AWS API Documentation
Request Syntax
response = client.tag_resource(
resourceArn='string',
tags={
'string': 'string'
}
)
resourceArn (string) –
[REQUIRED]
ARN of a resource tag.
tags (dict) –
[REQUIRED]
Tags assigned to a resource.
(string) –
(string) –
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Deassigns a resource tag.
See also: AWS API Documentation
Request Syntax
response = client.untag_resource(
resourceArn='string',
tagKeys=[
'string',
]
)
resourceArn (string) –
[REQUIRED]
ARN of a resource.
tagKeys (list) –
[REQUIRED]
Keys of a resource tag.
(string) –
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Updates the Config used when scheduling contacts.
Updating a Config will not update the execution parameters for existing future contacts scheduled with this Config .
See also: AWS API Documentation
Request Syntax
response = client.update_config(
configData={
'antennaDownlinkConfig': {
'spectrumConfig': {
'bandwidth': {
'units': 'GHz'|'MHz'|'kHz',
'value': 123.0
},
'centerFrequency': {
'units': 'GHz'|'MHz'|'kHz',
'value': 123.0
},
'polarization': 'LEFT_HAND'|'NONE'|'RIGHT_HAND'
}
},
'antennaDownlinkDemodDecodeConfig': {
'decodeConfig': {
'unvalidatedJSON': 'string'
},
'demodulationConfig': {
'unvalidatedJSON': 'string'
},
'spectrumConfig': {
'bandwidth': {
'units': 'GHz'|'MHz'|'kHz',
'value': 123.0
},
'centerFrequency': {
'units': 'GHz'|'MHz'|'kHz',
'value': 123.0
},
'polarization': 'LEFT_HAND'|'NONE'|'RIGHT_HAND'
}
},
'antennaUplinkConfig': {
'spectrumConfig': {
'centerFrequency': {
'units': 'GHz'|'MHz'|'kHz',
'value': 123.0
},
'polarization': 'LEFT_HAND'|'NONE'|'RIGHT_HAND'
},
'targetEirp': {
'units': 'dBW',
'value': 123.0
},
'transmitDisabled': True|False
},
'dataflowEndpointConfig': {
'dataflowEndpointName': 'string',
'dataflowEndpointRegion': 'string'
},
's3RecordingConfig': {
'bucketArn': 'string',
'prefix': 'string',
'roleArn': 'string'
},
'trackingConfig': {
'autotrack': 'PREFERRED'|'REMOVED'|'REQUIRED'
},
'uplinkEchoConfig': {
'antennaUplinkConfigArn': 'string',
'enabled': True|False
}
},
configId='string',
configType='antenna-downlink'|'antenna-downlink-demod-decode'|'antenna-uplink'|'dataflow-endpoint'|'tracking'|'uplink-echo'|'s3-recording',
name='string'
)
configData (dict) –
[REQUIRED]
Parameters of a Config .
antennaDownlinkConfig (dict) –
Information about how AWS Ground Station should configure an antenna for downlink during a contact.
spectrumConfig (dict) – [REQUIRED]
Object that describes a spectral Config .
bandwidth (dict) – [REQUIRED]
Bandwidth of a spectral Config . AWS Ground Station currently has the following bandwidth limitations:
For AntennaDownlinkDemodDecodeconfig , valid values are between 125 kHz to 650 MHz.
For AntennaDownlinkconfig valid values are between 10 kHz to 54 MHz.
For AntennaUplinkConfig , valid values are between 10 kHz to 54 MHz.
units (string) – [REQUIRED]
Frequency bandwidth units.
value (float) – [REQUIRED]
Frequency bandwidth value. AWS Ground Station currently has the following bandwidth limitations:
For AntennaDownlinkDemodDecodeconfig , valid values are between 125 kHz to 650 MHz.
For AntennaDownlinkconfig , valid values are between 10 kHz to 54 MHz.
For AntennaUplinkConfig , valid values are between 10 kHz to 54 MHz.
centerFrequency (dict) – [REQUIRED]
Center frequency of a spectral Config . Valid values are between 2200 to 2300 MHz and 7750 to 8400 MHz for downlink and 2025 to 2120 MHz for uplink.
units (string) – [REQUIRED]
Frequency units.
value (float) – [REQUIRED]
Frequency value. Valid values are between 2200 to 2300 MHz and 7750 to 8400 MHz for downlink and 2025 to 2120 MHz for uplink.
polarization (string) –
Polarization of a spectral Config . Capturing both "RIGHT_HAND" and "LEFT_HAND" polarization requires two separate configs.
antennaDownlinkDemodDecodeConfig (dict) –
Information about how AWS Ground Station should configure an antenna for downlink demod decode during a contact.
decodeConfig (dict) – [REQUIRED]
Information about the decode Config .
unvalidatedJSON (string) – [REQUIRED]
Unvalidated JSON of a decode Config .
demodulationConfig (dict) – [REQUIRED]
Information about the demodulation Config .
unvalidatedJSON (string) – [REQUIRED]
Unvalidated JSON of a demodulation Config .
spectrumConfig (dict) – [REQUIRED]
Information about the spectral Config .
bandwidth (dict) – [REQUIRED]
Bandwidth of a spectral Config . AWS Ground Station currently has the following bandwidth limitations:
For AntennaDownlinkDemodDecodeconfig , valid values are between 125 kHz to 650 MHz.
For AntennaDownlinkconfig valid values are between 10 kHz to 54 MHz.
For AntennaUplinkConfig , valid values are between 10 kHz to 54 MHz.
units (string) – [REQUIRED]
Frequency bandwidth units.
value (float) – [REQUIRED]
Frequency bandwidth value. AWS Ground Station currently has the following bandwidth limitations:
For AntennaDownlinkDemodDecodeconfig , valid values are between 125 kHz to 650 MHz.
For AntennaDownlinkconfig , valid values are between 10 kHz to 54 MHz.
For AntennaUplinkConfig , valid values are between 10 kHz to 54 MHz.
centerFrequency (dict) – [REQUIRED]
Center frequency of a spectral Config . Valid values are between 2200 to 2300 MHz and 7750 to 8400 MHz for downlink and 2025 to 2120 MHz for uplink.
units (string) – [REQUIRED]
Frequency units.
value (float) – [REQUIRED]
Frequency value. Valid values are between 2200 to 2300 MHz and 7750 to 8400 MHz for downlink and 2025 to 2120 MHz for uplink.
polarization (string) –
Polarization of a spectral Config . Capturing both "RIGHT_HAND" and "LEFT_HAND" polarization requires two separate configs.
antennaUplinkConfig (dict) –
Information about how AWS Ground Station should configure an antenna for uplink during a contact.
spectrumConfig (dict) – [REQUIRED]
Information about the uplink spectral Config .
centerFrequency (dict) – [REQUIRED]
Center frequency of an uplink spectral Config . Valid values are between 2025 to 2120 MHz.
units (string) – [REQUIRED]
Frequency units.
value (float) – [REQUIRED]
Frequency value. Valid values are between 2200 to 2300 MHz and 7750 to 8400 MHz for downlink and 2025 to 2120 MHz for uplink.
polarization (string) –
Polarization of an uplink spectral Config . Capturing both "RIGHT_HAND" and "LEFT_HAND" polarization requires two separate configs.
targetEirp (dict) – [REQUIRED]
EIRP of the target.
units (string) – [REQUIRED]
Units of an EIRP.
value (float) – [REQUIRED]
Value of an EIRP. Valid values are between 20.0 to 50.0 dBW.
transmitDisabled (boolean) –
Whether or not uplink transmit is disabled.
dataflowEndpointConfig (dict) –
Information about the dataflow endpoint Config .
dataflowEndpointName (string) – [REQUIRED]
Name of a dataflow endpoint.
dataflowEndpointRegion (string) –
Region of a dataflow endpoint.
s3RecordingConfig (dict) –
Information about an S3 recording Config .
bucketArn (string) – [REQUIRED]
ARN of the bucket to record to.
prefix (string) –
S3 Key prefix to prefice data files.
roleArn (string) – [REQUIRED]
ARN of the role Ground Station assumes to write data to the bucket.
trackingConfig (dict) –
Object that determines whether tracking should be used during a contact executed with this Config in the mission profile.
autotrack (string) – [REQUIRED]
Current setting for autotrack.
uplinkEchoConfig (dict) –
Information about an uplink echo Config .
Parameters from the AntennaUplinkConfig , corresponding to the specified AntennaUplinkConfigArn , are used when this UplinkEchoConfig is used in a contact.
antennaUplinkConfigArn (string) – [REQUIRED]
ARN of an uplink Config .
enabled (boolean) – [REQUIRED]
Whether or not an uplink Config is enabled.
configId (string) –
[REQUIRED]
UUID of a Config .
configType (string) –
[REQUIRED]
Type of a Config .
name (string) –
[REQUIRED]
Name of a Config .
dict
Response Syntax
{
'configArn': 'string',
'configId': 'string',
'configType': 'antenna-downlink'|'antenna-downlink-demod-decode'|'antenna-uplink'|'dataflow-endpoint'|'tracking'|'uplink-echo'|'s3-recording'
}
Response Structure
(dict) –
configArn (string) –
ARN of a Config .
configId (string) –
UUID of a Config .
configType (string) –
Type of a Config .
Exceptions
Updates a mission profile.
Updating a mission profile will not update the execution parameters for existing future contacts.
See also: AWS API Documentation
Request Syntax
response = client.update_mission_profile(
contactPostPassDurationSeconds=123,
contactPrePassDurationSeconds=123,
dataflowEdges=[
[
'string',
],
],
minimumViableContactDurationSeconds=123,
missionProfileId='string',
name='string',
trackingConfigArn='string'
)
contactPostPassDurationSeconds (integer) – Amount of time after a contact ends that you’d like to receive a CloudWatch event indicating the pass has finished.
contactPrePassDurationSeconds (integer) – Amount of time after a contact ends that you’d like to receive a CloudWatch event indicating the pass has finished.
dataflowEdges (list) –
A list of lists of ARNs. Each list of ARNs is an edge, with a from Config and a to Config .
(list) –
(string) –
minimumViableContactDurationSeconds (integer) – Smallest amount of time in seconds that you’d like to see for an available contact. AWS Ground Station will not present you with contacts shorter than this duration.
missionProfileId (string) –
[REQUIRED]
UUID of a mission profile.
name (string) – Name of a mission profile.
trackingConfigArn (string) – ARN of a tracking Config .
dict
Response Syntax
{
'missionProfileId': 'string'
}
Response Structure
(dict) –
missionProfileId (string) –
UUID of a mission profile.
Exceptions
Client exceptions are available on a client instance via the exceptions property. For more detailed instructions and examples on the exact usage of client exceptions, see the error handling user guide.
The available client exceptions are:
Dependency encountered an error.
Example
try:
...
except client.exceptions.DependencyException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'message': 'string',
'parameterName': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
Dependency encountered an error.
message (string) –
parameterName (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
One or more parameters are not valid.
Example
try:
...
except client.exceptions.InvalidParameterException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'message': 'string',
'parameterName': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
One or more parameters are not valid.
message (string) –
parameterName (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
Account limits for this resource have been exceeded.
Example
try:
...
except client.exceptions.ResourceLimitExceededException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'message': 'string',
'parameterName': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
Account limits for this resource have been exceeded.
message (string) –
parameterName (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
Resource was not found.
Example
try:
...
except client.exceptions.ResourceNotFoundException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
Resource was not found.
message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
The available paginators are:
paginator = client.get_paginator('list_configs')
Creates an iterator that will paginate through responses from GroundStation.Client.list_configs().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'configList': [
{
'configArn': 'string',
'configId': 'string',
'configType': 'antenna-downlink'|'antenna-downlink-demod-decode'|'antenna-uplink'|'dataflow-endpoint'|'tracking'|'uplink-echo'|'s3-recording',
'name': 'string'
},
],
'NextToken': 'string'
}
Response Structure
(dict) –
configList (list) –
List of Config items.
(dict) –
An item in a list of Config objects.
configArn (string) –
ARN of a Config .
configId (string) –
UUID of a Config .
configType (string) –
Type of a Config .
name (string) –
Name of a Config .
NextToken (string) –
A token to resume pagination.
paginator = client.get_paginator('list_contacts')
Creates an iterator that will paginate through responses from GroundStation.Client.list_contacts().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
endTime=datetime(2015, 1, 1),
groundStation='string',
missionProfileArn='string',
satelliteArn='string',
startTime=datetime(2015, 1, 1),
statusList=[
'AVAILABLE'|'AWS_CANCELLED'|'AWS_FAILED'|'CANCELLED'|'CANCELLING'|'COMPLETED'|'FAILED'|'FAILED_TO_SCHEDULE'|'PASS'|'POSTPASS'|'PREPASS'|'SCHEDULED'|'SCHEDULING',
],
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
endTime (datetime) –
[REQUIRED]
End time of a contact.
groundStation (string) – Name of a ground station.
missionProfileArn (string) – ARN of a mission profile.
satelliteArn (string) – ARN of a satellite.
startTime (datetime) –
[REQUIRED]
Start time of a contact.
statusList (list) –
[REQUIRED]
Status of a contact reservation.
(string) –
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'contactList': [
{
'contactId': 'string',
'contactStatus': 'AVAILABLE'|'AWS_CANCELLED'|'AWS_FAILED'|'CANCELLED'|'CANCELLING'|'COMPLETED'|'FAILED'|'FAILED_TO_SCHEDULE'|'PASS'|'POSTPASS'|'PREPASS'|'SCHEDULED'|'SCHEDULING',
'endTime': datetime(2015, 1, 1),
'errorMessage': 'string',
'groundStation': 'string',
'maximumElevation': {
'unit': 'DEGREE_ANGLE'|'RADIAN',
'value': 123.0
},
'missionProfileArn': 'string',
'postPassEndTime': datetime(2015, 1, 1),
'prePassStartTime': datetime(2015, 1, 1),
'region': 'string',
'satelliteArn': 'string',
'startTime': datetime(2015, 1, 1),
'tags': {
'string': 'string'
}
},
],
'NextToken': 'string'
}
Response Structure
(dict) –
contactList (list) –
List of contacts.
(dict) –
Data describing a contact.
contactId (string) –
UUID of a contact.
contactStatus (string) –
Status of a contact.
endTime (datetime) –
End time of a contact.
errorMessage (string) –
Error message of a contact.
groundStation (string) –
Name of a ground station.
maximumElevation (dict) –
Maximum elevation angle of a contact.
unit (string) –
Elevation angle units.
value (float) –
Elevation angle value.
missionProfileArn (string) –
ARN of a mission profile.
postPassEndTime (datetime) –
Amount of time after a contact ends that you’d like to receive a CloudWatch event indicating the pass has finished.
prePassStartTime (datetime) –
Amount of time prior to contact start you’d like to receive a CloudWatch event indicating an upcoming pass.
region (string) –
Region of a contact.
satelliteArn (string) –
ARN of a satellite.
startTime (datetime) –
Start time of a contact.
tags (dict) –
Tags assigned to a contact.
(string) –
(string) –
NextToken (string) –
A token to resume pagination.
paginator = client.get_paginator('list_dataflow_endpoint_groups')
Creates an iterator that will paginate through responses from GroundStation.Client.list_dataflow_endpoint_groups().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'dataflowEndpointGroupList': [
{
'dataflowEndpointGroupArn': 'string',
'dataflowEndpointGroupId': 'string'
},
],
'NextToken': 'string'
}
Response Structure
(dict) –
dataflowEndpointGroupList (list) –
A list of dataflow endpoint groups.
(dict) –
Item in a list of DataflowEndpoint groups.
dataflowEndpointGroupArn (string) –
ARN of a dataflow endpoint group.
dataflowEndpointGroupId (string) –
UUID of a dataflow endpoint group.
NextToken (string) –
A token to resume pagination.
paginator = client.get_paginator('list_ground_stations')
Creates an iterator that will paginate through responses from GroundStation.Client.list_ground_stations().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
satelliteId='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
satelliteId (string) – Satellite ID to retrieve on-boarded ground stations.
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'groundStationList': [
{
'groundStationId': 'string',
'groundStationName': 'string',
'region': 'string'
},
],
'NextToken': 'string'
}
Response Structure
(dict) –
groundStationList (list) –
List of ground stations.
(dict) –
Information about the ground station data.
groundStationId (string) –
UUID of a ground station.
groundStationName (string) –
Name of a ground station.
region (string) –
Ground station Region.
NextToken (string) –
A token to resume pagination.
paginator = client.get_paginator('list_mission_profiles')
Creates an iterator that will paginate through responses from GroundStation.Client.list_mission_profiles().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'missionProfileList': [
{
'missionProfileArn': 'string',
'missionProfileId': 'string',
'name': 'string',
'region': 'string'
},
],
'NextToken': 'string'
}
Response Structure
(dict) –
missionProfileList (list) –
List of mission profiles.
(dict) –
Item in a list of mission profiles.
missionProfileArn (string) –
ARN of a mission profile.
missionProfileId (string) –
UUID of a mission profile.
name (string) –
Name of a mission profile.
region (string) –
Region of a mission profile.
NextToken (string) –
A token to resume pagination.
paginator = client.get_paginator('list_satellites')
Creates an iterator that will paginate through responses from GroundStation.Client.list_satellites().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'satellites': [
{
'groundStations': [
'string',
],
'noradSatelliteID': 123,
'satelliteArn': 'string',
'satelliteId': 'string'
},
],
'NextToken': 'string'
}
Response Structure
(dict) –
satellites (list) –
List of satellites.
(dict) –
Item in a list of satellites.
groundStations (list) –
A list of ground stations to which the satellite is on-boarded.
(string) –
noradSatelliteID (integer) –
NORAD satellite ID number.
satelliteArn (string) –
ARN of a satellite.
satelliteId (string) –
UUID of a satellite.
NextToken (string) –
A token to resume pagination.