Spec-Zone.ru › AWS CLI v2

[ aws . elasticache ]

purchase-reserved-cache-nodes-offering

Описание

Позволяет приобрести предложение о выделенных узлах кэша. Выделенные узлы не подлежат отмене и не возвращаются. Дополнительную информацию см. в разделе Управление затратами с помощью выделенных узлов .

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

Синтаксис

  purchase-reserved-cache-nodes-offering
--reserved-cache-nodes-offering-id <value>
[--reserved-cache-node-id <value>]
[--cache-node-count <value>]
[--tags <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]

Параметры

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

Идентификатор предложения о выделенных узлах кэша для покупки.

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

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

Указанный клиентом идентификатор для отслеживания этого резервирования.

Примечание

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

Пример: myreservationID

--cache-node-count (целое число)

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

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

--tags (список)

Список тегов, которые нужно добавить к этому ресурсу. Тег — это пара «ключ-значение». Ключу тега должен соответствовать значение тега, хотя допускается null.

(структура)

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

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

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

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

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

Краткая синтаксическая запись:

Key=string,Value=string ...

Синтаксис JSON:

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

--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 для вывода.

--cli-auto-prompt (булево)

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

--no-cli-auto-prompt (булево)

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

Примеры

Примечание

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

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

Для приобретения предложения о выделенных узлах кэша

Следующий purchase-reserved-cache-nodes-offering пример позволяет приобрести предложение о выделенных узлах кэша.

aws elasticache purchase-reserved-cache-nodes-offering \
    --reserved-cache-nodes-offering-id xxxxxxx-4da5-4b90-b92d-929fbd7abed2

Вывод

{
    "ReservedCacheNode": {
        "ReservedCacheNodeId": "ri-2020-06-30-17-59-40-474",
        "ReservedCacheNodesOfferingId": "xxxxxxx-4da5-4b90-b92d-929fbd7abed2",
        "CacheNodeType": "cache.m3.2xlarge",
        "StartTime": "2020-06-30T17:59:40.474000+00:00",
        "Duration": 31536000,
        "FixedPrice": 1772.0,
        "UsagePrice": 0.0,
        "CacheNodeCount": 1,
        "ProductDescription": "redis",
        "OfferingType": "Heavy Utilization",
        "State": "payment-pending",
        "RecurringCharges": [
            {
                "RecurringChargeAmount": 0.25,
                "RecurringChargeFrequency": "Hourly"
            }
        ]
    }
}

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

Вывод

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

Представляет собой результат операции PurchaseReservedCacheNodesOffering.

ReservedCacheNodeId -> (строка)

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

ReservedCacheNodesOfferingId -> (строка)

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

CacheNodeType -> (строка)

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

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

  • Универсальные:

    • Текущее поколение: типы узлов M7g : cache.m7g.large , cache.m7g.xlarge , cache.m7g.2xlarge , cache.m7g.4xlarge , cache.m7g.8xlarge , cache.m7g.12xlarge , cache.m7g.16xlarge

    Примечание

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

    Типы узлов M6g (доступны только для версии Redis OSS 5.0.6 и выше, а также для версии Memcached 1.5.16 и выше): cache.m6g.large , cache.m6g.xlarge , cache.m6g.2xlarge , cache.m6g.4xlarge , cache.m6g.8xlarge , cache.m6g.12xlarge , cache.m6g.16xlarge Типы узлов M5: cache.m5.large , cache.m5.xlarge , cache.m5.2xlarge , cache.m5.4xlarge , cache.m5.12xlarge , cache.m5.24xlarge Типы узлов M4: cache.m4.large , cache.m4.xlarge , cache.m4.2xlarge , cache.m4.4xlarge , cache.m4.10xlarge Типы узлов T4g (доступны только для версии Redis OSS 5.0.6 и выше, а также для версии Memcached 1.5.16 и выше): cache.t4g.micro , cache.t4g.small , cache.t4g.medium Типы узлов T3: cache.t3.micro , cache.t3.small , cache.t3.medium Типы узлов T2: cache.t2.micro , cache.t2.small , cache.t2.medium

    • Предыдущее поколение: (не рекомендуется. Существующие кластеры по-прежнему поддерживаются, но создание новых кластеров для этих типов не поддерживается.) Типы узлов T1: cache.t1.micro Типы узлов M1: cache.m1.small , cache.m1.medium , cache.m1.large , cache.m1.xlarge Типы узлов M3: cache.m3.medium , cache.m3.large , cache.m3.xlarge , cache.m3.2xlarge
  • Оптимизированные для вычислений:

    • Предыдущее поколение: (не рекомендуется. Существующие кластеры по-прежнему поддерживаются, но создание новых кластеров для этих типов не поддерживается.) Типы узлов C1: cache.c1.xlarge
  • Оптимизированные для памяти:

    • Текущее поколение: типы узлов R7g : cache.r7g.large , cache.r7g.xlarge , cache.r7g.2xlarge , cache.r7g.4xlarge , cache.r7g.8xlarge , cache.r7g.12xlarge , cache.r7g.16xlarge

    Примечание

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

    Типы узлов R6g (доступны только для версии Redis OSS 5.0.6 и выше, а также для версии Memcached 1.5.16 и выше): cache.r6g.large , cache.r6g.xlarge , cache.r6g.2xlarge , cache.r6g.4xlarge , cache.r6g.8xlarge , cache.r6g.12xlarge , cache.r6g.16xlarge Типы узлов R5: cache.r5.large , cache.r5.xlarge , cache.r5.2xlarge , cache.r5.4xlarge , cache.r5.12xlarge , cache.r5.24xlarge Типы узлов R4: cache.r4.large , cache.r4.xlarge , cache.r4.2xlarge , cache.r4.4xlarge , cache.r4.8xlarge , cache.r4.16xlarge

    • Предыдущее поколение: (не рекомендуется. Существующие кластеры по-прежнему поддерживаются, но создание новых кластеров для этих типов не поддерживается.) Типы узлов M2: cache.m2.xlarge , cache.m2.2xlarge , cache.m2.4xlarge Типы узлов R3: cache.r3.large , cache.r3.xlarge , cache.r3.2xlarge , cache.r3.4xlarge , cache.r3.8xlarge
Дополнительная информация о типах узлов
  • Все типы экземпляров текущего поколения создаются по умолчанию в Amazon VPC.
  • Файлы Valkey или Redis OSS append-only (AOF) не поддерживаются для экземпляров T1 или T2.
  • Valkey или Redis OSS Multi-AZ с автоматическим резервированием не поддерживаются на экземплярах T1.
  • Переменные конфигурации appendonly и appendfsync не поддерживаются в Valkey или в Redis OSS версии 2.8.22 и более поздних версий.

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

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

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

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

FixedPrice -> (двойное)

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

UsagePrice -> (двойное)

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

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

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

ProductDescription -> (строка)

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

OfferingType -> (строка)

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

State -> (строка)

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

RecurringCharges -> (список)

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

(структура)

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

RecurringChargeAmount -> (двойное)

Денежная сумма периодического платежа.

RecurringChargeFrequency -> (строка)

Частота периодического платежа.

ReservationARN -> (строка)

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

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

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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