Select your cookie preferences

We use cookies and similar tools to enhance your experience, provide our services, deliver relevant advertising, and make improvements. Approved third parties also use these tools to help us deliver advertising and provide certain site features.

list_satellites

list_satellites(**kwargs)

Returns a list of satellites.

See also: AWS API Documentation

Request Syntax

response = client.list_satellites(
    maxResults=123,
    nextToken='string'
)
Parameters
  • 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.
Return type

dict

Returns

Response Syntax

{
    'nextToken': 'string',
    'satellites': [
        {
            'currentEphemeris': {
                'ephemerisId': 'string',
                'epoch': datetime(2015, 1, 1),
                'name': 'string',
                'source': 'CUSTOMER_PROVIDED'|'SPACE_TRACK'
            },
            '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.

        • currentEphemeris (dict) --

          The current ephemeris being used to compute the trajectory of the satellite.

          • ephemerisId (string) --

            UUID of a customer-provided ephemeris.

            This field is not populated for default ephemerides from Space Track.

          • epoch (datetime) --

            The epoch of a default, ephemeris from Space Track in UTC.

            This field is not populated for customer-provided ephemerides.

          • name (string) --

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

            A name is only returned for customer-provider ephemerides that have a name associated.

          • source (string) --

            The EphemerisSource that generated a given ephemeris.

        • 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

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