Spec-Zone.ru › AWS CLI v2

[ aws . elasticache ]

create-serverless-cache

Описание

Создаёт кэш без сервера.

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

Синтаксис

  create-serverless-cache
--serverless-cache-name <value>
[--description <value>]
--engine <value>
[--major-engine-version <value>]
[--cache-usage-limits <value>]
[--kms-key-id <value>]
[--security-group-ids <value>]
[--snapshot-arns-to-restore <value>]
[--tags <value>]
[--user-group-id <value>]
[--subnet-ids <value>]
[--snapshot-retention-limit <value>]
[--daily-snapshot-time <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]

Параметры

--serverless-cache-name (строка)

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

--description (строка)

Предоставляемое пользователем описание кэша без сервера. По умолчанию NULL, т.е. если описание не указано, то будет возвращена пустая строка. Максимальная длина 255 символов.

--engine (строка)

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

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

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

--cache-usage-limits (структура)

Устанавливает лимиты использования кэша для хранения и единиц обработки ElastiCache для кэша.

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

Максимальный лимит хранения данных в кэше, выраженный в гигабайтах.

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

Верхний предел для хранения данных, используемый кэшем.

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

Нижний предел для хранения данных, используемый кэшем.

Unit -> (строка)

Единица измерения хранения в ГБ.

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

Настройка количества единиц обработки ElastiCache (ECPU), которые кэш может потреблять в секунду.

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

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

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

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

Сокращённый синтаксис:

DataStorage={Maximum=integer,Minimum=integer,Unit=string},ECPUPerSecond={Maximum=integer,Minimum=integer}

Синтаксис JSON:

{
  "DataStorage": {
    "Maximum": integer,
    "Minimum": integer,
    "Unit": "GB"
  },
  "ECPUPerSecond": {
    "Maximum": integer,
    "Minimum": integer
  }
}

--kms-key-id (строка)

ARN управляемого клиентом ключа для шифрования данных при хранении. Если ключ KMS не предоставлен, используется стандартный сервисный ключ.

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

Список одной или нескольких групп безопасности VPC, которые необходимо связать с кэшем без сервера. Группа безопасности позволит авторизовать доступ к трафику для конечной точки VPC (private-link). Если нет другой информации, это будет группа безопасности по умолчанию VPC, связанная с конечной точкой VPC кластера.

(строка)

Синтаксис:

"string" "string" ...

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

Список ARN снимков, на основе которых будет создан новый кэш без сервера. Доступно только для Valkey, Redis OSS и Serverless Memcached.

(строка)

Синтаксис:

"string" "string" ...

--tags (список)

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

(структура)

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

Key -> (строка)

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

Value -> (строка)

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

Сокращённый синтаксис:

Key=string,Value=string ...

Синтаксис JSON:

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

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

Идентификатор UserGroup, который необходимо связать с кэшем без сервера. Доступно только для Valkey и Redis OSS. По умолчанию NULL.

--subnet-ids (список)

Список идентификаторов подсетей, в которых будет развернута конечная точка VPC для кэша без сервера. Все subnetId должны принадлежать одной VPC.

(строка)

Синтаксис:

"string" "string" ...

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

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

--daily-snapshot-time (строка)

Ежедневное время, в которое будут создаваться снимки нового кэша без сервера. По умолчанию это значение 0, т.е. снимки не будут создаваться автоматически ежедневно. Доступно только для Valkey, Redis OSS и Serverless Memcached.

--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
  • текст
  • таблица
  • 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.

Вывод

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

Ответ на попытку создания кэша Serverless.

ServerlessCacheName -> (строка)

Уникальный идентификатор кэша Serverless.

Описание -> (строка)

Описание кэша Serverless.

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

Время создания кэша Serverless.

Состояние -> (строка)

Текущее состояние кэша Serverless. Допустимые значения: CREATING, AVAILABLE, DELETING, CREATE-FAILED и MODIFYING.

Двигатель -> (строка)

Двигатель, с которым совместим кэш Serverless.

MajorEngineVersion -> (строка)

Номер версии двигателя, с которым совместим кэш Serverless.

FullEngineVersion -> (строка)

Название и номер версии двигателя, с которым совместим кэш Serverless.

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

Пределы использования кэша Serverless.

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

Максимальный лимит хранения данных в кэше, выраженный в гигабайтах.

Максимум -> (целое число)

Максимальный лимит для хранения данных в кэше.

Минимум -> (целое число)

Минимальный лимит для хранения данных в кэше.

Единица измерения -> (строка)

Единица измерения хранилища, в ГБ.

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

Настройка количества ElastiCache Processing Units (ECPU), которые кэш может потреблять в секунду.

Максимум -> (целое число)

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

Минимум -> (целое число)

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

KmsKeyId -> (строка)

Идентификатор ключа Amazon Web Services Key Management Service (KMS), используемого для шифрования данных в кэше Serverless.

SecurityGroupIds -> (список)

Идентификаторы EC2-сетевых групп, связанных с кэшем Serverless.

(строка)

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

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

Адрес -> (строка)

DNS-имя узла кэша.

Порт -> (целое число)

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

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

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

Адрес -> (строка)

DNS-имя узла кэша.

Порт -> (целое число)

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

ARN -> (строка)

Amazon Resource Name (ARN) кэша Serverless.

UserGroupId -> (строка)

Идентификатор группы пользователей, связанной с кэшем Serverless. Доступно только для Valkey и Redis OSS. По умолчанию NULL.

SubnetIds -> (список)

Если идентификаторы подсетей не указаны и ваша VPC находится в us-west-1, ElastiCache выберет 2 подсети по умолчанию по всем зонам доступности в вашей VPC. Во всех остальных регионах, если идентификаторы подсетей не указаны, ElastiCache выберет 3 подсети по умолчанию по всем зонам доступности в вашей VPC по умолчанию.

(строка)

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

Текущее значение для количества снимков кэша Serverless, которые система будет хранить. Доступно только для Valkey, Redis OSS и Serverless Memcached.

DailySnapshotTime -> (строка)

Время в день, когда будет создан снимок кэша. По умолчанию NULL, т.е. снимки не будут создаваться в определенное время ежедневно. Доступно только для Valkey, Redis OSS и Serverless Memcached.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API