Request Offline Data¶

Request offline data.

This request can be used to obtain offline data from an SLE provider. The link has to be of type org.yamcs.sle.OfflineTmSleLink.

start and stop are passed as parameters to the RAF-START SLE request. The SLE provider will deliver all frames having their Earth Reception Time (ERT) in the [start, stop] time interval, both ends are inclusive. SLE requires that start is strictly smaller than stop so start=stop is not accepted.

The time passed via API is at nanosecond resolution whereas the time passed in the RAF-START SLE request is at microsecond or picosecond resolution (depending on the SLE version used).

Leap seconds

Time passed via the API is according to the Timestamp protobuf message and is passed unsmeared to the SLE request. This is different from the normal requests to Yamcs where the time is transformed into internal Yamcs time (but at millisecond resolution!) by performing reverse smearing around the leap seconds.

This means that it is not possible to specify a retrieval that starts or stops on a leap second. For example 2016-12-31T23:59:60Z will be effectively translated into 2017-01-01T00:00:00Z.

URI Template

POST /api/sle/links/{instance}/{linkName}:requestOfflineData

{instance}

Yamcs instance name

{linkName}

Link name

Request Body

interface RequestOfflineDataRequest {

  // Start of the retrieval interval
  start: string;  // RFC 3339 timestamp

  // End of the retrieval interval
  stop: string;  // RFC 3339 timestamp
}