[ aws . mediaconvert ]
create-queue
Описание
Создает новую очередь для транскодирования. Сведения об очередях см. в руководстве пользователя в разделе «Работа с очередями» по адресу https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html
См. также: Документацию API AWS
Синтаксис
create-queue
[--concurrent-jobs <value>]
[--description <value>]
--name <value>
[--pricing-plan <value>]
[--reservation-plan-settings <value>]
[--status <value>]
[--tags <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]
Параметры
--concurrent-jobs (целое число) Укажите максимальное количество задач, которые ваша очередь может обрабатывать одновременно. Для очередей по запросу вводимое значение ограничено вашими квотами сервиса для Максимального количества одновременных задач на очередь по запросу и Максимального количества одновременных задач на аккаунт. Для резервированных очередей укажите количество задач, которые можно обрабатывать одновременно в вашем резервированном плане.
--description (строка) Необязательно. Описание очереди, которую вы создаете.
--name (строка) Название очереди, которую вы создаете.
--pricing-plan (строка) Указывает, является ли ценовая модель очереди по запросу или резервированной. Для по запросу — оплата за минуту с начислением в increments of .01 минуты. Для резервированной — оплата за транскодировочную емкость всей очереди независимо от того, сколько или как мало вы ее используете. Для резервированного ценообразования требуется обязательство на 12 месяцев. При создании очереди через API по умолчанию используется модель по запросу.
Возможные значения:
ON_DEMANDRESERVED
--reservation-plan-settings (структура) Сведения о ценовой модели вашей резервированной очереди. Требуется для резервированных очередей и не применяется к очередям по запросу.Commitment -> (строка)
RenewalType -> (строка)
ReservedSlots -> (целое число)
Сокращенная синтаксическая форма:
Commitment=string,RenewalType=string,ReservedSlots=integer
Синтаксис JSON:
{
"Commitment": "ONE_YEAR",
"RenewalType": "AUTO_RENEW"|"EXPIRE",
"ReservedSlots": integer
}
--status (строка) Начальное состояние очереди. Если вы создаете приостановленную очередь, задачи в этой очереди не будут запускаться.
Возможные значения:
ACTIVEPAUSED
--tags (массив) Теги, которые вы хотите добавить к ресурсу. Вы можете помечать ресурсы парой ключ-значение или только ключом.key -> (строка)
Сокращенная синтаксическая форма:
KeyName1=string,KeyName2=string
Синтаксис JSON:
{"string": "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 (логическое значение)
Включить отладочную запись журнала.
--endpoint-url (строка)
Переопределить URL по умолчанию команды указанным URL.
--no-verify-ssl (логическое значение)
По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого подключения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет стандартное поведение проверки сертификатов SSL.
--no-paginate (логическое значение)
Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (строка)
Стиль форматирования для вывода команды.
- json
- text
- table
- yaml
- yaml-stream
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использовать определенный профиль из вашего файла учетных данных.
--region (строка)
Используемый регион. Переопределяет настройки конфигурации/среды.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/отключить цветной вывод.
- on
- off
- auto
--no-sign-request (логическое значение)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент указан.
--ca-bundle (строка)
Файл с набором сертификатов CA для проверки сертификатов SSL. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (целое число)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.
--cli-connect-timeout (целое число)
Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.
--cli-binary-format (строка)
Стиль форматирования, используемый для двоичных блоков. По умолчанию используется формат base64. Формат base64 ожидает, что двоичные блоки будут предоставлены в виде строки, закодированной в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, которое соответствует двоичному блоку, fileb:// всегда будет обрабатываться как двоичное и использовать содержимое файла напрямую независимо от cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (логическое значение)
Отключить тулбар для вывода.
--cli-auto-prompt (логическое значение)
Автоматически запрашивать параметры входных данных CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматическую запрос параметров входных данных CLI.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительная информация приведена в руководстве по началу работы с AWS CLI в руководстве пользователя AWS CLI.
Если не указано иное, все примеры имеют правила цитирования, аналогичные правилам Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей консоли. Смотрите раздел «Использование кавычек со строками» в руководстве пользователя AWS CLI.
Для создания пользовательской очереди
Следующий create-queue пример создает пользовательскую очередь для транскодирования.
aws mediaconvert create-queue \
--endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \
--region region-name-1 \
--name Queue1 \
--description "Keep this queue empty unless job is urgent."
Чтобы получить специфичный для вашей учетной записи конечный пункт, используйте describe-endpoints, или отправьте команду без конечного пункта. Сервис возвращает ошибку и ваш конечный пункт.
Вывод:
{
"Queue": {
"Status": "ACTIVE",
"Name": "Queue1",
"LastUpdated": 1518034928,
"Arn": "arn:aws:mediaconvert:region-name-1:012345678998:queues/Queue1",
"Type": "CUSTOM",
"CreatedAt": 1518034928,
"Description": "Keep this queue empty unless job is urgent."
}
}
Дополнительную информацию см. в разделе «Работа с очередями AWS Elemental MediaConvert» в руководстве пользователя AWS Elemental MediaConvert.
Вывод
Очередь -> (структура)
Вы можете использовать очереди для управления ресурсами, доступными вашей учетной записи AWS для одновременного выполнения нескольких задач транскодирования. Если вы не укажете очередь, служба отправит все задачи в стандартную очередь. Дополнительную информацию см. на странице https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html.
Arn -> (строка)
ConcurrentJobs -> (целое число)
CreatedAt -> (метка времени)
Description -> (строка)
LastUpdated -> (метка времени)
Name -> (строка)
PricingPlan -> (строка)
ProgressingJobsCount -> (целое число)
ReservationPlan -> (структура)
Подробная информация о тарифном плане вашей резервированной очереди. Необходимо для резервированных очередей и не применимо к очередям по требованию.
Commitment -> (строка)
ExpiresAt -> (метка времени)
PurchasedAt -> (метка времени)
RenewalType -> (строка)
ReservedSlots -> (целое число)
Status -> (строка)
ServiceOverrides -> (список)
Список любых переопределений служб, примененных MediaConvert к настройкам, которые вы настроили. Если вы видите какие-либо переопределения, мы рекомендуем обратиться в поддержку AWS.
(структура)
Переопределение службы, применённое MediaConvert к настройкам, которые вы настроили. Если вы видите какие-либо переопределения, мы рекомендуем обратиться в поддержку AWS.
Message -> (строка)
Name -> (строка)
OverrideValue -> (строка)
Value -> (строка)
Status -> (строка)
SubmittedJobsCount -> (целое число)
Type -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.