Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

purchase-scheduled-instances

Описание

Примечание

Вы больше не можете приобретать запланированные инстансы.

Приобретает запланированные инстансы с указанным расписанием.

Запланированные инстансы позволяют вам приобрести вычислительные мощности Amazon EC2 почасово на срок в один год. Прежде чем вы сможете приобрести запланированный инстанс, вам необходимо вызвать DescribeScheduledInstanceAvailability, чтобы проверить наличие доступных расписаний и получить токен покупки. После покупки запланированного инстанса необходимо вызвать RunScheduledInstances в каждом запланированном временном интервале.

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

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

Синтаксис

  purchase-scheduled-instances
[--client-token <value>]
[--dry-run | --no-dry-run]
--purchase-requests <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]

Параметры

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

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

--dry-run | --no-dry-run (логическое значение)

Проверяет, обладают ли вы необходимыми разрешениями для действия, не отправляя фактический запрос, и предоставляет ответ об ошибке. Если у вас есть необходимые разрешения, ответ об ошибке — DryRunOperation . В противном случае — UnauthorizedOperation .

--purchase-requests (список)

Запросы на покупку.

(структура)

Описывает запрос на покупку запланированных инстансов.

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

Количество инстансов.

PurchaseToken -> (строка)

Токен покупки.

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

InstanceCount=integer,PurchaseToken=string ...

Синтаксис JSON:

[
  {
    "InstanceCount": integer,
    "PurchaseToken": "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
  • текст
  • таблица
  • 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-auto-prompt (логическое значение)

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

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

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

Примеры

Примечание

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

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

Приобретение запланированного инстанса

В этом примере приобретается запланированный инстанс.

Команда:

aws ec2 purchase-scheduled-instances --purchase-requests file://purchase-request.json

Purchase-request.json:

[
    {
        "PurchaseToken": "eyJ2IjoiMSIsInMiOjEsImMiOi...",
        "InstanceCount": 1
    }
]

Вывод:

{
  "ScheduledInstanceSet": [
      {
          "AvailabilityZone": "us-west-2b",
          "ScheduledInstanceId": "sci-1234-1234-1234-1234-123456789012",
          "HourlyPrice": "0.095",
          "CreateDate": "2016-01-25T21:43:38.612Z",
          "Recurrence": {
              "OccurrenceDaySet": [
                  1
              ],
              "Interval": 1,
              "Frequency": "Weekly",
              "OccurrenceRelativeToEnd": false,
              "OccurrenceUnit": ""
          },
          "Platform": "Linux/UNIX",
          "TermEndDate": "2017-01-31T09:00:00Z",
          "InstanceCount": 1,
          "SlotDurationInHours": 32,
          "TermStartDate": "2016-01-31T09:00:00Z",
          "NetworkPlatform": "EC2-VPC",
          "TotalScheduledInstanceHours": 1696,
          "NextSlotStartTime": "2016-01-31T09:00:00Z",
          "InstanceType": "c4.large"
      }
  ]
}

Вывод

ScheduledInstanceSet -> (список)

Информация о запланированных инстансах.

(структура)

Описание запланированного инстанса.

AvailabilityZone -> (строка)

Зона доступности.

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

Дата приобретения запланированного инстанса.

HourlyPrice -> (строка)

Цена в час за один инстанс.

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

Количество инстансов.

InstanceType -> (строка)

Тип инстанса.

NetworkPlatform -> (строка)

Сетевая платформа.

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

Время начала следующего расписания.

Platform -> (строка)

Платформа (Linux/UNIX или Windows).

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

Время завершения предыдущего расписания или время, когда оно завершится.

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

Повторение расписания.

Frequency -> (строка)

Частота (Daily, Weekly или Monthly).

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

Количество интервала. Единица интервала зависит от значения frequency. Например, каждые 2 недели или каждые 2 месяца.

OccurrenceDaySet -> (список)

Дни. Для ежемесячного расписания это один или несколько дней месяца (1-31). Для еженедельного расписания это один или несколько дней недели (1-7, где 1 — воскресенье).

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

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

Указывает, относится ли событие к концу указанной недели или месяца.

OccurrenceUnit -> (строка)

Единица для occurrenceDaySet (DayOfWeek или DayOfMonth).

ScheduledInstanceId -> (строка)

Идентификатор запланированного инстанса.

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

Количество часов в расписании.

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

Дата окончания срока действия запланированного инстанса.

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

Дата начала срока действия запланированного инстанса.

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

Общее количество часов для одного инстанса на весь срок.

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

Spec-Zone.ru

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