изменить-кластер-кэша

Описание

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

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

Синтаксис

  modify-cache-cluster
--cache-cluster-id <value>
[--num-cache-nodes <value>]
[--cache-node-ids-to-remove <value>]
[--az-mode <value>]
[--new-availability-zones <value>]
[--cache-security-group-names <value>]
[--security-group-ids <value>]
[--preferred-maintenance-window <value>]
[--notification-topic-arn <value>]
[--cache-parameter-group-name <value>]
[--notification-topic-status <value>]
[--apply-immediately | --no-apply-immediately]
[--engine <value>]
[--engine-version <value>]
[--auto-minor-version-upgrade | --no-auto-minor-version-upgrade]
[--snapshot-retention-limit <value>]
[--snapshot-window <value>]
[--cache-node-type <value>]
[--auth-token <value>]
[--auth-token-update-strategy <value>]
[--log-delivery-configurations <value>]
[--ip-discovery <value>]
[--scale-config <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]

Параметры

--cache-cluster-id (строка)

Идентификатор кластера. Это значение хранится как строка в нижнем регистре.

--num-cache-nodes (целое число)

Количество узлов кэша, которые должен иметь кластер. Если значение для NumCacheNodes больше суммы текущего количества узлов кэша и количества узлов кэша, ожидающих создания (что может быть нулём), добавляются дополнительные узлы. Если это значение меньше количества существующих узлов кэша, узлы удаляются. Если значение равно количеству текущих узлов кэша, все ожидающие запросы на добавление или удаление отменяются.

Если вы удаляете узлы кэша, вы должны использовать параметр CacheNodeIdsToRemove, чтобы указать идентификаторы конкретных узлов кэша для удаления.

Для кластеров, работающих с Valkey или Redis OSS, это значение должно быть 1. Для кластеров, работающих с Memcached, это значение должно быть от 1 до 40.

Примечание

Добавление или удаление узлов кэша Memcached может быть применено немедленно или как ожидаемое действие (см. ApplyImmediately).

Ожидаемое действие по изменению количества узлов кэша в кластере во время его окна обслуживания, будь то добавление или удаление узлов в соответствии с архитектурой масштабирования, не помещается в очередь. Последний запрос клиента на добавление или удаление узлов в кластер переопределяет все предыдущие ожидаемые действия по изменению количества узлов кэша в кластере. Например, запрос на удаление 2 узлов переопределит предыдущее ожидаемое действие на удаление 3 узлов. Аналогично, запрос на добавление 2 узлов переопределит предыдущее ожидаемое действие на удаление 3 узлов и наоборот. Поскольку узлы кэша Memcached теперь могут быть размещены в различных зонах доступности с гибким размещением узлов кэша, запрос на добавление узлов не автоматически переопределяет предыдущее ожидаемое действие по добавлению узлов. Клиент может изменить предыдущее ожидаемое действие на добавление дополнительных узлов или явно отменить ожидающий запрос и повторить новый запрос. Для отмены ожидающих действий по изменению количества узлов кэша в кластере используйте запрос ModifyCacheCluster и установите NumCacheNodes равным количеству узлов кэша в настоящее время в кластере.

--cache-node-ids-to-remove (список)

Список идентификаторов узлов кэша, которые необходимо удалить. Идентификатор узла — это числовой идентификатор (0001, 0002 и т. д.). Этот параметр действителен только тогда, когда NumCacheNodes меньше существующего количества узлов кэша. Количество идентификаторов узлов кэша, указанных в этом параметре, должно соответствовать разнице между существующим количеством узлов кэша в кластере или ожидающими узлами кэша, что больше, и значением NumCacheNodes в запросе.

Например: Если у вас есть 3 активных узла кэша, 7 ожидающих узлов кэша, и количество узлов кэша в этом вызове ModifyCacheCluster равно 5, вы должны указать 2 (7 - 5) идентификатора узлов кэша для удаления.

(строка)

Синтаксис:

"string" "string" ...

--az-mode (строка)

Указывает, создаются ли новые узлы в этом кластере Memcached все в одной зоне доступности или в нескольких зонах доступности.

Допустимые значения: single-az | cross-az.

Этот параметр поддерживается только для кластеров Memcached.

Примечание

Вы не можете указать single-az, если в кластере Memcached уже есть узлы кэша в разных зонах доступности. Если cross-az указан, существующие узлы Memcached остаются в своей текущей зоне доступности.

