Spec-Zone.ru › AWS CLI v2

[ aws . mediaconnect ]

list-reservations

Описание

Отображает список всех резерваций, приобретённых этой учётной записью в текущем регионе Amazon Web Services. Этот список включает все резервации во всех состояниях (например, активные и истекшие).

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

list-reservations — это постраничная операция. Для получения всего набора результатов могут быть выполнены несколько вызовов API. Вы можете отключить постраничность, предоставив аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничностью аргумент --query должен извлекать данные из результатов следующих выражений запроса: Reservations

Синтаксис

  list-reservations
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--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]

Параметры

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

--starting-token (строка)

Токен для указания места начала постраничного отображения. Это NextToken из ранее усечённого ответа.

Примеры использования см. в разделе Постраничная обработка в Руководстве пользователя AWS Command Line Interface.

--page-size (целое число)

Размер каждой страницы для получения в вызове AWS-сервиса. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, получая меньше элементов в каждом вызове. Это может помочь предотвратить таймаут вызовов AWS-сервиса.

Примеры использования см. в разделе Постраничная обработка в Руководстве пользователя AWS Command Line Interface.

--max-items (целое число)

Общее количество элементов для возврата в выводе команды. Если общее количество доступных элементов превышает указанное значение, в выводе команды предоставляется NextToken. Чтобы продолжить постраничность, укажите значение NextToken в аргументе starting-token последующей команды. Не используйте элемент ответа NextToken напрямую вне AWS CLI.

Примеры использования см. в разделе Постраничная обработка в Руководстве пользователя AWS Command Line Interface.

--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
  • таблица
  • yaml
  • yaml-поток

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

  • включено
  • выключено
  • авто

--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.

Вывод

NextToken -> (строка)

Токен, определяющий пакет результатов, который вы хотите увидеть.

Например, вы отправляете запрос ListReservations со значением MaxResults, установленным в 5. Сервис возвращает первый пакет результатов (до 5) и значение NextToken. Чтобы увидеть следующий пакет результатов, вы можете повторно отправить запрос ListReservations и указать значение NextToken.

Reservations -> (список)

Список всех резерваций, приобретённых этой учётной записью в текущем регионе Amazon Web Services.

(структура)

Договор ценообразования по сниженной цене за определённую пропускную способность исходящего трафика, которую ваша учётная запись MediaConnect будет использовать каждый месяц в течение определённого периода времени. Сниженная цена резервации применяется к пропускной способности исходящего трафика для всех потоков вашей учётной записи до тех пор, пока ваша учётная запись не достигнет объёма пропускной способности в вашей резервации. Если вы используете больше пропускной способности исходящего трафика, чем согласованное количество в один месяц, избыток взимается по тарифу на запросы.

CurrencyCode -> (строка)

Тип валюты, используемой для выставления счёта. Валюта, используемая для вашей резервации, — американские доллары.

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

Продолжительность действия этой резервации. MediaConnect определяет это значение в предложении.

DurationUnits -> (строка)

Единица измерения продолжительности резервации. MediaConnect определяет это значение в предложении.

End -> (строка)

Дата и время истечения срока действия этой резервации. Это значение рассчитывается на основе даты и времени начала, которые вы задали, и продолжительности предложения.

OfferingArn -> (строка)

Amazon Resource Name (ARN), присвоенный MediaConnect предложению.

OfferingDescription -> (строка)

Описание предложения. MediaConnect определяет это значение в предложении.

PricePerUnit -> (строка)

Стоимость единицы. Это значение в сочетании с priceUnits образует ставку. MediaConnect определяет это значение в предложении.

PriceUnits -> (строка)

Единица измерения, используемая для выставления счёта. Это значение в сочетании с pricePerUnit образует ставку. MediaConnect определяет это значение в предложении.

ReservationArn -> (строка)

Amazon Resource Name (ARN), который MediaConnect присваивает резервации при покупке предложения.

ReservationName -> (строка)

Имя, которое вы присвоили резервации при покупке предложения.

ReservationState -> (строка)

Статус вашей резервации.

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

Описание количества пропускной способности исходящего трафика, которую вы будете резервировать, если купите предложение. MediaConnect определяет значения, составляющие resourceSpecification, в предложении.

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

Количество пропускной способности исходящего трафика, которое снижается в предложении.

ResourceType -> (строка)

Тип ресурса и единица, за которую взимается плата.

Start -> (строка)

Дата и время, когда резервация начнёт действовать. Вы задаёте это значение при покупке предложения.

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

Spec-Zone.ru

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