list-jobs-by-status

Описание

Операция ListJobsByStatus получает список задач, имеющих указанный статус. Тело ответа содержит по одному элементу для каждой задачи, удовлетворяющей критериям поиска.

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

list-jobs-by-status является операцией с постраничной навигацией. Для получения всего набора результатов могут потребоваться несколько API-вызовов. Вы можете отключить постраничную навигацию, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничной навигацией, аргумент --query должен извлекать данные из результатов следующих выражений запроса: Jobs

Синтаксис

  list-jobs-by-status
--status <value>
[--ascending <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--max-items <value>]
[--generate-cli-skeleton <value>]
[--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]

Параметры

--status (строка)

Чтобы получить информацию обо всех задачах, связанных с текущей учётной записью AWS, имеющих заданный статус, укажите следующий статус: Submitted , Progressing , Complete , Canceled или Error .

--ascending (строка)

Чтобы упорядочить список задач по дате и времени их отправки в хронологическом порядке, введите true . Чтобы упорядочить список задач в обратном хронологическом порядке, введите false .

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON-строки. JSON-строка соответствует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределят значения, полученные из JSON. Невозможно передать произвольные двоичные значения с помощью JSON-значения, поскольку строка будет взята буквально. Это нельзя указывать вместе с --cli-input-yaml.

--starting-token (строка)

Маркер для указания места начала постраничной навигации. Это NextToken из ранее усечённого ответа.

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

--max-items (целое число)

Общее количество элементов, которые нужно вернуть в выводе команды. Если общее количество доступных элементов превышает указанное значение, в выводе команды будет предоставлен NextToken. Для продолжения постраничной навигации предоставьте значение NextToken в аргументе starting-token последующей команды. Не используйте элемент ответа NextToken напрямую вне AWS CLI.

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

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса API. Если указано без значения или со значением input, выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если указано yaml-input, будет выведен пример входного YAML, который можно использовать с --cli-input-yaml. Если указано значение output, он проверяет входные данные команды и возвращает пример выходного JSON для этой команды. Сгенерированный JSON-скелет не стабилен между версиями AWS CLI и не гарантирует обратной совместимости в сгенерированном JSON-скелете.

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

--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 (булево)

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

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

Отключить автоматическое запроса параметров ввода командной строки.

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. Более подробную информацию см. в руководстве пользователя AWS CLI в разделе «Начало работы».

Если не указано иное, все примеры используют правила цитирования, похожие на unix-like. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. Подробнее см. раздел «Использование кавычек со строками» в руководстве пользователя AWS CLI.

Для получения списка задач ElasticTranscoder со статусом Complete

Этот пример получает список задач ElasticTranscoder со статусом Complete.

Команда:

aws elastictranscoder list-jobs-by-status --status Complete

Вывод:

{
   "Jobs": []
}

Вывод

Задачи -> (список)

Массив объектов Job, имеющих указанный статус.

(структура)

Раздел тела ответа, предоставляющий информацию о созданной задаче.

Id -> (строка)

Идентификатор, присвоенный задаче Elastic Transcoder. Используется для получения настроек задачи или удаления задачи.

Arn -> (строка)

Amazon Resource Name (ARN) для задачи.

PipelineId -> (строка)

Идентификатор Id используемой для транскодирования трубы Elastic Transcoder. Труба определяет различные параметры, включая Amazon S3-хранилище, из которого Elastic Transcoder получает файлы для транскодирования, и хранилище, в которое Elastic Transcoder помещает транскодированные файлы.

Input -> (структура)

Раздел тела запроса или ответа, предоставляющий информацию о файле, подлежащем транскодированию.

Key -> (строка)

Имя файла для транскодирования. В другом месте тела JSON-блока указан идентификатор используемой трубы для обработки задачи. Объект InputBucket в этой трубе указывает Elastic Transcoder, из какого Amazon S3-хранилища получить файл.

Если имя файла содержит префикс, например cooking/lasagna.mpg , включите префикс в ключ. Если файл не находится в указанном хранилище, Elastic Transcoder возвращает ошибку.

FrameRate -> (строка)

Частота кадров входного файла. Если вы хотите, чтобы Elastic Transcoder автоматически определял частоту кадров входного файла, укажите auto. Если вы хотите указать частоту кадров для входного файла, введите одно из следующих значений:

10 , 15 , 23.97 , 24 , 25 , 29.97 , 30 , 60

Если вы укажете значение отличное от auto, Elastic Transcoder отключит автоматическое определение частоты кадров.

Resolution -> (строка)

Это значение должно быть auto, что заставит Elastic Transcoder автоматически определять разрешение входного файла.

AspectRatio -> (строка)

Соотношение сторон входного файла. Если вы хотите, чтобы Elastic Transcoder автоматически определял соотношение сторон входного файла, укажите auto. Если вы хотите указать соотношение сторон для выходного файла, введите одно из следующих значений:

1:1 , 4:3 , 3:2 , 16:9

Если вы укажете значение отличное от auto, Elastic Transcoder отключит автоматическое определение соотношения сторон.

Interlaced -> (строка)

Является ли входной файл интерлинованным. Если вы хотите, чтобы Elastic Transcoder автоматически определял, является ли входной файл интерлинованным, укажите auto. Если вы хотите указать, является ли входной файл интерлинованным, введите одно из следующих значений:

true , false

Если вы укажете значение отличное от auto, Elastic Transcoder отключит автоматическое определение интерлинования.

Container -> (строка)

Тип контейнера для входного файла. Если вы хотите, чтобы Elastic Transcoder автоматически определял тип контейнера входного файла, укажите auto. Если вы хотите указать тип контейнера для входного файла, введите одно из следующих значений:

3gp , aac , asf , avi , divx , flv , m4a , mkv , mov , mp3 , mp4 , mpeg , mpeg-ps , mpeg-ts , mxf , ogg , vob , wav , webm

Encryption -> (структура)

Настройки шифрования, если таковые имеются, используемые для расшифровки входных файлов. Если ваш входной файл зашифрован, необходимо указать режим, который Elastic Transcoder использует для расшифровки файла.

Mode -> (строка)

Конкретный режим шифрования на стороне сервера, который вы хотите использовать для расшифровки входных файлов или шифрования выходных файлов. Elastic Transcoder поддерживает следующие варианты:

s3: Amazon S3 создает и управляет ключами, используемыми для шифрования файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, который создает и управляет ключами, используемыми для шифрования файлов. Если вы укажете s3-aws-kms и не хотите использовать ключ по умолчанию, необходимо добавить используемый AWS-KMS ключ в вашу трубу.
aes-cbc-pkcs7: Режим шифрования блоков с заливкой, первоначально использовавшийся для файлов HLS.
aes-ctr: Режим AES Counter Mode.
aes-gcm: Режим AES Galois Counter Mode, режим аутентифицированного шифрования, означающий, что файл, ключ или начальный вектор, в котором обнаружены изменения, не проходит процесс расшифровки.

Для всех трех режимов AES необходимо предоставить следующие параметры, которые должны быть закодированы в base64:

Ключ
MD5 ключа
Начальный вектор

Предупреждение

Для режимов AES ваши закрытые ключи шифрования и нешифрованные данные никогда не хранятся AWS. Поэтому важно безопасно управлять своими ключами шифрования. Если вы их потеряете, вы не сможете расшифровать данные.

Key -> (строка)

Ключ шифрования данных, который вы хотите использовать для шифрования выходного файла или который использовался для шифрования входного файла. Ключ должен быть закодирован в base64 и должен иметь один из следующих размеров в битах до кодирования в base64:

128 , 192 или 256 .

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

MD5-хеш ключа, который вы использовали для шифрования входного файла или который вы хотите, чтобы Elastic Transcoder использовал для шифрования выходного файла. Elastic Transcoder использует хеш ключа как контрольную сумму, чтобы убедиться, что ваш ключ не был поврежден во время передачи. MD5 ключа должен быть закодирован в base64 и должен иметь длину ровно 16 байт до кодирования в base64.

InitializationVector -> (строка)

Последовательность случайных битов, сгенерированных генератором случайных чисел, уникальная для каждой операции шифрования, которую вы использовали для шифрования входных файлов или которую вы хотите, чтобы Elastic Transcoder использовал для шифрования выходных файлов. Начальный вектор должен быть закодирован в base64 и должен иметь длину ровно 16 байт до кодирования в base64.

TimeSpan -> (структура)

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

StartTime -> (строка)

Место в входном файле, с которого вы хотите начать обрезку. Формат может быть либо ЧЧ:мм:сс.МММ (максимальное значение: 23:59:59.999; МММ — тысячные доли секунды), либо ссссс.МММ (максимальное значение: 86399.999). Если значение не указано, Elastic Transcoder начинает с начала входного файла.

Duration -> (строка)

Продолжительность обрезки. Формат может быть либо ЧЧ:мм:сс.МММ (максимальное значение: 23:59:59.999; МММ — тысячные доли секунды), либо ссссс.МММ (максимальное значение: 86399.999). Если значение не указано, Elastic Transcoder создает выходной файл от StartTime до конца файла.

Если вы укажете значение, превышающее продолжительность входного файла, Elastic Transcoder транскодирует файл и вернёт предупреждение.

InputCaptions -> (структура)

Вы можете настроить Elastic Transcoder для транскодирования субтитров из одного формата в другой. Все субтитры должны быть в формате UTF-8. Elastic Transcoder поддерживает два типа субтитров:

Встроенные: Встроенные субтитры включены в тот же файл, что и аудио и видео. Elastic Transcoder поддерживает только один встроенный субтитр на язык, максимум 300 встроенных субтитров на файл. Допустимые входные значения включают: CEA-608 (EIA-608 , только первый непустой канал), CEA-708 (EIA-708 , только первый непустой канал), и mov-text. Допустимые выходные значения включают: mov-text. Elastic Transcoder поддерживает максимум один встроенный формат на выход.
Внешние: Внешние субтитры хранятся в отдельном метаданных файле от аудио и видео данных. Внешние субтитры требуют проигрывателя, способного понять взаимосвязь между видео файлом и файлом внешних субтитров. Elastic Transcoder поддерживает только один внешний субтитр на язык, максимум 20 внешних субтитров на файл. Допустимые входные значения включают: dfxp (только первый элемент div), ebu-tt , scc , smpt , srt , ttml (только первый элемент div), и webvtt. Допустимые выходные значения включают: dfxp (только первый элемент div), scc , srt , и webvtt.

Если вам требуются субтитры в формате ttml или smpte-tt, укажите dfxp в качестве выходного формата.

Elastic Transcoder не поддерживает OCR (оптическое распознавание символов), не принимает изображения в качестве допустимого входного формата для субтитров и недоступен для транскодирования только аудио. Elastic Transcoder не сохраняет форматирование текста (например, курсив) во время процесса транскодирования.

Чтобы удалить субтитры или оставить их пустыми, установите Captions в null. Чтобы пропустить существующие субтитры без изменений, установите MergePolicy в MergeRetain и передайте массив CaptionSources со значением null.

Дополнительную информацию об встроенных файлах см. на странице Wikipedia о субтитрах.

Дополнительную информацию о файлах внешних субтитров см. на страницах Wikipedia о платформе расширяемых метаданных и файлах внешних субтитров.

MergePolicy -> (строка)

Политика, определяющая, как Elastic Transcoder обрабатывает наличие нескольких субтитров.

MergeOverride: Elastic Transcoder транскодирует как встроенные, так и внешние субтитры в выходные данные. Если субтитры для языка встроены в входной файл и также присутствуют во внешнем файле, Elastic Transcoder использует внешние субтитры и игнорирует встроенные субтитры для данного языка.
MergeRetain: Elastic Transcoder транскодирует как встроенные, так и внешние субтитры в выходные данные. Если субтитры для языка встроены в входной файл и также присутствуют во внешнем файле, Elastic Transcoder использует встроенные субтитры и игнорирует внешние субтитры для данного языка. Если CaptionSources пусто, Elastic Transcoder пропускает все внешние субтитры из выходных файлов.
Override: Elastic Transcoder транскодирует только внешние субтитры, указанные в CaptionSources.

MergePolicy не может быть null.

CaptionSources -> (список)

Исходные файлы для входных внешних субтитров, используемые во время процесса транскодирования. Чтобы пропустить все внешние субтитры, оставьте CaptionSources пустым.

(структура)

Исходный файл для входных внешних субтитров, используемых во время процесса транскодирования.

Key -> (строка)

Имя файла внешних субтитров, который вы хотите включить в выходной файл Elastic Transcoder.

Language -> (строка)

Строка, которая указывает язык субтитров. Если вы указали несколько входных файлов с субтитрами, язык субтитров должен совпадать, чтобы они были включены в выходные данные. Укажите один из:

2-символьный код ISO 639-1
3-символьный код ISO 639-2

