Skip to main content

Services

RPC methods exposed by this API.

IngestService

MethodRequestResponseDescription
IngestWithConfigDataStreamIngestWithConfigDataStreamRequest (stream)IngestWithConfigDataStreamResponse
IngestArbitraryProtobufDataStreamIngestArbitraryProtobufDataStreamRequest (stream)IngestArbitraryProtobufDataStreamResponse

Messages

Data models used across requests/responses.

IngestArbitraryProtobufDataStreamRequest

FieldTypeLabelDescription
message_type_identifierstring
message_type_display_namestringoptional
asset_namestring
timestampgoogle.protobuf.Timestamp
valuebytes
run_idstring
namespacestring
organization_idstring
end_stream_on_validation_errorboolBy default, if this request fails to parse for any reason, the request is stored in an error queue and the stream continues to accept data. This ensures all data is saved, but only valid data is fully ingested. If this is set to true, any validation errors end the stream and return the error to the client.

IngestArbitraryProtobufDataStreamResponse

This message has no fields.

IngestWithConfigDataChannelValue

FieldTypeLabelDescription
oneof type. stringstring
oneof type. doubledouble
oneof type. floatfloat
oneof type. boolbool
oneof type. int32int32
oneof type. uint32uint32
oneof type. int64int64
oneof type. uint64uint64
oneof type. bit_fieldbytes
oneof type. enumuint32
oneof type. emptygoogle.protobuf.EmptyIf there’s not a new data point for a channel at the given timestamp, pass empty to skip it
oneof type. bytesbytes

IngestWithConfigDataStreamRequest

INTERNAL NOTE (remove from public protos): Any updates to this proto message MUST also update the IngestWithConfigDataStreamRequestLite and IngestWithConfigDataStreamChannelValuesOnly proto messages in sift_internal/ingest/v1/ingest.proto. For performance, only the minimal set of fields is deserialized on ingest by the IngestWithConfigDataStreamRequestLite proto message definition; other fields that are expensive and/or large and that are not required to be parsed should not be included there. Additionally, the field number MUST match exactly as we depend on the field numbers to correctly decode the fields despite technically different message definitions.
FieldTypeLabelDescription
ingestion_config_idstring
flowstring
timestampgoogle.protobuf.Timestamp
channel_valuesIngestWithConfigDataChannelValuerepeated
run_idstringThe run_id MUST be included if this data is part of a run.
end_stream_on_validation_errorboolBy default, if this request contains any channel values that do not match the supplied ingestion config, the request is stored in an error queue and the stream continues to accept data. This ensures all data is saved, but only valid data is fully ingested. If this is set to true, any validation errors end the stream and return the error to the client.
organization_idstring

IngestWithConfigDataStreamResponse

This message has no fields.

Enums

Allowed constant values used in message fields.