get-clip

Описание

Загружает файл MP4 (клип), содержащий архивированные, медиаданные по запросу из указанного видеопотока в указанном временном диапазоне.

Параметры StreamName и StreamARN являются необязательными, но при вызове этой операции API необходимо указать либо StreamName, либо StreamARN.

В качестве предварительного условия для использования API GetCLip необходимо получить конечную точку, используя GetDataEndpoint, указав GET_CLIP для параметра APIName.

Поток Amazon Kinesis видео имеет следующие требования для предоставления данных через MP4:

• Медиаданные должны содержать видео с кодированием h.264 или h.265 и, необязательно, аудио с кодированием AAC или G.711. В частности, идентификатор кодека дорожки 1 должен быть V_MPEG/ISO/AVC (для h.264) или V_MPEGH/ISO/HEVC (для H.265). Необязательно, идентификатор кодека дорожки 2 должен быть A_AAC (для AAC) или A_MS/ACM (для G.711).
• Срок хранения данных должен быть больше 0.
• Дорожка видео каждого фрагмента должна содержать данные кодека в формате Advanced Video Coding (AVC) для h.264 и HEVC для h.265. Для получения дополнительной информации см. спецификацию MPEG-4 ISO/IEC 14496-15. Для получения информации об адаптации данных потока к заданному формату см. NAL Adaptation Flags.
• Дорожка аудио (если присутствует) каждого фрагмента должна содержать данные кодека в формате AAC (спецификация AAC ISO/IEC 13818-7) или формате MS Wave.

Вы можете отслеживать количество исходящих данных, контролируя метрику GetClip.OutgoingBytes Amazon CloudWatch. Для получения информации об использовании CloudWatch для мониторинга потоков Kinesis Video см. Мониторинг потоков Kinesis Video Streams. Для информации о ценообразовании см. Цены на Amazon Kinesis Video Streams и Цены Amazon Web Services. Применяются сборы за исходящие данные Amazon Web Services.

См. также: Документация API AWS

Синтаксис

  get-clip
[--stream-name <value>]
[--stream-arn <value>]
--clip-fragment-selector <value>
<outfile>
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--stream-name (строка)

--stream-arn (строка)

--clip-fragment-selector (структура)

Сокращенный синтаксис:

FragmentSelectorType=string,TimestampRange={StartTimestamp=timestamp,EndTimestamp=timestamp}

Синтаксис JSON:

{
  "FragmentSelectorType": "PRODUCER_TIMESTAMP"|"SERVER_TIMESTAMP",
  "TimestampRange": {
    "StartTimestamp": timestamp,
    "EndTimestamp": timestamp
  }
}

outfile (строка) Имя файла, в котором будет сохранён контент

Глобальные параметры

--debug (булево)

Включить отладку.

--endpoint-url (строка)

Переопределить значение URL команды заданным URL.

--no-verify-ssl (булево)

По умолчанию AWS CLI использует SSL при общении с сервисами AWS. Для каждого соединения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет стандартное поведение проверки сертификатов SSL.

--no-paginate (булево)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI сделает только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования вывода команды.

• json
• text
• table
• yaml
• yaml-stream

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использовать определенный профиль из файла учетных данных.

--region (строка)

Использовать определенный регион. Переопределяет настройки конфигурации/среды.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включить/выключить вывод цвета.

• on
• off
• auto

--no-sign-request (булево)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент указан.

--ca-bundle (строка)

Файл с сертификатами CA для проверки сертификатов SSL. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. По умолчанию формат — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, которое соответствует двоичному блоку, fileb:// всегда будет обрабатываться как двоичный и будет использовать содержимое файла непосредственно независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенного cli-binary-format.

• base64
• raw-in-base64-out

--no-cli-pager (булево)

Отключить кли-пейджер для вывода.

--cli-auto-prompt (булево)

Автоматически запрашивать параметры CLI.

--no-cli-auto-prompt (булево)

Отключить автоматическую запрос параметров CLI.

Вывод

ContentType -> (строка)

Payload -> (потоковый блок)