Дополнительную информацию о кодах ISO языков и названиях языков см. в списке кодов ISO 639-1.

TimeOffset -> (строка)

Для создания фрагментов или субтитров, которые не начинаются одновременно с соответствующим видеофайлом, TimeOffset сообщает Elastic Transcoder, сколько видео необходимо закодировать перед включением субтитров.

Укажите TimeOffset в формате [+-]SS.sss или [+-]HH:mm:SS.ss.

Label -> (строка)

Метка субтитров, отображаемая в проигрывателе при выборе языка. Рекомендуется указывать здесь название языка субтитров на языке самих субтитров.

Encryption -> (структура)

Настройки шифрования, если таковые имеются, которые Elastic Transcoder должен использовать для дешифрования ваших источников субтитров или которые вы хотите применить к вашим источникам субтитров.

Mode -> (строка)

Конкретный режим шифрования на стороне сервера, который вы хотите использовать Elastic Transcoder при дешифровании входных файлов или шифровании выходных файлов. Elastic Transcoder поддерживает следующие варианты:

s3: Amazon S3 создает и управляет ключами, используемыми для шифрования ваших файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, который создает и управляет ключами, используемыми для шифрования ваших файлов. Если вы указали s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить используемый AWS-KMS ключ в свою конвейерную линию.
aes-cbc-pkcs7: Заполненный режим шифрования блоков, первоначально используемый для файлов HLS.
aes-ctr: Режим AES Counter.
aes-gcm: Режим AES Galois Counter Mode, режим, представляющий собой аутентифицированный формат шифрования, означающий, что файл, ключ или начальный вектор, подвергшийся изменениям, не проходит процесс дешифрования.

Для всех трех режимов AES вам необходимо предоставить следующие параметры, которые должны быть закодированы в base64:

Ключ
MD5 ключа
Начальный вектор

Предупреждение

Для режимов AES ваши приватные ключи шифрования и ваши нешифрованные данные никогда не хранятся AWS; поэтому важно безопасно управлять своими ключами шифрования. Если вы их потеряете, вы не сможете дешифровать свои данные.

Key -> (строка)

Ключ шифрования данных, который вы хотите использовать Elastic Transcoder для шифрования выходного файла или который использовался для шифрования входного файла. Ключ должен быть закодирован в base64, и его длина в битах до кодирования в base64 должна быть одной из следующих:

128 , 192 , или 256.

Ключ также должен быть зашифрован с использованием Amazon Key Management Service.

KeyMd5 -> (строка)

MD5-хеш ключа, используемого для шифрования входного файла или который вы хотите использовать Elastic Transcoder для шифрования выходного файла. Elastic Transcoder использует хеш ключа как контрольную сумму, чтобы убедиться, что ваш ключ не был поврежден при передаче. MD5 ключа должен быть закодирован в base64 и иметь длину ровно 16 байт до кодирования в base64.

InitializationVector -> (строка)

Последовательность случайных битов, созданных генератором случайных битов, уникальная для каждой операции шифрования, которую вы использовали для шифрования входных файлов или которую вы хотите использовать Elastic Transcoder для шифрования выходных файлов. Начальный вектор должен быть закодирован в base64 и иметь длину ровно 16 байт до кодирования в base64.

DetectedProperties -> (структура)

Обнаруженные свойства входного файла.

Width -> (целое число)

Обнаруженная ширина входного файла в пикселях.

Height -> (целое число)

Обнаруженная высота входного файла в пикселях.

FrameRate -> (строка)

Обнаруженная частота кадров входного файла в кадрах в секунду.

FileSize -> (длинное целое)

Обнаруженный размер входного файла в байтах.

DurationMillis -> (длинное целое)

Обнаруженная продолжительность входного файла в миллисекундах.

Inputs -> (список)

Информация о файлах, которые вы транскодируете. Если вы указали несколько файлов для этой задачи, Elastic Transcoder объединяет их в один выходной файл.

(структура)

Информация о файле, который вы транскодируете.

Ключ -> (строка)

Имя файла для транскодирования. В другом месте блока JSON указан идентификатор конвейера для обработки задачи. Объект InputBucket в этом конвейере сообщает Elastic Transcoder, из какой ведра Amazon S3 получить файл.

Если имя файла содержит префикс, например cooking/lasagna.mpg, включите префикс в ключ. Если файл не находится в указанном ведре, Elastic Transcoder вернёт ошибку.

FrameRate -> (строка)

10 , 15 , 23.97 , 24 , 25 , 29.97 , 30 , 60

Если вы укажете значение, отличное от auto, Elastic Transcoder отключит автоматическое определение частоты кадров.

Resolution -> (строка)

Это значение должно быть auto, что заставит Elastic Transcoder автоматически определять разрешение входного файла.

AspectRatio -> (строка)

Соотношение сторон входного файла. Если вы хотите, чтобы Elastic Transcoder автоматически определял соотношение сторон входного файла, укажите auto. Если вы хотите указать соотношение сторон выходного файла, введите одно из следующих значений:

1:1 , 4:3 , 3:2 , 16:9

Если вы укажете значение, отличное от auto, Elastic Transcoder отключит автоматическое определение соотношения сторон.

Interlaced -> (строка)

Является ли входной файл чересстрочным. Если вы хотите, чтобы Elastic Transcoder автоматически определял, является ли входной файл чересстрочным, укажите auto. Если вы хотите указать, является ли входной файл чересстрочным, введите одно из следующих значений:

true , false

Если вы укажете значение, отличное от auto, Elastic Transcoder отключит автоматическое определение чересстрочного кодирования.

Container -> (строка)

3gp , aac , asf , avi , divx , flv , m4a , mkv , mov , mp3 , mp4 , mpeg , mpeg-ps , mpeg-ts , mxf , ogg , vob , wav , webm

Encryption -> (структура)

Настройки шифрования, если таковые имеются, используемые для расшифровки входных файлов. Если ваш входной файл зашифрован, вы должны указать режим, который Elastic Transcoder использует для его расшифровки.

Mode -> (строка)

Конкретный режим шифрования на стороне сервера, который вы хотите использовать Elastic Transcoder для расшифровки входных файлов или шифрования выходных файлов. Elastic Transcoder поддерживает следующие варианты:

s3: Amazon S3 создаёт и управляет ключами, используемыми для шифрования файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, который создаёт и управляет ключами, используемыми для шифрования файлов. Если вы укажете s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить ключ AWS-KMS, который хотите использовать, в свой конвейер.
aes-cbc-pkcs7: Режим шифрования с блоками и заполнением, первоначально использовавшийся для файлов HLS.
aes-ctr: Режим AES Counter Mode.
aes-gcm: Режим AES Galois Counter Mode, режим аутентифицированного шифрования, означающий, что файл, ключ или начальный вектор, которые были изменены, не проходят процесс расшифровки.

Для всех трёх режимов AES вы должны указать следующие параметры, которые должны быть закодированы в base64:

Ключ
MD5 ключа
Начальный вектор

Предупреждение

Для режимов AES ваши закрытые ключи шифрования и ваши незашифрованные данные никогда не хранятся AWS; поэтому важно безопасно управлять своими ключами шифрования. Если вы их потеряете, вы не сможете расшифровать свои данные.

Key -> (строка)

Ключ шифрования данных, который вы хотите использовать Elastic Transcoder для шифрования выходного файла или который использовался для шифрования входного файла. Ключ должен быть закодирован в base64 и должен иметь один из следующих размеров в битах до кодирования в base64:

128 , 192 или 256 .

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

MD5-хеш ключа, который вы использовали для шифрования входного файла или который вы хотите использовать Elastic Transcoder для шифрования выходного файла. Elastic Transcoder использует хеш ключа как контрольную сумму, чтобы убедиться, что ваш ключ не был повреждён при передаче. MD5 ключа должен быть закодирован в base64 и иметь длину ровно 16 байт до кодирования в base64.

InitializationVector -> (строка)

TimeSpan -> (структура)

Настройки для обрезки входных данных. У каждого входа могут быть разные настройки обрезки.

StartTime -> (строка)

Место в входном файле, где вы хотите начать обрезку. Формат может быть либо HH:mm:ss.SSS (максимальное значение: 23:59:59.999; SSS - тысячные доли секунды), либо sssss.SSS (максимальное значение: 86399.999). Если вы не укажете значение, Elastic Transcoder начнёт с начала входного файла.

Duration -> (строка)

Продолжительность обрезки. Формат может быть либо HH:mm:ss.SSS (максимальное значение: 23:59:59.999; SSS - тысячные доли секунды), либо sssss.SSS (максимальное значение: 86399.999). Если вы не укажете значение, Elastic Transcoder создаст выходной файл от StartTime до конца файла.

Если вы укажете значение, превышающее длительность входного файла, Elastic Transcoder транскодирует файл и вернёт сообщение об ошибке.

InputCaptions -> (структура)

Вы можете настроить Elastic Transcoder для транскодирования субтитров или титров из одного формата в другой. Все субтитры должны быть в формате UTF-8. Elastic Transcoder поддерживает два типа субтитров:

Встроенные: Встроенные субтитры включены в тот же файл, что и аудио и видео. Elastic Transcoder поддерживает только один встроенный субтитр на язык, до максимального значения 300 встроенных субтитров на файл. Допустимые входные значения включают: CEA-608 (EIA-608 , только первый непустой канал), CEA-708 (EIA-708 , только первый непустой канал), и mov-text. Допустимые выходные значения включают: mov-text. Elastic Transcoder поддерживает максимальное значение один встроенный формат на выходной.
Внешние: Внешние субтитры хранятся в отдельном файле метаданных от аудио и видеоданных. Внешние субтитры требуют плеера, способного понимать связь между видеофайлом и внешним файлом. Elastic Transcoder поддерживает только один внешний субтитр на язык, до максимального значения 20 внешних субтитров на файл. Допустимые входные значения включают: dfxp (только первый элемент div), ebu-tt , scc , smpt , srt , ttml (только первый элемент div), и webvtt. Допустимые выходные значения включают: dfxp (только первый элемент div), scc , srt , и webvtt.

Если вам нужны субтитры в формате ttml или smpte-tt, укажите dfxp в качестве выходного формата.

Elastic Transcoder не поддерживает OCR (оптическое распознавание символов), не принимает изображения в качестве допустимого входного значения для субтитров и недоступен для транскодирования только аудио. Elastic Transcoder не сохраняет форматирование текста (например, курсив) во время процесса транскодирования.

Чтобы удалить субтитры или оставить их пустыми, установите Captions в значение null. Чтобы пропустить существующие субтитры без изменений, установите MergePolicy в значение MergeRetain и передайте массив CaptionSources со значением null.

Дополнительную информацию об встроенных файлах см. на странице Wikipedia о субтитрах.

Дополнительную информацию о внешних файлах см. на страницах Wikipedia «Расширяемая платформа метаданных» и «Внешние файлы».

MergePolicy -> (строка)

Политика, определяющая, как Elastic Transcoder обрабатывает наличие нескольких субтитров.

MergeOverride: Elastic Transcoder транскодирует как встроенные, так и внешние субтитры в выходные данные. Если субтитры для языка встроены в входной файл и также присутствуют во внешнем файле, Elastic Transcoder использует внешние субтитры и игнорирует встроенные субтитры для данного языка.
MergeRetain: Elastic Transcoder транскодирует как встроенные, так и внешние субтитры в выходные данные. Если субтитры для языка встроены в входной файл и также присутствуют во внешнем файле, Elastic Transcoder использует встроенные субтитры и игнорирует внешние субтитры для данного языка. Если CaptionSources пусто, Elastic Transcoder опускает все внешние субтитры из выходных файлов.
Override: Elastic Transcoder транскодирует только внешние субтитры, указанные в CaptionSources.

MergePolicy не может быть null.

CaptionSources -> (список)

Исходные файлы для внешних субтитров, используемых в процессе транскодирования. Чтобы исключить все внешние субтитры, оставьте CaptionSources пустым.

(структура)

Исходный файл для внешних субтитров, используемых в процессе транскодирования.

Key -> (строка)

Имя файла внешних субтитров, который вы хотите, чтобы Elastic Transcoder включил в выходной файл.

Language -> (строка)

Строка, определяющая язык субтитров. Если вы указали несколько входных данных с субтитрами, язык субтитров должен совпадать, чтобы они были включены в выходной файл. Укажите это в виде:

2-символьный код ISO 639-1
3-символьный код ISO 639-2

Дополнительную информацию о кодах ISO языков и названиях языков см. в списке кодов ISO 639-1.

TimeOffset -> (строка)

Для генерации фрагментов или субтитров, которые не начинаются одновременно с соответствующим видеофайлом, TimeOffset указывает Elastic Transcoder, сколько видео кодировать перед включением субтитров.

Укажите TimeOffset в формате [+-]SS.sss или [+-]HH:mm:SS.ss.

Label -> (строка)

