GroundStation / Client / update_config

update_config#

GroundStation.Client.update_config(**kwargs)#

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'
)
Parameters:
  • configData (dict) –

    [REQUIRED]

    Parameters of a Config.

    Note

    This is a Tagged Union structure. Only one of the following top level keys can be set: antennaDownlinkConfig, antennaDownlinkDemodDecodeConfig, antennaUplinkConfig, dataflowEndpointConfig, s3RecordingConfig, trackingConfig, uplinkEchoConfig.

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

Return type:

dict

Returns:

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

  • GroundStation.Client.exceptions.InvalidParameterException

  • GroundStation.Client.exceptions.DependencyException

  • GroundStation.Client.exceptions.ResourceNotFoundException