Table Of Contents


User Guide

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

[ aws . kinesis-video-archived-media ]



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 GetMediaForFragmentList API:

  • A client can call GetMediaForFragmentList 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 GetMediaForFragmentList session.

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.


--stream-name <value>
--fragments <value>
outfile <value>


--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 ListFragments .


"string" "string" ...

outfile (string) Filename where the content will be saved

See 'aws help' for descriptions of global parameters.


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 GetMediaForFragmentList 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