Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

describe-spot-fleet-request-history

Описание

Описывает события для указанного запроса Spot Fleet в течение указанного времени.

События Spot Fleet с задержкой до 30 секунд, прежде чем их можно будет описать. Это гарантирует, что вы можете запросить по последнему времени оценки и не пропустить зарегистрированное событие. События Spot Fleet доступны в течение 48 часов.

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

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

Синтаксис

  describe-spot-fleet-request-history
[--dry-run | --no-dry-run]
--spot-fleet-request-id <value>
[--event-type <value>]
--start-time <value>
[--next-token <value>]
[--max-results <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]

Параметры

--dry-run | --no-dry-run (boolean)

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

--spot-fleet-request-id (string)

Идентификатор запроса Spot Fleet.

--event-type (string)

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

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

  • instanceChange
  • fleetRequestChange
  • error
  • information

--start-time (timestamp)

Начальная дата и время событий в формате UTC (например, YYYY -MM -DD T*HH* :MM :SS Z).

--next-token (string)

Токен для включения в другой запрос, чтобы получить следующую страницу элементов. Это значение — null, когда больше элементов возвращать не нужно.

--max-results (integer)

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

--cli-input-json | --cli-input-yaml (string) Считывает аргументы из предоставленной JSON-строки. JSON-строка соответствует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения перекроют значения, предоставленные через JSON. Невозможно передавать произвольные двоичные значения с помощью значения, предоставленного через JSON, так как строка будет взята дословно. Это не может быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (string) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. При отсутствии значения или значении input выводит пример входного JSON, который можно использовать как аргумент для --cli-input-json. Аналогично, при значении yaml-input выводит пример входного YAML, который можно использовать с --cli-input-yaml. При значении output выполняет проверку входных данных команды и возвращает пример выходного JSON для этой команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

Глобальные параметры

--debug (boolean)

Включает отладку протоколирования.

--endpoint-url (string)

Заменить URL по умолчанию команды на заданный URL.

--no-verify-ssl (boolean)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого соединения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет стандартное поведение проверки сертификатов SSL.

--no-paginate (boolean)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (string)

Стиль форматирования для вывода команды.

  • json
  • text
  • table
  • yaml
  • yaml-stream

--query (string)

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

--profile (string)

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

--region (string)

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

--version (string)

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

--color (string)

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

  • on
  • off
  • auto

--no-sign-request (boolean)

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

--ca-bundle (string)

Набор сертификатов CA для использования при проверке сертификатов SSL. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (int)

Максимальное время чтения сокета в секундах. Если значение равно 0, чтение сокета будет блокирующим и без таймаута. Значение по умолчанию — 60 секунд.

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение равно 0, подключение сокета будет блокирующим и без таймаута. Значение по умолчанию — 60 секунд.

--cli-binary-format (string)

Стиль форматирования, используемый для двоичных блоков. По умолчанию используется формат 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 (boolean)

Отключить кли-пайджер для вывода.

--cli-auto-prompt (boolean)

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

--no-cli-auto-prompt (boolean)

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

Примеры

Примечание

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

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

Для описания истории Spot Fleet

Эта команда возвращает историю для указанного Spot fleet начиная с указанного времени.

Команда:

aws ec2 describe-spot-fleet-request-history --spot-fleet-request-id sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE --start-time 2015-05-26T00:00:00Z

Следующий пример вывода показывает успешные запуски двух Spot Instance для Spot fleet.

Вывод:

{
  "HistoryRecords": [
      {
          "Timestamp": "2015-05-26T23:17:20.697Z",
          "EventInformation": {
              "EventSubType": "submitted"
          },
          "EventType": "fleetRequestChange"
      },
      {
          "Timestamp": "2015-05-26T23:17:20.873Z",
          "EventInformation": {
              "EventSubType": "active"
          },
          "EventType": "fleetRequestChange"
      },
      {
          "Timestamp": "2015-05-26T23:21:21.712Z",
          "EventInformation": {
              "InstanceId": "i-1234567890abcdef0",
              "EventSubType": "launched"
          },
          "EventType": "instanceChange"
      },
      {
          "Timestamp": "2015-05-26T23:21:21.816Z",
          "EventInformation": {
              "InstanceId": "i-1234567890abcdef1",
              "EventSubType": "launched"
          },
          "EventType": "instanceChange"
      }
  ],
  "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE",
  "NextToken": "CpHNsscimcV5oH7bSbub03CI2Qms5+ypNpNm+53MNlR0YcXAkp0xFlfKf91yVxSExmbtma3awYxMFzNA663ZskT0AHtJ6TCb2Z8bQC2EnZgyELbymtWPfpZ1ZbauVg+P+TfGlWxWWB/Vr5dk5d4LfdgA/DRAHUrYgxzrEXAMPLE=",
  "StartTime": "2015-05-26T00:00:00Z"
}

Вывод

HistoryRecords -> (список)

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

(структура)

Описание события в истории запроса Spot Fleet.

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