Метка субтитров, отображаемая в плеере при выборе языка. Рекомендуется указать здесь название языка субтитров на языке самих субтитров.

Encryption -> (структура)

Настройки шифрования, если таковые имеются, необходимые Elastic Transcoder для расшифровки ваших исходных файлов субтитров или для применения Elastic Transcoder к вашим исходным файлам субтитров.

Mode -> (строка)

Конкретный режим шифрования на стороне сервера, который вы хотите использовать Elastic Transcoder при расшифровке входных файлов или шифровании выходных файлов. Elastic Transcoder поддерживает следующие варианты:

s3: Amazon S3 создаёт и управляет ключами, используемыми для шифрования ваших файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, которая создаёт и управляет ключами, используемыми для шифрования файлов. Если вы указали s3-aws-kms и не хотите использовать ключ по умолчанию, вам необходимо добавить используемый AWS-KMS ключ в вашу конвейерную линию.
aes-cbc-pkcs7: Режим шифрования блоками с применением дополнения, изначально использовавшийся для файлов HLS.
aes-ctr: AES режим счётчика.
aes-gcm: AES режим счётчика Galois, режим, являющийся режимом аутентифицированного шифрования, то есть файл, ключ или вектор инициализации, которые были изменены, не пройдут процесс расшифровки.

Для всех трёх режимов AES вам необходимо предоставить следующие настройки, которые должны быть закодированы в base64:

Key
Key MD5
Initialization Vector

Предупреждение

В режимах AES ваши частные ключи шифрования и ваши нешифрованные данные никогда не хранятся AWS; поэтому важно безопасно управлять своими ключами шифрования. Если вы их потеряете, вы не сможете расшифровать свои данные.

Key -> (строка)

Ключ шифрования данных, который вы хотите использовать Elastic Transcoder для шифрования выходного файла или который использовался для шифрования входного файла. Ключ должен быть закодирован в base64 и должен иметь один из следующих размеров в битах до кодирования в base64:

128 , 192 или 256.

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

MD5-хеш ключа, который использовался для шифрования входного файла или который вы хотите, чтобы Elastic Transcoder использовал для шифрования выходного файла. Elastic Transcoder использует хэш ключа как контрольную сумму, чтобы убедиться, что ваш ключ не был повреждён при передаче. MD5 ключа должен быть закодирован в base64 и должен иметь длину ровно 16 байт до кодирования в base64.

InitializationVector -> (строка)

Последовательность случайных бит, созданных генератором случайных чисел, уникальная для каждой операции шифрования, которую вы использовали для шифрования входных файлов или которую вы хотите, чтобы Elastic Transcoder использовал для шифрования выходных файлов. Вектор инициализации должен быть закодирован в base64 и должен иметь длину ровно 16 байт до кодирования в base64.

DetectedProperties -> (структура)

Обнаруженные свойства входного файла.

Width -> (целое число)

Обнаруженная ширина входного файла в пикселях.

Height -> (целое число)

Обнаруженная высота входного файла в пикселях.

FrameRate -> (строка)

Обнаруженная частота кадров входного файла в кадрах в секунду.

FileSize -> (длинное целое число)

Обнаруженный размер входного файла в байтах.

DurationMillis -> (длинное целое число)

Обнаруженная продолжительность входного файла в миллисекундах.

Output -> (структура)

Если вы указали один вывод для задания, информация об этом выводе. Если вы указали несколько выводов для задания, объект Output содержит информацию о первом выводе. Это дублирует информацию, которая указана для первого вывода в объекте Outputs.

Предупреждение

Рекомендуется использовать Outputs.

Раздел запроса или тела ответа, который содержит информацию о преобразованном (целевом) файле.

Id -> (строка)

Последовательный счётчик, начиная с 1, который идентифицирует вывод среди выводов текущего задания. В синтаксисе Output это значение всегда равно 1.

Key -> (строка)

Имя, которое нужно назначить преобразованному файлу. Elastic Transcoder сохраняет файл в указатом в объекте OutputBucket Amazon S3-бакете в конвейере, указанном ID конвейера.

ThumbnailPattern -> (строка)

Указывает, хотите ли вы, чтобы Elastic Transcoder создавал миниатюры для ваших видео и, если да, как вы хотите, чтобы Elastic Transcoder называл эти файлы.

Если вы не хотите, чтобы Elastic Transcoder создавал миниатюры, укажите “”.

Если вы хотите, чтобы Elastic Transcoder создавал миниатюры, укажите информацию, которую вы хотите включить в имя файла для каждой миниатюры. Вы можете указать следующие значения в любом порядке:

``{count}`` (Обязательно) : Если вы хотите создать миниатюры, вы должны включить {count} в объект ThumbnailPattern. В любом месте, где вы укажете {count} , Elastic Transcoder добавит пятизначный порядковый номер (начинающийся с 00001 ) в имена файлов миниатюр. Число указывает, где определённая миниатюра появляется в последовательности миниатюр для преобразованного файла.

Предупреждение

Если вы укажете литеральное значение и/или {resolution}, но пропустите {count}, Elastic Transcoder вернёт ошибку валидации и не создаст задание.

Литеральные значения (Необязательно) : Вы можете указать литеральные значения в любом месте объекта ThumbnailPattern. Например, вы можете включить их в качестве префикса имени файла или разделителя между {resolution} и {count}.
``{resolution}`` (Необязательно) : Если вы хотите, чтобы Elastic Transcoder включал разрешение в имя файла, включите {resolution} в объект ThumbnailPattern.

При создании миниатюр Elastic Transcoder автоматически сохраняет файлы в формате (.jpg или .png), который появляется в пресете, указанном в значении PresetID объекта CreateJobOutput. Elastic Transcoder также добавляет соответствующее расширение имени файла.

ThumbnailEncryption -> (структура)

Настройки шифрования (если таковые имеются), которые вы хотите, чтобы Elastic Transcoder применял к вашей миниатюре.

Mode -> (строка)

Конкретный режим шифрования на стороне сервера, который вы хотите использовать для дешифрования входных файлов или шифрования выходных файлов. Elastic Transcoder поддерживает следующие варианты:

s3: Amazon S3 создаёт и управляет ключами, используемыми для шифрования ваших файлов.
s3-aws-kms: Amazon S3 вызывает Amazon Key Management Service, который создаёт и управляет ключами, используемыми для шифрования ваших файлов. Если вы укажете s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить используемый AWS-KMS ключ в свой конвейер.
aes-cbc-pkcs7: Режим шифрования блоков с заполнением, изначально использовавшийся для файлов HLS.
aes-ctr: AES Counter Mode.
aes-gcm: AES Galois Counter Mode, режим, представляющий собой аутентифицированный формат шифрования, означающий, что файл, ключ или вектор инициализации, подвергшиеся несанкционированному изменению, не проходят процесс дешифрования.

Для всех трёх режимов AES вам необходимо предоставить следующие параметры, которые должны быть закодированы в base64:

Ключ
MD5 ключа
Вектор инициализации

Предупреждение

Для режимов AES ваши ключи шифрования и ваши нешифрованные данные никогда не хранятся AWS; поэтому важно безопасно управлять своими ключами шифрования. Если вы их потеряете, вы не сможете расшифровать свои данные.

Key -> (строка)

Ключ шифрования данных, который вы хотите использовать для шифрования выходного файла или который использовался для шифрования входного файла. Ключ должен быть закодирован в base64 и должен иметь один из следующих битовых размеров перед кодированием в base64:

128, 192 или 256.

Ключ также должен быть зашифрован с использованием Amazon Key Management Service.

KeyMd5 -> (строка)

MD5-хеш ключа, который вы использовали для шифрования входного файла или который вы хотите использовать для шифрования выходного файла. Elastic Transcoder использует хеш ключа в качестве контрольной суммы, чтобы убедиться, что ваш ключ не был повреждён во время передачи. MD5 ключа должен быть закодирован в base64 и должен иметь точно 16 байт перед кодированием в base64.

InitializationVector -> (строка)

Последовательность случайных бит, созданная генератором случайных чисел, уникальная для каждой операции шифрования, которую вы использовали для шифрования входных файлов или которую вы хотите использовать для шифрования выходных файлов. Вектор инициализации должен быть закодирован в base64 и должен иметь точно 16 байт перед кодированием в base64.

Rotate -> (строка)

Количество градусов по часовой стрелке, на которое вы хотите, чтобы Elastic Transcoder повернул вывод относительно входа. Введите одно из следующих значений:

auto, 0, 90, 180, 270

Значение auto, как правило, работает только если файл, который вы преобразуете, содержит метаданные о повороте.

PresetId -> (строка)

Значение объекта Id для пресета, который вы хотите использовать для этого задания. Пресет определяет настройки аудио, видео и миниатюр, которые Elastic Transcoder использует для преобразования. Чтобы использовать пресет, который вы создали, укажите идентификатор пресета, возвращённый Elastic Transcoder в ответе при создании пресета. Вы также можете использовать системные пресеты Elastic Transcoder, которые можно получить с помощью ListPresets.

SegmentDuration -> (строка)

Предупреждение

(Вызовы только в формате Fragmented MP4 или MPEG-TS.)

Если вы указываете пресет в PresetId, для которого значение Container равно fmp4 (Fragmented MP4) или ts (MPEG-TS), SegmentDuration является максимальной длительностью каждого сегмента в секундах. Для плейлистов формата HLSv3 каждый сегмент медиа сохраняется в отдельном файле .ts. Для плейлистов HLSv4, MPEG-DASH и Smooth все сегменты медиа для вывода сохраняются в одном файле. Каждый сегмент приблизительно равен длительности SegmentDuration, хотя отдельные сегменты могут быть короче или длиннее.

Диапазон допустимых значений от 1 до 60 секунд. Если длительность видео не делится на SegmentDuration без остатка, длительность последнего сегмента является остатком от деления общей длительности на SegmentDuration.

Elastic Transcoder создаёт плейлист, специфичный для каждого вывода HLS, который вы указываете в OutputKeys. Чтобы добавить вывод в основной плейлист для этого задания, включите его в OutputKeys соответствующего плейлиста.

Status -> (строка)

Статус одного вывода в задании. Если вы указали только один вывод для задания, Outputs:Status всегда совпадает с Job:Status. Если вы указали более одного вывода:

Job:Status и Outputs:Status для всех выводов имеют значение Submitted, пока Elastic Transcoder не начнёт обрабатывать первый вывод.
Когда Elastic Transcoder начинает обрабатывать первый вывод, Outputs:Status для этого вывода и Job:Status изменяются на Progressing. Для каждого вывода значение Outputs:Status остаётся Submitted до тех пор, пока Elastic Transcoder не начнёт обрабатывать вывод.
Статус задания остаётся Progressing, пока все выводы не достигнут конечного статуса, либо Complete, либо Error.
Когда все выводы достигнут конечного статуса, Job:Status изменяется на Complete только если Outputs:Status для всех выводов равно Complete. Если Outputs:Status для одного или нескольких выводов равно Error, конечный статус для Job:Status также будет Error.

Значение Status может быть одним из следующих: Submitted, Progressing, Complete, Canceled или Error.

StatusDetail -> (строка)

Дополнительная информация, поясняющая Status.

Duration -> (целое число)

Длительность выходного файла в секундах.

Width -> (целое число)

Указывает ширину выходного файла в пикселях.

Height -> (целое число)

Высота выходного файла в пикселях.

FrameRate -> (строка)

Частота кадров выходного файла в кадрах в секунду.

FileSize -> (целое число)

Размер выходного файла в байтах.

DurationMillis -> (целое число)

Длительность выходного файла в миллисекундах.

Watermarks -> (список)

Информация о водяных знаках, которые вы хотите, чтобы Elastic Transcoder добавлял к видео во время транскодирования. Вы можете указать до четырех водяных знаков для каждого вывода. Настройки каждого водяного знака должны быть определены в предустановке, которую вы указываете в Preset для текущего вывода.

Водяные знаки добавляются к выходному видео в том порядке, в котором вы их перечисляете в выходных данных задания — первый водяной знак в списке добавляется к выходному видео первым, второй водяной знак в списке добавляется следующим и так далее. В результате, если настройки в предустановке заставят Elastic Transcoder разместить все водяные знаки в одном месте, второй водяной знак, который вы добавляете, перекроет первый, третий — второй, а четвертый — третий.

(структура)

Водяные знаки могут быть в формате .png или .jpg. Если вы хотите отобразить водяной знак, который не является прямоугольным, используйте формат .png, который поддерживает прозрачность.

PresetWatermarkId -> (строка)

Идентификатор настроек водяных знаков, которые Elastic Transcoder использует для добавления водяных знаков к видео во время транскодирования. Настройки находятся в предустановке, указанной в Preset для текущего вывода. В этой предустановке значение Watermarks Id сообщает Elastic Transcoder, какие настройки использовать.

