describe-reserved-cache-nodes-offerings

Описание

Выводит список доступных предложений по зарезервированным узлам кэша.

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

describe-reserved-cache-nodes-offerings является постраничной операцией. Для получения всего набора результатов могут быть выполнены несколько вызовов API. Вы можете отключить постраничный вывод, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничной обработкой, аргумент --query должен извлечь данные из результатов следующих выражений запроса: ReservedCacheNodesOfferings

Синтаксис

  describe-reserved-cache-nodes-offerings
[--reserved-cache-nodes-offering-id <value>]
[--cache-node-type <value>]
[--duration <value>]
[--product-description <value>]
[--offering-type <value>]
[--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]

Параметры

--reserved-cache-nodes-offering-id (строка)

Значение фильтра по идентификатору предложения. Используйте этот параметр, чтобы отобразить только доступные предложения, соответствующие указанному идентификатору резервации.

Пример: 438012d3-4052-4cc7-b2e3-8d3372e0e706

--cache-node-type (строка)

Значение фильтра по типу узла кэша. Используйте этот параметр, чтобы отобразить только доступные предложения, соответствующие указанному типу узла кэша.

ElastiCache поддерживает следующие типы узлов. Как правило, типы текущего поколения предоставляют больше памяти и вычислительной мощности по более низкой цене по сравнению со своими аналогами предыдущего поколения.

Универсальные типы:
- Текущее поколение: Типы узлов M7g : cache.m7g.large , cache.m7g.xlarge , cache.m7g.2xlarge , cache.m7g.4xlarge , cache.m7g.8xlarge , cache.m7g.12xlarge , cache.m7g.16xlarge
Примечание

Доступность в регионах см. в разделе Поддерживаемые типы узлов

Типы узлов M6g (доступны только для версии Redis OSS движка 5.0.6 и более поздней, а также для версии движка Memcached 1.5.16 и более поздней): cache.m6g.large , cache.m6g.xlarge , cache.m6g.2xlarge , cache.m6g.4xlarge , cache.m6g.8xlarge , cache.m6g.12xlarge , cache.m6g.16xlarge Типы узлов M5: cache.m5.large , cache.m5.xlarge , cache.m5.2xlarge , cache.m5.4xlarge , cache.m5.12xlarge , cache.m5.24xlarge Типы узлов M4: cache.m4.large , cache.m4.xlarge , cache.m4.2xlarge , cache.m4.4xlarge , cache.m4.10xlarge Типы узлов T4g (доступны только для версии Redis OSS движка 5.0.6 и более поздней, а также для версии движка Memcached 1.5.16 и более поздней): cache.t4g.micro , cache.t4g.small , cache.t4g.medium Типы узлов T3: cache.t3.micro , cache.t3.small , cache.t3.medium Типы узлов T2: cache.t2.micro , cache.t2.small , cache.t2.medium
- Предыдущее поколение: (не рекомендуется. Существующие кластеры по-прежнему поддерживаются, но создание новых кластеров для этих типов не поддерживается.) Типы узлов T1: cache.t1.micro Типы узлов M1: cache.m1.small , cache.m1.medium , cache.m1.large , cache.m1.xlarge Типы узлов M3: cache.m3.medium , cache.m3.large , cache.m3.xlarge , cache.m3.2xlarge
Оптимизированные по вычислительной мощности:
- Предыдущее поколение: (не рекомендуется. Существующие кластеры по-прежнему поддерживаются, но создание новых кластеров для этих типов не поддерживается.) Типы узлов C1: cache.c1.xlarge
Оптимизированные по памяти:
- Текущее поколение: Типы узлов R7g : cache.r7g.large , cache.r7g.xlarge , cache.r7g.2xlarge , cache.r7g.4xlarge , cache.r7g.8xlarge , cache.r7g.12xlarge , cache.r7g.16xlarge
Примечание

Доступность в регионах см. в разделе Поддерживаемые типы узлов

Типы узлов R6g (доступны только для версии Redis OSS движка 5.0.6 и более поздней, а также для версии движка Memcached 1.5.16 и более поздней): cache.r6g.large , cache.r6g.xlarge , cache.r6g.2xlarge , cache.r6g.4xlarge , cache.r6g.8xlarge , cache.r6g.12xlarge , cache.r6g.16xlarge Типы узлов R5: cache.r5.large , cache.r5.xlarge , cache.r5.2xlarge , cache.r5.4xlarge , cache.r5.12xlarge , cache.r5.24xlarge Типы узлов R4: cache.r4.large , cache.r4.xlarge , cache.r4.2xlarge , cache.r4.4xlarge , cache.r4.8xlarge , cache.r4.16xlarge
- Предыдущее поколение: (не рекомендуется. Существующие кластеры по-прежнему поддерживаются, но создание новых кластеров для этих типов не поддерживается.) Типы узлов M2: cache.m2.xlarge , cache.m2.2xlarge , cache.m2.4xlarge Типы узлов R3: cache.r3.large , cache.r3.xlarge , cache.r3.2xlarge , cache.r3.4xlarge , cache.r3.8xlarge