Информация о событии.

EventDescription -> (строка)

Описание события.

EventSubType -> (строка)

Событие.

error события:
  • iamFleetRoleInvalid - У запроса EC2 Fleet или Spot Fleet нет необходимых разрешений для запуска или завершения экземпляра.
  • allLaunchSpecsTemporarilyBlacklisted - Ни одна из конфигураций не является допустимой, и несколько попыток запуска экземпляров завершились неудачей. Для получения дополнительной информации см. описание события.
  • spotInstanceCountLimitExceeded - Достигнут лимит на количество экземпляров Spot Instance, которые можно запустить.
  • spotFleetRequestConfigurationInvalid - Конфигурация некорректна. Для получения дополнительной информации см. описание события.
fleetRequestChange события:
  • active - Запрос EC2 Fleet или Spot Fleet был проверен, и Amazon EC2 пытается поддерживать целевое количество запущенных экземпляров.
  • deleted (EC2 Fleet) / cancelled (Spot Fleet) - Запрос EC2 Fleet удален или запрос Spot Fleet отменен и не имеет запущенных экземпляров. EC2 Fleet или Spot Fleet будут удалены через два дня после завершения работы экземпляров.
  • deleted_running (EC2 Fleet) / cancelled_running (Spot Fleet) - EC2 Fleet удален или запрос Spot Fleet отменен и не запускает дополнительные экземпляры. Его существующие экземпляры продолжают работать до момента их прерывания или завершения. Запрос остается в этом состоянии до тех пор, пока все экземпляры не будут прерваны или завершены.
  • deleted_terminating (EC2 Fleet) / cancelled_terminating (Spot Fleet) - EC2 Fleet удален или запрос Spot Fleet отменен, и его экземпляры завершают работу. Запрос остается в этом состоянии до тех пор, пока все экземпляры не будут завершены.
  • expired - Запрос EC2 Fleet или Spot Fleet истек. Если запрос был создан с TerminateInstancesWithExpiration, последующее событие terminated указывает на завершение работы экземпляров.
  • modify_in_progress - Запрос EC2 Fleet или Spot Fleet изменяется. Запрос остается в этом состоянии до тех пор, пока изменение не будет полностью обработано.
  • modify_succeeded - Запрос EC2 Fleet или Spot Fleet был изменен.
  • submitted - Запрос EC2 Fleet или Spot Fleet оценивается, и Amazon EC2 готовится запустить целевое количество экземпляров.
  • progress - Запрос EC2 Fleet или Spot Fleet находится в процессе выполнения.
instanceChange события:
  • launched - Запущен новый экземпляр.
  • terminated - Пользователь завершил работу экземпляра.
  • termination_notified - Уведомление о завершении работы экземпляра было отправлено, когда экземпляр Spot Instance был завершен Amazon EC2 во время уменьшения масштаба, когда целевая емкость флота была уменьшена, например, с целевой емкости 4 до целевой емкости 3.
Information события:
  • fleetProgressHalted - Цена во всех спецификациях запуска недействительна, потому что она ниже цены Spot (все спецификации запуска вызвали launchSpecUnusable события). Спецификация запуска может стать действительной, если цена Spot изменится.
  • launchSpecTemporarilyBlacklisted - Конфигурация недействительна, и несколько попыток запуска экземпляров завершились неудачей. Для получения дополнительной информации см. описание события.
  • launchSpecUnusable - Цена, указанная в спецификации запуска, недействительна, потому что она ниже цены Spot для запрошенных пулов Spot. Примечание: даже если флот с типом запроса maintain находится в процессе отмены, он может опубликовать событие launchSpecUnusable. Это не означает, что отменяемый флот пытается запустить новый экземпляр.
  • registerWithLoadBalancersFailed - Попытка зарегистрировать экземпляры с балансировщиками нагрузки завершилась неудачей. Для получения дополнительной информации см. описание события.

InstanceId -> (строка)

Идентификатор экземпляра. Эта информация доступна только для instanceChange событий.

EventType -> (строка)

Тип события.

  • error - Ошибка в запросе Spot Fleet.
  • fleetRequestChange - Изменение состояния или конфигурации запроса Spot Fleet.
  • instanceChange - Экземпляр был запущен или завершен.
  • Information - Информационное событие.

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

Дата и время события в формате UTC (например, YYYY -MM -DD T*HH* :MM :SS Z).

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

Последняя дата и время событий в формате UTC (например, YYYY -MM -DD T*HH* :MM :SS Z). Все записи до этого времени были извлечены.

Если nextToken указывает на наличие дополнительных элементов, это значение отсутствует.

NextToken -> (строка)

Токен, который следует включить в другой запрос для получения следующей страницы элементов. Это значение null, если больше элементов нет.

SpotFleetRequestId -> (строка)

Идентификатор запроса Spot Fleet.

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

Начальная дата и время событий в формате UTC (например, YYYY -MM -DD T*HH* :MM :SS Z).

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

Spec-Zone.ru

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