InputKey -> (строка)

Имя файла .png или .jpg, который вы хотите использовать для водяного знака. Чтобы определить, в каком ведре Amazon S3 находится указанный файл, Elastic Transcoder проверяет конвейер, указанный в Pipeline; объект Input Bucket в этом конвейере определяет ведро.

Если имя файла включает префикс, например, logos/128x64.png , включите префикс в ключ. Если файл не находится в указанном ведре, Elastic Transcoder возвращает ошибку.

Encryption -> (структура)

Настройки шифрования, если таковые имеются, которые вы хотите, чтобы Elastic Transcoder применял к вашим водяным знакам.

Mode -> (строка)

Конкретный режим шифрования на стороне сервера, который вы хотите, чтобы Elastic Transcoder использовал при дешифровании входных файлов или шифровании выходных файлов. Elastic Transcoder поддерживает следующие варианты:

s3: Amazon S3 создает и управляет ключами, используемыми для шифрования ваших файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, которая создает и управляет ключами, используемыми для шифрования ваших файлов. Если вы указываете s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить используемый вами ключ AWS-KMS в свой конвейер.
aes-cbc-pkcs7: Заполненный режим шифрования блоков, первоначально использовавшийся для файлов HLS.
aes-ctr: Режим AES Counter.
aes-gcm: Режим AES Galois Counter, режим, представляющий собой аутентифицированный формат шифрования, что означает, что файл, ключ или начальный вектор, в которых произошли изменения, не проходят процесс дешифрования.

Для всех трех вариантов AES вам необходимо предоставить следующие настройки, которые должны быть закодированы в base64:

Ключ
MD5 ключа
Начальный вектор

Предупреждение

Для режимов AES ваши закрытые ключи шифрования и ваши нешифрованные данные никогда не хранятся в AWS; поэтому важно безопасно управлять своими ключами шифрования. Если вы их потеряете, вы не сможете расшифровать свои данные.

Key -> (строка)

Ключ шифрования данных, который вы хотите, чтобы Elastic Transcoder использовал для шифрования выходного файла или который использовался для шифрования входного файла. Ключ должен быть закодирован в base64 и должен иметь один из следующих размеров в битах до кодирования в base64:

128 , 192 , или 256 .

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

MD5-хеш ключа, который вы использовали для шифрования входного файла или который вы хотите, чтобы Elastic Transcoder использовал для шифрования выходного файла. Elastic Transcoder использует хеш ключа как контрольную сумму, чтобы убедиться, что ваш ключ не был поврежден при передаче. MD5 ключа должен быть закодирован в base64 и должен иметь длину ровно 16 байт до кодирования в base64.

InitializationVector -> (строка)

Последовательность случайных бит, созданных генератором случайных бит, уникальных для каждой операции шифрования, которые вы использовали для шифрования входных файлов или которые вы хотите, чтобы Elastic Transcoder использовал для шифрования выходных файлов. Начальный вектор должен быть закодирован в base64 и должен иметь длину ровно 16 байт до кодирования в base64.

AlbumArt -> (структура)

Изображение обложки альбома, которое должно быть связано с выходным файлом, если таковое имеется.

MergePolicy -> (строка)

Политика, определяющая, как Elastic Transcoder обрабатывает наличие нескольких файлов с изображениями обложки альбома.

Replace: Указанное изображение обложки заменяет любое существующее изображение обложки.
Prepend: Указанное изображение обложки размещается перед любым существующим изображением обложки.
Append: Указанное изображение обложки размещается после любого существующего изображения обложки.
Fallback: Если исходный входной файл содержит изображение обложки, Elastic Transcoder использует это изображение для выходного файла. Если исходный входной файл не содержит изображения обложки, Elastic Transcoder использует указанный файл изображения обложки.

Artwork -> (список)

Файл, используемый в качестве изображения обложки альбома. Может быть несколько изображений обложки, связанных с аудиофайлом, не более 20. Допустимые форматы — .jpg и .png

(структура)

Файл, используемый в качестве изображения обложки альбома. Может быть несколько изображений обложки, связанных с аудиофайлом, не более 20.

Чтобы удалить изображение обложки или оставить его пустым, можно установить Artwork в значение null или установить Merge Policy в «Заменить» и использовать пустой массив Artwork.

Чтобы сохранить существующее изображение обложки без изменений, установите Merge Policy в «Префикс», «Добавить» или «Падение» и используйте пустой массив Artwork.

InputKey -> (строка)

Имя файла, используемого в качестве изображения обложки альбома. Чтобы определить, в каком ведре Amazon S3 содержится указанный файл, Elastic Transcoder проверяет конвейер, указанный в PipelineId ; объект InputBucket в этом конвейере идентифицирует ведро.

Если имя файла содержит префикс, например, cooking/pie.jpg , включите префикс в ключ. Если файл не находится в указанном ведре, Elastic Transcoder возвращает ошибку.

MaxWidth -> (строка)

Максимальная ширина выходного изображения обложки в пикселях. Если вы укажете auto, Elastic Transcoder использует значение по умолчанию 600. Если вы укажете числовое значение, введите четное целое число от 32 до 4096 включительно.

MaxHeight -> (строка)

Максимальная высота выходного изображения обложки в пикселях. Если вы укажете auto, Elastic Transcoder использует значение по умолчанию 600. Если вы укажете числовое значение, введите четное целое число от 32 до 3072 включительно.

SizingPolicy -> (строка)

Укажите одно из следующих значений для управления масштабированием выходного изображения обложки:

Fit: Elastic Transcoder масштабирует выходное изображение так, чтобы оно соответствовало значению, указанному в MaxWidth или MaxHeight, не превышая при этом другое значение.
Fill: Elastic Transcoder масштабирует выходное изображение так, чтобы оно соответствовало значению, указанному в MaxWidth или MaxHeight, и соответствовало или превышало другое значение. Elastic Transcoder центрирует выходное изображение и затем обрезает его в измерении (если таковое имеется), которое превышает максимальное значение.
Stretch: Elastic Transcoder растягивает выходное изображение так, чтобы оно соответствовало значениям, указанным для MaxWidth и MaxHeight. Если относительные пропорции входного и выходного изображений отличаются, выходное изображение будет искажено.
Keep: Elastic Transcoder не масштабирует выходное изображение. Если любое измерение входного изображения превышает значения, указанные для MaxWidth и MaxHeight, Elastic Transcoder обрезает выходное изображение.
ShrinkToFit: Elastic Transcoder уменьшает масштаб выходного изображения так, чтобы его размеры соответствовали значениям, указанным для хотя бы одного из MaxWidth и MaxHeight, не превышая ни одно из значений. Если вы выберите этот параметр, Elastic Transcoder не увеличивает масштаб изображения.
ShrinkToFill Elastic Transcoder уменьшает масштаб выходного изображения так, чтобы его размеры соответствовали значениям, указанным для хотя бы одного из MaxWidth и MaxHeight, не опускаясь ниже ни одного значения. Если вы выберите этот параметр, Elastic Transcoder не увеличивает масштаб изображения.

PaddingPolicy -> (строка)

Когда вы устанавливаете PaddingPolicy в значение Pad, Elastic Transcoder может добавить белые полосы к верхней и нижней и/или левой и правой сторонам выходного изображения обложки, чтобы общий размер выходного изображения соответствовал значениям, указанным для MaxWidth и MaxHeight.

AlbumArtFormat -> (строка)

Формат изображения обложки, если таковое имеется. Допустимые форматы — .jpg и .png.

Encryption -> (структура)

Параметры шифрования, если таковые имеются, которые вы хотите применить к изображению обложки с помощью Elastic Transcoder.

Mode -> (строка)

Конкретный режим шифрования на стороне сервера, который вы хотите использовать в Elastic Transcoder при расшифровке входных файлов или шифровании выходных файлов. Elastic Transcoder поддерживает следующие варианты:

s3: Amazon S3 создает и управляет ключами, используемыми для шифрования файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, который создает и управляет ключами, используемыми для шифрования файлов. Если вы указали s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить требуемый ключ AWS-KMS в свой конвейер.
aes-cbc-pkcs7: Режим шифрования блоков с заливкой, первоначально используемый для файлов HLS.
aes-ctr: AES Counter Mode.
aes-gcm: AES Galois Counter Mode, режим шифрования, представляющий собой аутентифицированный формат шифрования, то есть файл, ключ или вектор инициализации, подвергшиеся изменениям, не проходят процесс расшифровки.

Для всех трех вариантов AES необходимо указать следующие параметры, которые должны быть закодированы в base64:

Ключ
MD5 ключа
Вектор инициализации

Предупреждение

Для режимов AES ваши закрытые ключи шифрования и ваши нешифрованные данные никогда не хранятся в AWS; поэтому важно безопасно управлять вашими ключами шифрования. Если вы их потеряете, вы не сможете расшифровать свои данные.

Key -> (строка)

Ключ шифрования данных, который вы хотите использовать в Elastic Transcoder для шифрования выходного файла или который использовался для шифрования входного файла. Ключ должен быть закодирован в base64 и должен иметь один из следующих размеров в битах перед кодированием в base64:

128 , 192 или 256 .

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

MD5-хеш ключа, который вы использовали для шифрования входного файла или который вы хотите использовать в Elastic Transcoder для шифрования выходного файла. Elastic Transcoder использует хеш ключа как контрольную сумму, чтобы убедиться, что ваш ключ не был поврежден во время передачи. MD5-хеш ключа должен быть закодирован в base64 и должен иметь ровно 16 байт длины до кодирования в base64.

InitializationVector -> (строка)

Последовательность случайных битов, созданных генератором случайных чисел, уникальная для каждой операции шифрования, которую вы использовали для шифрования входных файлов или которую вы хотите использовать в Elastic Transcoder для шифрования выходных файлов. Вектор инициализации должен быть закодирован в base64 и должен иметь ровно 16 байт длины до кодирования в base64.

Composition -> (список)

Вы можете создать выходной файл, содержащий фрагмент из входного файла. Этот фрагмент, называемый клипом, может быть из начала, середины или конца файла. Объект Composition содержит настройки для клипов, составляющих выходной файл. В текущей версии вы можете указать настройки только для одного клипа на выходной файл. Объект Composition не может быть null.

(структура)

Настройки одного клипа в композиции. Все задания в списке воспроизведения должны иметь одинаковые настройки клипов.

TimeSpan -> (структура)

Настройки, определяющие, когда начинается клип и как долго он длится.

StartTime -> (строка)

Место в входном файле, где вы хотите начать клип. Формат может быть либо HH:mm:ss.SSS (максимальное значение: 23:59:59.999; SSS — тысячные доли секунды), либо sssss.SSS (максимальное значение: 86399.999). Если вы не укажете значение, Elastic Transcoder начнёт с начала входного файла.

Duration -> (строка)

Продолжительность клипа. Формат может быть либо HH:mm:ss.SSS (максимальное значение: 23:59:59.999; SSS — тысячные доли секунды), либо sssss.SSS (максимальное значение: 86399.999). Если вы не укажете значение, Elastic Transcoder создаст выходной файл от StartTime до конца файла.

Если вы укажете значение, превышающее длительность входного файла, Elastic Transcoder транскодирует файл и вернет сообщение об ошибке.

Captions -> (структура)

Встроенные: Встроенные субтитры включаются в тот же файл, что и аудио и видео. Elastic Transcoder поддерживает только один встроенный субтитр на язык, максимум 300 встроенных субтитров на файл. Допустимые входные значения включают: CEA-608 (EIA-608 , только первый ненулевой канал), CEA-708 (EIA-708 , только первый ненулевой канал), и mov-text. Допустимые выходные значения включают: mov-text. Elastic Transcoder поддерживает максимум один встроенный формат на выход.
В виде отдельного файла: Субтитры в виде отдельного файла хранятся в отдельном файле метаданных от аудио и видео данных. Для субтитров в виде отдельного файла требуется игрок, который может понимать взаимосвязь между файлом видео и файлом субтитров. Elastic Transcoder поддерживает только один субтитр в виде отдельного файла на язык, максимум 20 субтитров в виде отдельного файла на файл. Допустимые входные значения включают: dfxp (только первый элемент div), ebu-tt , scc , smpt , srt , ttml (только первый элемент div), и webvtt. Допустимые выходные значения включают: dfxp (только первый элемент div), scc , srt , и webvtt.

Если вам нужны субтитры в формате ttml или smpte-tt, укажите dfxp в качестве выходного формата.

Чтобы удалить субтитры или оставить их пустыми, установите Captions в значение null. Чтобы не изменять существующие субтитры, установите MergePolicy в MergeRetain и передайте массив CaptionSources со значением null.

Дополнительную информацию об встроенных файлах см. на странице Википедии о субтитрах.

Дополнительную информацию о файлах в виде отдельного файла см. на страницах Википедии о расширяемой платформе метаданных и файлах в виде отдельного файла.

