read-job

Описание

Операция ReadJob возвращает подробную информацию о задании.

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

Синтаксис

  read-job
--id <value>
[--cli-input-json | --cli-input-yaml]
[--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]

Параметры

--id (строка)

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

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

--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 read-job --id 1533838012294-example

Вывод:

{
   "Job": {
       "Status": "Progressing",
       "Inputs": [
           {
               "Container": "mp4",
               "FrameRate": "auto",
               "Key": "ETS_example_file.mp4",
               "AspectRatio": "auto",
               "Resolution": "auto",
               "Interlaced": "auto"
           }
       ],
       "Playlists": [],
       "Outputs": [
           {
               "Status": "Progressing",
               "Rotate": "0",
               "PresetId": "1351620000001-100250",
               "Watermarks": [],
               "Key": "webm/ETS_example_file-kindlefirehd.webm",
               "Id": "1"
           }
       ],
       "PipelineId": "3333333333333-abcde3",
       "OutputKeyPrefix": "recipes/",
       "UserMetadata": {
           "Cook book": "recipe notebook",
           "Food type": "Italian"
       },
       "Output": {
           "Status": "Progressing",
           "Rotate": "0",
           "PresetId": "1351620000001-100250",
           "Watermarks": [],
           "Key": "webm/ETS_example_file-kindlefirehd.webm",
           "Id": "1"
       },
       "Timing": {
           "SubmitTimeMillis": 1533838012298,
           "StartTimeMillis": 1533838013786
       },
       "Input": {
           "Container": "mp4",
           "FrameRate": "auto",
           "Key": "ETS_example_file.mp4",
           "AspectRatio": "auto",
           "Resolution": "auto",
           "Interlaced": "auto"
       },
       "Id": "1533838012294-example",
       "Arn": "arn:aws:elastictranscoder:us-west-2:123456789012:job/1533838012294-example"
   }
}

Вывод

Задача -> (структура)

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

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

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

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

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

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

Key -> (строка)

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

128 , 192 , или 256 .

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

KeyMd5 -> (строка)

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

InitializationVector -> (строка)

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

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

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

StartTime -> (строка)

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

Duration -> (строка)

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

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

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

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

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

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

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

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

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

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

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

двухбуквенный код ISO 639-1
трехбуквенный код ISO 639-2

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

TimeOffset -> (строка)

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

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

Label -> (строка)

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

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

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

Mode -> (строка)

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

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

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

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

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

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

Key -> (строка)

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

128 , 192 или 256.

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

KeyMd5 -> (строка)

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

InitializationVector -> (строка)

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

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

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

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

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

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

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

FrameRate -> (строка)

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

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

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

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

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

Inputs -> (список)

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

(структура)

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

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

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

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

FrameRate -> (строка)

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

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

Resolution -> (строка)

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

AspectRatio -> (строка)

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

Interlaced -> (строка)

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

true , false

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

Container -> (строка)

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

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

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

Mode -> (строка)

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

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

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

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

MergePolicy -> (строка)

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

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

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

CaptionSources -> (список)

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

(структура)

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

Key -> (строка)

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

Language -> (строка)

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

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

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

TimeOffset -> (строка)

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

Укажите TimeOffset в формате [+-]SS.sss или [+-]ЧЧ:мм:СС.сс.

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 -> (длинное целое)

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

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

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

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

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

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

Id -> (строка)

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

Key -> (строка)

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

ThumbnailPattern -> (строка)

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

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

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

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

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

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

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

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

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

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

Mode -> (строка)

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

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

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

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

Ключ
MD5 ключа
Инициализирующий вектор

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

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

Key -> (строка)

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

128 , 192 , или 256 .

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

KeyMd5 -> (строка)

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

InitializationVector -> (строка)

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

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

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

MergePolicy -> (строка)

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

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

Artwork -> (список)

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

(структура)

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

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

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

InputKey -> (строка)

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

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

MaxWidth -> (строка)

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

MaxHeight -> (строка)

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

SizingPolicy -> (строка)

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

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

PaddingPolicy -> (строка)

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

AlbumArtFormat -> (строка)

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

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

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

Mode -> (строка)

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

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

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

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

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

Key -> (строка)

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

128 , 192 , или 256 .

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

KeyMd5 -> (строка)

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

InitializationVector -> (строка)

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

Composition -> (список)

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

(структура)

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

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

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

StartTime -> (строка)

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

Duration -> (строка)

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

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

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

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

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

MergePolicy -> (строка)

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

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

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

CaptionSources -> (список)

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

(структура)

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

Key -> (строка)

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

Language -> (строка)

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

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

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

TimeOffset -> (строка)

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

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

Label -> (строка)

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

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

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

Mode -> (строка)

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

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

CaptionFormats -> (список)

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

(структура)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Для режимов 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-bucket.

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

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

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

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

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

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

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

128 , 192 , или 256 .

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

KeyMd5 -> (строка)

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

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

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

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

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

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

Key -> (строка)

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

128 , 192 , или 256 .

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

KeyMd5 -> (строка)

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

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

Key
Key MD5
Initialization Vector

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

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

Key -> (строка)

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

128 , 192 , или 256 .

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

KeyMd5 -> (строка)

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

InitializationVector -> (строка)

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

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

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

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

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

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

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

Key -> (строка)

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

128, 192 или 256.

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

KeyMd5 -> (строка)

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

InitializationVector -> (строка)

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

Composition -> (список)

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

(структура)

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

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

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

StartTime -> (строка)

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

Duration -> (строка)

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

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

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

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

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

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

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

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

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

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

MergePolicy -> (строка)

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

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

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

CaptionSources -> (список)

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

(структура)

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

Key -> (строка)

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

Language -> (строка)

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

двухсимвольный код ISO 639-1
трехсимвольный код ISO 639-2

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

TimeOffset -> (строка)

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

Label -> (строка)

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

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

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

Mode -> (строка)

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

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

Key
Key MD5
Initialization Vector

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

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

Key -> (строка)

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

128 , 192 или 256.

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

KeyMd5 -> (строка)

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

InitializationVector -> (строка)

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

CaptionFormats -> (список)

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

(структура)

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

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

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

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

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

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

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

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

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

Например, предположим, что вы транскодируете в формате srt. При вводе «Sydney-{язык}-восход» и языке субтитров — английский (en) — имя первого файла субтитров будет Sydney-en-восход00000.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, режим аутентифицированного шифрования, означающий, что файл, ключ или вектор инициализации, подвергшиеся подделке, не пройдут процесс дешифрования.

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

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

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

Name -> (строка)

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

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

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