Spec-Zone.ru › AWS CLI v2

[ aws . mediaconvert ]

update-queue

Описание

Изменить одну из ваших существующих очередей.

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

Синтаксис

  update-queue
[--concurrent-jobs <value>]
[--description <value>]
--name <value>
[--reservation-plan-settings <value>]
[--status <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 (строка) Имя очереди, которую вы изменяете.

--reservation-plan-settings (структура) Новые подробности плана ценообразования для вашей резервируемой очереди. Когда вы настраиваете новый план ценообразования для замены истекшего, вы вступаете в другое 12-месячное обязательство. При увеличении емкости вашей очереди за счет увеличения количества RTS вы продлеваете срок своего обязательства на 12 месяцев с момента добавления емкости. После принятия этих обязательств, вы не можете их отменить. Обязательство -> (строка)

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

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

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

  • ACTIVE
  • PAUSED

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

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. Если предоставлено значение без значения или значение input, выводит пример JSON-ввода, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если предоставлено значение yaml-input, он выведет пример ввода YAML, который можно использовать с --cli-input-yaml. Если предоставлено значение output, он проверяет входные данные команды и возвращает пример выходного JSON для этой команды. Сгенерированный JSON-скелет нестабилен между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

Глобальные параметры

--debug (логическое значение)

Включить отладку логирования.

--endpoint-url (строка)

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

--no-verify-ssl (логическое значение)

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

--no-paginate (логическое значение)

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

--output (строка)

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

  • json
  • text
  • table
  • yaml
  • yaml-stream

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

  • on
  • off
  • auto

--no-sign-request (логическое значение)

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

--ca-bundle (строка)

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

--cli-read-timeout (целое число)

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

--cli-connect-timeout (целое число)

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

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию - base64. Формат base64 ожидает, что двоичные блоки будут предоставлены в виде закодированной строкой base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, отображающего двоичный блок, fileb:// всегда будет рассматриваться как двоичный и будет использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенного cli-binary-format.

  • base64
  • raw-in-base64-out

--no-cli-pager (логическое значение)

Отключить пейджер CLI для вывода.

--cli-auto-prompt (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

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

Примеры

Примечание

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

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

Изменение очереди

В следующем update-queue примере приостанавливается указанная очередь, изменив ее статус на PAUSED.

aws mediaconvert update-queue \
--name Customer1 \
--status PAUSED
--endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com

Вывод:

{
    "Queue": {
        "LastUpdated": 1568839845,
        "Status": "PAUSED",
        "ProgressingJobsCount": 0,
        "CreatedAt": 1526428516,
        "Arn": "arn:aws:mediaconvert:us-west-1:123456789012:queues/Customer1",
        "Name": "Customer1",
        "SubmittedJobsCount": 0,
        "PricingPlan": "ON_DEMAND",
        "Type": "CUSTOM"
    }
}

Дополнительную информацию см. в разделе Работа с очередями 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 of .01 минуты. Для резервируемого, вы платите за транскодировочную емкость всей очереди, независимо от того, насколько много или мало вы ее используете. Резервируемая цена требует обязательства на 12 месяцев.

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

Оцененное количество задач со статусом PROGRESSING.

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

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

Commitment -> (строка)

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

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

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

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

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

RenewalType -> (строка)

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

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

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

Status -> (строка)

Указывает, является ли тарифный план вашей резервируемой очереди ACTIVE или EXPIRED.

ServiceOverrides -> (список)

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

(структура)

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

Message -> (строка)

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

Name -> (строка)

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

OverrideValue -> (строка)

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

Value -> (строка)

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

Status -> (строка)

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

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

Оцененное количество задач со статусом SUBMITTED.

Type -> (строка)

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

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

Spec-Zone.ru

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