MergePolicy -> (строка)

Политика, определяющая, как Elastic Transcoder обрабатывает наличие нескольких субтитров.

MergeOverride: Elastic Transcoder транскодирует как встроенные, так и субтитры в виде отдельного файла в выходные данные. Если субтитры на языке встроены в входной файл и также присутствуют в файле субтитров в виде отдельного файла, Elastic Transcoder использует субтитры в виде отдельного файла и игнорирует встроенные субтитры для данного языка.
MergeRetain: Elastic Transcoder транскодирует как встроенные, так и субтитры в виде отдельного файла в выходные данные. Если субтитры на языке встроены в входной файл и также присутствуют в файле субтитров в виде отдельного файла, Elastic Transcoder использует встроенные субтитры и игнорирует субтитры в виде отдельного файла для данного языка. Если CaptionSources пусто, Elastic Transcoder опускает все субтитры в виде отдельного файла из выходных файлов.
Override: Elastic Transcoder транскодирует только субтитры в виде отдельного файла, указанные в CaptionSources.

MergePolicy не может быть null.

CaptionSources -> (список)

Исходные файлы для входных субтитров в виде отдельного файла, используемые во время процесса транскодирования. Чтобы опустить все субтитры в виде отдельного файла, оставьте CaptionSources пустым.

(структура)

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

Key -> (строка)

Название файла субтитров в виде отдельного файла, который вы хотите, чтобы Elastic Transcoder включил в выходной файл.

Language -> (строка)

Строка, которая определяет язык субтитров. Если вы указали несколько входных данных с субтитрами, язык субтитров должен совпадать, чтобы быть включенным в выходные данные. Укажите один из:

2-символьный код ISO 639-1
3-символьный код ISO 639-2

Дополнительную информацию о кодах языков ISO и названиях языков см. в списке кодов ISO 639-1.

TimeOffset -> (строка)

Для генерации фрагментов или субтитров, которые не начинаются одновременно с связанным файлом видео, TimeOffset сообщает Elastic Transcoder, сколько видео нужно закодировать до включения субтитров.

Укажите TimeOffset в формате [+-]SS.sss или [+-]HH:mm:SS.ss.

Label -> (строка)

Метка субтитров, отображаемая в плеере при выборе языка. Мы рекомендуем поместить здесь название языка субтитров на языке самих субтитров.

Encryption -> (структура)

Настройки шифрования, если таковые имеются, которые Elastic Transcoder должен использовать для дешифровки ваших исходных файлов субтитров или которые вы хотите, чтобы Elastic Transcoder применил к вашим исходным файлам субтитров.

Mode -> (строка)

Конкретный режим шифрования на стороне сервера, который вы хотите использовать Elastic Transcoder при дешифровке входных файлов или шифровании выходных файлов. Elastic Transcoder поддерживает следующие варианты:

s3: Amazon S3 создает и управляет ключами, используемыми для шифрования ваших файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, который создает и управляет ключами, используемыми для шифрования ваших файлов. Если вы указали s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить нужный AWS-KMS ключ в свой конвейер.
aes-cbc-pkcs7: Заполненная шифрованная блочная операция, первоначально используемая для файлов HLS.
aes-ctr: Режим подсчета AES.
aes-gcm: Режим подсчета AES Galois, режим работы, являющийся аутентифицированным форматом шифрования, что означает, что файл, ключ или вектор инициализации, который был изменён, не пройдёт процесс дешифровки.

Для всех трёх вариантов AES вы должны предоставить следующие настройки, которые должны быть закодированы в base64:

Ключ
MD5 ключа
Вектор инициализации

Предупреждение

Для режимов AES ваши закрытые ключи шифрования и ваши нешифрованные данные никогда не хранятся AWS; поэтому важно безопасно управлять своими ключами шифрования. Если вы их потеряете, вы не сможете дешифровать свои данные.

Key -> (строка)

Ключ шифрования данных, который вы хотите использовать Elastic Transcoder для шифрования выходного файла или который использовался для шифрования входного файла. Ключ должен быть закодирован в base64 и должен иметь один из следующих разрядов до кодирования в base64:

128 , 192 или 256.

Ключ также должен быть зашифрован с использованием Amazon Key Management Service.

KeyMd5 -> (строка)

MD5 дайджест ключа, который вы использовали для шифрования входного файла или который вы хотите, чтобы Elastic Transcoder использовал для шифрования выходного файла. Elastic Transcoder использует дайджест ключа в качестве контрольной суммы, чтобы убедиться, что ваш ключ не был повреждён при передаче. Key MD5 должен быть закодирован в base64 и должен иметь ровно 16 байт до кодирования в base64.

InitializationVector -> (строка)

Последовательность случайных битов, созданных генератором случайных битов, уникальная для каждой операции шифрования, которую вы использовали для шифрования входных файлов или которую вы хотите, чтобы Elastic Transcoder использовал для шифрования выходных файлов. Вектор инициализации должен быть закодирован в base64 и должен иметь ровно 16 байт до кодирования в base64.

CaptionFormats -> (список)

Массив форматов файлов для выходных субтитров. Если вы оставите это значение пустым, Elastic Transcoder вернёт ошибку.

(структура)

Формат выходных субтитров. Если вы оставите это значение пустым, Elastic Transcoder вернёт ошибку.

Формат -> (строка)

Указанный вами формат определяет, создаст ли Elastic Transcoder встроенные или отдельные субтитры для данного вывода.

Допустимые встроенные форматы субтитров:
- для FLAC : Нет
- для MP3 : Нет
- для MP4 : mov-text
- для MPEG-TS : Нет
- для ogg : Нет
- для webm : Нет
Допустимые форматы отдельных субтитров: Elastic Transcoder поддерживает dfxp (только первый элемент div), scc, srt и webvtt. Если вы хотите субтитры в формате ttml или smpte-tt, укажите dfxp в качестве выходного формата.
- для FMP4 : dfxp
- Выходы, отличные от FMP4 : Все типы отдельных субтитров

fmp4 субтитры имеют расширение .ismt

Шаблон -> (строка)

Префикс для имён файлов субтитров в формате описание -{language} , где:

описание — описание видео.
{language} — буквальное значение, которое Elastic Transcoder заменяет двух- или трёхбуквенным кодом языка субтитров в именах выходных файлов.

Если вы не включите {language} в шаблон имени файла, Elastic Transcoder автоматически добавит «{language} » к значению, которое вы указали для описания. Кроме того, Elastic Transcoder автоматически добавляет счётчик в конце файлов сегментов.

Например, предположим, что вы транскодируете в формате srt. При вводе «Sydney-{язык}-sunrise» и языке субтитров английский (en), имя первого файла субтитров будет Sydney-en-sunrise00000.srt.

Шифрование -> (структура)

Настройки шифрования, если таковые имеются, которые вы хотите применить к форматам субтитров.

Режим -> (строка)

s3: Amazon S3 создаёт и управляет ключами, используемыми для шифрования ваших файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, который создаёт и управляет ключами, используемыми для шифрования ваших файлов. Если вы указали s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить необходимый ключ AWS-KMS в свою конвейерную линию.
aes-cbc-pkcs7: Режим шифрования с блоками и добавленными блоками, изначально использовавшийся для файлов HLS.
aes-ctr: Режим AES Counter Mode.
aes-gcm: Режим AES Galois Counter Mode, режим аутентифицированного шифрования, означающий, что файл, ключ или начальный вектор, подвергшиеся изменениям, не пройдут процесс расшифровки.

Для всех трёх вариантов AES вам необходимо указать следующие настройки, которые должны быть закодированы в base64:

Ключ
MD5 ключа
Начальный вектор

Предупреждение

Для режимов AES ваши личные ключи шифрования и ваши нешифрованные данные никогда не хранятся AWS; поэтому важно безопасно управлять вашими ключами шифрования. Если вы их потеряете, вы не сможете расшифровать свои данные.

Ключ -> (строка)

Ключ шифрования данных, который вы хотите использовать Elastic Transcoder для шифрования выходного файла, или который использовался для шифрования входного файла. Ключ должен быть закодирован в base64 и иметь один из следующих битовых размеров перед кодированием в base64:

128 , 192 , или 256 .

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

MD5-хеш ключа, который вы использовали для шифрования входного файла, или который вы хотите использовать Elastic Transcoder для шифрования выходного файла. Elastic Transcoder использует хеш ключа в качестве контрольной суммы, чтобы убедиться, что ваш ключ не был повреждён во время передачи. MD5 ключа должен быть закодирован в base64 и иметь ровно 16 байт перед кодированием в base64.

InitializationVector -> (строка)

Последовательность случайных битов, сгенерированная генератором случайных битов, уникальная для каждой операции шифрования, которую вы использовали для шифрования входных файлов или которую вы хотите использовать Elastic Transcoder для шифрования выходных файлов. Начальный вектор должен быть закодирован в base64 и иметь ровно 16 байт перед кодированием в base64.

Шифрование -> (структура)

Настройки шифрования, если таковые имеются, которые вы хотите применить к выходным файлам. Если вы выбираете использование шифрования, вам необходимо указать используемый режим. Если вы не хотите использовать шифрование, Elastic Transcoder запишет нешифрованный файл в ваш Amazon S3-ковёш.

Режим -> (строка)

s3: Amazon S3 создаёт и управляет ключами, используемыми для шифрования ваших файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, который создаёт и управляет ключами, используемыми для шифрования ваших файлов. Если вы указали s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить необходимый ключ AWS-KMS в свою конвейерную линию.
aes-cbc-pkcs7: Режим шифрования с блоками и добавленными блоками, изначально использовавшийся для файлов HLS.
aes-ctr: Режим AES Counter Mode.
aes-gcm: Режим AES Galois Counter Mode, режим аутентифицированного шифрования, означающий, что файл, ключ или начальный вектор, подвергшиеся изменениям, не пройдут процесс расшифровки.

Ключ
MD5 ключа
Начальный вектор

Предупреждение

Ключ -> (строка)

128 , 192 , или 256 .

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

InitializationVector -> (строка)

AppliedColorSpaceConversion -> (строка)

Если Elastic Transcoder использовал предустановку с ColorSpaceConversionMode для транскодирования выходного файла, параметр AppliedColorSpaceConversion показывает использованное преобразование. Если в предустановке не было определено ColorSpaceConversionMode , этот параметр не будет включён в ответ на задание.

Outputs -> (список)

Информация об выходных файлах. Мы рекомендуем использовать синтаксис Outputs для всех задач, даже если вы хотите, чтобы Elastic Transcoder транскодировал файл только в один формат. Не используйте одновременно синтаксисы Outputs и Output в одном запросе. Вы можете создать не более 30 выходов на задачу.

Если вы указываете более одного выхода для задачи, Elastic Transcoder создаёт файлы для каждого выхода в том порядке, в котором вы их указали в задаче.

(структура)

Предупреждение

Рекомендуются выходы.

Если вы указали один выход для задачи, информация об этом выходе. Если вы указали несколько выходов для задачи, объект Output перечисляет информацию о первом выходе. Это дублирует информацию, перечисленную для первого выхода в объекте Outputs.

Id -> (строка)

Последовательный счётчик, начиная с 1, который идентифицирует выход среди выходов текущей задачи. В синтаксисе вывода это значение всегда равно 1.

Key -> (строка)

Имя, которое нужно присвоить транскодированному файлу. Elastic Transcoder сохраняет файл в ведре Amazon S3, указанном объектом OutputBucket в конвейере, который указан идентификатором конвейера.

ThumbnailPattern -> (строка)

Нужно ли Elastic Transcoder создавать миниатюры для ваших видео и, если да, как вы хотите, чтобы Elastic Transcoder называл файлы.

Если вы не хотите, чтобы Elastic Transcoder создавал миниатюры, укажите “”.

``{count}`` (Обязательно) : Если вы хотите создать миниатюры, вы должны включить {count} в объект ThumbnailPattern. В любом месте, где вы указываете {count}, Elastic Transcoder добавляет пятизначный порядковый номер (начиная с 00001) к именам файлов миниатюр. Число указывает, где данная миниатюра появляется в последовательности миниатюр для транскодированного файла.

Предупреждение

Если вы указываете литеральное значение и/или {resolution}, но пропускаете {count}, Elastic Transcoder возвращает ошибку валидации и не создаёт задачу.

Литеральные значения (Необязательно) : Вы можете указать литеральные значения в любом месте объекта ThumbnailPattern. Например, вы можете включить их в качестве префикса имени файла или разделителя между {resolution} и {count}.
``{resolution}`` (Необязательно) : Если вы хотите, чтобы Elastic Transcoder включал разрешение в имя файла, включите {resolution} в объект ThumbnailPattern.