Только вновь созданные узлы могут находиться в разных зонах доступности.

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

single-az
cross-az

--new-availability-zones (список)

Примечание

Этот параметр поддерживается только для кластеров Memcached.

Список зон доступности, в которых создаются новые узлы кэша Memcached.

Этот параметр действителен только в том случае, если NumCacheNodes в запросе больше суммы активных узлов кэша и узлов кэша, ожидающих создания (что может быть равно нулю). Количество зон доступности, указанных в этом списке, должно соответствовать количеству добавляемых узлов кэша в этом запросе.

Сценарии:

Сценарий 1: У вас 3 активных узла, и вы хотите добавить 2 узла. Укажите NumCacheNodes=5 (3 + 2) и необязательно укажите две зоны доступности для двух новых узлов.
Сценарий 2: У вас 3 активных узла и 2 узла, ожидающие создания (из сценария 1 вызова), и вы хотите добавить ещё 1 узел. Укажите NumCacheNodes=6 ((3 + 2) + 1) и необязательно укажите зону доступности для нового узла.
Сценарий 3: Вы хотите отменить все ожидающие действия. Укажите NumCacheNodes=3 для отмены всех ожидающих действий.

Расположение зоны доступности узлов, ожидающих создания, изменить нельзя. Если вы хотите отменить создание каких-либо ожидающих узлов, добавьте 0 узлов, установив NumCacheNodes равным количеству текущих узлов.

Если cross-az указан, существующие узлы Memcached останутся в своей текущей зоне доступности. Только вновь созданные узлы могут находиться в разных зонах доступности. Инструкции по перемещению существующих узлов Memcached в разные зоны доступности см. в разделе «Учёт зон доступности» в разделе «Общие сведения об узлах кэша для Memcached».

Влияние новых запросов на добавление/удаление на ожидающие запросы

Сценарий-1
- Ожидаемое действие: Удалить
- Новый запрос: Удалить
- Результат: Новое удаление, ожидаемое или немедленное, заменяет ожидаемое удаление.
Сценарий-2
- Ожидаемое действие: Удалить
- Новый запрос: Создать
- Результат: Новое создание, ожидаемое или немедленное, заменяет ожидаемое удаление.
Сценарий-3
- Ожидаемое действие: Создать
- Новый запрос: Удалить
- Результат: Новое удаление, ожидаемое или немедленное, заменяет ожидаемое создание.
Сценарий-4
- Ожидаемое действие: Создать
- Новый запрос: Создать
- Результат: Новое создание добавляется к ожидающему созданию.
Предупреждение

Важно: Если новый запрос на создание — Применить немедленно — Да, все создания выполняются немедленно. Если новый запрос на создание — Применить немедленно — Нет, все создания ожидаются.

(строка)

Синтаксис:

"string" "string" ...

--cache-security-group-names (список)

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

Этот параметр можно использовать только с кластерами, созданными за пределами виртуальной частной сети Amazon (Amazon VPC).

Ограничения: Должен содержать не более 255 буквенно-цифровых символов. Не может быть «Default».

(строка)

Синтаксис:

"string" "string" ...

--security-group-ids (список)

Указывает группы безопасности VPC, связанные с кластером.

Этот параметр можно использовать только с кластерами, созданными в виртуальной частной сети Amazon (Amazon VPC).

(строка)

Синтаксис:

"string" "string" ...

--preferred-maintenance-window (строка)

Указывает еженедельный временной интервал, в течение которого выполняется обслуживание кластера. Он задаётся как диапазон в формате ddd:hh24:mi-ddd:hh24:mi (24-часовой формат UTC). Минимальная продолжительность окна обслуживания — 60 минут.

Допустимые значения для ddd:

sun
mon
tue
wed
thu
fri
sat

Пример: sun:23:00-mon:01:30

--notification-topic-arn (строка)

Идентификатор ресурса Amazon (ARN) темы Amazon SNS, в которую отправляются уведомления.

Примечание

Владелец темы Amazon SNS должен совпадать с владельцем кластера.

--cache-parameter-group-name (строка)

Название группы параметров кэша, применяемой к этому кластеру. Это изменение применяется асинхронно в кратчайшие сроки для параметров, когда параметр ApplyImmediately указан как true для данного запроса.

--notification-topic-status (строка)

Статус темы уведомлений Amazon SNS. Уведомления отправляются только в том случае, если статус active.

