create_ephemeris

GroundStation.Client.create_ephemeris(**kwargs)

Creates an Ephemeris with the specified EphemerisData .

See also: AWS API Documentation

Request Syntax

response = client.create_ephemeris(
    enabled=True|False,
    ephemeris={
        'oem': {
            'oemData': 'string',
            's3Object': {
                'bucket': 'string',
                'key': 'string',
                'version': 'string'
            }
        },
        'tle': {
            's3Object': {
                'bucket': 'string',
                'key': 'string',
                'version': 'string'
            },
            'tleData': [
                {
                    'tleLine1': 'string',
                    'tleLine2': 'string',
                    'validTimeRange': {
                        'endTime': datetime(2015, 1, 1),
                        'startTime': datetime(2015, 1, 1)
                    }
                },
            ]
        }
    },
    expirationTime=datetime(2015, 1, 1),
    kmsKeyArn='string',
    name='string',
    priority=123,
    satelliteId='string',
    tags={
        'string': 'string'
    }
)
Parameters
  • enabled (boolean) --

    Whether to set the ephemeris status to ENABLED after validation.

    Setting this to false will set the ephemeris status to DISABLED after validation.

  • ephemeris (dict) --

    Ephemeris data.

    Note

    This is a Tagged Union structure. Only one of the following top level keys can be set: oem, tle.

    • oem (dict) --

      Ephemeris data in Orbit Ephemeris Message (OEM) format.

      • oemData (string) --

        The data for an OEM ephemeris, supplied directly in the request rather than through an S3 object.

      • s3Object (dict) --

        Identifies the S3 object to be used as the ephemeris.

        • bucket (string) --

          An Amazon S3 Bucket name.

        • key (string) --

          An Amazon S3 key for the ephemeris.

        • version (string) --

          For versioned S3 objects, the version to use for the ephemeris.

    • tle (dict) --

      Two-line element set (TLE) ephemeris.

      • s3Object (dict) --

        Identifies the S3 object to be used as the ephemeris.

        • bucket (string) --

          An Amazon S3 Bucket name.

        • key (string) --

          An Amazon S3 key for the ephemeris.

        • version (string) --

          For versioned S3 objects, the version to use for the ephemeris.

      • tleData (list) --

        The data for a TLE ephemeris, supplied directly in the request rather than through an S3 object.

        • (dict) --

          Two-line element set (TLE) data.

          • tleLine1 (string) -- [REQUIRED]

            First line of two-line element set (TLE) data.

          • tleLine2 (string) -- [REQUIRED]

            Second line of two-line element set (TLE) data.

          • validTimeRange (dict) -- [REQUIRED]

            The valid time range for the TLE. Gaps or overlap are not permitted.

            • endTime (datetime) -- [REQUIRED]

              Time in UTC at which the time range ends.

            • startTime (datetime) -- [REQUIRED]

              Time in UTC at which the time range starts.

  • expirationTime (datetime) -- An overall expiration time for the ephemeris in UTC, after which it will become EXPIRED .
  • kmsKeyArn (string) -- The ARN of a KMS key used to encrypt the ephemeris in Ground Station.
  • name (string) --

    [REQUIRED]

    A name string associated with the ephemeris. Used as a human-readable identifier for the ephemeris.

  • priority (integer) --

    Customer-provided priority score to establish the order in which overlapping ephemerides should be used.

    The default for customer-provided ephemeris priority is 1, and higher numbers take precedence.

    Priority must be 1 or greater

  • satelliteId (string) --

    [REQUIRED]

    AWS Ground Station satellite ID for this ephemeris.

  • tags (dict) --

    Tags assigned to an ephemeris.

    • (string) --
      • (string) --
Return type

dict

Returns

Response Syntax

{
    'ephemerisId': 'string'
}

Response Structure

  • (dict) --

    • ephemerisId (string) --

      The AWS Ground Station ephemeris ID.

Exceptions

  • GroundStation.Client.exceptions.InvalidParameterException
  • GroundStation.Client.exceptions.DependencyException
  • GroundStation.Client.exceptions.ResourceNotFoundException