При создании миниатюр Elastic Transcoder автоматически сохраняет файлы в формате (.jpg или .png), который появляется в предустановке, которую вы указали в значении PresetID объекта CreateJobOutput. Elastic Transcoder также добавляет соответствующее расширение имени файла.

ThumbnailEncryption -> (структура)

Настройки шифрования, если таковые имеются, которые вы хотите, чтобы Elastic Transcoder применял к вашей миниатюре.

Mode -> (строка)

s3: Amazon S3 создаёт и управляет ключами, используемыми для шифрования ваших файлов.
s3-aws-kms: Amazon S3 вызывает Amazon Key Management Service, который создаёт и управляет ключами, используемыми для шифрования ваших файлов. Если вы указываете s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить ключ AWS-KMS, который вы хотите использовать, в свой конвейер.
aes-cbc-pkcs7: Паддинг шифрования блочного режима, первоначально использовавшийся для файлов HLS.
aes-ctr: Режим AES Counter.
aes-gcm: Режим AES Galois Counter, режим работы, представляющий собой аутентифицированный формат шифрования, означающий, что файл, ключ или вектор инициализации, которые были изменены, не проходят процесс дешифрования.

Для всех трёх вариантов AES вам необходимо указать следующие параметры, которые должны быть закодированы в base64:

Ключ
MD5 ключа
Вектор инициализации

Предупреждение

Key -> (строка)

Ключ шифрования данных, который вы хотите, чтобы Elastic Transcoder использовал для шифрования выходного файла или который использовался для шифрования входного файла. Ключ должен быть закодирован в base64, и он должен иметь один из следующих размеров в битах перед кодированием в base64:

128 , 192 , или 256 .

Ключ также должен быть зашифрован с использованием Amazon Key Management Service.

KeyMd5 -> (строка)

MD5-хеш ключа, который вы использовали для шифрования входного файла или который вы хотите, чтобы Elastic Transcoder использовал для шифрования выходного файла. Elastic Transcoder использует хеш ключа в качестве контрольной суммы, чтобы убедиться, что ваш ключ не был повреждён при передаче. MD5 ключа должен быть закодирован в base64 и иметь длину ровно 16 байт перед кодированием в base64.

InitializationVector -> (строка)

Последовательность случайных битов, созданных генератором случайных чисел, уникальная для каждой операции шифрования, которую вы использовали для шифрования входных файлов или которую вы хотите, чтобы Elastic Transcoder использовал для шифрования выходных файлов. Вектор инициализации должен быть закодирован в base64, и он должен иметь длину ровно 16 байт перед кодированием в base64.

Rotate -> (строка)

Количество градусов по часовой стрелке, на которое вы хотите, чтобы Elastic Transcoder повернул выходной результат относительно входного. Введите одно из следующих значений:

auto , 0 , 90 , 180 , 270

Значение auto обычно работает только в том случае, если файл, который вы транскодируете, содержит метаданные о повороте.

PresetId -> (строка)

Значение объекта Id для предустановки, которую вы хотите использовать для этой задачи. Предустановка определяет настройки аудио, видео и миниатюр, которые Elastic Transcoder использует для транскодирования. Чтобы использовать предустановку, которую вы создали, укажите идентификатор предустановки, который Elastic Transcoder вернул в ответе при создании предустановки. Вы также можете использовать системные предустановки Elastic Transcoder, которые можно получить с помощью ListPresets.

SegmentDuration -> (строка)

Предупреждение

(Только выходы в формате Fragmented MP4 или MPEG-TS)

Если вы указываете предустановку в PresetId, для которой значение Container равно fmp4 (Fragmented MP4) или ts (MPEG-TS), SegmentDuration является целевым максимальным временем каждого сегмента во секундах. Для плейлистов формата HLSv3 каждый сегмент медиа хранится в отдельном файле .ts. Для плейлистов HLSv4, MPEG-DASH и Smooth все сегменты медиа для выхода хранятся в одном файле. Каждый сегмент примерно длится SegmentDuration, хотя отдельные сегменты могут быть короче или длиннее.

Диапазон допустимых значений от 1 до 60 секунд. Если продолжительность видео не делится нацело на SegmentDuration, продолжительность последнего сегмента — остаток от деления общей длины на SegmentDuration.

Elastic Transcoder создаёт выходной плейлист для каждого выхода HLS, который вы указываете в OutputKeys. Чтобы добавить выход в мастер-плейлист для этой задачи, включите его в OutputKeys связанного плейлиста.

Status -> (строка)

Состояние одного выхода в задаче. Если вы указали только один выход для задачи, Outputs:Status всегда такое же, как Job:Status. Если вы указали более одного выхода:

Job:Status и Outputs:Status для всех выходов равны Submitted до тех пор, пока Elastic Transcoder не начнёт обрабатывать первый выход.
Когда Elastic Transcoder начинает обрабатывать первый выход, Outputs:Status для этого выхода и Job:Status меняются на Progressing. Для каждого выхода значение Outputs:Status остаётся Submitted до тех пор, пока Elastic Transcoder не начнёт обрабатывать выход.
Статус задачи остаётся Progressing до тех пор, пока все выходы не достигнут конечного статуса, либо Complete, либо Error.
Когда все выходы достигают конечного статуса, Job:Status меняется на Complete только если Outputs:Status для всех выходов равен Complete. Если Outputs:Status для одного или нескольких выходов равен Error, конечный статус для Job:Status также равен Error.

Значение Status — одно из следующих: Submitted, Progressing, Complete, Canceled или Error.

StatusDetail -> (строка)

Дополнительная информация, поясняющая Status.

Duration -> (целое число)

Продолжительность выходного файла в секундах.

Width -> (целое число)

Указывает ширину выходного файла в пикселях.

Height -> (целое число)

Высота выходного файла в пикселях.

FrameRate -> (строка)

Частота кадров выходного файла в кадрах в секунду.

FileSize -> (целое число)

Размер файла выходного файла в байтах.

DurationMillis -> (целое число)

Продолжительность выходного файла в миллисекундах.

Watermarks -> (список)

Водяные знаки добавляются к выходному видео в том порядке, в котором вы их перечисляете в выходе задания — первый водяной знак в списке добавляется к выходному видео первым, второй водяной знак в списке добавляется следующим и так далее. В результате, если настройки в предустановке приводят к тому, что Elastic Transcoder размещает все водяные знаки в одном месте, второй добавленный водяной знак перекрывает первый, третий перекрывает второй, а четвертый перекрывает третий.

(структура)

PresetWatermarkId -> (строка)

Идентификатор настроек водяного знака, которые Elastic Transcoder использует для добавления водяных знаков к видео во время транскодирования. Настройки находятся в предустановке, указанной в Preset для текущего вывода. В этой предустановке значение Watermarks Id сообщает Elastic Transcoder, какие настройки использовать.

InputKey -> (строка)

Имя файла .png или .jpg, который вы хотите использовать в качестве водяного знака. Для определения того, в каком Amazon S3-бакете содержится указанный файл, Elastic Transcoder проверяет конвейер, указанный в Pipeline; объект Input Bucket в этом конвейере определяет бакет.

Если имя файла включает префикс, например, logos/128x64.png, включите префикс в ключе. Если файл не находится в указанном бакете, Elastic Transcoder возвращает ошибку.

Encryption -> (структура)

Mode -> (строка)

Конкретный режим шифрования на стороне сервера, который вы хотите, чтобы Elastic Transcoder использовал при расшифровке входных файлов или шифровании выходных файлов. Elastic Transcoder поддерживает следующие варианты:

s3: Amazon S3 создает и управляет ключами, используемыми для шифрования файлов.
s3-aws-kms: Amazon S3 вызывает Amazon Key Management Service, который создает и управляет ключами, используемыми для шифрования файлов. Если вы указываете s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить используемый AWS-KMS ключ в свой конвейер.
aes-cbc-pkcs7: Режим шифрования блоками с заполнением, изначально использовавшийся для файлов HLS.
aes-ctr: Режим AES Counter.
aes-gcm: AES Galois Counter Mode, режим, представляющий собой аутентифицированный формат шифрования, что означает, что файл, ключ или вектор инициализации, подвергшиеся изменениям, не проходят процесс расшифровки.

Для всех трех вариантов AES необходимо предоставить следующие настройки, которые должны быть закодированы в base64:

Ключ
MD5 ключа
Вектор инициализации

Предупреждение

Для режимов AES ваши частные ключи шифрования и ваши незашифрованные данные никогда не хранятся AWS; поэтому важно безопасно управлять своими ключами шифрования. Если вы их потеряете, вы не сможете расшифровать данные.

Key -> (строка)

Ключ шифрования данных, который вы хотите, чтобы Elastic Transcoder использовал для шифрования выходного файла, или который использовался для шифрования входного файла. Ключ должен быть закодирован в base64 и должен иметь один из следующих битовых размеров перед кодированием в base64:

128 , 192 , или 256 .

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

MD5 дайджест ключа, который вы использовали для шифрования входного файла или который вы хотите, чтобы Elastic Transcoder использовал для шифрования выходного файла. Elastic Transcoder использует дайджест ключа как контрольную сумму, чтобы убедиться, что ваш ключ не был поврежден во время передачи. MD5 ключа должен быть закодирован в base64 и должен иметь ровно 16 байт длины перед кодированием в base64.

InitializationVector -> (строка)

Последовательность случайных битов, созданных генератором случайных битов, уникальных для каждой операции шифрования, которую вы использовали для шифрования входных файлов или которую вы хотите, чтобы Elastic Transcoder использовал для шифрования выходных файлов. Вектор инициализации должен быть закодирован в base64 и должен иметь ровно 16 байт длины перед кодированием в base64.

AlbumArt -> (структура)

Изображение обложки альбома для выходного файла, если необходимо.

MergePolicy -> (строка)

Политика, определяющая, как Elastic Transcoder обрабатывает наличие нескольких файлов изображения обложки альбома.

Replace: Указанное изображение обложки заменяет любое существующее изображение обложки.
Prepend: Указанное изображение обложки помещается перед любым существующим изображением обложки.
Append: Указанное изображение обложки помещается после любого существующего изображения обложки.
Fallback: Если исходный входной файл содержит изображение обложки, Elastic Transcoder использует это изображение для вывода. Если исходный входной файл не содержит изображения обложки, Elastic Transcoder использует указанный файл изображения обложки.

Artwork -> (список)

Файл, используемый в качестве изображения обложки альбома. Может быть несколько изображений обложки, связанных с аудиофайлом, максимум 20. Допустимые форматы — .jpg и .png

(структура)

Файл, используемый в качестве изображения обложки альбома. Может быть несколько изображений обложки, связанных с аудиофайлом, максимум 20.

Чтобы сохранить существующее изображение обложки без изменений, установите Merge Policy в «В начало», «В конец» или «По умолчанию» и используйте пустой массив Artwork.

InputKey -> (строка)

Имя файла, используемого в качестве изображения обложки альбома. Для определения Amazon S3-бакета, содержащего указанный файл, Elastic Transcoder проверяет конвейер, указанный в PipelineId; объект InputBucket в этом конвейере определяет бакет.

Если имя файла содержит префикс, например, cooking/pie.jpg, включите префикс в ключ. Если файл не находится в указанном бакете, Elastic Transcoder возвращает ошибку.

MaxWidth -> (строка)

Максимальная ширина выходного изображения обложки альбома в пикселях. Если вы укажете auto, Elastic Transcoder использует значение по умолчанию 600. Если вы укажете числовое значение, введите четное целое число от 32 до 4096 включительно.

MaxHeight -> (строка)

Максимальная высота выходного изображения обложки альбома в пикселях. Если вы укажете auto, Elastic Transcoder использует значение по умолчанию 600. Если вы укажете числовое значение, введите четное целое число от 32 до 3072 включительно.

SizingPolicy -> (строка)

Укажите одно из следующих значений для управления масштабированием выходного изображения обложки:

Fit: Elastic Transcoder масштабирует выходное изображение так, чтобы оно соответствовало значению, указанному в MaxWidth или MaxHeight, не превышая при этом другое значение.
Fill: Elastic Transcoder масштабирует выходное изображение так, чтобы оно соответствовало значению, указанному в MaxWidth или MaxHeight, и соответствовало или превышало другое значение. Elastic Transcoder центрирует выходное изображение, а затем обрезает его по размеру (если таковой имеется), превышающему максимальное значение.
Stretch: Elastic Transcoder растягивает выходное изображение так, чтобы оно соответствовало значениям, указанным для MaxWidth и MaxHeight. Если относительные пропорции входного и выходного изображений отличаются, выходное изображение будет искажено.
Keep: Elastic Transcoder не масштабирует выходное изображение. Если любой размер входного изображения превышает значения, указанные для MaxWidth и MaxHeight, Elastic Transcoder обрезает выходное изображение.
ShrinkToFit: Elastic Transcoder уменьшает масштаб выходного изображения так, чтобы его размеры соответствовали значениям, указанным для хотя бы одного из MaxWidth и MaxHeight, не превышая ни одно из них. Если вы выберете этот параметр, Elastic Transcoder не увеличивает масштаб изображения.
ShrinkToFill Elastic Transcoder уменьшает масштаб выходного изображения так, чтобы его размеры соответствовали значениям, указанным для хотя бы одного из MaxWidth и MaxHeight, не опускаясь ниже ни одного из них. Если вы выберете этот параметр, Elastic Transcoder не увеличивает масштаб изображения.