Дополнительная информация о типах узлов

Все типы экземпляров текущего поколения по умолчанию создаются в Amazon VPC.
Файлы Valkey или Redis OSS append-only (AOF) не поддерживаются для экземпляров T1 или T2.
Valkey или Redis OSS Multi-AZ с автоматическим переключением не поддерживаются для экземпляров T1.
Переменные конфигурации appendonly и appendfsync не поддерживаются для Valkey или для Redis OSS версии 2.8.22 и более поздних.

--duration (строка)

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

Допустимые значения: 1 | 3 | 31536000 | 94608000

--product-description (строка)

Значение фильтра по описанию продукта. Используйте этот параметр, чтобы отобразить только доступные предложения, соответствующие указанному описанию продукта.

--offering-type (строка)

Значение фильтра по типу предложения. Используйте этот параметр, чтобы отобразить только доступные предложения, соответствующие указанному типу предложения.

--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 (boolean)

Включить отладовую запись в журнал.

--endpoint-url (string)

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

--no-verify-ssl (boolean)

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

--no-paginate (boolean)

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

--output (string)

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

json
text
table
yaml
yaml-stream

--query (string)

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

--profile (string)

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

--region (string)

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

--version (string)

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

--color (string)

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

on
off
auto

--no-sign-request (boolean)

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

--ca-bundle (string)

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

--cli-read-timeout (int)

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

--cli-connect-timeout (int)

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

--cli-binary-format (string)

Стиль форматирования, используемый для бинарных блоков. Формат по умолчанию — 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 (boolean)

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

--cli-auto-prompt (boolean)

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

--no-cli-auto-prompt (boolean)

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

Примеры

Примечание

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

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

Для описания reserved-cache-nodes-offerings

Следующий describe-reserved-cache-nodes-offerings пример возвращает детали предложений по резервированию узлов кэширования.

aws elasticache describe-reserved-cache-nodes-offerings

Вывод:

{
    "ReservedCacheNodesOfferings": [
        {
            "ReservedCacheNodesOfferingId": "01ce0a19-a476-41cb-8aee-48eacbcdc8e5",
            "CacheNodeType": "cache.t3.small",
            "Duration": 31536000,
            "FixedPrice": 97.0,
            "UsagePrice": 0.0,
            "ProductDescription": "memcached",
            "OfferingType": "Partial Upfront",
            "RecurringCharges": [
                {
                    "RecurringChargeAmount": 0.011,
                    "RecurringChargeFrequency": "Hourly"
                }
            ]
        },
        {
            "ReservedCacheNodesOfferingId": "0443a27b-4da5-4b90-b92d-929fbd7abed2",
            "CacheNodeType": "cache.m3.2xlarge",
            "Duration": 31536000,
            "FixedPrice": 1772.0,
            "UsagePrice": 0.0,
            "ProductDescription": "redis",
            "OfferingType": "Heavy Utilization",
            "RecurringCharges": [
                {
                    "RecurringChargeAmount": 0.25,
                    "RecurringChargeFrequency": "Hourly"
                }
            ]
        },

        ...

    ]
}

Для получения дополнительной информации см. Получение информации о предложениях по резервированию узлов кэширования в Руководстве пользователя Elasticache Redis или Получение информации о предложениях по резервированию узлов кэширования в Руководстве пользователя Elasticache Memcached.

Вывод

Маркер -> (строка)

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

ReservedCacheNodesOfferings -> (список)

Список предложений по резервированию узлов кэширования. Каждый элемент списка содержит подробную информацию об одном предложении.

(структура)

Описывает все атрибуты предложения по резервированию узлов кэширования.

ReservedCacheNodesOfferingId -> (строка)

Уникальный идентификатор предложения по резервированию узлов кэширования.

CacheNodeType -> (строка)

Тип узла кэширования для узла резервирования кэширования.

Elasticache поддерживает следующие типы узлов. В общем случае, типы текущего поколения обеспечивают больший объем памяти и вычислительную мощность по более низкой цене по сравнению со своими аналогами предыдущего поколения.

Общие:
- Текущее поколение: типы узлов M7g : cache.m7g.large , cache.m7g.xlarge , cache.m7g.2xlarge , cache.m7g.4xlarge , cache.m7g.8xlarge , cache.m7g.12xlarge , cache.m7g.16xlarge
Примечание

