create-pipeline

Описание

Операция CreatePipeline создаёт конвейер с заданными вами настройками.

См. также: AWS API Documentation

Синтаксис

  create-pipeline
--name <value>
--input-bucket <value>
[--output-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]

Параметры

--name (строка)

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

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

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

Ведро Amazon S3, в котором сохранены медиафайлы, которые вы хотите транскодировать.

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

Ведро Amazon S3, в которое Elastic Transcoder должен сохранить транскодированные файлы. (Используйте это или ContentConfig:Bucket плюс ThumbnailConfig:Bucket.)

Укажите это значение, если все перечисленные ниже условия выполняются:

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

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

Когда Elastic Transcoder сохраняет файлы в OutputBucket , он предоставляет полный контроль над файлами только учётной записи AWS, владеющей ролью, указанной в Role .

Вы хотите ассоциировать транскодированные файлы и миниатюры с хранилищем Amazon S3 Standard.

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

--role (строка)

IAM Amazon Resource Name (ARN) роли, которую вы хотите использовать 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 (структура)

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

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

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

Progressing : ARN темы Amazon Simple Notification Service (Amazon SNS), которую вы хотите уведомить, когда Elastic Transcoder начнёт обработку задания в этом конвейере. Это ARN, возвращённый Amazon SNS при создании темы. Для получения дополнительной информации см. Create a Topic в руководстве Amazon Simple Notification Service Developer Guide.
Complete : ARN темы Amazon SNS, которую вы хотите уведомить, когда Elastic Transcoder завершит обработку задания в этом конвейере. Это ARN, возвращённый Amazon SNS при создании темы.
Warning : ARN темы Amazon SNS, которую вы хотите уведомить, когда Elastic Transcoder столкнётся с предупреждением при обработке задания в этом конвейере. Это ARN, возвращённый Amazon SNS при создании темы.
Error : ARN темы Amazon SNS, которую вы хотите уведомить, когда Elastic Transcoder столкнётся с ошибкой при обработке задания в этом конвейере. Это ARN, возвращённый Amazon SNS при создании темы.

Progressing -> (строка)

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

Completed -> (строка)

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

Warning -> (строка)

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

Error -> (строка)

Тема 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.

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", ...]
    }
    ...
  ]
}

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

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

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

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

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

Канонический идентификатор пользователя отличается от номера AWS-аккаунта.
- Email : Значение в объекте Grantee - это зарегистрированный адрес электронной почты AWS-аккаунта.
- Group : Значение в объекте Grantee - это одна из следующих предопределённых групп Amazon S3: AllUsers, AuthenticatedUsers или LogDelivery.
Grantee : AWS-пользователь или группа, которому вы хотите предоставить доступ к файлам миниатюр. Для идентификации пользователя или группы можно указать канонический идентификатор пользователя для AWS-аккаунта, идентификатор доступа к источнику для распределения CloudFront, зарегистрированный адрес электронной почты AWS-аккаунта или предопределённую группу Amazon S3.
Access : Разрешение, которое вы хотите предоставить 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-ведре.

Bucket -> (строка)

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

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

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

Следующий create-pipeline пример создаёт пайплайн для ElasticTranscoder.

aws elastictranscoder create-pipeline \
    --name Default \
    --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": "salesoffice.example.com-public-promos",
            "StorageClass": "Standard",
            "Permissions": [
                {
                    "Access": [
                        "FullControl"
                    ],
                    "Grantee": "marketing-promos@example.com",
                    "GranteeType": "Email"
                }
            ]
        },
        "Name": "Default",
        "ThumbnailConfig": {
            "Bucket": "salesoffice.example.com-public-promos-thumbnails",
            "StorageClass": "ReducedRedundancy",
            "Permissions": [
                {
                    "Access": [
                        "FullControl"
                    ],
                    "Grantee": "marketing-promos@example.com",
                    "GranteeType": "Email"
                }
            ]
        },
        "Notifications": {
            "Completed": "",
            "Warning": "",
            "Progressing": "",
            "Error": "arn:aws:sns:us-east-1:123456789012:ETS_Errors"
        },
        "Role": "arn:aws:iam::123456789012:role/Elastic_Transcoder_Default_Role",
        "InputBucket": "salesoffice.example.com-source",
        "Id": "1533765810590-example",
        "Arn": "arn:aws:elastictranscoder:us-west-2:123456789012:pipeline/1533765810590-example"
    },
    "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"
        }
    ]
}

Вывод

Пайплайн -> (структура)

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

Id -> (строка)

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

Arn -> (строка)

Amazon Resource Name (ARN) для пайплайна.

Name -> (строка)

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

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

Status -> (строка)

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

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

InputBucket -> (строка)

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

OutputBucket -> (строка)

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

Role -> (строка)

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.

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

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

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

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

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

Progressing -> (строка)

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

Completed -> (строка)

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

Warning -> (строка)

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

Error -> (строка)

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

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

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

Bucket : Amazon S3-ведро, в которое вы хотите, чтобы Elastic Transcoder сохранил транскодированные файлы и плейлисты.
Permissions : Список пользователей и/или предопределенных групп 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 : Уполномоченное лицо может читать разрешения доступа к объекту для объектов, которые Elastic Transcoder добавляет в Amazon S3-ведро.
  - WRITE_ACP : Уполномоченное лицо может записывать разрешения доступа для объектов, которые 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 -> (строка)

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 : Уполномоченное лицо может читать разрешения доступа к объекту для миниатюр, которые Elastic Transcoder добавляет в Amazon S3-ведро.
WRITE_ACP : Уполномоченное лицо может записывать разрешения доступа для миниатюр, которые 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 должны находиться в той же области, что и конвейерная линия.

END_OF_DOCUMENT_MARKER