PaddingPolicy -> (строка)

Когда вы устанавливаете PaddingPolicy в значение Pad, Elastic Transcoder может добавить белые полосы сверху и снизу и/или слева и справа выходного изображения обложки, чтобы общий размер выходного изображения соответствовал значениям, указанным для MaxWidth и MaxHeight.

AlbumArtFormat -> (строка)

Формат изображения обложки, если необходимо. Допустимые форматы — .jpg и .png.

Encryption -> (структура)

Параметры шифрования, если необходимо, которые вы хотите применить к изображению обложки с помощью Elastic Transcoder.

Mode -> (строка)

s3: Amazon S3 создает и управляет ключами, используемыми для шифрования файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, который создает и управляет ключами, используемыми для шифрования файлов. Если вы указываете s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить используемый AWS-KMS-ключ в свой конвейер.
aes-cbc-pkcs7: Заполненный режим шифрования блоков, изначально использовавшийся для файлов HLS.
aes-ctr: Режим AES Counter.
aes-gcm: Режим AES Galois Counter Mode — режим аутентифицированного шифрования, означающий, что файл, ключ или начальный вектор, которые были изменены, не пройдут процесс расшифровки.

Для всех трех вариантов AES необходимо указать следующие параметры, которые должны быть закодированы в формате base64:

Ключ
MD5 ключа
Начальный вектор

Предупреждение

Для режимов AES ваши приватные ключи шифрования и ваши нешифрованные данные никогда не хранятся в AWS; поэтому важно безопасно управлять вашими ключами шифрования. Если вы их потеряете, вы не сможете расшифровать свои данные.

Key -> (строка)

Ключ шифрования данных, который вы хотите использовать Elastic Transcoder для шифрования выходного файла или который использовался для шифрования входного файла. Ключ должен быть закодирован в формате base64, и его длина в битах должна быть одной из следующих перед кодированием в формате base64:

128 , 192 , или 256.

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

MD5-хеш ключа, который вы использовали для шифрования входного файла или который вы хотите использовать Elastic Transcoder для шифрования выходного файла. Elastic Transcoder использует хеш ключа как контрольную сумму, чтобы убедиться, что ваш ключ не был поврежден во время передачи. MD5 ключа должен быть закодирован в формате base64 и иметь длину ровно 16 байтов перед кодированием в формате base64.

InitializationVector -> (строка)

Последовательность случайных битов, созданных генератором случайных битов, уникальная для каждой операции шифрования, которую вы использовали для шифрования входных файлов или которую вы хотите использовать Elastic Transcoder для шифрования выходных файлов. Начальный вектор должен быть закодирован в формате base64 и иметь длину ровно 16 байтов перед кодированием в формате base64.

Composition -> (список)

Вы можете создать выходной файл, содержащий фрагмент входного файла. Этот фрагмент, называемый клипом, может быть из начала, середины или конца файла. Объект Composition содержит параметры для клипов, составляющих выходной файл. В текущей версии вы можете указать параметры только для одного клипа на один выходной файл. Объект Composition не может быть null.

(структура)

Параметры одного клипа в композиции. Все задания в списке воспроизведения должны иметь одинаковые параметры клипа.

TimeSpan -> (структура)

Параметры, определяющие, когда начинается клип и сколько он длится.

StartTime -> (строка)

Местоположение в входном файле, где вы хотите начать клип. Формат может быть HH:mm:ss.SSS (максимальное значение: 23:59:59.999; SSS — тысячные доли секунды) или sssss.SSS (максимальное значение: 86399.999). Если вы не укажете значение, Elastic Transcoder начнет с начала входного файла.

Duration -> (строка)

Продолжительность клипа. Формат может быть HH:mm:ss.SSS (максимальное значение: 23:59:59.999; SSS — тысячные доли секунды) или sssss.SSS (максимальное значение: 86399.999). Если вы не укажете значение, Elastic Transcoder создаст выходной файл от StartTime до конца файла.

Если вы укажете значение, превышающее продолжительность входного файла, Elastic Transcoder транскодирует файл и вернёт сообщение об ошибке.

Captions -> (структура)

Встроенные: Встроенные субтитры включены в тот же файл, что и аудио и видео. Elastic Transcoder поддерживает только один встроенный субтитр на язык, максимум 300 встроенных субтитров на файл. Допустимые входные значения включают: CEA-608 (EIA-608 , только первый непустой канал), CEA-708 (EIA-708 , только первый непустой канал), и mov-text. Допустимые выходные значения включают: mov-text. Elastic Transcoder поддерживает максимум один встроенный формат на выход.
Внешние: Внешние субтитры хранятся в отдельном файле метаданных от аудио и видеоданных. Внешние субтитры требуют проигрывателя, способного понимать взаимосвязь между файлом видео и файлом внешних субтитров. Elastic Transcoder поддерживает только один внешний субтитр на язык, максимум 20 внешних субтитров на файл. Допустимые входные значения включают: dfxp (только первый элемент div), ebu-tt , scc , smpt , srt , ttml (только первый элемент div), и webvtt. Допустимые выходные значения включают: dfxp (только первый элемент div), scc , srt , и webvtt.

Если вам нужны субтитры в формате ttml или smpte-tt, укажите dfxp в качестве выходного формата.

Elastic Transcoder не поддерживает OCR (оптическое распознавание символов), не принимает изображения в качестве допустимого ввода для субтитров и недоступен для транскодирования только аудио. Elastic Transcoder не сохраняет форматирование текста (например, курсив) во время процесса транскодирования.

Чтобы удалить субтитры или оставить их пустыми, установите Captions в null. Чтобы сохранить существующие субтитры без изменений, установите MergePolicy в MergeRetain и передайте массив CaptionSources со значением null.

Дополнительную информацию об встроенных файлах см. на странице Википедии про субтитры.

Дополнительную информацию о внешних файлах см. на страницах Википедии о платформе расширяемых метаданных и файлах внешних данных.

MergePolicy -> (строка)

Политика, определяющая, как Elastic Transcoder обрабатывает существование нескольких субтитров.

MergeOverride: Elastic Transcoder транскодирует как встроенные, так и внешние субтитры в выходные данные. Если субтитры для языка встроенны в входной файл и также присутствуют во внешнем файле, Elastic Transcoder использует внешние субтитры и игнорирует встроенные субтитры для этого языка.
MergeRetain: Elastic Transcoder транскодирует как встроенные, так и внешние субтитры в выходные данные. Если субтитры для языка встроенны в входной файл и также присутствуют во внешнем файле, Elastic Transcoder использует встроенные субтитры и игнорирует внешние субтитры для этого языка. Если CaptionSources пусто, Elastic Transcoder пропускает все внешние субтитры из выходных файлов.
Override: Elastic Transcoder транскодирует только внешние субтитры, указанные в CaptionSources.

MergePolicy не может быть null.

CaptionSources -> (список)

(структура)

Исходный файл для входных внешних субтитров, используемый во время процесса транскодирования.

Key -> (строка)

Имя файла внешних субтитров, который вы хотите включить Elastic Transcoder в выходной файл.

Language -> (строка)

Строка, определяющая язык субтитров. Если вы указали несколько входных данных с субтитрами, язык субтитров должен совпадать, чтобы они были включены в выходные данные. Укажите один из:

2-символьный код ISO 639-1
3-символьный код ISO 639-2

Дополнительную информацию о кодах ISO языков и названиях языков см. в списке кодов ISO 639-1.

TimeOffset -> (строка)

Для генерации клипов или субтитров, которые не начинаются в то же время, что и связанный файл видео, TimeOffset сообщает Elastic Transcoder, сколько видео следует закодировать до включения субтитров.

Укажите TimeOffset в формате [+-]SS.sss или [+-]HH:mm:SS.ss.

Label -> (строка)

Метка субтитров, отображаемая в проигрывателе при выборе языка. Мы рекомендуем размещать здесь название языка субтитров на языке самих субтитров.

Encryption -> (структура)

Настройки шифрования, если таковые имеются, которые Elastic Transcoder должен использовать для расшифровки ваших исходных данных субтитров или которые вы хотите применить к вашим исходным данным субтитров.

Mode -> (строка)

s3: Amazon S3 создаёт и управляет ключами, используемыми для шифрования файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, который создаёт и управляет ключами, используемыми для шифрования файлов. Если вы указали s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить используемый AWS-KMS ключ в вашу конвейерную линию.
aes-cbc-pkcs7: Заполненный режим шифрования блоков, первоначально использовавшийся для файлов HLS.
aes-ctr: Режим AES Counter.
aes-gcm: Режим AES Galois Counter, режим аутентифицированного шифрования, означающий, что файл, ключ или вектор инициализации, подвергшиеся взлому, не проходят процесс дешифрования.

Для всех трёх вариантов AES вам необходимо предоставить следующие параметры, которые должны быть закодированы в base64:

Ключ
MD5 ключа
Вектор инициализации

Предупреждение

Для режимов AES ваши приватные ключи шифрования и ваши нешифрованные данные никогда не хранятся AWS; поэтому важно безопасно управлять вашими ключами шифрования. Если вы их потеряете, вы не сможете расшифровать свои данные.

Key -> (строка)

Ключ шифрования данных, который вы хотите использовать Elastic Transcoder для шифрования выходного файла или который использовался для шифрования входного файла. Ключ должен быть закодирован в base64 и должен иметь один из следующих размеров в битах до кодирования в base64:

128 , 192 или 256.

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

MD5-хеш ключа, который вы использовали для шифрования входного файла или который вы хотите использовать Elastic Transcoder для шифрования выходного файла. Elastic Transcoder использует хеш ключа как контрольную сумму, чтобы убедиться, что ваш ключ не был поврежден во время передачи. MD5 ключа должен быть закодирован в base64 и должен иметь длину ровно 16 байт до кодирования в base64.

InitializationVector -> (строка)

Последовательность случайных битов, созданных генератором случайных битов, уникальная для каждой операции шифрования, которую вы использовали для шифрования входных файлов или которую вы хотите использовать Elastic Transcoder для шифрования выходных файлов. Вектор инициализации должен быть закодирован в base64 и должен иметь длину ровно 16 байт до кодирования в base64.

CaptionFormats -> (список)

Массив форматов файлов для вывода субтитров. Если вы оставите это значение пустым, Elastic Transcoder вернёт ошибку.

(структура)

Формат файла выводимых субтитров. Если вы оставите это значение пустым, Elastic Transcoder вернёт ошибку.

Формат -> (строка)

Указанный вами формат определяет, генерирует ли Elastic Transcoder встроенные или отдельные субтитры для этого вывода.

Допустимые встроенные форматы субтитров:
- для FLAC : Нет
- Для MP3 : Нет
- Для MP4 : mov-text
- Для MPEG-TS : Нет
- Для ogg : Нет
- Для webm : Нет
Допустимые форматы отдельных субтитров: Elastic Transcoder поддерживает dfxp (только первый элемент div), scc, srt и webvtt. Если вы хотите субтитры, совместимые с ttml или smpte-tt, укажите dfxp в качестве формата вывода.
- Для FMP4 : dfxp
- Выходы, не являющиеся FMP4 : Все типы отдельных субтитров

fmp4 субтитры имеют расширение .ismt

Шаблон -> (строка)

Префикс для имён файлов субтитров в формате описание -{language} , где:

описание - описание видео.
{language} - это буквальное значение, которое Elastic Transcoder заменяет двух- или трёхбуквенным кодом языка субтитров в именах выходных файлов.

Например, предположим, что вы транскодируете в формат srt. Когда вы введёте «Sydney-{язык}-sunrise», а язык субтитров - английский (en), имя первого файла субтитров будет Sydney-en-sunrise00000.srt.

Шифрование -> (структура)

Настройки шифрования, если таковые имеются, которые вы хотите применить к форматам субтитров.

Режим -> (строка)

s3: Amazon S3 создаёт и управляет ключами, используемыми для шифрования файлов.
s3-aws-kms: Amazon S3 вызывает Amazon Key Management Service, который создаёт и управляет ключами, используемыми для шифрования файлов. Если вы укажете s3-aws-kms и не хотите использовать ключ по умолчанию, необходимо добавить нужный AWS-KMS ключ в вашу конвейерную линию.
aes-cbc-pkcs7: Заполненный режим шифрования блоков, изначально используемый для файлов HLS.
aes-ctr: AES режим подсчёта.
aes-gcm: AES режим подсчёта Galois, режим работы, являющийся аутентифицированным форматом шифрования, что означает, что файл, ключ или вектор инициализации, подвергшиеся изменениям, не пройдут процесс дешифрования.