Допустимые значения: active | inactive

--apply-immediately | --no-apply-immediately (булево)

Если true, этот параметр заставляет изменения в этом запросе и любые ожидающие изменения применяться асинхронно и в кратчайшие сроки, независимо от настройки PreferredMaintenanceWindow для кластера.

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

Предупреждение

Если вы выполняете ModifyCacheCluster до применения ожидающего изменения, ожидающее изменение заменяется новым изменением.

Допустимые значения: true | false

По умолчанию: false

--engine (строка)

Тип движка, используемый кластером кэша. Варианты: valkey, memcached или redis.

--engine-version (строка)

Обновленная версия движка кэша, которая будет работать на узлах кэша.

Важно: Вы можете обновить версию движка до более новой (см. Выбор движка кэша и версии), но вы не можете перейти к более ранней версии движка. Если вы хотите использовать более раннюю версию движка, вы должны удалить существующий кластер и создать новый с более ранней версией движка.

--auto-minor-version-upgrade | --no-auto-minor-version-upgrade (булево)

Если вы используете движок Valkey 7.2 или Redis OSS версии 6.0 или более поздней, установите этот параметр в «да», чтобы принять участие в следующей кампании по автоматическому обновлению малой версии. Этот параметр отключён для предыдущих версий.

--snapshot-retention-limit (целое число)

Количество дней, в течение которых ElastiCache сохраняет автоматические снимки кластера перед их удалением. Например, если вы установите SnapshotRetentionLimit в значение 5, снимок, сделанный сегодня, сохраняется в течение 5 дней, прежде чем будет удалён.

Примечание

Если значение SnapshotRetentionLimit установлено в ноль (0), резервные копии отключены.

--snapshot-window (строка)

Ежедневный временной интервал (в формате UTC), в течение которого ElastiCache начинает создание ежедневного снимка вашего кластера.

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

Действительный тип узла кэша, до которого вы хотите масштабировать этот кластер.

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

Зарезервированный параметр. Пароль, используемый для доступа к защищенному паролем серверу. Этот параметр должен быть указан с параметром auth-token-update. Ограничения пароля:

Должен содержать только печатаемые символы ASCII
Должен быть не менее 16 и не более 128 символов в длину
Не может содержать следующие символы: ‘/’, ‘”’, или ‘@’, ‘%’

Для получения дополнительной информации, см. AUTH пароль в AUTH.

--auth-token-update-strategy (строка)

Указывает стратегию обновления маркера AUTH. Этот параметр должен быть указан с параметром auth-token. Возможные значения:

ROTATE - значение по умолчанию, если стратегия обновления не задана
SET - разрешено только после ROTATE
DELETE - разрешено только при переходе на RBAC

Для получения дополнительной информации, см. Авторизация пользователей с помощью AUTH

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

SET
ROTATE
DELETE

--log-delivery-configurations (список)

Указывает место назначения, формат и тип журналов.

(структура)

Указывает место назначения, формат и тип журналов.

LogType -> (строка)

Относится к slow-log или engine-log.

DestinationType -> (строка)

Укажите либо cloudwatch-logs, либо kinesis-firehose в качестве типа места назначения.

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

Сведения о конфигурации места назначения CloudWatch Logs или Kinesis Data Firehose.

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

Сведения о конфигурации места назначения CloudWatch Logs.

LogGroup -> (строка)

Имя группы журналов CloudWatch Logs.

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

Сведения о конфигурации места назначения Kinesis Data Firehose.

DeliveryStream -> (строка)

Имя потока доставки Kinesis Data Firehose.

LogFormat -> (строка)

Укажите JSON или TEXT

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

Укажите, включена ли доставка журналов. Значение по умолчанию true.

Сокращенная синтаксическая запись:

LogType=string,DestinationType=string,DestinationDetails={CloudWatchLogsDetails={LogGroup=string},KinesisFirehoseDetails={DeliveryStream=string}},LogFormat=string,Enabled=boolean ...

Синтаксис JSON:

[
  {
    "LogType": "slow-log"|"engine-log",
    "DestinationType": "cloudwatch-logs"|"kinesis-firehose",
    "DestinationDetails": {
      "CloudWatchLogsDetails": {
        "LogGroup": "string"
      },
      "KinesisFirehoseDetails": {
        "DeliveryStream": "string"
      }
    },
    "LogFormat": "text"|"json",
    "Enabled": true|false
  }
  ...
]

