describe-reserved-instances-listings
Описание
Описывает список резервированных экземпляров вашей учетной записи в Marketplace резервированных экземпляров.
Marketplace резервированных экземпляров связывает продавцов, желающих перепродать резервированные емкости экземпляров, которые им больше не нужны, с покупателями, желающими приобрести дополнительную емкость. Резервированные экземпляры, купленные и проданные через Marketplace резервированных экземпляров, работают как любые другие резервированные экземпляры.
В качестве продавца вы выбираете, какие резервированные экземпляры включить в список, и устанавливаете начальную цену для их продажи. Ваши резервированные экземпляры будут размещены в Marketplace резервированных экземпляров и станут доступны для покупки.
В качестве покупателя вы указываете конфигурацию резервированного экземпляра, который хотите приобрести, и Marketplace подбирает то, что вы ищете, с тем, что доступно. Marketplace сначала продаёт вам резервированные экземпляры по самой низкой цене и продолжает продавать доступные списки резервированных экземпляров, пока ваш спрос не будет удовлетворен. Вам взимается плата на основании общей цены всех списков, которые вы приобретаете.
Для получения дополнительной информации, см. раздел Продажа в Marketplace резервированных экземпляров в руководстве пользователя Amazon EC2.
Примечание
Порядок элементов в ответе, включая вложенные структуры, может отличаться. Приложения не должны предполагать какой-либо определённый порядок элементов.См. также: Документация API AWS
Синопсис
describe-reserved-instances-listings
[--reserved-instances-id <value>]
[--reserved-instances-listing-id <value>]
[--filters <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]
Параметры
--reserved-instances-id (строка)
--reserved-instances-listing-id (строка)
--filters (список)
Один или несколько фильтров.
-
reserved-instances-id- Идентификатор резервированных экземпляров. -
reserved-instances-listing-id- Идентификатор списка резервированных экземпляров. -
status- Состояние списка резервированных экземпляров (pending|active|cancelled|closed). -
status-message- Причина состояния.
(структура)
Пара имя-значение фильтра, используемая для возвращения более конкретного списка результатов из операции describe. Фильтры могут использоваться для сопоставления набора ресурсов по определённым критериям, таким как теги, атрибуты или идентификаторы.
Если вы указываете несколько фильтров, фильтры объединяются с помощью AND , и запрос возвращает только результаты, которые соответствуют всем указанным фильтрам.
Для получения дополнительной информации, см. Список и фильтрацию с помощью командной строки и API в руководстве пользователя Amazon EC2.
Имя -> (строка)
Значения -> (список)
Значения фильтра. Значения фильтров чувствительны к регистру. Если вы указываете несколько значений для фильтра, значения объединяются с помощью OR , и запрос возвращает все результаты, которые соответствуют любому из указанных значений.
(строка)
Сокращенная синтаксис:
Name=string,Values=string,string ...
Синтаксис JSON:
[
{
"Name": "string",
"Values": ["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
- таблица
- 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-auto-prompt (логическое значение)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматическую запрос параметров ввода CLI.
Примеры
Примечание
Чтобы использовать следующие примеры, вы должны установить и настроить AWS CLI. См. руководство по началу работы в руководстве пользователя AWS CLI для получения дополнительной информации.
Если не указано иное, все примеры используют правила цитирования Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной оболочки. См. Использование кавычек со строками в руководстве пользователя AWS CLI.
Для описания списка резервированных экземпляров
Следующий пример describe-reserved-instances-listings извлекает информацию о указанном списке резервированных экземпляров.
aws ec2 describe-reserved-instances-listings \
--reserved-instances-listing-id 5ec28771-05ff-4b9b-aa31-9e57dexample
Эта команда не выводит никаких данных.
Вывод
ReservedInstancesListings -> (список)
Информация о списке резервированных экземпляров.
(структура)
Описание списка резервированных экземпляров.
ClientToken -> (строка)
CreateDate -> (метка времени)
InstanceCounts -> (список)
Количество экземпляров в данном состоянии.
(структура)
Описание состояния списка резервированных экземпляров.
InstanceCount -> (целое число)
state.State -> (строка)
PriceSchedules -> (список)
Цена списка резервированных экземпляров.
(структура)
Описание цены резервированного экземпляра.
Active -> (логическое значение)
Текущее расписание цен, как определяется оставшимся сроком действия резервированного экземпляра в списке.
Специфическое расписание цен всегда действует, но только одно расписание может быть активным в любое время. Например, для списка резервированных экземпляров, срок действия которого составляет пять месяцев. Когда вы указываете расписание цен на пять месяцев и два месяца, это означает, что расписание 1, охватывающее первые три месяца оставшегося срока, будет активным в месяцах 5, 4 и 3. Затем расписание 2, охватывающее последние два месяца срока действия, будет активным в месяцах 2 и 1.
CurrencyCode -> (строка)
USD.Price -> (двойное значение)
Term -> (целое число)
ReservedInstancesId -> (строка)
ReservedInstancesListingId -> (строка)
Status -> (строка)
StatusMessage -> (строка)
Tags -> (список)
Любые теги, назначенные ресурсу.
(структура)
Описание тега.
Key -> (строка)
Ключ тега.
Ограничения: Ключи тегов чувствительны к регистру и принимают максимум 127 символов Unicode. Не должно начинаться с aws:.
Value -> (строка)
Значение тега.
Ограничения: Значения тегов чувствительны к регистру и принимают максимум 256 символов Unicode.
UpdateDate -> (метка времени)
© Copyright 2025, Amazon Web Services. Created using Sphinx.