AWS Ground Station

2020/07/20 - AWS Ground Station - 6 updated api methods

Changes  Adds optional MTU property to DataflowEndpoint and adds contact source and destination details to DescribeContact response.

CreateConfig (updated) Link ¶
Changes (request)
{'configData': {'antennaUplinkConfig': {'transmitDisabled': 'boolean'}}}

Creates a Config with the specified configData parameters.

Only one type of configData can be specified.

See also: AWS API Documentation

Request Syntax

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'
        },
        'trackingConfig': {
            'autotrack': 'PREFERRED'|'REMOVED'|'REQUIRED'
        },
        'uplinkEchoConfig': {
            'antennaUplinkConfigArn': 'string',
            'enabled': True|False
        }
    },
    name='string',
    tags={
        'string': 'string'
    }
)
type configData

dict

param configData

[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.

  • 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.

type name

string

param name

[REQUIRED]

Name of a Config .

type tags

dict

param tags

Tags assigned to a Config .

  • (string) --

    • (string) --

rtype

dict

returns

Response Syntax

{
    'configArn': 'string',
    'configId': 'string',
    'configType': 'antenna-downlink'|'antenna-downlink-demod-decode'|'antenna-uplink'|'dataflow-endpoint'|'tracking'|'uplink-echo'
}

Response Structure

  • (dict) --

    • configArn (string) --

      ARN of a Config .

    • configId (string) --

      UUID of a Config .

    • configType (string) --

      Type of a Config .

CreateDataflowEndpointGroup (updated) Link ¶
Changes (request)
{'endpointDetails': {'endpoint': {'mtu': 'integer'}}}

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

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'
    }
)
type endpointDetails

list

param endpointDetails

[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) --

type tags

dict

param tags

Tags of a dataflow endpoint group.

  • (string) --

    • (string) --

rtype

dict

returns

Response Syntax

{
    'dataflowEndpointGroupId': 'string'
}

Response Structure

  • (dict) --

    • dataflowEndpointGroupId (string) --

      UUID of a dataflow endpoint group.

DescribeContact (updated) Link ¶
Changes (response)
{'dataflowList': [{'destination': {'configDetails': {'antennaDemodDecodeDetails': {'outputNode': 'string'},
                                                     'endpointDetails': {'endpoint': {'address': {'name': 'string',
                                                                                                  'port': 'integer'},
                                                                                      'mtu': 'integer',
                                                                                      'name': 'string',
                                                                                      'status': 'created '
                                                                                                '| '
                                                                                                'creating '
                                                                                                '| '
                                                                                                'deleted '
                                                                                                '| '
                                                                                                'deleting '
                                                                                                '| '
                                                                                                'failed'},
                                                                         'securityDetails': {'roleArn': 'string',
                                                                                             'securityGroupIds': ['string'],
                                                                                             'subnetIds': ['string']}}},
                                   'configId': 'string',
                                   'configType': 'antenna-downlink | '
                                                 'antenna-downlink-demod-decode '
                                                 '| antenna-uplink | '
                                                 'dataflow-endpoint | tracking '
                                                 '| uplink-echo',
                                   'dataflowDestinationRegion': 'string'},
                   'source': {'configDetails': {'antennaDemodDecodeDetails': {'outputNode': 'string'},
                                                'endpointDetails': {'endpoint': {'address': {'name': 'string',
                                                                                             'port': 'integer'},
                                                                                 'mtu': 'integer',
                                                                                 'name': 'string',
                                                                                 'status': 'created '
                                                                                           '| '
                                                                                           'creating '
                                                                                           '| '
                                                                                           'deleted '
                                                                                           '| '
                                                                                           'deleting '
                                                                                           '| '
                                                                                           'failed'},
                                                                    'securityDetails': {'roleArn': 'string',
                                                                                        'securityGroupIds': ['string'],
                                                                                        'subnetIds': ['string']}}},
                              'configId': 'string',
                              'configType': 'antenna-downlink | '
                                            'antenna-downlink-demod-decode | '
                                            'antenna-uplink | '
                                            'dataflow-endpoint | tracking | '
                                            'uplink-echo',
                              'dataflowSourceRegion': 'string'}}]}

Describes an existing contact.

See also: AWS API Documentation

Request Syntax

client.describe_contact(
    contactId='string'
)
type contactId

string

param contactId

[REQUIRED]

UUID of a contact.

rtype

dict

returns

Response Syntax

{
    'contactId': 'string',
    'contactStatus': 'AVAILABLE'|'AWS_CANCELLED'|'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',
                            ]
                        }
                    }
                },
                'configId': 'string',
                'configType': 'antenna-downlink'|'antenna-downlink-demod-decode'|'antenna-uplink'|'dataflow-endpoint'|'tracking'|'uplink-echo',
                'dataflowDestinationRegion': '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',
                            ]
                        }
                    }
                },
                'configId': 'string',
                'configType': 'antenna-downlink'|'antenna-downlink-demod-decode'|'antenna-uplink'|'dataflow-endpoint'|'tracking'|'uplink-echo',
                '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) --

          • configId (string) --

            UUID of a Config .

          • configType (string) --

            Type of a Config .

          • dataflowDestinationRegion (string) --

            Region of a dataflow destination.

        • 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) --

          • 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) --

GetConfig (updated) Link ¶
Changes (response)
{'configData': {'antennaUplinkConfig': {'transmitDisabled': 'boolean'}}}

Returns Config information.

Only one Config response can be returned.

See also: AWS API Documentation

Request Syntax

client.get_config(
    configId='string',
    configType='antenna-downlink'|'antenna-downlink-demod-decode'|'antenna-uplink'|'dataflow-endpoint'|'tracking'|'uplink-echo'
)
type configId

string

param configId

[REQUIRED]

UUID of a Config .

type configType

string

param configType

[REQUIRED]

Type of a Config .

rtype

dict

returns

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'
        },
        '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',
    '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.

      • 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) --

GetDataflowEndpointGroup (updated) Link ¶
Changes (response)
{'endpointsDetails': {'endpoint': {'mtu': 'integer'}}}

Returns the dataflow endpoint group.

See also: AWS API Documentation

Request Syntax

client.get_dataflow_endpoint_group(
    dataflowEndpointGroupId='string'
)
type dataflowEndpointGroupId

string

param dataflowEndpointGroupId

[REQUIRED]

UUID of a dataflow endpoint group.

rtype

dict

returns

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) --

UpdateConfig (updated) Link ¶
Changes (request)
{'configData': {'antennaUplinkConfig': {'transmitDisabled': 'boolean'}}}

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

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'
        },
        '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',
    name='string'
)
type configData

dict

param configData

[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.

  • 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.

type configId

string

param configId

[REQUIRED]

UUID of a Config .

type configType

string

param configType

[REQUIRED]

Type of a Config .

type name

string

param name

[REQUIRED]

Name of a Config .

rtype

dict

returns

Response Syntax

{
    'configArn': 'string',
    'configId': 'string',
    'configType': 'antenna-downlink'|'antenna-downlink-demod-decode'|'antenna-uplink'|'dataflow-endpoint'|'tracking'|'uplink-echo'
}

Response Structure

  • (dict) --

    • configArn (string) --

      ARN of a Config .

    • configId (string) --

      UUID of a Config .

    • configType (string) --

      Type of a Config .