--ip-discovery (строка)

Тип сети, который вы выбираете при изменении кластера, либо ipv4 | ipv6. IPv6 поддерживается для рабочих нагрузок, использующих Valkey 7.2 и выше, Redis OSS engine версии 6.2 до 7.1 или Memcached engine версии 1.6.6 и выше на всех экземплярах, построенных на системе Nitro.

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

ipv4
ipv6

--scale-config (структура)

Настраивает горизонтальное или вертикальное масштабирование для кластеров Memcached, указывая процент масштабирования и интервал.

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

Процент масштабирования кластера Memcached, либо горизонтально путем добавления узлов, либо вертикально путем увеличения ресурсов.

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

Интервал времени в секундах между операциями масштабирования при выполнении постепенного масштабирования кластера Memcached.

Сокращенная синтаксическая запись:

ScalePercentage=integer,ScaleIntervalMinutes=integer

Синтаксис JSON:

{
  "ScalePercentage": integer,
  "ScaleIntervalMinutes": integer
}

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

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

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

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

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

Примеры

Примечание

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

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

Изменение кластеров кэша

Следующий modify-cache-cluster пример изменяет настройки указанного кластера.

aws elasticache modify-cache-cluster \
    --cache-cluster-id "my-cluster" \
    --num-cache-nodes 1

Вывод:

{
    "CacheCluster": {
        "CacheClusterId": "my-cluster",
        "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:",
        "CacheNodeType": "cache.m5.large",
        "Engine": "redis",
        "EngineVersion": "5.0.5",
        "CacheClusterStatus": "available",
        "NumCacheNodes": 1,
        "PreferredAvailabilityZone": "us-west-2c",
        "CacheClusterCreateTime": "2019-12-04T18:24:56.652Z",
        "PreferredMaintenanceWindow": "sat:10:00-sat:11:00",
        "PendingModifiedValues": {},
        "CacheSecurityGroups": [],
        "CacheParameterGroup": {
            "CacheParameterGroupName": "default.redis5.0",
            "ParameterApplyStatus": "in-sync",
            "CacheNodeIdsToReboot": []
        },
        "CacheSubnetGroupName": "default",
        "AutoMinorVersionUpgrade": true,
        "SnapshotRetentionLimit": 0,
        "SnapshotWindow": "07:00-08:00",
        "TransitEncryptionEnabled": false,
        "AtRestEncryptionEnabled": false
    }
}

Дополнительную информацию см. в разделе Изменение кластера ElastiCache в Руководстве пользователя Elasticache.

Вывод

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

Содержит все атрибуты конкретного кластера.

CacheClusterId -> (строка)

Указанный пользователем идентификатор кластера. Этот идентификатор является уникальным ключом, определяющим кластер.

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

Представляет конечную точку кластера Memcached, которую приложение может использовать для подключения к любому узлу в кластере. В конфигурации конечной точки всегда присутствует .cfg.

Пример: mem-3.9dvc4r.cfg.usw2.cache.amazonaws.com:11211

Address -> (строка)

DNS-имя хоста узла кэша.

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

Номер порта, на котором работает кэширующий движок.

ClientDownloadLandingPage -> (строка)

URL веб-страницы, где можно скачать последнюю библиотеку клиента ElastiCache.

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 и более поздних.

Engine -> (строка)

Название кэширующего движка (memcached или redis ), используемого для этого кластера.

EngineVersion -> (строка)

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

CacheClusterStatus -> (строка)

Текущее состояние этого кластера, одно из следующих значений: available , creating , deleted , deleting , incompatible-network , modifying , rebooting cluster nodes , restore-failed или snapshotting.

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

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

PreferredAvailabilityZone -> (строка)

Название зоны доступности, в которой находится кластер, или «Multiple», если узлы кэша находятся в разных зонах доступности.

PreferredOutpostArn -> (строка)

ARN вспомогательного узла, в котором создан кластер кэша.

CacheClusterCreateTime -> (временная метка)

Дата и время создания кластера.

PreferredMaintenanceWindow -> (строка)

Указывает временной интервал в течение недели, в который выполняется обслуживание кластера. Он задается как диапазон в формате ddd:hh24:mi-ddd:hh24:mi (24-часовой формат UTC). Минимальная продолжительность окна обслуживания составляет 60 минут.

Допустимые значения для ddd:

sun
mon
tue
wed
thu
fri
sat

