/  Yamcs HTTP API  /  Parameter Values  /  Load Parameter Values

Load Parameter ValuesΒΆ

Load a stream of parameter values

Warning

This method uses client-streaming.

URI Template

POST /api/parameter-values/{instance}/streams/{stream}:load
{instance}

Yamcs instance name

{stream}

Stream name

Request Body

interface LoadParameterValuesRequest {

  // A group of values, and their properties
  values: ParameterValueUpdate[];
}

Response Type

interface LoadParameterValuesResponse {

  // The number of values that were loaded
  valueCount: number;

  // The earliest generation time of all received values
  minGenerationTime: string;  // RFC 3339 timestamp

  // The latest generation time of all received values
  maxGenerationTime: string;  // RFC 3339 timestamp
}

Related Types

interface ParameterValueUpdate {

  // Fully qualified parameter name
  parameter: string;

  // The new value
  value: Value;

  // The generation time of the value. If specified, must be a date
  // string in ISO 8601 format.
  generationTime: string;  // RFC 3339 timestamp

  // How long before this value expires, in milliseconds
  expiresIn: string;  // String decimal
}

// Union type for storing a value
interface Value {
  type: Type;
  floatValue: number;
  doubleValue: number;
  sint32Value: number;
  uint32Value: number;
  binaryValue: string;  // Base64
  stringValue: string;
  timestampValue: string;  // String decimal
  uint64Value: string;  // String decimal
  sint64Value: string;  // String decimal
  booleanValue: boolean;
  aggregateValue: AggregateValue;
  arrayValue: Value[];
}

// An aggregate value is an ordered list of (member name, member value).
// Two arrays are used in order to be able to send just the values (since
// the names will not change)
interface AggregateValue {
  name: string[];
  value: Value[];
}

enum Type {
  FLOAT = "FLOAT",
  DOUBLE = "DOUBLE",
  UINT32 = "UINT32",
  SINT32 = "SINT32",
  BINARY = "BINARY",
  STRING = "STRING",
  TIMESTAMP = "TIMESTAMP",
  UINT64 = "UINT64",
  SINT64 = "SINT64",
  BOOLEAN = "BOOLEAN",
  AGGREGATE = "AGGREGATE",
  ARRAY = "ARRAY",

  // Enumerated values have both an integer (sint64Value) and a string representation
  ENUMERATED = "ENUMERATED",
  NONE = "NONE",
}