обновить-потоковую-обработку

Описание

Используйте операцию UpdatePipeline для обновления настроек потоковой обработки.

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

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

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

Синтаксис

  update-pipeline
--id <value>
[--name <value>]
[--input-bucket <value>]
[--role <value>]
[--aws-kms-key-arn <value>]
[--notifications <value>]
[--content-config <value>]
[--thumbnail-config <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 (строка)

Идентификатор конвейера, который требуется обновить.

--name (строка)

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

Ограничения: максимальная длина 40 символов

--input-bucket (строка)

Ведро Amazon S3, в котором сохранены медиафайлы, подлежащие транскодированию, и графические элементы, используемые в качестве водяных знаков.

--role (строка)

Идентификатор ресурса Amazon Resource Name (ARN) для роли IAM, которую Elastic Transcoder должен использовать для транскодирования задач для данного конвейера.

--aws-kms-key-arn (строка)

Ключ AWS Key Management Service (AWS KMS), который нужно использовать с этим конвейером.

Если вы используете либо s3, либо s3-aws-kms в качестве Encryption:Mode, вам не нужно указывать ключ для вашей задачи, так как для вас автоматически создается ключ по умолчанию, известный как ключ AWS-KMS. Вам необходимо указать ключ AWS-KMS только в том случае, если вы хотите использовать нестандартный ключ AWS-KMS или если вы используете Encryption:Mode для aes-cbc-pkcs7, aes-ctr или aes-gcm.

--notifications (структура)

ARN темы Amazon Simple Notification Service (Amazon SNS), которую нужно оповестить о статусе задачи.

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

Для получения уведомлений необходимо также подписаться на новую тему в консоли Amazon SNS.

В процессе : ARN темы Amazon Simple Notification Service (Amazon SNS), которую нужно оповестить, когда Elastic Transcoder начал обрабатывать задачи, добавленные в этот конвейер. Это ARN, возвращенный Amazon SNS при создании темы.
Завершено : ARN темы Amazon SNS, которую нужно оповестить, когда Elastic Transcoder завершил обработку задачи. Это ARN, возвращенный Amazon SNS при создании темы.
Предупреждение : ARN темы Amazon SNS, которую нужно оповестить, когда Elastic Transcoder обнаружил предупреждение. Это ARN, возвращенный Amazon SNS при создании темы.
Ошибка : ARN темы Amazon SNS, которую нужно оповестить, когда Elastic Transcoder обнаружил ошибку. Это ARN, возвращенный Amazon SNS при создании темы.

В процессе -> (строка)

Тема Amazon Simple Notification Service (Amazon SNS), которую нужно оповестить, когда Elastic Transcoder начал обработку задачи.

Завершено -> (строка)

Тема Amazon SNS, которую нужно оповестить, когда Elastic Transcoder завершил обработку задачи.

Предупреждение -> (строка)

Тема Amazon SNS, которую нужно оповестить, когда Elastic Transcoder обнаружил предупреждение.

Ошибка -> (строка)

Тема Amazon SNS, которую нужно оповестить, когда Elastic Transcoder обнаружил ошибку.

Сокращенная синтаксическая запись:

Progressing=string,Completed=string,Warning=string,Error=string

Синтаксис JSON:

{
  "Progressing": "string",
  "Completed": "string",
  "Warning": "string",
  "Error": "string"
}

--content-config (структура)

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

Если вы указываете значения для ContentConfig, вы также должны указать значения для ThumbnailConfig.

Если вы указываете значения для ContentConfig и ThumbnailConfig, опустите объект OutputBucket.

Ведро : Ведро Amazon S3, в котором Elastic Transcoder должен сохранять транскодированные файлы и плейлисты.
Разрешения (Необязательно): Объект Разрешения указывает, какие пользователи должны иметь доступ к транскодированным файлам и какой тип доступа у них должен быть. Вы можете предоставить разрешения максимум 30 пользователям и/или предопределенным группам Amazon S3.
Тип получателя : Укажите тип значения, который отображается в объекте Grantee:
- Канонический : Значение в объекте Grantee — это либо канонический идентификатор пользователя для учётной записи AWS, либо идентификатор доступа к источнику для распределения Amazon CloudFront. Более подробную информацию о канонических идентификаторах пользователей см. в разделе Обзор списка управления доступом (ACL) в руководстве разработчика Amazon Simple Storage Service. Более подробную информацию об использовании идентификаторов доступа к источнику CloudFront для требования к пользователям использовать URL-адреса CloudFront вместо URL-адресов Amazon S3 см. в разделе Использование идентификатора доступа к источнику для ограничения доступа к вашему содержимому Amazon S3.
Предупреждение

Канонический идентификатор пользователя не совпадает с номером учётной записи AWS.
- Электронная почта : Значение в объекте Grantee — это зарегистрированный адрес электронной почты учётной записи AWS.
- Группа : Значение в объекте Grantee — это одна из следующих предопределенных групп Amazon S3: AllUsers, AuthenticatedUsers или LogDelivery.
Получатель : Пользователь или группа AWS, которым требуется доступ к транскодированным файлам и плейлистам. Для идентификации пользователя или группы можно указать канонический идентификатор пользователя учётной записи AWS, идентификатор доступа к источнику для распределения CloudFront, зарегистрированный адрес электронной почты учётной записи AWS или предопределённую группу Amazon S3.
Доступ : Разрешение, которое вы хотите предоставить пользователю AWS, указанному в Grantee. Разрешения предоставляются на файлы, которые Elastic Transcoder добавляет в ведро, включая плейлисты и видеофайлы. Допустимые значения включают:
- READ : Получатель может читать объекты и метаданные объектов, которые Elastic Transcoder добавляет в ведро Amazon S3.
- READ_ACP : Получатель может читать ACL объектов, которые Elastic Transcoder добавляет в ведро Amazon S3.
- WRITE_ACP : Получатель может записывать ACL для объектов, которые Elastic Transcoder добавляет в ведро Amazon S3.
- FULL_CONTROL : Получатель имеет READ, READ_ACP и WRITE_ACP разрешения для объектов, которые Elastic Transcoder добавляет в ведро Amazon S3.
StorageClass : Класс хранения Amazon S3, Standard или ReducedRedundancy, который вы хотите, чтобы Elastic Transcoder назначил видеофайлам и плейлистам, которые он сохраняет в вашем ведре Amazon S3.

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

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

Вы хотите сохранить транскодированные файлы, миниатюры (при их наличии) и плейлисты (при их наличии) вместе в одном ведре.
Вы не хотите указывать пользователей или группы, имеющие доступ к транскодированным файлам, миниатюрам и плейлистам.
Вы не хотите указывать разрешения, которые Elastic Transcoder предоставляет для файлов.
Вы хотите связать транскодированные файлы и миниатюры с классом хранения Amazon S3 Standard.

Если вы хотите сохранить транскодированные файлы и плейлисты в одном ведре, а миниатюры — в другом ведре, укажите, какие пользователи могут получить доступ к транскодированным файлам, или какие разрешения у них есть, или измените класс хранения Amazon S3. В этом случае опустите OutputBucket и укажите значения для ContentConfig и ThumbnailConfig.

StorageClass -> (строка)

Класс хранения Amazon S3, Standard или ReducedRedundancy, который вы хотите, чтобы Elastic Transcoder назначил видеофайлам и плейлистам, которые он сохраняет в вашем ведре Amazon S3.

Разрешения -> (список)

Необязательно. Объект Permissions указывает, какие пользователи и/или предопределенные группы Amazon S3 должны иметь доступ к транскодированным файлам и плейлистам, а также тип доступа, который им должен быть предоставлен. Вы можете предоставить разрешения максимум 30 пользователям и/или предопределенным группам Amazon S3.

Если вы включаете Permissions, Elastic Transcoder предоставляет только указанные вами разрешения. Он не предоставляет полные разрешения владельцу роли, указанной в Role. Если вы хотите, чтобы у этого пользователя были все права, вы должны явно предоставить ему полные права.

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

(структура)

Структура Permission.

Тип получателя -> (строка)

Тип значения, который появляется в объекте Получатель:

Canonical : Либо канонический идентификатор пользователя для учётной записи AWS, либо идентификатор доступа к источнику для распределения Amazon CloudFront.

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

Канонический идентификатор пользователя не совпадает с номером учётной записи AWS.

Email : Зарегистрированный адрес электронной почты учётной записи AWS.
Group : Одна из следующих предопределенных групп Amazon S3: AllUsers, AuthenticatedUsers или LogDelivery.

Получатель -> (строка)

Пользователь или группа AWS, которым требуется доступ к транскодированным файлам и плейлистам. Для идентификации пользователя или группы можно указать канонический идентификатор пользователя учётной записи AWS, идентификатор доступа к источнику для распределения CloudFront, зарегистрированный адрес электронной почты учётной записи AWS или предопределённую группу Amazon S3.

Доступ -> (список)

Разрешение, которое вы хотите предоставить пользователю AWS, указанному в Получатель. Допустимые значения включают:

READ : Получатель может читать миниатюры и метаданные миниатюр, которые Elastic Transcoder добавляет в ведро Amazon S3.
READ_ACP : Получатель может читать ACL объектов миниатюр, которые Elastic Transcoder добавляет в ведро Amazon S3.
WRITE_ACP : Получатель может записывать ACL для миниатюр, которые Elastic Transcoder добавляет в ведро Amazon S3.
FULL_CONTROL : Получатель имеет разрешения READ, READ_ACP и WRITE_ACP для миниатюр, которые Elastic Transcoder добавляет в ведро Amazon S3.

(строка)

Синтаксис JSON:

{
  "Bucket": "string",
  "StorageClass": "string",
  "Permissions": [
    {
      "GranteeType": "string",
      "Grantee": "string",
      "Access": ["string", ...]
    }
    ...
  ]
}

--thumbnail-config (структура)

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

Если вы указываете значения для ContentConfig, вы также должны указать значения для ThumbnailConfig, даже если вы не хотите создавать миниатюры.

Если вы указываете значения для ContentConfig и ThumbnailConfig, опустите объект OutputBucket.

Ведро : Amazon S3-ведро, в котором Elastic Transcoder должен сохранять миниатюры.
Разрешения (Необязательно): Объект Permissions указывает, какие пользователи и/или предопределённые группы Amazon S3 должны иметь доступ к миниатюрам, а также тип доступа. Вы можете предоставить разрешения максимум 30 пользователям и/или предопределённым группам Amazon S3.
Тип получателя : Укажите тип значения, который появляется в объекте Grantee:
- Канонический : значение в объекте Grantee — это либо канонический идентификатор пользователя для учётной записи AWS, либо идентификатор доступа к источнику для распределения Amazon CloudFront.
Предупреждение

Канонический идентификатор пользователя не является тем же, что и номер учётной записи AWS.
- Электронная почта : значение в объекте Grantee — зарегистрированный адрес электронной почты учётной записи AWS.
- Группа : значение в объекте Grantee — это одна из следующих предопределённых групп Amazon S3: AllUsers, AuthenticatedUsers или LogDelivery.
Получатель : Пользователь или группа AWS, которые должны иметь доступ к миниатюрам. Для идентификации пользователя или группы вы можете указать канонический идентификатор пользователя для учётной записи AWS, идентификатор доступа к источнику для распределения CloudFront, зарегистрированный адрес электронной почты учётной записи AWS или предопределённую группу Amazon S3.
Доступ : Разрешение, которое вы хотите предоставить пользователю AWS, указанному в Grantee. Разрешения предоставляются на миниатюры, которые Elastic Transcoder добавляет в ведро. Допустимые значения включают:
- READ : Получатель может читать миниатюры и метаданные для объектов, которые Elastic Transcoder добавляет в Amazon S3-ведро.
- READ_ACP : Получатель может читать ACL объекта для миниатюр, которые Elastic Transcoder добавляет в Amazon S3-ведро.
- WRITE_ACP : Получатель может записывать ACL для миниатюр, которые Elastic Transcoder добавляет в Amazon S3-ведро.
- FULL_CONTROL : Получатель имеет разрешения READ, READ_ACP и WRITE_ACP для миниатюр, которые Elastic Transcoder добавляет в Amazon S3-ведро.
Класс хранения : Класс хранения Amazon S3, Standard или ReducedRedundancy, который вы хотите, чтобы Elastic Transcoder назначил миниатюрам, которые он сохраняет в вашем Amazon S3-ведре.

Bucket -> (строка)

Amazon S3-ведро, в котором вы хотите, чтобы Elastic Transcoder сохранял перекодированные файлы. Укажите это значение, если все перечисленные условия верны:

Вы хотите сохранить перекодированные файлы, миниатюры (если есть) и плейлисты (если есть) вместе в одном ведре.
Вы не хотите указывать пользователей или группы, которые имеют доступ к перекодированным файлам, миниатюрам и плейлистам.
Вы не хотите указывать разрешения, которые Elastic Transcoder предоставляет для файлов.
Вы хотите связать перекодированные файлы и миниатюры с классом хранения Amazon S3 Standard.

Если вы хотите сохранить перекодированные файлы и плейлисты в одном ведре, а миниатюры — в другом, укажите, какие пользователи могут получить доступ к перекодированным файлам или какие разрешения у них есть, или измените класс хранения Amazon S3, опустите OutputBucket и укажите значения для ContentConfig и ThumbnailConfig вместо него.

StorageClass -> (строка)

Класс хранения Amazon S3, Standard или ReducedRedundancy, который вы хотите, чтобы Elastic Transcoder назначил видеофайлам и плейлистам, которые он сохраняет в вашем Amazon S3-ведре.

Permissions -> (список)

Необязательно. Объект Permissions указывает, какие пользователи и/или предопределённые группы Amazon S3 должны иметь доступ к перекодированным файлам и плейлистам, а также тип доступа. Вы можете предоставить разрешения максимум 30 пользователям и/или предопределённым группам Amazon S3.

Если вы включаете Permissions, Elastic Transcoder предоставляет только указанные разрешения. Он не предоставляет полные разрешения владельцу роли, указанной в Role. Если вы хотите, чтобы у этого пользователя был полный контроль, вы должны явно предоставить ему полный контроль.

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

(структура)

Структура Permission.

GranteeType -> (строка)

Тип значения, который появляется в объекте Grantee:

Canonical : либо канонический идентификатор пользователя для учётной записи AWS, либо идентификатор доступа к источнику для распределения Amazon CloudFront.

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

Канонический идентификатор пользователя не является тем же, что и номер учётной записи AWS.

Email : зарегистрированный адрес электронной почты учётной записи AWS.
Group : одна из следующих предопределённых групп Amazon S3: AllUsers, AuthenticatedUsers или LogDelivery.

Grantee -> (строка)

Пользователь или группа AWS, которым вы хотите предоставить доступ к перекодированным файлам и плейлистам. Для идентификации пользователя или группы можно указать канонический идентификатор пользователя для учётной записи AWS, идентификатор доступа к источнику для распределения CloudFront, зарегистрированный адрес электронной почты учётной записи AWS или предопределённую группу Amazon S3.

Access -> (список)

Разрешение, которое вы хотите предоставить пользователю AWS, указанному в Grantee. Допустимые значения включают:

READ : получатель может читать миниатюры и метаданные миниатюр, которые Elastic Transcoder добавляет в Amazon S3-ведро.
READ_ACP : получатель может читать ACL объекта для миниатюр, которые Elastic Transcoder добавляет в Amazon S3-ведро.
WRITE_ACP : получатель может записывать ACL для миниатюр, которые Elastic Transcoder добавляет в Amazon S3-ведро.
FULL_CONTROL : получатель имеет разрешения READ, READ_ACP и WRITE_ACP для миниатюр, которые Elastic Transcoder добавляет в Amazon S3-ведро.

(строка)

Синтаксис JSON:

{
  "Bucket": "string",
  "StorageClass": "string",
  "Permissions": [
    {
      "GranteeType": "string",
      "Grantee": "string",
      "Access": ["string", ...]
    }
    ...
  ]
}

--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 (boolean)

Включить отладочную запись в журнал.

--endpoint-url (string)

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

--no-verify-ssl (boolean)

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

--no-paginate (boolean)

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

--output (string)

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

json
text
table
yaml
yaml-stream

--query (string)

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

--profile (string)

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

--region (string)

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

--version (string)

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

--color (string)

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

on
off
auto

--no-sign-request (boolean)

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

--ca-bundle (string)

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

--cli-read-timeout (int)

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

--cli-connect-timeout (int)

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

--cli-binary-format (string)

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

Отключить вывод с помощью страницы кли.

--cli-auto-prompt (boolean)

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

--no-cli-auto-prompt (boolean)

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

Примеры

Примечание

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

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

Обновление конвейера ElasticTranscoder

Следующий update-pipeline пример обновляет указанный конвейер ElasticTranscoder.

aws elastictranscoder update-pipeline \
    --id 1111111111111-abcde1
    --name DefaultExample \
    --input-bucket salesoffice.example.com-source \
    --role arn:aws:iam::123456789012:role/Elastic_Transcoder_Default_Role \
    --notifications Progressing="",Completed="",Warning="",Error=arn:aws:sns:us-east-1:111222333444:ETS_Errors \
    --content-config file://content-config.json \
    --thumbnail-config file://thumbnail-config.json

Содержание content-config.json:

{
    "Bucket":"salesoffice.example.com-public-promos",
    "Permissions":[
        {
            "GranteeType":"Email",
            "Grantee":"marketing-promos@example.com",
            "Access":[
                "FullControl"
            ]
        }
    ],
    "StorageClass":"Standard"
}

Содержание thumbnail-config.json:

{
    "Bucket":"salesoffice.example.com-public-promos-thumbnails",
    "Permissions":[
        {
            "GranteeType":"Email",
            "Grantee":"marketing-promos@example.com",
            "Access":[
                "FullControl"
            ]
        }
    ],
    "StorageClass":"ReducedRedundancy"
}

Вывод:

{
    "Pipeline": {
        "Status": "Active",
        "ContentConfig": {
            "Bucket": "ets-example",
            "StorageClass": "Standard",
            "Permissions": [
                {
                    "Access": [
                        "FullControl"
                    ],
                    "Grantee": "marketing-promos@example.com",
                    "GranteeType": "Email"
                }
            ]
        },
        "Name": "DefaultExample",
        "ThumbnailConfig": {
            "Bucket": "ets-example",
            "StorageClass": "ReducedRedundancy",
            "Permissions": [
                {
                    "Access": [
                        "FullControl"
                    ],
                    "Grantee": "marketing-promos@example.com",
                    "GranteeType": "Email"
                }
            ]
        },
        "Notifications": {
            "Completed": "",
            "Warning": "",
            "Progressing": "",
            "Error": "arn:aws:sns:us-east-1:111222333444:ETS_Errors"
        },
        "Role": "arn:aws:iam::123456789012:role/Elastic_Transcoder_Default_Role",
        "InputBucket": "ets-example",
        "Id": "3333333333333-abcde3",
        "Arn": "arn:aws:elastictranscoder:us-west-2:123456789012:pipeline/3333333333333-abcde3"
    },
    "Warnings": [
        {
            "Message": "The SNS notification topic for Error events and the pipeline are in different regions, which increases processing time for jobs in the pipeline and can incur additional charges. To decrease processing time and prevent cross-regional charges, use the same region for the SNS notification topic and the pipeline.",
            "Code": "6006"
        }
    ]
}

Вывод

Поток —> (структура)

Поток, обновленный этим UpdatePipelineResponse вызовом.

Id —> (строка)

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

Arn —> (строка)

Amazon Resource Name (ARN) для потока.

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

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

Ограничения: Максимальная длина 40 символов

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

Текущий статус потока:

Active : Поток обрабатывает задания.
Paused : Поток в данный момент не обрабатывает задания.

InputBucket —> (строка)

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

OutputBucket —> (строка)

Amazon S3-ведро, в котором вы хотите, чтобы Elastic Transcoder сохранял транскодированные файлы, миниатюры и плейлисты. Либо вы указываете это значение, либо указываете оба ContentConfig и ThumbnailConfig .

Роль —> (строка)

IAM Amazon Resource Name (ARN) для роли, которую Elastic Transcoder использует для транскодирования заданий для этого потока.

AwsKmsKeyArn —> (строка)

Ключ AWS Key Management Service (AWS KMS), который вы хотите использовать с этим потоком.

Если вы используете либо s3 или s3-aws-kms в качестве своего Encryption:Mode, вам не нужно предоставлять ключ вместе с заданием, потому что для вас автоматически создается стандартный ключ AWS-KMS. Вам необходимо предоставить ключ AWS-KMS только если вы хотите использовать нестандартный ключ AWS-KMS, или если вы используете Encryption:Mode вида aes-cbc-pkcs7, aes-ctr или aes-gcm.

Уведомления —> (структура)

Тема Amazon Simple Notification Service (Amazon SNS), которую вы хотите уведомить о статусе задания.

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

Для получения уведомлений необходимо также подписаться на новую тему в консоли Amazon SNS.

Обработка (необязательно): Тема Amazon Simple Notification Service (Amazon SNS), которую вы хотите уведомить, когда Elastic Transcoder начал обработку задания.
Завершено (необязательно): Тема Amazon SNS, которую вы хотите уведомить, когда Elastic Transcoder завершил обработку задания.
Предупреждение (необязательно): Тема Amazon SNS, которую вы хотите уведомить, когда Elastic Transcoder столкнулся с предупреждением.
Ошибка (необязательно): Тема Amazon SNS, которую вы хотите уведомить, когда Elastic Transcoder столкнулся с ошибкой.

Обработка —> (строка)

Тема Amazon Simple Notification Service (Amazon SNS), которую вы хотите уведомить, когда Elastic Transcoder начал обработку задания.

Завершено —> (строка)

Тема Amazon SNS, которую вы хотите уведомить, когда Elastic Transcoder завершил обработку задания.

Предупреждение —> (строка)

Тема Amazon SNS, которую вы хотите уведомить, когда Elastic Transcoder столкнулся с предупреждением.

Ошибка —> (строка)

Тема Amazon SNS, которую вы хотите уведомить, когда Elastic Transcoder столкнулся с ошибкой.

ContentConfig —> (структура)

Информация об Amazon S3-ведре, в котором вы хотите, чтобы Elastic Transcoder сохранял транскодированные файлы и плейлисты. Либо вы указываете оба ContentConfig и ThumbnailConfig, либо вы указываете OutputBucket.

Ведро : Amazon S3-ведро, в котором вы хотите, чтобы Elastic Transcoder сохранял транскодированные файлы и плейлисты.
Разрешения : Список пользователей и/или предопределенных групп Amazon S3, которым вы хотите предоставить доступ к транскодированным файлам и плейлистам, и тип доступа, который вы хотите предоставить.
- GranteeType: Тип значения, которое появляется в объекте Grantee:
  - Canonical : Либо канонический идентификатор пользователя для учетной записи AWS, либо идентификатор доступа к источнику для распределения Amazon CloudFront.
  - Email : Зарегистрированный адрес электронной почты учетной записи AWS.
  - Group : Одна из следующих предопределенных групп Amazon S3: AllUsers, AuthenticatedUsers или LogDelivery.
- Grantee : Пользователь или группа AWS, которым вы хотите предоставить доступ к транскодированным файлам и плейлистам.
- Access : Разрешение, которое вы хотите предоставить пользователю AWS, который указан в Grantee. Допустимые значения включают:
  - READ : Субъект может читать объекты и метаданные объектов, которые Elastic Transcoder добавляет в Amazon S3-ведро.
  - READ_ACP : Субъект может читать ACL объекта для объектов, которые Elastic Transcoder добавляет в Amazon S3-ведро.
  - WRITE_ACP : Субъект может записывать ACL для объектов, которые Elastic Transcoder добавляет в Amazon S3-ведро.
  - FULL_CONTROL : Субъект имеет READ, READ_ACP и WRITE_ACP разрешения на объекты, которые Elastic Transcoder добавляет в Amazon S3-ведро.
StorageClass : Класс хранения Amazon S3, Standard или ReducedRedundancy, который вы хотите, чтобы Elastic Transcoder назначил видеофайлам и плейлистам, которые он хранит в вашем Amazon S3-ведре.

Bucket —> (строка)

Amazon S3-ведро, в котором вы хотите, чтобы Elastic Transcoder сохранял транскодированные файлы. Укажите это значение, если все из перечисленного ниже верно:

Вы хотите сохранить транскодированные файлы, миниатюры (если есть) и плейлисты (если есть) вместе в одном ведре.
Вы не хотите указывать пользователей или группы, которые имеют доступ к транскодированным файлам, миниатюрам и плейлистам.
Вы не хотите указывать разрешения, которые Elastic Transcoder предоставляет файлам.
Вы хотите связать транскодированные файлы и миниатюры с классом хранения Amazon S3 Standard.

Если вы хотите сохранить транскодированные файлы и плейлисты в одном ведре, а миниатюры — в другом, укажите, какие пользователи могут получить доступ к транскодированным файлам или какие разрешения у них есть, или измените класс хранения Amazon S3, пропустите OutputBucket и укажите значения для ContentConfig и ThumbnailConfig вместо этого.

StorageClass —> (строка)

Класс хранения Amazon S3, Standard или ReducedRedundancy, который вы хотите, чтобы Elastic Transcoder назначил видеофайлам и плейлистам, которые он хранит в вашем Amazon S3-ведре.

Permissions —> (список)

Необязательно. Объект Permissions указывает, каким пользователям и/или предопределенным группам Amazon S3 вы хотите предоставить доступ к транскодированным файлам и плейлистам, и какой тип доступа вы хотите предоставить. Вы можете предоставить разрешения максимум 30 пользователям и/или предопределенным группам Amazon S3.

Если вы включаете Permissions, Elastic Transcoder предоставляет только те разрешения, которые вы указываете. Он не предоставляет полные разрешения владельцу роли, указанной в Role. Если вы хотите, чтобы у этого пользователя были полные права, вы должны явно предоставить полные права пользователю.

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

(структура)

Структура Permission.

GranteeType —> (строка)

Тип значения, который появляется в объекте Grantee:

Canonical : Либо канонический идентификатор пользователя для учетной записи AWS, либо идентификатор доступа к источнику для распределения Amazon CloudFront.

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

Канонический идентификатор пользователя отличается от номера учетной записи AWS.

Email : Зарегистрированный адрес электронной почты учетной записи AWS.
Group : Одна из следующих предопределенных групп Amazon S3: AllUsers, AuthenticatedUsers или LogDelivery.

Grantee —> (строка)

Пользователь или группа AWS, которому вы хотите предоставить доступ к транскодированным файлам и плейлистам. Для идентификации пользователя или группы вы можете указать канонический идентификатор пользователя для учетной записи AWS, идентификатор доступа к источнику для распределения CloudFront, зарегистрированный адрес электронной почты учетной записи AWS или предопределенную группу Amazon S3.

Access —> (список)

Разрешение, которое вы хотите предоставить пользователю AWS, указанному в Grantee. Допустимые значения включают:

READ : Субъект может читать миниатюры и метаданные для миниатюр, которые Elastic Transcoder добавляет в Amazon S3-ведро.
READ_ACP : Субъект может читать ACL объекта для миниатюр, которые Elastic Transcoder добавляет в Amazon S3-ведро.
WRITE_ACP : Субъект может записывать ACL для миниатюр, которые Elastic Transcoder добавляет в Amazon S3-ведро.
FULL_CONTROL : Субъект имеет разрешения READ, READ_ACP и WRITE_ACP для миниатюр, которые Elastic Transcoder добавляет в Amazon S3-ведро.

(строка)

ThumbnailConfig —> (структура)

Информация о ведре Amazon S3, в котором вы хотите, чтобы Elastic Transcoder сохранял файлы миниатюр. Вы должны указать либо ContentConfig и ThumbnailConfig , либо OutputBucket .

Bucket : Ведро Amazon S3, в котором вы хотите, чтобы Elastic Transcoder сохранял файлы миниатюр.
Permissions : Список пользователей и/или предопределенных групп Amazon S3, которым вы хотите предоставить доступ к файлам миниатюр, и тип доступа, который вы хотите предоставить.
- GranteeType: Тип значения, отображаемого в объекте Grantee:
  - Canonical : Каннонический идентификатор пользователя учетной записи AWS или идентификатор доступа к источнику для распределения Amazon CloudFront.
  Предупреждение
  
  Каннонический идентификатор пользователя не является тем же, что и номер учетной записи AWS.
  - Email : Зарегистрированный адрес электронной почты учетной записи AWS.
  - Group : Одна из следующих предопределённых групп Amazon S3: AllUsers , AuthenticatedUsers или LogDelivery .
- Grantee : Пользователь или группа AWS, которому/которой вы хотите предоставить доступ к файлам миниатюр.
- Access: Разрешение, которое вы хотите предоставить пользователю AWS, указанному в Grantee. Допустимые значения:
  - READ : Пользователь может читать миниатюры и метаданные для миниатюр, которые Elastic Transcoder добавляет в ведро Amazon S3.
  - READ_ACP : Пользователь может читать ACL объекта для миниатюр, которые Elastic Transcoder добавляет в ведро Amazon S3.
  - WRITE_ACP : Пользователь может записывать ACL для миниатюр, которые Elastic Transcoder добавляет в ведро Amazon S3.
  - FULL_CONTROL : Пользователь имеет права READ, READ_ACP и WRITE_ACP для миниатюр, которые Elastic Transcoder добавляет в ведро Amazon S3.
StorageClass : Класс хранения Amazon S3, Standard или ReducedRedundancy , который вы хотите, чтобы Elastic Transcoder назначил миниатюрам, хранящимся в вашем ведре Amazon S3.

Bucket -> (строка)

Ведро Amazon S3, в котором вы хотите, чтобы Elastic Transcoder сохранял перекодированные файлы. Указывайте это значение, если выполняются все следующие условия:

Вы хотите сохранить перекодированные файлы, миниатюры (при наличии) и плейлисты (при наличии) вместе в одном ведре.
Вы не хотите указывать пользователей или группы, которые имеют доступ к перекодированным файлам, миниатюрам и плейлистам.
Вы не хотите указывать разрешения, предоставляемые Elastic Transcoder для файлов.
Вы хотите связать перекодированные файлы и миниатюры с классом хранения Amazon S3 Standard.

Если вы хотите сохранить перекодированные файлы и плейлисты в одном ведре, а миниатюры — в другом, укажите, какие пользователи могут получить доступ к перекодированным файлам или какие разрешения у них есть, или измените класс хранения Amazon S3, пропустите OutputBucket и укажите значения для ContentConfig и ThumbnailConfig вместо него.

StorageClass -> (строка)

Класс хранения Amazon S3, Standard или ReducedRedundancy , который вы хотите, чтобы Elastic Transcoder назначил видеофайлам и плейлистам, хранящимся в вашем ведре Amazon S3.

Permissions -> (список)

Необязательно. Объект Permissions указывает, каких пользователей и/или предопределенных групп Amazon S3 вы хотите предоставить доступ к перекодированным файлам и плейлистам, и какой тип доступа вы хотите предоставить. Вы можете предоставить разрешения максимум 30 пользователям и/или предопределенным группам Amazon S3.

Если вы включаете Permissions , Elastic Transcoder предоставляет только те разрешения, которые вы указываете. Он не предоставляет полные разрешения владельцу роли, указанной в Role . Если вы хотите, чтобы у этого пользователя был полный контроль, вы должны явно предоставить ему полный контроль.

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

(структура)

Структура Permission .

GranteeType -> (строка)

Тип значения, отображаемого в объекте Grantee:

Canonical : Каннонический идентификатор пользователя учетной записи AWS или идентификатор доступа к источнику для распределения Amazon CloudFront.

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

Каннонический идентификатор пользователя не является тем же, что и номер учетной записи AWS.

Email : Зарегистрированный адрес электронной почты учетной записи AWS.
Group : Одна из следующих предопределённых групп Amazon S3: AllUsers , AuthenticatedUsers или LogDelivery .

Grantee -> (строка)

Пользователь или группа AWS, которому/которой вы хотите предоставить доступ к перекодированным файлам и плейлистам. Для идентификации пользователя или группы вы можете указать канонический идентификатор пользователя для учетной записи AWS, идентификатор доступа к источнику для распределения CloudFront, зарегистрированный адрес электронной почты учетной записи AWS или предопределённую группу Amazon S3.

Access -> (список)

Разрешение, которое вы хотите предоставить пользователю AWS, указанному в Grantee. Допустимые значения:

READ : Пользователь может читать миниатюры и метаданные для миниатюр, которые Elastic Transcoder добавляет в ведро Amazon S3.
READ_ACP : Пользователь может читать ACL объекта для миниатюр, которые Elastic Transcoder добавляет в ведро Amazon S3.
WRITE_ACP : Пользователь может записывать ACL для миниатюр, которые Elastic Transcoder добавляет в ведро Amazon S3.
FULL_CONTROL : Пользователь имеет права READ, READ_ACP и WRITE_ACP для миниатюр, которые Elastic Transcoder добавляет в ведро Amazon S3.

(строка)

Warnings -> (список)

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

Использование ресурсов в одном регионе, таких как ваши ведра Amazon S3, темы уведомлений Amazon SNS и ключ AWS KMS, сокращает время обработки и предотвращает региональные сборы.

(структура)

Code -> (строка)

Код предупреждения о межрегиональном различии.

Message -> (строка)

Сообщение, объясняющее, какие ресурсы находятся в другом регионе по сравнению с конвейерной линией.

Примечание

Ключи AWS KMS должны находиться в том же регионе, что и конвейерная линия.