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 a Kinesis video stream.


This operation is only available for the AWS SDK for Java. It is not supported in AWS SDKs for other languages.

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.


--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 list-fragments .


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