Для всех трёх вариантов AES необходимо указать следующие настройки, которые должны быть закодированы в base64:

Ключ
MD5 ключа
Вектор инициализации

Предупреждение

Ключ -> (строка)

Ключ шифрования данных, который вы хотите использовать для шифрования выходного файла или который использовался для шифрования входного файла. Ключ должен быть закодирован в base64 и иметь один из следующих разрядов длины перед кодированием в base64:

128 , 192 , или 256 .

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

MD5 дайджест ключа, который вы использовали для шифрования входного файла или который вы хотите использовать для шифрования выходного файла. Elastic Transcoder использует дайджест ключа в качестве контрольной суммы, чтобы убедиться, что ваш ключ не был повреждён при передаче. MD5 ключа должен быть закодирован в base64 и иметь ровно 16 байтов до кодирования в base64.

InitializationVector -> (строка)

Последовательность случайных битов, созданная генератором случайных битов, уникальная для каждой операции шифрования, которую вы использовали для шифрования входных файлов или которую вы хотите использовать для шифрования выходных файлов. Вектор инициализации должен быть закодирован в base64 и иметь ровно 16 байтов до кодирования в base64.

Шифрование -> (структура)

Настройки шифрования, если таковые имеются, которые вы хотите применить к выходным файлам. Если вы выберете шифрование, вам необходимо указать используемый режим. Если вы не хотите использовать шифрование, Elastic Transcoder запишет нешифрованный файл в ваш Amazon S3-bucket.

Режим -> (строка)

s3: Amazon S3 создаёт и управляет ключами, используемыми для шифрования файлов.
s3-aws-kms: Amazon S3 вызывает Amazon Key Management Service, который создаёт и управляет ключами, используемыми для шифрования файлов. Если вы укажете s3-aws-kms и не хотите использовать ключ по умолчанию, необходимо добавить нужный AWS-KMS ключ в вашу конвейерную линию.
aes-cbc-pkcs7: Заполненный режим шифрования блоков, изначально используемый для файлов HLS.
aes-ctr: AES режим подсчёта.
aes-gcm: AES режим подсчёта Galois, режим работы, являющийся аутентифицированным форматом шифрования, что означает, что файл, ключ или вектор инициализации, подвергшиеся изменениям, не пройдут процесс дешифрования.

Для всех трёх вариантов AES необходимо указать следующие настройки, которые должны быть закодированы в base64:

Ключ
MD5 ключа
Вектор инициализации

Предупреждение

Ключ -> (строка)

Ключ шифрования данных, который вы хотите использовать для шифрования выходного файла или который использовался для шифрования входного файла. Ключ должен быть закодирован в base64 и иметь один из следующих разрядов длины перед кодированием в base64:

128 , 192 , или 256 .

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

InitializationVector -> (строка)

AppliedColorSpaceConversion -> (строка)

Если Elastic Transcoder использовал пресет с ColorSpaceConversionMode для транскодирования выходного файла, параметр AppliedColorSpaceConversion показывает используемую конвертацию. Если в пресете не было определено ColorSpaceConversionMode, этот параметр не будет включён в ответ задания.

OutputKeyPrefix -> (строка)

Значение, если таковое имеется, которое вы хотите, чтобы Elastic Transcoder добавлял в начало имён всех файлов, созданных этим заданием, включая выходные файлы, миниатюры и плейлисты. Рекомендуется добавлять / или какой-либо другой разделитель в конец OutputKeyPrefix .

Плейлисты -> (список)

Предупреждение

Выходные данные только в формате фрагментированного MP4 или MPEG-TS.

Если вы укажете предустановку в PresetId, значение Container которой равно fmp4 (фрагментированный MP4) или ts (MPEG-TS), Playlists содержит информацию о мастер-плейлистах, которые вы хотите создать с помощью Elastic Transcoder.

Максимальное количество мастер-плейлистов в задании составляет 30.

(структура)

Используется только для выходных данных в формате фрагментированного MP4 или MPEG-TS. Если вы укажете предустановку, для которой значение параметра Контейнер равно fmp4 (фрагментированный MP4) или ts (MPEG-TS), параметр Плейлисты содержит информацию о мастер-плейлистах, которые вы хотите создать с помощью Elastic Transcoder. Рекомендуется создавать только один мастер-плейлист на каждый формат выходных данных. Максимальное количество мастер-плейлистов в задании составляет 30.

Имя -> (строка)

Имя, которое вы хотите назначить мастер-плейлисту, например, nyc-vacation.m3u8. Если имя содержит символ /, часть имени до последнего символа / должна быть идентичной для всех объектов Name. Если вы создаете более одного мастер-плейлиста, значения всех объектов Name должны быть уникальными.

Примечание

Elastic Transcoder автоматически добавляет соответствующее расширение файла к имени файла (.m3u8 для плейлистов HLSv3 и HLSv4, и .ism и .ismc для плейлистов Smooth). Если вы включаете расширение файла в Name, имя файла будет иметь два расширения.

Формат -> (строка)

Формат выходного плейлиста. Допустимые форматы включают HLSv3, HLSv4 и Smooth.

OutputKeys -> (список)

Для каждого выходного файла в этом задании, который вы хотите включить в мастер-плейлист, значение объекта Outputs:Key.

Если ваш выходной файл не HLS или не имеет установленной длительности сегмента, имя выходного файла является конкатенацией OutputKeyPrefix и Outputs:Key: OutputKeyPrefix``Outputs:Key``
Если ваш выходной файл HLSv3 и имеет установленную длительность сегмента, или не включен в плейлист, Elastic Transcoder создает файл выходного плейлиста с расширением .m3u8, и ряд файлов .ts, которые содержат пятизначный последовательный счётчик, начиная с 00000: OutputKeyPrefix``Outputs:Key`` .m3u8 OutputKeyPrefix``Outputs:Key`` 00000.ts
Если ваш выходной файл HLSv4, имеет установленную длительность сегмента и включен в плейлист HLSv4, Elastic Transcoder создает файл выходного плейлиста с расширением _v4.m3u8. Если выходной файл - видео, Elastic Transcoder также создает выходной файл с расширением _iframe.m3u8: OutputKeyPrefix``Outputs:Key`` _v4.m3u8 OutputKeyPrefix``Outputs:Key`` _iframe.m3u8 OutputKeyPrefix``Outputs:Key`` .ts

Elastic Transcoder автоматически добавляет соответствующее расширение файла к имени файла. Если вы включаете расширение файла в Output Key, имя файла будет иметь два расширения.

Если вы включаете более одного выходного файла в плейлист, любые настройки длительности сегмента, настройки клипов или настройки субтитров должны быть одинаковыми для всех выходных файлов в плейлисте. Для плейлистов Smooth, соотношение Audio:Profile, Video:Profile и Video:FrameRate к Video:KeyframesMaxDist должно быть одинаковым для всех выходных файлов.

(строка)

HlsContentProtection -> (структура)

Настройки защиты контента HLS, если таковые имеются, которые вы хотите применить к выходным файлам, связанным с этим плейлистом.

Метод -> (строка)

Метод защиты контента для вашего выходного файла. Единственное допустимое значение: aes-128.

Это значение записывается в атрибут method тега метаданных EXT-X-KEY в выходном плейлисте.

Ключ -> (строка)

Если вы хотите, чтобы Elastic Transcoder сгенерировал ключ для вас, оставьте это поле пустым.

Если вы решите предоставить свой собственный ключ, вы должны зашифровать его с помощью AWS KMS. Ключ должен быть закодирован в base64, и он должен иметь один из следующих битовых размеров до кодирования в base64:

128, 192 или 256.

KeyMd5 -> (строка)

Если Elastic Transcoder генерирует ключ для вас, оставьте это поле пустым.

MD5-хеш ключа, который вы хотите использовать для шифрования выходного файла и в качестве контрольной суммы, чтобы убедиться, что ваш ключ не был поврежден во время передачи. MD5 ключа должен быть закодирован в base64 и должен составлять ровно 16 байт перед кодированием в base64.

InitializationVector -> (строка)

Если Elastic Transcoder генерирует ключ для вас, оставьте это поле пустым.

Последовательность случайных бит, сгенерированных генератором случайных чисел, уникальная для каждой операции шифрования, которую вы хотите использовать для шифрования выходных файлов. Инициализационный вектор должен быть закодирован в base64, и должен составлять ровно 16 байт перед кодированием в base64.

LicenseAcquisitionUrl -> (строка)

Расположение ключа лицензии, необходимого для расшифровки вашего плейлиста HLS. URL должен быть абсолютным путем и упоминается в атрибуте URI тега EXT-X-KEY в файле плейлиста.

KeyStoragePolicy -> (строка)

Укажите, хотите ли вы, чтобы Elastic Transcoder записал ваш ключ лицензии HLS в ведро Amazon S3. Если вы выберете WithVariantPlaylists, LicenseAcquisitionUrl должно быть оставлено пустым, и Elastic Transcoder запишет ваш ключ в то же ведро, что и связанный плейлист.

PlayReadyDrm -> (структура)

Настройки DRM, если таковые имеются, которые вы хотите применить к выходным файлам, связанным с этим плейлистом.

Формат -> (строка)

Тип DRM, если таковой имеется, который вы хотите применить к выходным файлам, связанным с этим плейлистом.

Ключ -> (строка)

Ключ DRM для вашего файла, предоставленный вашим поставщиком лицензий DRM. Ключ должен быть закодирован в base64, и он должен иметь один из следующих битовых размеров до кодирования в base64:

128, 192 или 256.

Ключ также должен быть зашифрован с помощью AWS KMS.

KeyMd5 -> (строка)

MD5-хеш ключа, используемого для DRM вашего файла, который вы хотите использовать в качестве контрольной суммы, чтобы убедиться, что ваш ключ не был повреждён во время передачи. MD5 ключа должен быть закодирован в base64 и должен составлять ровно 16 байт перед кодированием в base64.

KeyId -> (строка)

Идентификатор вашего ключа DRM, чтобы ваш поставщик лицензий DRM знал, какой ключ предоставить.

Идентификатор ключа должен быть предоставлен в формате big endian, и Elastic Transcoder преобразует его в little endian перед вставкой в заголовки PlayReady DRM. Если вы не уверены, предоставляет ли ваш сервер лицензий идентификатор ключа в формате big или little endian, обратитесь к вашему поставщику DRM.

InitializationVector -> (строка)

Последовательность случайных бит, сгенерированных генератором случайных чисел, уникальная для каждой операции шифрования, которую вы хотите использовать для шифрования ваших файлов. Инициализационный вектор должен быть закодирован в base64 и должен иметь ровно 8 байт длины перед кодированием в base64. Если инициализационный вектор не предоставлен, Elastic Transcoder сгенерирует его для вас.

LicenseAcquisitionUrl -> (строка)

Расположение ключа лицензии, необходимого для воспроизведения контента DRM. URL должен быть абсолютным путём и указывается в заголовке PlayReady. Заголовок PlayReady указан в заголовке защиты клиентского манифеста для выходных данных Smooth Streaming, и в тегах метаданных EXT-X-DXDRM и EXT-XDXDRMINFO для выходных данных плейлистов HLS. Пример URL выглядит так: https://www.example.com/exampleKey/

Статус -> (строка)

Статус задания, с которым связан плейлист.

ПодробныйСтатус -> (строка)

Дополнительная информация о статусе.

Статус -> (строка)

Статус задания: Submitted, Progressing, Complete, Canceled или Error.

UserMetadata -> (массив)

Пользовательские метаданные, которые вы хотите связать с заданием Elastic Transcoder. Вы указываете метаданные в парах key/value, и вы можете добавить до 10 пар key/value на задание. Elastic Transcoder не гарантирует, что пары key/value будут возвращены в том же порядке, в котором вы их указали.

Метаданные keys и values должны использовать символы из следующего списка:

0-9
A-Z и a-z
Space
Следующие символы: _.:/=+-%@

ключ -> (строка)

значение -> (строка)

Время -> (структура)

Информация о времени выполнения задания.

ВремяОтправкиМс -> (длинное целое число)

Время отправки задания в Elastic Transcoder в миллисекундах с эпохи.

ВремяНачалоМс -> (длинное целое число)

Время начала транскодирования задания в миллисекундах с эпохи.

ВремяЗавершенияМс -> (длинное целое число)

Время завершения транскодирования задания в миллисекундах с эпохи.

NextPageToken -> (строка)

Значение, которое вы используете для доступа ко второй и последующим страницам результатов, если таковые имеются. Когда задания в указанной пайплайне помещаются на одной странице или когда вы достигли последней страницы результатов, значение NextPageToken равно null.