describe-reserved-cache-nodes

Описание

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

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

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

Синтаксис

  describe-reserved-cache-nodes
[--reserved-cache-node-id <value>]
[--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-node-id (строка)

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

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

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

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

Для описания зарезервированных узлов кэша

Следующий describe-reserved-cache-nodes пример возвращает информацию о зарезервированных узлах кэша для этой учетной записи или о заданном зарезервированном узле кэша.

aws elasticache describe-reserved-cache-nodes

Вывод:

{
    "ReservedCacheNodes": [
        {
            "ReservedCacheNodeId": "mynode",
            "ReservedCacheNodesOfferingId": "xxxxxxxxx-xxxxx-xxxxx-xxxx-xxxxxxxx71",
            "CacheNodeType": "cache.t3.small",
            "StartTime": "2019-12-06T02:50:44.003Z",
            "Duration": 31536000,
            "FixedPrice": 0.0,
            "UsagePrice": 0.0,
            "CacheNodeCount": 1,
            "ProductDescription": "redis",
            "OfferingType": "No Upfront",
            "State": "payment-pending",
            "RecurringCharges": [
                {
                    "RecurringChargeAmount": 0.023,
                    "RecurringChargeFrequency": "Hourly"
                }
            ],
            "ReservationARN": "arn:aws:elasticache:us-west-2:xxxxxxxxxxxx52:reserved-instance:mynode"
        }
    ]
}

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

Вывод

Marker -> (string)

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

ReservedCacheNodes -> (list)

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

(структура)

Представляет вывод операции PurchaseReservedCacheNodesOffering.

ReservedCacheNodeId -> (string)

Уникальный идентификатор бронирования.

ReservedCacheNodesOfferingId -> (string)

Идентификатор предложения.

CacheNodeType -> (string)

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

Следующие типы узлов поддерживаются 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 и выше.

StartTime -> (timestamp)

Время начала бронирования.

Duration -> (integer)

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

FixedPrice -> (double)

Фиксированная цена за этот зарезервированный узел кэша.

UsagePrice -> (double)

Часовая цена за этот зарезервированный узел кэша.

CacheNodeCount -> (integer)

Количество зарезервированных узлов кэша.

ProductDescription -> (string)

Описание зарезервированного узла кэша.

OfferingType -> (string)

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

State -> (string)

Состояние зарезервированного узла кэша.

RecurringCharges -> (list)

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

(структура)

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

RecurringChargeAmount -> (double)

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

RecurringChargeFrequency -> (string)

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

ReservationARN -> (string)

Amazon Resource Name (ARN) зарезервированного узла кэша.

Пример: arn:aws:elasticache:us-east-1:123456789012:reserved-instance:ri-2017-03-27-08-33-25-582

END_OF_DOCUMENT_MARKER