Sign in

v1

latestOpenAPI 3.1.0Apache 2.02026-07-178042197.1 KB
Flows

List Flows

List the Flows registered in the TAMS service instance.

get/flows

Query parameters

source_idstring

A Universally Unique Identifier (UUID) as defined in RFC9562

Filter on Source identifier.

timerangestring

A timerange of timestamps. It is represented using one or two timestamps with inclusivity and exclusivity markers.

E.g.

  • [0:0_10:0) represents 10 seconds of media starting at timestamp 0:0 and ending before 10:0.
  • (5:0_ represents a timerange starting after 5:0 and to eternity.
  • _ without timestamps or inclusivity markers represents "eternity" (i.e. the entire timeline).
  • () without timestamps represents "never" (i.e. a range of zero length in no particular position).
  • [1694429247:0_1694429248:0) is a 1 second TAI timerange starting at 2023-09-11T10:46:50.0Z UTC.
  • [1694429247:0] is an instantaneous TAI timerange at 2023-09-11T10:46:50.0Z UTC. This is equivalent to [1694429247:0_1694429247:0]. The short syntax is preferred due to ease of identification as instantaneous. Instantaneous TimeRanges cannot use exclusive markers (i.e. ( or )).
  • A [ or ] indicates that bound is inclusive, and a ( or ) indicates that bound is exclusive.

Details of the format can be found in the Timestamps in TAMS application note.

Filter on Flows that overlap the given timerange. An empty timerange returns Flows with no content.

format'urn:x-nmos:format:video' | 'urn:x-tam:format:image' | 'urn:x-nmos:format:audio' | 'urn:x-nmos:format:data' | 'urn:x-nmos:format:multi' uri

Identifies the content format for a Flow or Source using a URN string

Filter on Flow format.

codecstring

A Mime Type without parameters as defined in RFC2045 and RFC7231

Filter on Flow codec.

labelstring

Filter on Flows that have the given label.

tag.{name}string

A list of tag values, formatted for use in query string parameters

Filter on flows that have a tag named {name} with a value in the given comma-seperated list of values. The {name} and the value MUST be URL encoded where special characters are present. Where the tag's value is a string, at least one of the given values will match. Where the tag's value is an array, at least one value in the array will match at least one of the given values. Partial string matches of the values are not valid.

tag_exists.{name}boolean

Filter on Flows that have a tag named {name} regardless of value. {name} MUST be URL encoded where special characters are present. If set to true then the presence of the tag is filtered for. If set to false then its absence is. If left out then no filtering on tag presence is performed.

frame_widthinteger

Filter on video Flows that have the given frame width.

frame_heightinteger

Filter on video Flows that have the given frame height.

init_segmentsboolean

Filter Flows on the value of init_segments.

pagestring

Opaque string used by backend to access a specific page of results. Clients should read the next URL from the Link header returned with responses, or use value of the returned X-Paging-NextKey header. If not supplied, the first page is accessed. Service implementations should ensure a consistent sort order is applied to pages of results.

limitinteger

Restrict the response to the specified number of results. Service implementations may specify their own default and maximum for the limit

Response