Пример: sun:23:00-mon:01:30

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

Группа настроек, которые будут применены к кластеру в будущем или которые в настоящее время применяются.

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

Новое количество узлов кэша для кластера.

CacheNodeIdsToRemove -> (список)

Список идентификаторов узлов кэша, которые удаляются (или будут удалены) из кластера. Идентификатор узла — это 4-значный числовой идентификатор (0001, 0002 и т. д.).

(строка)

EngineVersion -> (строка)

Новая версия кэширующего движка, на которой работает кластер.

CacheNodeType -> (строка)

Тип узла кэша, к которому масштабируется этот кластер или группа репликации.

AuthTokenStatus -> (строка)

Статус токена аутентификации

LogDeliveryConfigurations -> (список)

Настройки доставки журналов, которые изменяются

(структура)

Настройки доставки журналов, которые изменяются

LogType -> (строка)

Относится к медленным логам или логам движка.

DestinationType -> (строка)

Возвращает тип назначения: CloudWatch Logs или Kinesis Data Firehose.

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

Детали конфигурации назначения в CloudWatch Logs или Kinesis Data Firehose.

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

Детали конфигурации назначения в CloudWatch Logs.

LogGroup -> (строка)

Название группы логов CloudWatch Logs.

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

Детали конфигурации назначения в Kinesis Data Firehose.

DeliveryStream -> (строка)

Имя потока доставки Kinesis Data Firehose.

LogFormat -> (строка)

Возвращает формат логов: JSON или TEXT

TransitEncryptionEnabled -> (булево)

Флаг, включающий шифрование канала передачи при установке в значение true.

TransitEncryptionMode -> (строка)

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

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

Изменения конфигурации масштабирования, ожидающие применения к кластеру Memcached.

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

Процент масштабирования кластера Memcached, либо горизонтально, добавляя узлы, либо вертикально, увеличивая ресурсы.

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

Временной интервал в секундах между операциями масштабирования при постепенном масштабировании кластера Memcached.

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

Описывает тему уведомлений и её статус. Темы уведомлений используются для публикации событий ElastiCache подписчикам с помощью Amazon Simple Notification Service (SNS).

TopicArn -> (строка)

Amazon Resource Name (ARN), идентифицирующий тему.

TopicStatus -> (строка)

Текущее состояние темы.

CacheSecurityGroups -> (список)

Список элементов группы безопасности кэша, состоящих из имени и статуса.

(структура)

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

CacheSecurityGroupName -> (строка)

Имя группы безопасности кэша.

Status -> (строка)

Статус членства в группе безопасности кэша. Статус меняется при изменении группы безопасности кэша или при изменении групп безопасности кэша, назначенных кластеру.

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

Состояние группы параметров кэша.

CacheParameterGroupName -> (строка)

Имя группы параметров кэша.

ParameterApplyStatus -> (строка)

Состояние обновления параметров.

CacheNodeIdsToReboot -> (список)

Список идентификаторов узлов кэша, которые необходимо перезапустить для применения изменений параметров. Идентификатор узла — это числовой идентификатор (0001, 0002 и т. д.).

(строка)

CacheSubnetGroupName -> (строка)

Имя группы подсетей кэша, связанной с кластером.

CacheNodes -> (список)

Список узлов кэша, которые являются членами кластера.

(структура)

Представляет отдельный узел кэша в кластере. Каждый узел кэша выполняет свою собственную инстанцию протокол-совместимого кэширующего программного обеспечения кластера — Memcached, Valkey или Redis OSS.

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 по умолчанию.
Файлы только для добавления (AOF) Valkey или Redis OSS не поддерживаются для инстанций T1 или T2.
Valkey или Redis OSS Multi-AZ с автоматическим переключением не поддерживаются на инстанциях T1.
Переменные конфигурации appendonly и appendfsync не поддерживаются в Valkey или в Redis OSS версии 2.8.22 и выше.

CacheNodeId -> (строка)

Идентификатор узла кэша. Идентификатор узла — это числовой идентификатор (0001, 0002 и т. д.). Сочетание идентификатора кластера и идентификатора узла однозначно определяет каждый узел кэша, используемый в учетной записи Amazon клиента.

CacheNodeStatus -> (строка)

Текущее состояние этого узла кэша, одно из следующих значений: available , creating , rebooting или deleting .

CacheNodeCreateTime -> (временная метка)

