AWaws-samples
Objects

Object Information

Changed on

Contains Flows that references the init/Media Object and other information.

The paging query parameters and headers are required for the list of Flow references in the Object. Service implementations should return a complete list of Flow references within reason and API clients should expect paging to happen in some rare cases where a Object is used in many Flows.

When making requests to provided get_urls that are not presigned, clients SHOULD include credentials if the provided URL is on the same origin as the Service itself, akin to the same-origin mode in the WhatWG Fetch Standard. Services MAY support the use of out-of-band credentials where the provided URL is on a different origin to the Service itself. Services SHOULD NOT solely require the use of out-of-band credentials.

get/objects/{objectId}

Request

  • Base URL
    http://localhost:4010
  • URL
    http://localhost:4010/objects/{objectId}
  • Auth
    • HTTP bearer
    • or API key in query parameter access_token
    • or HTTP basic

Path parameters

objectIdstring required

The Object identifier. The Object ID may include special characters such as / which should be URL encoded.

Query parameters

verbose_storageboolean

Include storage metadata in get_urls. When verbose_storage is false only url, presigned, and label will be included in get_urls and init_object.get_urls.

accept_get_urlsstring

A list of Object GET URL Labels, formatted for use in query string parameters

A comma separated list of labels of Object get_urls and init_object.get_urls to include in the response. Omitting accept_get_urls will result in no filtering of get_urls or init_object.get_urls. An empty accept_get_urls results in get_urls and init_object.get_urls being empty or omitted in the response. Object get_urls and init_object.get_urls with no label will only be returned if accept_get_urls is omitted. Without get_urls and init_object.get_urls, the response from the service could be substantially faster if it is not required to generate a large number of pre-signed URLs for example. Where multiple filter query parameters are provided, the returned get_urls and init_object.get_urls will match all filters.

accept_storage_idsstring

A comma separated list of storage_ids of Object get_urls and init_object.get_urls to include in the response. Omitting accept_storage_ids, or providing an empty accept_storage_ids will result in no filtering of get_urls or init_object.get_urls. Object get_urls and init_object.get_urls with no storage ID will only be returned if accept_storage_ids is omitted or empty. A full list of available storage_ids may be found at the service/storage-backends endpoint. Where multiple filter query parameters are provided, the returned get_urls and init_object.get_urls will match all filters.

presignedboolean

If set to true, only presigned URLs (i.e. those whos presigned property is true) will be returned in get_urls and init_object.get_urls. If set to false, only non-presigned URLs (i.e. those whos presigned property is false) will be returned in get_urls and init_object.get_urls. If omitted, both presigned and non-presigned URLs will be returned. If presigned is set to false, the response from the service could be substantially faster if it is not required to generate a large number of pre-signed URLs. Where multiple filter query parameters are provided, the returned get_urls and init_object.get_urls will match all filters.

flow_tag.{name}string

Filter referenced_by_flows on tag values. This option is the same as the tag.{name} query parameter on the /flows/ API endpoint.

flow_tag_exists.{name}boolean

Filter referenced_by_flows on tag names. This option is the same as the tag_exists.{name} query parameter on the /flows/ API endpoint.

storage_backend_tag.{name}string

Filter get_urls and init_object.get_urls on tag values. This option is the same as the tag.{name} query parameter on the /service/storage-backends API endpoint.

storage_backend_tag_exists.{name}boolean

Filter get_urls and init_object.get_urls on tag names. This option is the same as the tag_exists.{name} query parameter on the /service/storage-backends API endpoint.

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

idstring required

The Object identifier.

referenced_by_flowsUuid[] required

List of Flows that reference this Object via Flow Segments in this store instance. For init Objects, this reference is indirect via Media Objects.

first_referenced_by_flowstring

A Universally Unique Identifier (UUID) as defined in RFC9562

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.

key_frame_countinteger

The number of key frames in the Media Object. This should be set greater than zero when the Media Object contains key frames that serve as a stream access point

Changes

  • eb3977b33601Revision changes
    • info

      added the new optional query request parameter storage_backend_tag.{name}

    • info

      added the new optional query request parameter storage_backend_tag_exists.{name}

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ///// to the response with the status

  • 7a9a5cdbb3d2Revision changes
    • breaking

      the response property / became optional for the status

    • info

      added to the response body allOf list for the response status

    • info

      removed from the response body allOf list for the response status

    • info

      added the optional property / to the response with the status