Spec-Zone.ru › AWS CLI v2

[ 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_DEMAND
  • RESERVED

--reservation-plan-settings (структура) Сведения о ценовой модели вашей резервированной очереди. Требуется для резервированных очередей и не применяется к очередям по запросу.Commitment -> (строка)

Срок действия вашего обязательства по ценовой модели резервированной очереди.

RenewalType -> (строка)

Указывает, автоматически ли продлевается срок вашей резервированной ценовой модели очереди (AUTO_RENEW) или истекает (EXPIRE) по окончании срока. При автоматическом продлении вы продлеваете обязательство на 12 месяцев с даты автоматического продления. Вы можете отменить это обязательство.

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

Указывает количество резервированных слотов для транскодирования (RTS) в этой очереди. Количество RTS определяет, сколько задач очередь может обрабатывать параллельно; каждый RTS может обрабатывать одну задачу за раз. Вы не можете уменьшить количество RTS в вашей резервированной очереди. Вы можете увеличить количество RTS, продлив существующее обязательство новым обязательством на 12 месяцев для большего числа. Новое обязательство вступает в силу при покупке дополнительной емкости. Вы не можете отменить свое обязательство или вернуться к первоначальному обязательству после увеличения емкости.

Сокращенная синтаксическая форма:

Commitment=string,RenewalType=string,ReservedSlots=integer

Синтаксис JSON:

{
  "Commitment": "ONE_YEAR",
  "RenewalType": "AUTO_RENEW"|"EXPIRE",
  "ReservedSlots": integer
}

--status (строка) Начальное состояние очереди. Если вы создаете приостановленную очередь, задачи в этой очереди не будут запускаться.

Возможные значения:

  • ACTIVE
  • PAUSED

--tags (массив) Теги, которые вы хотите добавить к ресурсу. Вы можете помечать ресурсы парой ключ-значение или только ключом.key -> (строка)

value -> (строка)

Сокращенная синтаксическая форма:

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

Идентификатор этого ресурса, уникальный в рамках всей AWS.

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

Максимальное количество задач, которые ваша очередь может обрабатывать одновременно.

CreatedAt -> (метка времени)

Метка времени в секундах с момента создания очереди.

Description -> (строка)

Необязательное описание, которое вы создаете для каждой очереди.

LastUpdated -> (метка времени)

Метка времени в секундах с момента последнего обновления очереди.

Name -> (строка)

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

PricingPlan -> (строка)

Указывает, является ли тарифный план очереди по требованию или резервированным. При оплате по требованию вы платите за каждую минуту, со счетом в increments по 0,01 минуты. При резервировании вы оплачиваете транскодировочную емкость всей очереди независимо от того, сколько или как мало вы ее используете. Резервирование требует обязательства на 12 месяцев.

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

Приблизительное количество задач со статусом PROGRESSING.

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

Подробная информация о тарифном плане вашей резервированной очереди. Необходимо для резервированных очередей и не применимо к очередям по требованию.

Commitment -> (строка)

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

ExpiresAt -> (метка времени)

Метка времени в секундах, когда истекает текущий срок тарифного плана для этой резервированной очереди.

PurchasedAt -> (метка времени)

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

RenewalType -> (строка)

Указывает, продлевается ли срок вашего тарифного плана для резервированной очереди автоматически (AUTO_RENEW) или истекает (EXPIRE) в конце срока.

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

Указывает количество зарезервированных слотов транскодирования (RTS) для этой очереди. Количество RTS определяет, сколько задач может обрабатывать очередь параллельно; каждый RTS может обрабатывать одну задачу за раз. При увеличении этого числа вы продлеваете существующее обязательство новым 12-месячным обязательством для большего количества RTS. Новое обязательство начинается с покупки дополнительной емкости. Вы не можете уменьшить количество RTS в своей резервированной очереди.

Status -> (строка)

Указывает, является ли тарифный план вашей резервированной очереди АКТИВНЫМ или ИСТЕКШИМ.

ServiceOverrides -> (список)

Список любых переопределений служб, примененных MediaConvert к настройкам, которые вы настроили. Если вы видите какие-либо переопределения, мы рекомендуем обратиться в поддержку AWS.

(структура)

Переопределение службы, применённое MediaConvert к настройкам, которые вы настроили. Если вы видите какие-либо переопределения, мы рекомендуем обратиться в поддержку AWS.

Message -> (строка)

Подробности о переопределении службы, применённом MediaConvert.

Name -> (строка)

Имя настройки, к которой MediaConvert применил переопределение.

OverrideValue -> (строка)

Текущее значение переопределения службы, примененного MediaConvert.

Value -> (строка)

Значение настройки, которое вы настроили до любых переопределений, применённых MediaConvert.

Status -> (строка)

Очереди могут быть АКТИВНЫ или ПРИОСТАНОВЛЕНЫ. Если вы приостанавливаете очередь, служба не будет запускать обработку задач в этой очереди. Задачи, которые выполняются во время приостановки очереди, продолжают выполняться до завершения или возникновения ошибки.

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

Приблизительное количество задач со статусом SUBMITTED.

Type -> (строка)

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

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API