Дата и время создания узла кэша.

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

Имя хоста для подключения к этому узлу кэша.

Address -> (строка)

Имя хоста DNS узла кэша.

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

Номер порта, на котором работает кэширующий движок.

ParameterGroupStatus -> (строка)

Состояние группы параметров, применённой к этому узлу кэша.

SourceCacheNodeId -> (строка)

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

CustomerAvailabilityZone -> (строка)

Доступная зона, в которой был создан и сейчас находится этот узел.

CustomerOutpostArn -> (строка)

ARN клиентского узла вычислений для узла кэша.

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

Если вы используете Valkey или Redis OSS движок версии 6.0 или выше, установите этот параметр в «да», чтобы включить автоматическое обновление до следующей версии. Этот параметр отключен для предыдущих версий.

SecurityGroups -> (список)

Список VPC групп безопасности, связанных с кластером.

(структура)

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

SecurityGroupId -> (строка)

Идентификатор группы безопасности кэша.

Status -> (строка)

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

ReplicationGroupId -> (строка)

Группа репликации, к которой принадлежит этот кластер. Если это поле пустое, кластер не связан ни с одной группой репликации.

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

Количество дней, в течение которых ElastiCache сохраняет автоматические снимки кластера перед их удалением. Например, если вы установите SnapshotRetentionLimit в 5, снимок, сделанный сегодня, сохраняется в течение 5 дней перед удалением.

Предупреждение

Если значение SnapshotRetentionLimit установлено в ноль (0), резервные копии отключаются.

SnapshotWindow -> (строка)

Пример: 05:00-09:00

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

Флаг, который включает использование AuthToken (пароль) при выполнении команд Valkey или Redis OSS.

По умолчанию: false

AuthTokenLastModifiedDate -> (временная метка)

Дата последнего изменения токена аутентификации.

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

Флаг, который включает шифрование трафика при установке в true .

Требуется: Доступно только при создании группы репликации в Amazon VPC с использованием Redis OSS версии 3.2.6 , 4.x или выше.

По умолчанию: false

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

Флаг, который включает шифрование данных в состоянии покоя при установке в true .

Вы не можете изменить значение AtRestEncryptionEnabled после создания кластера. Чтобы включить шифрование данных в состоянии покоя в кластере, необходимо установить AtRestEncryptionEnabled в true при создании кластера.

По умолчанию: false

ARN -> (строка)

ARN (Amazon Resource Name) кластера кэша.

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

Логическое значение, указывающее, включена ли доставка логов для группы репликации.

LogDeliveryConfigurations -> (список)

Возвращает пункт назначения, формат и тип журналов.

(структура)

Возвращает пункт назначения, формат и тип журналов.

LogType -> (строка)

Относится к медленным журналам или журналам движка.

DestinationType -> (строка)

Возвращает тип пункта назначения, либо cloudwatch-logs, либо kinesis-firehose.

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

Детали конфигурации пункта назначения CloudWatch Logs или Kinesis Data Firehose.

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

Детали конфигурации пункта назначения CloudWatch Logs.

LogGroup -> (строка)

Имя группы журналов CloudWatch Logs.

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

Детали конфигурации пункта назначения Kinesis Data Firehose.

DeliveryStream -> (строка)

Имя потока доставки Kinesis Data Firehose.

LogFormat -> (строка)

Возвращает формат журнала, JSON или TEXT.

Status -> (строка)

Возвращает состояние конфигурации доставки журналов. Значения — enabling | disabling | modifying | active | error.

Message -> (строка)

Возвращает сообщение об ошибке для конфигурации доставки журналов.

NetworkType -> (строка)

Должно быть либо ipv4 | ipv6 | dual_stack. IPv6 поддерживается для рабочих нагрузок с использованием Valkey 7.2 и выше, Redis OSS движок версии 6.2 7.1 или Memcached движок версии 1.6.6 и выше на всех экземплярах, построенных на системе Nitro.

IpDiscovery -> (строка)

Тип сети, связанной с кластером, либо ipv4 | ipv6. IPv6 поддерживается для рабочих нагрузок с использованием Valkey 7.2 и выше, Redis OSS движок версии 6.2 до 7.1 или Memcached движок версии 1.6.6 и выше на всех экземплярах, построенных на системе Nitro.

TransitEncryptionMode -> (строка)

Настройка, позволяющая перенести клиентов на использование шифрования в транзите без простоев.