Yamcs HTTP API
- Activities
- Alarms
- Audit
- Buckets
- Clearance
- Commands
- COP-1
- Database
- Events
- File Transfer
- IAM
- Indexes
- Instances
- Links
- MDB Override
- MDB
- Packets
- Parameter Archive
- Parameter Lists
- Parameter Values
- Processing
- Queues
- Replication
- RocksDB
- Server
- Services
- Sessions
- Stream Archive
- Table
- Time Correlation
- Time
- Timeline
Related
Yamcs Release Notes
Yamcs Server Manual
Source Code Documentation
Download this Document
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",
}