создать-кластер-кэша

Описание

Создаёт кластер. Все узлы в кластере выполняют программное обеспечение одного и того же протокол-совместимого движка кэша, либо Memcached, либо Valkey, либо Redis OSS.

Данная операция не поддерживается для кластеров Valkey или Redis OSS (режим кластера включён).

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

Синтаксис

  create-cache-cluster
--cache-cluster-id <value>
[--replication-group-id <value>]
[--az-mode <value>]
[--preferred-availability-zone <value>]
[--preferred-availability-zones <value>]
[--num-cache-nodes <value>]
[--cache-node-type <value>]
[--engine <value>]
[--engine-version <value>]
[--cache-parameter-group-name <value>]
[--cache-subnet-group-name <value>]
[--cache-security-group-names <value>]
[--security-group-ids <value>]
[--tags <value>]
[--snapshot-arns <value>]
[--snapshot-name <value>]
[--preferred-maintenance-window <value>]
[--port <value>]
[--notification-topic-arn <value>]
[--auto-minor-version-upgrade | --no-auto-minor-version-upgrade]
[--snapshot-retention-limit <value>]
[--snapshot-window <value>]
[--auth-token <value>]
[--outpost-mode <value>]
[--preferred-outpost-arn <value>]
[--preferred-outpost-arns <value>]
[--log-delivery-configurations <value>]
[--transit-encryption-enabled | --no-transit-encryption-enabled]
[--network-type <value>]
[--ip-discovery <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 (строка)

Идентификатор группы узлов (фрагмента). Этот параметр хранится в виде строки в нижнем регистре.

Ограничения:

Имя должно содержать от 1 до 50 буквенно-цифровых символов или дефисов.
Первый символ должен быть буквой.
Имя не должно заканчиваться дефисом и не может содержать два последовательных дефиса.

--replication-group-id (строка)

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

Если указанная группа репликации поддерживает Multi-AZ, а зона доступности не указана, кластер создается в зонах доступности, обеспечивающих наилучшее распределение реплик чтения по зонам доступности.

Примечание

Этот параметр действителен только если параметр Engine равен redis .

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

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

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

Если AZMode и PreferredAvailabilityZones не указаны, ElastiCache предполагает режим single-az.

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

single-az
cross-az

--preferred-availability-zone (строка)

Зона доступности EC2, в которой создается кластер.

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

По умолчанию: выбранная системой зона доступности.

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

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

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

Примечание

Если вы создаете свой кластер в Amazon VPC (рекомендуется), вы можете размещать узлы только в зонах доступности, ассоциированных с подсетями в выбранной группе подсетей.

Количество указанных зон доступности должно быть равно значению NumCacheNodes .

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

По умолчанию: выбранные системой зоны доступности.

(строка)

Синтаксис:

"string" "string" ...

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

Начальное количество узлов кэша, имеющихся в кластере.

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

Если для вашего кластера Memcached требуется более 40 узлов, заполните форму запроса на увеличение лимита ElastiCache по адресу http://aws.amazon.com/contact-us/elasticache-node-limit-request/ .

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

--engine (строка)

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

Допустимые значения для этого параметра: memcached | redis

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

Номер версии движка кэша, который будет использоваться для этого кластера. Для просмотра поддерживаемых версий движков кэша используйте операцию DescribeCacheEngineVersions.

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

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

Имя группы параметров, которая должна быть связана с этим кластером. Если этот аргумент опущен, используется группа параметров по умолчанию для указанного движка. Вы не можете использовать никакую группу параметров, которая имеет cluster-enabled='yes' при создании кластера.

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

Имя группы подсетей, которое будет использоваться для кластера.

Используйте этот параметр только при создании кластера в Amazon Virtual Private Cloud (Amazon VPC).

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

Если вы собираетесь запускать свой кластер в Amazon VPC, вам необходимо создать группу подсетей перед началом создания кластера. Дополнительную информацию см. в разделе Подсети и группы подсетей.

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

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

Используйте этот параметр только при создании кластера вне Amazon Virtual Private Cloud (Amazon VPC).

(строка)

Синтаксис:

"string" "string" ...

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

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

Используйте этот параметр только при создании кластера в Amazon Virtual Private Cloud (Amazon VPC).

(строка)

Синтаксис:

"string" "string" ...

--tags (список)

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

(структура)

Тег, который можно добавить к кластеру или группе репликации ElastiCache. Теги состоят из пары «Ключ/Значение». Вы можете использовать теги для категоризации и отслеживания всех ресурсов ElastiCache, за исключением глобальной группы репликации. При добавлении или удалении тегов в группах репликации эти действия будут реплицированы на все узлы в группе репликации. Разрешен тег со значением null.

Ключ -> (строка)

Ключ тега. Не может быть null.

Значение -> (строка)

Значение тега. Может быть null.

Упрощенный синтаксис:

Key=string,Value=string ...

JSON-синтаксис:

[
  {
    "Key": "string",
    "Value": "string"
  }
  ...
]

--snapshot-arns (список)

Список строк с единственным элементом, содержащим Amazon Resource Name (ARN), который однозначно идентифицирует файл снимка Valkey или Redis OSS RDB, хранящийся в Amazon S3. Файл снимка используется для заполнения группы узлов (раздела). Имя объекта Amazon S3 в ARN не должно содержать запятых.

Примечание

Этот параметр действителен только если параметр Engine имеет значение redis .

Пример ARN Amazon S3: arn:aws:s3:::my_bucket/snapshot1.rdb

(строка)

Синтаксис:

"string" "string" ...

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

Имя снимка Valkey или Redis OSS, из которого необходимо восстановить данные в новую группу узлов (раздел). Статус снимка меняется на restoring во время создания новой группы узлов (раздела).

Примечание

Этот параметр действителен только если параметр Engine имеет значение redis .

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

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

--port (целое число)

Номер порта, на котором каждый узел кэша принимает подключения.

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

Amazon Resource Name (ARN) темы Amazon Simple Notification Service (SNS), в которую отправляются уведомления.

Примечание

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

--auto-minor-version-upgrade | --no-auto-minor-version-upgrade (логическое значение)

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

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

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

Примечание

Этот параметр действителен только если параметр Engine имеет значение redis .

По умолчанию: 0 (т.е. автоматические резервные копии отключены для этого кластера кэша).

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

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

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

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

Примечание

Этот параметр действителен только если параметр Engine имеет значение redis .

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

Зарезервированный параметр. Пароль, используемый для доступа к защищённому паролем серверу.

Ограничения на пароль:

Должен содержать только печатаемые символы ASCII.
Длина должна быть не менее 16 и не более 128 символов.
Допустимы только печатаемые специальные символы !, &, #, $, ^, <, > и -. Другие печатаемые специальные символы не могут использоваться в токенах AUTH.

Для получения дополнительной информации см. пароль AUTH в http://redis.io/commands/AUTH.

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

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

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

single-outpost
cross-outpost

--preferred-outpost-arn (строка)

ARN отделения, в котором создаётся кластер кэша.

--preferred-outpost-arns (список)

ARN отделений, в которых создаётся кластер кэша.

(строка)

Синтаксис:

"string" "string" ...

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

--transit-encryption-enabled | --no-transit-encryption-enabled (логическое значение)

Флаг, включающий шифрование во время передачи при значении «true».

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

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

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

ipv4
ipv6
dual_stack

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

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

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

ipv4
ipv6

--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
table
yaml
yaml-stream

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

on
off
auto

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

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

Следующий create-cache-cluster пример создаёт кластер кэша с использованием движка Redis.

aws elasticache create-cache-cluster \
    --cache-cluster-id "cluster-test" \
    --engine redis \
    --cache-node-type cache.m5.large \
    --num-cache-nodes 1

Вывод:

{
    "CacheCluster": {
        "CacheClusterId": "cluster-test",
        "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:",
        "CacheNodeType": "cache.m5.large",
        "Engine": "redis",
        "EngineVersion": "5.0.5",
        "CacheClusterStatus": "creating",
        "NumCacheNodes": 1,
        "PreferredMaintenanceWindow": "sat:13:00-sat:14:00",
        "PendingModifiedValues": {},
        "CacheSecurityGroups": [],
        "CacheParameterGroup": {
            "CacheParameterGroupName": "default.redis5.0",
            "ParameterApplyStatus": "in-sync",
            "CacheNodeIdsToReboot": []
        },
        "CacheSubnetGroupName": "default",
        "AutoMinorVersionUpgrade": true,
        "SnapshotRetentionLimit": 0,
        "SnapshotWindow": "06:30-07:30",
        "TransitEncryptionEnabled": false,
        "AtRestEncryptionEnabled": false
    }
}

Дополнительную информацию см. в разделе Создание кластера в руководстве пользователя 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 с автоматическим переключением не поддерживаются на экземплярах 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 -> (целое число)

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

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

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 -> (строка)

Ссылается на slow-log или engine-log.

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 -> (строка)

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

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

AuthTokenEnabled -> (булево значение)

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

Default: false

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

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

TransitEncryptionEnabled -> (булево значение)

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

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

Default: false

AtRestEncryptionEnabled -> (булево значение)

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

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

Default: false

ARN -> (строка)

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

ReplicationGroupLogDeliveryEnabled -> (булево значение)

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

LogDeliveryConfigurations -> (список)

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

(структура)

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

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.

Status -> (строка)

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

Message -> (строка)

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

NetworkType -> (строка)

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

IpDiscovery -> (строка)

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

TransitEncryptionMode -> (строка)

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