list-jobs-by-pipeline

Описание

Операция ListJobsByPipeline получает список задач, текущих в конвейере.

Elastic Transcoder возвращает все задачи, текущие в указанном конвейере. Тело ответа содержит по одному элементу для каждой задачи, удовлетворяющей критериям поиска.

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

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

Синтаксис

  list-jobs-by-pipeline
--pipeline-id <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]

Параметры

--pipeline-id (строка)

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

--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 Command Line Interface.

--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 для вывода.

--cli-auto-prompt (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

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

Примеры

Примечание

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

Если не указано иное, все примеры используют правила цитирования Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки терминала. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.

Для получения списка задач ElasticTranscoder в указанном конвейере

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

Команда:

aws elastictranscoder list-jobs-by-pipeline --pipeline-id 1111111111111-abcde1

Вывод:

{
   "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 при расшифровке входных файлов или шифровании выходных файлов. 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.

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.

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

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

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 с галоисовым кодом, режим, являющийся аутентифицированным режимом шифрования, что означает, что файл, ключ или вектор инициализации, подвергшиеся модификации, не пройдут процесс дешифрования.

Для всех трех вариантов 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

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 -> (строка)

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.

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 в качестве выходного формата.

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

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

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

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, режим аутентифицированного шифрования, означающий, что файл, ключ или вектор инициализации, подвергшиеся изменениям, не проходят процесс расшифровки.

Для всех трёх режимов 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 -> (длинное целое число)

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

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

``` END_OF_DOCUMENT_MARKER

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

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

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

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

Id -> (строка)

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

Key -> (строка)

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

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 -> (строка)

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

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 -> (структура)

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

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

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

Чтобы сохранить существующее изображение обложки без изменений, установите Merge Policy в «Prepend», «Append» или «Fallback» и используйте пустой массив 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.
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.

Composition -> (список)

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

(структура)

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

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

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

StartTime -> (строка)

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

Duration -> (строка)

Продолжительность клипа. Формат может быть либо ЧЧ:мм:сс.ммм (максимальное значение: 23:59:59.999; ммм — тысячные доли секунды), либо ссссс.ммм (максимальное значение: 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 не сохраняет форматирование текста (например, курсив) во время процесса транскодирования.

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

Дополнительную информацию о файлах в отдельном файле см. на страницах Wikipedia «Extensible Metadata Platform» и «Файлы в отдельном файле».

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 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 : None
- Для MP3 : None
- Для MP4 : mov-text
- Для MPEG-TS : None
- Для ogg : None
- Для webm : None
Допустимые форматы отдельных субтитров: 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.

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

Настройки шифрования, если таковые имеются, которые вы хотите применить к форматам субтитров 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; поэтому важно надёжно управлять своими ключами шифрования. Если вы их потеряете, вы не сможете расшифровать свои данные.

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

Ключ шифрования данных, который вы хотите использовать 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. Если вы выберите использование шифрования, вам необходимо указать режим. Если вы не хотите использовать шифрование, 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.
aes-gcm: Режим AES Galois Counter Mode — режим аутентифицированного шифрования, означающий, что файл, ключ или начальный вектор, подвергшиеся изменениям, не пройдут процесс дешифрования.

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

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

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

Ключ шифрования данных, который вы хотите использовать 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.

AppliedColorSpaceConversion -> (строка)

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

Outputs -> (список)

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

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

(структура)

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

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

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

Id -> (строка)

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

Key -> (строка)

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

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 -> (строка)

Конкретный режим шифрования на стороне сервера, который вы хотите использовать для дешифрования входных файлов или шифрования выходных файлов. 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 -> (строка)

Ключ шифрования данных, который вы хотите использовать для шифрования выходного файла или который использовался для шифрования входного файла. Ключ должен быть закодирован в 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 -> (строка)

auto , 0 , 90 , 180 , 270

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

PresetId -> (строка)

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

SegmentDuration -> (строка)

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

(Выходы только в формате фрагментированного 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 размещать все водяные знаки в одном месте, второй добавленный водяной знак накладывается на первый, третий — на второй, а четвёртый — на третий.

(структура)

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 -> (строка)

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.

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 режим счётчика.
aes-gcm: AES режим галоического счётчика, режим шифрования, который является аутентифицированным форматом шифрования, что означает, что файл, ключ или начальный вектор, которые были изменены, не пройдут процесс расшифровки.

Для всех трёх вариантов 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 -> (список)

Исходные файлы для входных внешних субтитров, используемых во время процесса транскодирования. Чтобы исключить все внешние субтитры, оставьте 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 -> (строка)

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 ключа
Инициализирующий вектор

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

Для режимов 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 встроенные или отдельные субтитры для этого вывода.

Допустимые встроенные форматы субтитров:
- для 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-{language}-sunrise», а языком субтитров является английский (en), имя первого файла субтитров будет Sydney-en-sunrise00000.srt.

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

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

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

Конкретный режим серверного шифрования, который вы хотите использовать 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; поэтому важно безопасно управлять своими ключами шифрования. Если вы их потеряете, вы не сможете дешифровать свои данные.

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

Ключ шифрования данных, который вы хотите использовать 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.
aes-gcm: Режим счётчика AES Galois, режим аутентифицированного шифрования, что означает, что файл, ключ или вектор инициализации, в которых были обнаружены изменения, не пройдут процесс дешифрования.

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

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

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

128 , 192 или 256 .

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

KeyMd5 -> (строка)

InitializationVector -> (строка)

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

AppliedColorSpaceConversion -> (строка)

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

OutputKeyPrefix -> (строка)

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

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

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

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

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

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

(структура)

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

Name -> (строка)

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

Примечание

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

Format -> (строка)

Формат выходного плейлиста. Допустимые форматы включают 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, если таковые имеются, которые вы хотите применить к выходным файлам, связанным с этим плейлистом.

Method -> (строка)

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

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

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, если таковые имеются, которые вы хотите применить к выходным файлам, связанным с этим плейлистом.

Format -> (строка)

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

Key -> (строка)

Ключ 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 перед вставкой в заголовки DRM PlayReady. Если вы не уверены, в каком формате (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/

Status -> (строка)

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

StatusDetail -> (строка)

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

Status -> (строка)

Статус задания: 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
Следующие символы: _.:/=+-%@

key -> (строка)

value -> (строка)

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

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

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

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

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

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

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

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

NextPageToken -> (строка)

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