Table Of Contents

Feedback

User Guide

First time using the AWS CLI? See the User Guide for help getting started.

[ aws . kinesis-video-archived-media ]

get-media-for-fragment-list

Description

Gets media for a list of fragments (specified by fragment number) from the archived data in an Amazon Kinesis video stream.

The following limits apply when using the get-media-for-fragment-list API:

  • A client can call get-media-for-fragment-list up to five times per second per stream.
  • Kinesis Video Streams sends media data at a rate of up to 25 megabytes per second (or 200 megabits per second) during a get-media-for-fragment-list session.

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.

Synopsis

  get-media-for-fragment-list
--stream-name <value>
--fragments <value>
outfile <value>

Options

--stream-name (string)

The name of the stream from which to retrieve fragment media.

--fragments (list)

A list of the numbers of fragments for which to retrieve media. You retrieve these values with list-fragments .

Syntax:

"string" "string" ...

outfile (string) Filename where the content will be saved

See 'aws help' for descriptions of global parameters.

Output

ContentType -> (string)

The content type of the requested media.

Payload -> (blob)

The payload that Kinesis Video Streams returns is a sequence of chunks from the specified stream. For information about the chunks, see PutMedia . The chunks that Kinesis Video Streams returns in the get-media-for-fragment-list call also include the following additional Matroska (MKV) tags:

  • AWS_KINESISVIDEO_FRAGMENT_NUMBER - Fragment number returned in the chunk.
  • AWS_KINESISVIDEO_SERVER_SIDE_TIMESTAMP - Server-side time stamp of the fragment.
  • AWS_KINESISVIDEO_PRODUCER_SIDE_TIMESTAMP - Producer-side time stamp of the fragment.

The following tags will be included if an exception occurs:

  • AWS_KINESISVIDEO_FRAGMENT_NUMBER - The number of the fragment that threw the exception
  • AWS_KINESISVIDEO_EXCEPTION_ERROR_CODE - The integer code of the exception
  • AWS_KINESISVIDEO_EXCEPTION_MESSAGE - A text description of the exception