Для доступности в регионах см. Поддерживаемые типы узлов

Типы узлов M6g (доступны только для версии Redis OSS движка 5.0.6 и выше и для версии движка Memcached 1.5.16 и выше): cache.m6g.large , cache.m6g.xlarge , cache.m6g.2xlarge , cache.m6g.4xlarge , cache.m6g.8xlarge , cache.m6g.12xlarge , cache.m6g.16xlarge Типы узлов M5: cache.m5.large , cache.m5.xlarge , cache.m5.2xlarge , cache.m5.4xlarge , cache.m5.12xlarge , cache.m5.24xlarge Типы узлов M4: cache.m4.large , cache.m4.xlarge , cache.m4.2xlarge , cache.m4.4xlarge , cache.m4.10xlarge Типы узлов T4g (доступны только для версии Redis OSS движка 5.0.6 и выше и для версии движка Memcached 1.5.16 и выше): cache.t4g.micro , cache.t4g.small , cache.t4g.medium Типы узлов T3: cache.t3.micro , cache.t3.small , cache.t3.medium Типы узлов T2: cache.t2.micro , cache.t2.small , cache.t2.medium
- Предыдущее поколение: (не рекомендуется. Существующие кластеры по-прежнему поддерживаются, но создание новых кластеров для этих типов не поддерживается.) Типы узлов T1: cache.t1.micro Типы узлов M1: cache.m1.small , cache.m1.medium , cache.m1.large , cache.m1.xlarge Типы узлов M3: cache.m3.medium , cache.m3.large , cache.m3.xlarge , cache.m3.2xlarge
Оптимизированные для вычислений:
- Предыдущее поколение: (не рекомендуется. Существующие кластеры по-прежнему поддерживаются, но создание новых кластеров для этих типов не поддерживается.) Типы узлов C1: cache.c1.xlarge
Оптимизированные для памяти:
- Текущее поколение: типы узлов R7g : cache.r7g.large , cache.r7g.xlarge , cache.r7g.2xlarge , cache.r7g.4xlarge , cache.r7g.8xlarge , cache.r7g.12xlarge , cache.r7g.16xlarge
Примечание

Для доступности в регионах см. Поддерживаемые типы узлов

Типы узлов R6g (доступны только для версии Redis OSS движка 5.0.6 и выше и для версии движка Memcached 1.5.16 и выше): cache.r6g.large , cache.r6g.xlarge , cache.r6g.2xlarge , cache.r6g.4xlarge , cache.r6g.8xlarge , cache.r6g.12xlarge , cache.r6g.16xlarge Типы узлов R5: cache.r5.large , cache.r5.xlarge , cache.r5.2xlarge , cache.r5.4xlarge , cache.r5.12xlarge , cache.r5.24xlarge Типы узлов R4: cache.r4.large , cache.r4.xlarge , cache.r4.2xlarge , cache.r4.4xlarge , cache.r4.8xlarge , cache.r4.16xlarge
- Предыдущее поколение: (не рекомендуется. Существующие кластеры по-прежнему поддерживаются, но создание новых кластеров для этих типов не поддерживается.) Типы узлов M2: cache.m2.xlarge , cache.m2.2xlarge , cache.m2.4xlarge Типы узлов R3: cache.r3.large , cache.r3.xlarge , cache.r3.2xlarge , cache.r3.4xlarge , cache.r3.8xlarge

Дополнительная информация о типах узлов

Все типы узлов текущего поколения создаются по умолчанию в Amazon VPC.
Файлы Valkey или Redis OSS append-only (AOF) не поддерживаются для экземпляров T1 или T2.
Valkey или Redis OSS Multi-AZ с автоматическим failover не поддерживаются на экземплярах T1.
Переменные конфигурации appendonly и appendfsync не поддерживаются для Valkey или для Redis OSS версии 2.8.22 и выше.

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

Длительность предложения в секундах.

FixedPrice -> (дробное число)

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

UsagePrice -> (дробное число)

Часовая цена, взимаемая за это предложение.

ProductDescription -> (строка)

Тип кэширующего движка, используемого предложением.

OfferingType -> (строка)

Тип предложения.

RecurringCharges -> (список)

Повторяющаяся цена, взимаемая за запуск этого резервированного узла кэширования.

(структура)

Содержит конкретную цену и частоту повторяющихся платежей за резервированный узел кэширования или предложение по резервированию узла кэширования.

RecurringChargeAmount -> (дробное число)

Денежная сумма повторяющегося платежа.

RecurringChargeFrequency -> (строка)

Частота повторяющегося платежа.

END_OF_DOCUMENT_MARKER