Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

describe-spot-fleet-requests

Описание

Описывает ваши запросы на использование Spot Fleet.

Запросы на использование Spot Fleet удаляются через 48 часов после их отмены и завершения работы соответствующих экземпляров.

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

describe-spot-fleet-requests является постраничной операцией. Для получения всего набора результатов могут потребоваться несколько вызовов API. Вы можете отключить постраничную обработку, предоставив аргумент --no-paginate. При использовании --output text и аргумента --query с постраничным ответом, аргумент --query должен извлечь данные из результатов следующих выражений запроса: SpotFleetRequestConfigs

Синтаксис

  describe-spot-fleet-requests
[--dry-run | --no-dry-run]
[--spot-fleet-request-ids <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--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 (логическое значение)

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

--spot-fleet-request-ids (список)

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

(строка)

Синтаксис:

"string" "string" ...

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

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

Токен для указания места начала постраничной обработки. Это NextToken из ранее урезанного ответа.

Примеры использования см. в разделе Постраничная обработка в Руководстве пользователя AWS Command Line Interface.

--page-size (целое число)

Размер каждой страницы для получения в вызове AWS-сервиса. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, получая меньше элементов в каждом вызове. Это может помочь предотвратить истечение времени ожидания вызовов AWS-сервиса.

Примеры использования см. в разделе Постраничная обработка в Руководстве пользователя AWS Command Line Interface.

--max-items (целое число)

Общее количество элементов, которые должны быть возвращены в выводе команды. Если общее количество доступных элементов больше указанного значения, в выводе команды предоставляется NextToken. Для возобновления постраничной обработки, предоставьте значение NextToken в аргументе starting-token последующей команды. **Не используйте** элемент ответа NextToken напрямую вне AWS CLI.

Примеры использования см. в разделе Постраничная обработка в Руководстве пользователя AWS Command Line Interface.

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

Примеры

Примечание

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

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

Описание ваших запросов на использование Spot Fleet

В этом примере описываются все ваши запросы на использование Spot Fleet.

Команда:

aws ec2 describe-spot-fleet-requests

Вывод:

{
  "SpotFleetRequestConfigs": [
      {
          "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE",
          "SpotFleetRequestConfig": {
              "TargetCapacity": 20,
              "LaunchSpecifications": [
                  {
                      "EbsOptimized": false,
                      "NetworkInterfaces": [
                          {
                              "SubnetId": "subnet-a61dafcf",
                              "DeviceIndex": 0,
                              "DeleteOnTermination": false,
                              "AssociatePublicIpAddress": true,
                              "SecondaryPrivateIpAddressCount": 0
                          }
                      ],
                      "InstanceType": "cc2.8xlarge",
                      "ImageId": "ami-1a2b3c4d"
                  },
                  {
                      "EbsOptimized": false,
                      "NetworkInterfaces": [
                          {
                              "SubnetId": "subnet-a61dafcf",
                              "DeviceIndex": 0,
                              "DeleteOnTermination": false,
                              "AssociatePublicIpAddress": true,
                              "SecondaryPrivateIpAddressCount": 0
                          }
                      ],
                      "InstanceType": "r3.8xlarge",
                      "ImageId": "ami-1a2b3c4d"
                  }
              ],
              "SpotPrice": "0.05",
              "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role"
          },
          "SpotFleetRequestState": "active"
      },
      {
          "SpotFleetRequestId": "sfr-306341ed-9739-402e-881b-ce47bEXAMPLE",
          "SpotFleetRequestConfig": {
              "TargetCapacity": 20,
              "LaunchSpecifications": [
                  {
                      "EbsOptimized": false,
                      "NetworkInterfaces": [
                          {
                              "SubnetId": "subnet-6e7f829e",
                              "DeviceIndex": 0,
                              "DeleteOnTermination": false,
                              "AssociatePublicIpAddress": true,
                              "SecondaryPrivateIpAddressCount": 0
                          }
                      ],
                      "InstanceType": "m3.medium",
                      "ImageId": "ami-1a2b3c4d"
                  }
              ],
              "SpotPrice": "0.05",
              "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role"
          },
          "SpotFleetRequestState": "active"
      }
  ]
}

Описание запроса на использование Spot Fleet

В этом примере описывается указанный запрос на использование Spot Fleet.

Команда:

aws ec2 describe-spot-fleet-requests --spot-fleet-request-ids sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE

Вывод:

{
  "SpotFleetRequestConfigs": [
      {
          "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE",
          "SpotFleetRequestConfig": {
              "TargetCapacity": 20,
              "LaunchSpecifications": [
                  {
                      "EbsOptimized": false,
                      "NetworkInterfaces": [
                          {
                              "SubnetId": "subnet-a61dafcf",
                              "DeviceIndex": 0,
                              "DeleteOnTermination": false,
                              "AssociatePublicIpAddress": true,
                              "SecondaryPrivateIpAddressCount": 0
                          }
                      ],
                      "InstanceType": "cc2.8xlarge",
                      "ImageId": "ami-1a2b3c4d"
                  },
                  {
                      "EbsOptimized": false,
                      "NetworkInterfaces": [
                          {
                              "SubnetId": "subnet-a61dafcf",
                              "DeviceIndex": 0,
                              "DeleteOnTermination": false,
                              "AssociatePublicIpAddress": true,
                              "SecondaryPrivateIpAddressCount": 0
                          }
                      ],
                      "InstanceType": "r3.8xlarge",
                      "ImageId": "ami-1a2b3c4d"
                  }
              ],
              "SpotPrice": "0.05",
              "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role"
          },
          "SpotFleetRequestState": "active"
      }
  ]
}

Вывод

NextToken -> (строка)

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

SpotFleetRequestConfigs -> (список)

Информация о конфигурации вашего Spot Fleet.

(структура)

Описание запроса Spot Fleet.

ActivityStatus -> (строка)

Прогресс запроса Spot Fleet. Если произошла ошибка, статус равен error. После размещения всех запросов статус равен pending_fulfillment. Если размер флота равен или больше целевой емкости, статус равен fulfilled. Если размер флота уменьшается, статус равен pending_termination, пока Spot-инстансы завершают работу.

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

Дата и время создания запроса.

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

Конфигурация запроса Spot Fleet.

AllocationStrategy -> (строка)

Стратегия, определяющая, как распределить целевую емкость Spot-инстансов по пулам Spot-инстансов, указанным в конфигурации запуска Spot Fleet. Дополнительную информацию см. в разделе Стратегии распределения Spot-инстансов в руководстве пользователя Amazon EC2.

priceCapacityOptimized (рекомендуется)

Spot Fleet определяет пулы с наибольшей доступностью емкости для запускаемого числа инстансов. Это означает, что мы будем запрашивать Spot-инстансы из пулов, которые, по нашему мнению, имеют наименьший риск прерывания в ближайшее время. Затем Spot Fleet запрашивает Spot-инстансы из пула с самой низкой ценой в этих пулах.

capacityOptimized

Spot Fleet определяет пулы с наибольшей доступностью емкости для запускаемого числа инстансов. Это означает, что мы будем запрашивать Spot-инстансы из пулов, которые, по нашему мнению, имеют наименьший риск прерывания в ближайшее время. Чтобы повысить вероятность запуска определенных типов инстансов, используйте capacityOptimizedPrioritized. Установите приоритет для каждого типа инстанса, используя параметр Priority для LaunchTemplateOverrides. Вы можете назначить одинаковый приоритет различным LaunchTemplateOverrides. EC2 реализует приоритеты с наилучшими усилиями, но в первую очередь оптимизирует емкость. capacityOptimizedPrioritized поддерживается только в том случае, если ваш Spot Fleet использует шаблон запуска. Обратите внимание, что если OnDemandAllocationStrategy установлено в значение prioritized, тот же приоритет применяется при удовлетворении емкости On-Demand.

diversified

Spot Fleet запрашивает инстансы из всех указанных вами пулов Spot-инстансов.

lowestPrice (не рекомендуется)

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

Мы не рекомендуем стратегию распределения lowestPrice, так как она имеет наибольший риск прерывания работы ваших Spot-инстансов.

Spot Fleet запрашивает инстансы из пула Spot-инстансов с самой низкой ценой, имеющего доступную емкость. Если пул с самой низкой ценой не имеет доступной емкости, Spot-инстансы берутся из следующего пула с самой низкой ценой, имеющего доступную емкость. Если пул исчерпает емкость, прежде чем удовлетворить вашу желаемую емкость, Spot Fleet будет продолжать удовлетворять ваш запрос, выбирая из следующего пула с самой низкой ценой. Для обеспечения вашей желаемой емкости вы можете получить Spot-инстансы из нескольких пулов. Поскольку эта стратегия учитывает только цену инстанса, а не доступность емкости, она может привести к высокой частоте прерываний.

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

OnDemandAllocationStrategy -> (строка)

Порядок перезаписи шаблона запуска, используемого для удовлетворения емкости On-Demand. Если вы укажете lowestPrice, Spot Fleet использует цену для определения порядка, запуская инстансы с самой низкой ценой в первую очередь. Если вы укажете prioritized, Spot Fleet использует приоритет, который вы назначаете каждому экземпляру перезаписи шаблона запуска Spot Fleet, запуская экземпляры с наивысшим приоритетом в первую очередь. Если вы не укажете значение, Spot Fleet по умолчанию использует lowestPrice.

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

Стратегии управления вашими Spot-инстансами, которые имеют повышенный риск прерывания.

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

Стратегия замены Spot-инстансов, используемая при получении от Amazon EC2 сигнала о том, что ваш Spot-инстанс имеет повышенный риск прерывания. Дополнительную информацию см. в разделе Перебалансировка емкости в руководстве пользователя Amazon EC2.

ReplacementStrategy -> (строка)

Стратегия замены. Доступна только для флотов типа maintain.

launch - Spot Fleet запускает новый заменяющий Spot-инстанс при получении уведомления о перебалансировке для существующего Spot-инстанса во флоте. Spot Fleet не завершает работу инстансов, получивших уведомление о перебалансировке. Вы можете завершить работу старых инстансов или оставить их работающими. Вам будет взиматься плата за все инстансы в течение всего времени их работы.

launch-before-terminate - Spot Fleet запускает новый заменяющий Spot-инстанс при получении уведомления о перебалансировке для существующего Spot-инстанса во флоте, а затем, после задержки, которую вы укажете (в TerminationDelay), завершает работу инстансов, получивших уведомление о перебалансировке.

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

Время (в секундах), которое Amazon EC2 ждет перед завершением работы старого Spot-инстанса после запуска нового заменяющего Spot-инстанса.

Требуется, когда ReplacementStrategy установлено в launch-before-terminate.

Недействительно, когда ReplacementStrategy установлено в launch.

Допустимые значения: Минимальное значение 120 секунд. Максимальное значение 7200 секунд.

ClientToken -> (строка)

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

ExcessCapacityTerminationPolicy -> (строка)

Указывает, нужно ли завершать работу работающих инстансов, если вы уменьшите целевую емкость запроса Spot Fleet ниже текущего размера Spot Fleet.

Поддерживается только для флотов типа maintain.

FulfilledCapacity -> (двойное число)

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

OnDemandFulfilledCapacity -> (двойное число)

Количество единиц On-Demand, выполненных данным запросом по сравнению с заданной целевой емкостью On-Demand.

IamFleetRole -> (строка)

Amazon Resource Name (ARN) роли Identity and Access Management (IAM), которая предоставляет Spot Fleet разрешение на запрос, запуск, завершение работы и маркирование инстансов от вашего имени. Дополнительную информацию см. в разделе Предварительные требования к Spot Fleet в руководстве пользователя Amazon EC2. Spot Fleet может завершить работу Spot-инстансов от вашего имени при отмене запроса Spot Fleet с помощью CancelSpotFleetRequests или при истечении срока действия запроса Spot Fleet, если вы установите TerminateInstancesWithExpiration.

LaunchSpecifications -> (список)

Спецификации запуска запроса Spot Fleet. Если вы укажете LaunchSpecifications, вы не сможете указать LaunchTemplateConfigs. Если вы включаете емкость On-Demand в свой запрос, вы должны использовать LaunchTemplateConfigs.

Примечание

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

(структура)

Описание спецификаций запуска одного или нескольких экземпляров Spot. Если вы включаете емкость On-Demand в свой запрос флота или хотите указать сетевое устройство EFA, вы не можете использовать SpotFleetLaunchSpecification; вы должны использовать LaunchTemplateConfig.

AddressingType -> (строка)

Устарело.

BlockDeviceMappings -> (список)

Один или несколько блочных устройств, которые сопоставлены с экземплярами Spot. Вы не можете указать и идентификатор снимка, и значение шифрования. Это связано с тем, что только пустые тома могут быть зашифрованы при создании. Если снимок является основой для тома, он не пуст, и его статус шифрования используется для статуса шифрования тома.

(структура)

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

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

Параметры, используемые для автоматической настройки томов EBS при запуске экземпляра.

DeleteOnTermination -> (булево)

Указывает, будет ли том EBS удален при завершении работы экземпляра. Дополнительную информацию см. в руководстве пользователя Amazon EC2 в разделе «Сохранение томов Amazon EBS при завершении работы экземпляра».

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

Количество операций ввода-вывода в секунду (IOPS). Для томов типов gp3, io1 и io2 это число IOPS, которые зарезервированы для тома. Для томов типа gp2 это базовая производительность тома и скорость накопления кредитов ввода-вывода для повышения производительности.

Следующие значения поддерживаются для каждого типа тома:

  • gp3: 3 000—16 000 IOPS
  • io1: 100—64 000 IOPS
  • io2: 100—256 000 IOPS

Для томов io2 вы можете достичь до 256 000 IOPS на экземплярах, созданных на основе Nitro System. На других экземплярах вы можете достичь производительности до 32 000 IOPS.

Этот параметр требуется для томов io1 и io2. По умолчанию для томов gp3 значение равно 3 000 IOPS.

SnapshotId -> (строка)

Идентификатор снимка.

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

Размер тома в GiB. Вы должны указать либо идентификатор снимка, либо размер тома. Если вы указываете снимок, по умолчанию используется размер снимка. Вы можете указать размер тома, который равен или больше размера снимка.

Следующие значения поддерживаются для каждого типа тома:

  • gp2 и gp3: 1—16 384 GiB
  • io1: 4—16 384 GiB
  • io2: 4—65 536 GiB
  • st1 и sc1: 125—16 384 GiB
  • standard: 1—1024 GiB

VolumeType -> (строка)

Тип тома. Дополнительную информацию см. в руководстве пользователя Amazon EBS в разделе «Типы томов Amazon EBS».

KmsKeyId -> (строка)

Идентификатор (ИД ключа, псевдоним ключа, ARN ключа или ARN псевдонима) управляемого пользователем ключа KMS, используемого для шифрования томов EBS.

Этот параметр поддерживается только для объектов BlockDeviceMapping, вызываемых методами RunInstances, RequestSpotFleet и RequestSpotInstances.

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

Пропускная способность, которую поддерживает том в MiB/с.

Этот параметр действует только для томов типа gp3.

Диапазон допустимых значений: минимальное значение 125, максимальное 1000.

OutpostArn -> (строка)

ARN облачного поста Outpost, на котором хранится снимок.

Этот параметр не поддерживается при использовании CreateImage.

Encrypted -> (булево)

Указывает, был ли изменен статус шифрования тома EBS при восстановлении из резервного снимка. Эффект установки состояния шифрования в значение true зависит от источника тома (новый или из снимка), начального состояния шифрования, владения и того, включено ли шифрование по умолчанию. Дополнительную информацию см. в руководстве пользователя Amazon EBS в разделе «Шифрование Amazon EBS».

В любом случае вы не можете отключить шифрование зашифрованного тома.

Зашифрованные тома могут быть подключены только к экземплярам, которые поддерживают шифрование Amazon EBS. Дополнительную информацию см. в разделе Поддерживаемые типы экземпляров.

Этот параметр не возвращается методом DescribeImageAttribute.

Для CreateImage и RegisterImage разрешение на включение этого параметра и допустимые значения зависят от типа создаваемого отображения блочных устройств.

  • Если вы создаете отображение блочных устройств для нового (пустого) тома, вы можете включить этот параметр и указать true для зашифрованного тома или false для незашифрованного. Если вы опустите этот параметр, он по умолчанию будет равен false (незашифрованный).
  • Если вы создаете отображение блочных устройств из существующего зашифрованного или незашифрованного снимка, вы должны опустить этот параметр. Если вы включите этот параметр, запрос завершится ошибкой независимо от указанного значения.
  • Если вы создаете отображение блочных устройств из существующего незашифрованного тома, вы можете включить этот параметр, но вы должны указать false. Если вы укажете true, запрос завершится ошибкой. В этом случае мы рекомендуем опустить этот параметр.
  • Если вы создаете отображение блочных устройств из существующего зашифрованного тома, вы можете включить этот параметр и указать true или false. Однако если вы укажете false, параметр будет проигнорирован, и отображение блочных устройств всегда будет зашифровано. В этом случае мы рекомендуем опустить этот параметр.

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

Указывает скорость инициализации тома Amazon EBS в MiB/с, с которой блоки снимка загружаются из Amazon S3 в том. Это также известно как инициализация тома. Указание скорости инициализации тома гарантирует, что том будет инициализирован с предсказуемой и постоянной скоростью после создания.

Этот параметр поддерживается только для томов, созданных из снимков. Опустите этот параметр, если:

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

Примечание

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

Дополнительную информацию см. в руководстве пользователя Amazon EC2 в разделе «Инициализация томов Amazon EBS».

Этот параметр не поддерживается при использовании CreateImage.

Диапазон допустимых значений: 100—300 MiB/с

NoDevice -> (строка)

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

DeviceName -> (строка)

Имя устройства (например, /dev/sdh или xvdh).

VirtualName -> (строка)

Виртуальное имя устройства (ephemeral N). Тома хранилища экземпляров нумеруются, начиная с 0. Экземпляр типа с 2 доступными томами хранилища экземпляра может указать отображения для ephemeral0 и ephemeral1. Количество доступных томов хранилища экземпляра зависит от типа экземпляра. После подключения к экземпляру вы должны смонтировать том.

Тома хранилища экземпляров NVMe автоматически перечисляются и им присваивается имя устройства. Включение их в отображение блочных устройств не оказывает никакого эффекта.

Ограничения: для экземпляров M3 вы должны указать тома хранилища экземпляров в отображении блочных устройств для экземпляра. При запуске экземпляра M3 мы игнорируем любые тома хранилища экземпляров, указанные в отображении блочных устройств для AMI.

EbsOptimized -> (булево)

Указывает, оптимизированы ли экземпляры для ввода-вывода EBS. Эта оптимизация обеспечивает выделенную пропускную способность для Amazon EBS и оптимизированный стек конфигурации для обеспечения оптимальной производительности ввода-вывода EBS. Эта оптимизация не доступна для всех типов экземпляров. При использовании экземпляра EBS Optimized применяются дополнительные сборы за использование.

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

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

Профиль экземпляра IAM.

Arn -> (строка)

Amazon Resource Name (ARN) профиля экземпляра.

Name -> (строка)

Имя профиля экземпляра.

ImageId -> (строка)

Идентификатор AMI.

InstanceType -> (строка)

Тип экземпляра.

KernelId -> (строка)

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

KeyName -> (строка)

Имя пары ключей.

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

Включение или отключение мониторинга для экземпляров.

Enabled -> (булево)

Включает мониторинг для экземпляра.

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

NetworkInterfaces -> (список)

Сетевые интерфейсы.

Примечание

SpotFleetLaunchSpecification не поддерживает адаптер Elastic Fabric Adapter (EFA). Вы должны использовать LaunchTemplateConfig вместо него.

(структура)

Описание сетевого интерфейса.

AssociatePublicIpAddress -> (boolean)

Указывает, следует ли назначить общедоступный IP-адрес IPv4 экземпляру, запущенному в VPC. Общедоступный IP-адрес может быть назначен только сетевому интерфейсу для eth0 и только новому сетевому интерфейсу, а не существующему. Вы не можете указать более одного сетевого интерфейса в запросе. Если запуск осуществляется в подсети по умолчанию, значение по умолчанию равно true .

Amazon Web Services взимает плату за все общедоступные IPv4-адреса, включая общедоступные IPv4-адреса, связанные с работающими экземплярами и Elastic IP-адресами. Дополнительную информацию см. на вкладке «Общедоступный IPv4-адрес» на странице ценообразования Amazon VPC.

DeleteOnTermination -> (boolean)

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

Description -> (string)

Описание сетевого интерфейса. Применимо только при создании сетевого интерфейса при запуске экземпляра.

DeviceIndex -> (integer)

Позиция сетевого интерфейса в порядке подключения. Первичный сетевой интерфейс имеет индекс устройства 0.

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

Groups -> (list)

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

(string)

Ipv6AddressCount -> (integer)

Количество IPv6-адресов для назначения сетевому интерфейсу. Amazon EC2 выбирает IPv6-адреса из диапазона подсети. Вы не можете указать этот параметр и параметр назначения конкретных IPv6-адресов в одном запросе. Вы можете указать этот параметр, если вы указали минимальное количество экземпляров для запуска.

Ipv6Addresses -> (list)

IPv6-адреса для назначения сетевому интерфейсу. Вы не можете указать этот параметр и параметр назначения количества IPv6-адресов в одном запросе. Вы не можете указать этот параметр, если вы указали минимальное количество экземпляров для запуска.

(структура)

Описание IPv6-адреса.

Ipv6Address -> (string)

IPv6-адрес.

IsPrimaryIpv6 -> (boolean)

Определяет, является ли IPv6-адрес, связанный с сетевым интерфейсом, основным IPv6-адресом. При включении IPv6-адреса GUA в качестве основного IPv6, первый IPv6 GUA будет сделан основным IPv6-адресом до завершения работы экземпляра или отсоединения сетевого интерфейса. Дополнительную информацию см. в разделе RunInstances.

NetworkInterfaceId -> (string)

Идентификатор сетевого интерфейса.

Если вы создаёте Spot Fleet, опустите этот параметр, так как вы не можете указать идентификатор сетевого интерфейса в спецификации запуска.

PrivateIpAddress -> (string)

Приватный IPv4-адрес сетевого интерфейса. Применимо только при создании сетевого интерфейса при запуске экземпляра. Вы не можете указать этот параметр, если запускаете более одного экземпляра в запросе RunInstances.

PrivateIpAddresses -> (list)

Приватные IPv4-адреса для назначения сетевому интерфейсу. Только один приватный IPv4-адрес может быть назначен в качестве основного. Вы не можете указать этот параметр, если запускаете более одного экземпляра в запросе RunInstances.

(структура)

Описание дополнительного приватного IPv4-адреса для сетевого интерфейса.

Primary -> (boolean)

Указывает, является ли приватный IPv4-адрес основным приватным IPv4-адресом. Только один IPv4-адрес может быть назначен в качестве основного.

PrivateIpAddress -> (string)

Приватный IPv4-адрес.

SecondaryPrivateIpAddressCount -> (integer)

Количество дополнительных приватных IPv4-адресов. Вы не можете указать этот параметр и также указать дополнительный приватный IP-адрес с помощью параметра PrivateIpAddress.

SubnetId -> (string)

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

AssociateCarrierIpAddress -> (boolean)

Указывает, следует ли назначить адрес транспортного канала сетевому интерфейсу.

Вы можете назначить адрес транспортного канала только сетевому интерфейсу, который находится в подсети в зоне Wavelength. Дополнительную информацию об адресах транспортного канала см. в разделе «Адрес транспортного канала» в руководстве разработчика Amazon Web Services Wavelength.

InterfaceType -> (string)

Тип сетевого интерфейса.

Если вы указываете efa-only, не назначайте никакие IP-адреса сетевому интерфейсу. Сетевые интерфейсы только EFA не поддерживают IP-адреса.

Допустимые значения: interface | efa | efa-only

NetworkCardIndex -> (integer)

Индекс сетевой карты. Некоторые типы экземпляров поддерживают несколько сетевых карт. Первичному сетевому интерфейсу должен быть назначен индекс сетевой карты 0. Значение по умолчанию — индекс сетевой карты 0.

Если вы используете RequestSpotInstances для создания Spot-экземпляров, опустите этот параметр, так как вы не можете указать индекс сетевой карты при использовании этого API. Для указания индекса сетевой карты используйте RunInstances.

Ipv4Prefixes -> (list)

Делегированные префиксы IPv4, которые необходимо назначить сетевому интерфейсу. Вы не можете использовать этот параметр, если используете параметр Ipv4PrefixCount.

(структура)

Описание параметра префикса IPv4 для сетевого интерфейса.

Ipv4Prefix -> (string)

Префикс IPv4. Дополнительную информацию см. в разделе Назначение префиксов сетевым интерфейсам в руководстве пользователя Amazon EC2.

Ipv4PrefixCount -> (integer)

Количество делегированных префиксов IPv4, которые необходимо автоматически назначить сетевому интерфейсу. Вы не можете использовать этот параметр, если используете параметр Ipv4Prefix.

Ipv6Prefixes -> (list)

Делегированные префиксы IPv6, которые необходимо назначить сетевому интерфейсу. Вы не можете использовать этот параметр, если используете параметр Ipv6PrefixCount.

(структура)

Описание параметра префикса IPv6 для сетевого интерфейса.

Ipv6Prefix -> (string)

Префикс IPv6.

Ipv6PrefixCount -> (integer)

Количество делегированных префиксов IPv6, которые необходимо автоматически назначить сетевому интерфейсу. Вы не можете использовать этот параметр, если используете параметр Ipv6Prefix.

PrimaryIpv6 -> (boolean)

Основной IPv6-адрес сетевого интерфейса. При включении IPv6-адреса GUA в качестве основного IPv6, первый IPv6 GUA будет сделан основным IPv6-адресом до завершения работы экземпляра или отсоединения сетевого интерфейса. Дополнительную информацию об основных IPv6-адресах см. в разделе RunInstances.

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

Устанавливает настройки ENA Express для сетевого интерфейса, подключённого к экземпляру.

EnaSrdEnabled -> (boolean)

Указывает, включён ли ENA Express для сетевого интерфейса при запуске экземпляра.

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

Содержит настройки ENA Express для UDP-сетевого трафика для сетевого интерфейса, подключенного к экземпляру.

EnaSrdUdpEnabled -> (boolean)

Указывает, использует ли UDP-трафик ENA Express для вашего экземпляра. Чтобы гарантировать, что UDP-трафик может использовать ENA Express при запуске экземпляра, необходимо также установить EnaSrdEnabled в EnaSrdSpecificationRequest на true.

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

Спецификация отслеживания соединений группы безопасности, позволяющая задать таймаут для отслеживания соединений на сетевом интерфейсе Elastic. Дополнительную информацию см. в разделе Таймауты отслеживания соединений в руководстве пользователя Amazon EC2.

TcpEstablishedTimeout -> (integer)

Таймаут (в секундах) для неактивных TCP-соединений в установленном состоянии. Минимальное значение: 60 секунд. Максимальное значение: 432000 секунд (5 дней). Значение по умолчанию: 432000 секунд. Рекомендуется значение меньше 432000 секунд.

UdpStreamTimeout -> (integer)

Таймаут (в секундах) для неактивных UDP-потоков, классифицированных как потоки, которые увидели более одной транзакции запрос-ответ. Минимальное значение: 60 секунд. Максимальное значение: 180 секунд (3 минуты). Значение по умолчанию: 180 секунд.

UdpTimeout -> (integer)

Таймаут (в секундах) для неактивных UDP-потоков, которые видели трафик только в одном направлении или в одной транзакции запрос-ответ. Минимальное значение: 30 секунд. Максимальное значение: 60 секунд. Значение по умолчанию: 30 секунд.

EnaQueueCount -> (integer)

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

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

Информация о размещении.

AvailabilityZone -> (string)

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

[Только для Spot Fleet] Для указания нескольких зон доступности разделяйте их запятыми; например, «us-west-2a, us-west-2b».

GroupName -> (string)

Имя группы размещения.

Tenancy -> (string)

Тип аренды экземпляра (если экземпляр работает в VPC). Экземпляр с арендой dedicated работает на оборудовании с единым арендатором. Тип аренды host не поддерживается для Spot-экземпляров.

RamdiskId -> (string)

Идентификатор RAM-диска. Некоторые ядра требуют дополнительных драйверов при запуске. Проверьте требования к ядру, чтобы узнать, нужно ли указать RAM-диск. Для поиска требований к ядру обратитесь к центру ресурсов Amazon Web Services и найдите идентификатор ядра.

SpotPrice -> (string)

Максимальная цена за единицу часа, которую вы готовы заплатить за Spot-экземпляр. Мы не рекомендуем использовать этот параметр, так как он может привести к увеличению прерываний. Если вы не укажете этот параметр, вы будете платить текущую цену Spot.

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

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

SubnetId -> (string)

Идентификаторы подсетей, в которых нужно запустить экземпляры. Для указания нескольких подсетей разделяйте их запятыми; например, «subnet-1234abcdeexample1, subnet-0987cdef6example2».

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

UserData -> (string)

Данные пользователя в кодировке base64, которые экземпляры используют при запуске. Данные пользователя ограничены 16 КБ.

WeightedCapacity -> (double)

Количество единиц, предоставляемых указанным типом экземпляра. Это те же единицы, которые вы выбрали для установки целевой ёмкости в отношении экземпляров или характеристик производительности, таких как vCPU, память или ввод/вывод.

Если целевая ёмкость, делённая на это значение, не является целым числом, Amazon EC2 округляет количество экземпляров до ближайшего целого числа. Если это значение не указано, значение по умолчанию равно 1.

Примечание

При указании весов цена, используемая в стратегиях распределения lowestPrice и priceCapacityOptimized, составляет за единицу час (где цена экземпляра делится на указанный вес). Однако если все указанные веса превышают запрашиваемый TargetCapacity, что приводит к запуску только 1 экземпляра, цена используется за экземпляр час.

TagSpecifications -> (список)

Теги, которые следует применять при создании.

(структура)

Теги для ресурса Spot Fleet.

ResourceType -> (строка)

Тип ресурса. В настоящее время поддерживается только тип ресурса instance. Чтобы применить теги к запросу Spot Fleet при создании, используйте параметр TagSpecifications в `` SpotFleetRequestConfigData ``.

Tags -> (список)

Теги.

(структура)

Описание тега.

Key -> (строка)

Ключ тега.

Ограничения: ключи тегов чувствительны к регистру и принимают максимум 127 символов Юникода. Не могут начинаться с aws:.

Value -> (строка)

Значение тега.

Ограничения: значения тегов чувствительны к регистру и принимают максимум 256 символов Юникода.

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

Атрибуты для типов экземпляров. При указании атрибутов экземпляра Amazon EC2 определит типы экземпляров с указанными атрибутами.

Примечание

Если вы укажете InstanceRequirements , вы не можете указать InstanceType .

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

Минимальное и максимальное количество виртуальных процессоров (vCPU).

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

Минимальное количество vCPU. Если значение равно 0 , минимальное ограничение отсутствует.

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

Максимальное количество vCPU. Если этот параметр не указан, максимальное ограничение отсутствует.

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

Минимальный и максимальный объём памяти в Мбайт.

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

Минимальный объём памяти в Мбайт. Если этот параметр не указан, минимальное ограничение отсутствует.

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

Максимальный объём памяти в Мбайт. Если этот параметр не указан, максимальное ограничение отсутствует.

CpuManufacturers -> (список)

Производители процессоров для включения.

  • Для типов экземпляров с процессорами Intel укажите intel .
  • Для типов экземпляров с процессорами AMD укажите amd .
  • Для типов экземпляров с процессорами Amazon Web Services укажите amazon-web-services .
  • Для типов экземпляров с процессорами Apple укажите apple .

Примечание

Не путайте производителя процессора с архитектурой процессора. Экземпляры будут запущены с совместимой архитектурой процессора на основе образа Amazon Machine Image (AMI), который вы указали в шаблоне запуска.

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

(строка)

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

Минимальный и максимальный объём памяти на один vCPU в Гигабайтах.

По умолчанию: Минимальные и максимальные ограничения отсутствуют

Min -> (двойное число)

Минимальный объём памяти на один vCPU в Гигабайтах. Если этот параметр не указан, минимальное ограничение отсутствует.

Max -> (двойное число)

Максимальный объём памяти на один vCPU в Гигабайтах. Если этот параметр не указан, максимальное ограничение отсутствует.

ExcludedInstanceTypes -> (список)

Типы экземпляров для исключения.

Вы можете использовать строки с одним или несколькими символами подстановки, представленными звёздочкой (* ), чтобы исключить тип, размер или поколение экземпляра. Примеры: m5.8xlarge , c5*.* , m5a.* , r* , *3* .

Например, если вы укажете c5* , Amazon EC2 исключит всю семейство экземпляров C5, включая все типы экземпляров C5a и C5n. Если вы укажете m5a.* , Amazon EC2 исключит все типы экземпляров M5a, но не типы экземпляров M5n.

Примечание

Если вы укажете ExcludedInstanceTypes , вы не можете указать AllowedInstanceTypes .

По умолчанию: Типы экземпляров не исключены

(строка)

InstanceGenerations -> (список)

Указывает, включены ли типы экземпляров текущего или предыдущего поколения. Рекомендуется использовать типы экземпляров текущего поколения. Типы экземпляров текущего поколения, как правило, являются последними двумя-тремя поколениями в каждой семействе экземпляров. Дополнительную информацию см. в разделе «Типы экземпляров» в Руководстве пользователя Amazon EC2.

Для типов экземпляров текущего поколения укажите current .

Для типов экземпляров предыдущего поколения укажите previous .

По умолчанию: Типы экземпляров текущего и предыдущего поколений

(строка)

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

[Защита от цены] Пороговое значение защиты от цены для Spot-экземпляров в процентах, превышающее идентифицированную цену Spot. Идентифицированная цена Spot — это цена Spot самого низкого по цене типа экземпляра текущего поколения C, M или R с указанными атрибутами. Если ни один тип экземпляра текущего поколения C, M или R не соответствует вашим атрибутам, то идентифицированная цена Spot берется от самого низкого по цене типа экземпляра текущего поколения, а в случае неудачи — от самого низкого по цене типа экземпляра предыдущего поколения, соответствующего вашим атрибутам. При выборе Amazon EC2 типов экземпляров с вашими атрибутами типы экземпляров, цена Spot которых превышает указанный порог, будут исключены.

Параметр принимает целое число, которое Amazon EC2 интерпретирует как процент.

Если вы установите TargetCapacityUnitType на vcpu или memory-mib , порог защиты от цены применяется на основе цены за vCPU или за память, а не на основе цены за экземпляр.

Этот параметр не поддерживается для GetSpotPlacementScores и GetInstanceTypesFromInstanceRequirements.

Примечание

Можно указать только один из SpotMaxPricePercentageOverLowestPrice или MaxSpotPriceAsPercentageOfOptimalOnDemandPrice. Если вы не укажете ни один из них, Amazon EC2 автоматически применит оптимальную защиту от цены, чтобы последовательно выбирать из широкого диапазона типов экземпляров. Чтобы указать отсутствие порога защиты от цены для Spot-экземпляров, т. е. вы хотите учитывать все типы экземпляров, которые соответствуют вашим атрибутам, укажите один из этих параметров и задайте высокое значение, например, 999999.

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

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

[Защита от цены] Пороговое значение защиты от цены для On-Demand-экземпляров в процентах, превышающее идентифицированную цену On-Demand. Идентифицированная цена On-Demand — это цена самого низкого по цене типа экземпляра текущего поколения C, M или R с указанными атрибутами. При выборе Amazon EC2 типов экземпляров с вашими атрибутами типы экземпляров, цена которых превышает указанный порог, будут исключены.

Параметр принимает целое число, которое Amazon EC2 интерпретирует как процент.

Чтобы отключить защиту от цены, задайте высокое значение, например, 999999.

Этот параметр не поддерживается для GetSpotPlacementScores и GetInstanceTypesFromInstanceRequirements.

Примечание

Если вы установите TargetCapacityUnitType на vcpu или memory-mib , порог защиты от цены применяется на основе цены за vCPU или за память, а не на основе цены за экземпляр.

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

BareMetal -> (строка)

Указывает, должны ли включаться, исключаться или требоваться типы экземпляров bare metal.

  • Для включения типов экземпляров bare metal укажите included .
  • Для требования только типов экземпляров bare metal укажите required .
  • Для исключения типов экземпляров bare metal укажите excluded .

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

BurstablePerformance -> (строка)

Указывает, включены ли типы экземпляров с возможностью повышения производительности (T), исключены или требуются. Дополнительную информацию см. в разделе «Экземпляры с возможностью повышения производительности».

  • Для включения типов экземпляров с возможностью повышения производительности укажите included .
  • Для требования только типов экземпляров с возможностью повышения производительности укажите required .
  • Для исключения типов экземпляров с возможностью повышения производительности укажите excluded .

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

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

Указывает, должны ли типы экземпляров поддерживать приостановку работы для On-Demand-экземпляров.

Этот параметр не поддерживается для GetSpotPlacementScores.

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

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

Минимальное и максимальное количество сетевых интерфейсов.

По умолчанию: Минимальные и максимальные ограничения отсутствуют

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

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

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

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

LocalStorage -> (строка)

Указывает, должны ли включаться, исключаться или требоваться типы экземпляров с томами памяти экземпляров. Дополнительную информацию см. в разделе «Память экземпляра Amazon EC2» в Руководстве пользователя Amazon EC2.

  • Для включения типов экземпляров с томами памяти экземпляров укажите included .
  • Для требования только типов экземпляров с томами памяти экземпляров укажите required .
  • Для исключения типов экземпляров с томами памяти экземпляров укажите excluded .

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

LocalStorageTypes -> (список)

Тип локального хранилища, который требуется.

  • Для типов экземпляров с хранилищем на жёстких дисках (HDD) укажите hdd .
  • Для типов экземпляров с хранилищем на твердотельных накопителях (SSD) укажите ssd .

По умолчанию: hdd и ssd

(строка)

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

Минимальный и максимальный объём общего локального хранилища в ГБ.

По умолчанию: Минимальные и максимальные ограничения отсутствуют

Min -> (двойное число)

Минимальный объём общего локального хранилища в ГБ. Если этот параметр не указан, минимальное ограничение отсутствует.

Max -> (двойное число)

Максимальный объём общего локального хранилища в ГБ. Если этот параметр не указан, максимальное ограничение отсутствует.

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

Минимальная и максимальная пропускная способность Amazon EBS в Мбит/с. Дополнительную информацию см. в разделе «Оптимизированные экземпляры Amazon EBS» в Руководстве пользователя Amazon EC2.

По умолчанию: Минимальные и максимальные ограничения отсутствуют

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

Минимальная пропускная способность в Мбит/с. Если этот параметр не указан, минимальное ограничение отсутствует.

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

Максимальная пропускная способность в Мбит/с. Если этот параметр не указан, максимальное ограничение отсутствует.

AcceleratorTypes -> (список)

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

  • Для типов экземпляров с ускорителями FPGA укажите fpga .
  • Для типов экземпляров с ускорителями GPU укажите gpu .
  • Для типов экземпляров с ускорителями Inference укажите inference .

По умолчанию: Любой тип ускорителя

(строка)

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

Минимальное и максимальное количество ускорителей (GPU, FPGA или чипов Amazon Web Services Inferentia) на экземпляре.

Чтобы исключить типы экземпляров с ускорителями, установите Max на 0 .

По умолчанию: Минимальные и максимальные ограничения отсутствуют

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

Минимальное количество ускорителей. Если этот параметр не указан, минимальное ограничение отсутствует.

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

Максимальное количество ускорителей. Если этот параметр не указан, максимальное ограничение отсутствует.

AcceleratorManufacturers -> (список)

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

  • Для типов экземпляров с устройствами Amazon Web Services укажите amazon-web-services .
  • Для типов экземпляров с устройствами AMD укажите amd .
  • Для типов экземпляров с устройствами Habana укажите habana .
  • Для типов экземпляров с устройствами NVIDIA укажите nvidia .
  • Для типов экземпляров с устройствами Xilinx укажите xilinx .

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

(строка)

AcceleratorNames -> (список)

Ускорители, которые должны быть на типе экземпляра.

  • Для типов экземпляров с графическими процессорами NVIDIA A10G укажите a10g .
  • Для типов экземпляров с графическими процессорами NVIDIA A100 укажите a100 .
  • Для типов экземпляров с графическими процессорами NVIDIA H100 укажите h100 .
  • Для типов экземпляров с чипами Inferentia от Amazon Web Services укажите inferentia .
  • Для типов экземпляров с графическими процессорами NVIDIA GRID K520 укажите k520 .
  • Для типов экземпляров с графическими процессорами NVIDIA K80 укажите k80 .
  • Для типов экземпляров с графическими процессорами NVIDIA M60 укажите m60 .
  • Для типов экземпляров с графическими процессорами AMD Radeon Pro V520 укажите radeon-pro-v520 .
  • Для типов экземпляров с графическими процессорами NVIDIA T4 укажите t4 .
  • Для типов экземпляров с графическими процессорами NVIDIA T4G укажите t4g .
  • Для типов экземпляров с FPGA Xilinx VU9P укажите vu9p .
  • Для типов экземпляров с графическими процессорами NVIDIA V100 укажите v100 .

По умолчанию: любой ускоритель

(строка)

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

Минимальный и максимальный объём памяти ускорителя в MiB.

По умолчанию: без минимальных или максимальных ограничений

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

Минимальный объём памяти ускорителя в MiB. Если этот параметр не указан, минимального ограничения нет.

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

Максимальный объём памяти ускорителя в MiB. Если этот параметр не указан, максимального ограничения нет.

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

Минимальный и максимальный объём пропускной способности сети в гигабитах в секунду (Gbps).

По умолчанию: без минимальных или максимальных ограничений

Min -> (вещественное число)

Минимальный объём пропускной способности сети в Gbps. Если этот параметр не указан, минимального ограничения нет.

Max -> (вещественное число)

Максимальный объём пропускной способности сети в Gbps. Если этот параметр не указан, максимального ограничения нет.

AllowedInstanceTypes -> (список)

Типы экземпляров, к которым применяются заданные атрибуты. Все остальные типы экземпляров игнорируются, даже если они соответствуют заданным атрибутам.

Можно использовать строки с одной или несколькими подстановочными знаками, представленными звёздочкой (* ), чтобы разрешить тип, размер или поколение экземпляра. Примеры: m5.8xlarge , c5*.* , m5a.* , r* , *3* .

Например, если вы укажете c5* , Amazon EC2 разрешит всю семейство типов экземпляров C5, что включает все типы экземпляров C5a и C5n. Если вы укажете m5a.* , Amazon EC2 разрешит все типы экземпляров M5a, но не типы экземпляров M5n.

Примечание

Если вы укажете AllowedInstanceTypes , вы не можете указать ExcludedInstanceTypes .

По умолчанию: все типы экземпляров

(строка)

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

[Защита цен] Пороговое значение защиты цен для Spot-экземпляров в процентах от указанной цены On-Demand. Указанная цена On-Demand — это цена самого недорогого типа экземпляра текущего поколения C, M или R с заданными атрибутами. Если ни один тип экземпляра текущего поколения C, M или R не соответствует вашим атрибутам, цена определяется по самому дешёвому типу экземпляра текущего поколения, а затем — по самому дешёвому типу предыдущего поколения, соответствующему вашим атрибутам. Когда Amazon EC2 выбирает типы экземпляров с вашими атрибутами, он исключает типы экземпляров, цена которых превышает указанный порог.

Параметр принимает целое число, которое Amazon EC2 интерпретирует как процент.

Если вы установите TargetCapacityUnitType на vcpu или memory-mib , порог защиты цены будет основываться на цене за виртуальный процессор или за память, а не на цене за экземпляр.

Примечание

Можно указать только один из SpotMaxPricePercentageOverLowestPrice или MaxSpotPriceAsPercentageOfOptimalOnDemandPrice . Если вы не укажете ни один из них, Amazon EC2 автоматически применит оптимальную защиту цены, чтобы последовательно выбирать из широкого спектра типов экземпляров. Чтобы указать отсутствие порога защиты цен для Spot-экземпляров, то есть вы хотите учитывать все типы экземпляров, соответствующие вашим атрибутам, включите один из этих параметров и укажите высокое значение, например, 999999 .

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

Базовое производительность для рассмотрения, используя семейство экземпляров в качестве справочной точки. Семейство экземпляров устанавливает минимально допустимый уровень производительности. Amazon EC2 использует эту базу для ориентирования при выборе типов экземпляров, но нет гарантии, что выбранные типы экземпляров всегда будут превышать базовый уровень для каждого приложения. В настоящее время этот параметр поддерживает производительность ЦП в качестве фактора базовой производительности. Дополнительную информацию см. в разделе Защита производительности в Руководстве пользователя Amazon EC2.

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

Производительность ЦП для рассмотрения, используя семейство экземпляров в качестве справочной точки.

References -> (список)

Укажите семейство экземпляров, чтобы использовать его в качестве справочной точки для производительности ЦП. Все типы экземпляров, соответствующие вашим заданным атрибутам, будут сравниваться с производительностью ЦП указанного семейства экземпляров, независимо от производителя ЦП или архитектуры.

Примечание

В настоящее время в списке можно указать только одно семейство экземпляров.

(структура)

Укажите семейство экземпляров, чтобы использовать его в качестве справочной точки для производительности ЦП. Все типы экземпляров, соответствующие вашим заданным атрибутам, будут сравниваться с производительностью ЦП указанного семейства экземпляров, независимо от производителя ЦП или архитектуры.

Примечание

В настоящее время в списке можно указать только одно семейство экземпляров.

InstanceFamily -> (строка)

Семейство экземпляров, используемое в качестве справочной точки.

Примечание

Убедитесь, что вы указали правильное значение для семейства экземпляров. Семейство экземпляров — это всё до точки (. ) в имени типа экземпляра. Например, в типе экземпляра c6i.large семейством экземпляров является c6i , а не c6 . Дополнительную информацию см. в разделе Конвенции именования типов экземпляров Amazon EC2 в Типах экземпляров Amazon EC2.

Следующие семейства экземпляров не поддерживаются для защиты производительности:

  • c1
  • g3 | g3s
  • hpc7g
  • m1 | m2
  • mac1 | mac2 | mac2-m1ultra | mac2-m2 | mac2-m2pro
  • p3dn | p4d | p5
  • t1
  • u-12tb1 | u-18tb1 | u-24tb1 | u-3tb1 | u-6tb1 | u-9tb1 | u7i-12tb | u7in-16tb | u7in-24tb | u7in-32tb

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

Если вы укажете неподдерживаемое семейство экземпляров в качестве значения для базовой производительности, API возвращает пустой ответ для GetInstanceTypesFromInstanceRequirements и исключение для CreateFleet , RequestSpotFleet , ModifyFleet и ModifySpotFleetRequest .

SecurityGroups -> (список)

Наборы правил безопасности.

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

(структура)

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

GroupId -> (строка)

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

GroupName -> (строка)

Имя набора правил безопасности.

LaunchTemplateConfigs -> (список)

Шаблон запуска и настройка параметров. Если вы укажете LaunchTemplateConfigs, вы не сможете указать LaunchSpecifications. Если вы включаете емкость On-Demand в свой запрос, вы должны использовать LaunchTemplateConfigs.

(структура)

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

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

Шаблон запуска, который необходимо использовать. Убедитесь, что шаблон запуска не содержит параметр NetworkInterfaceId, поскольку вы не можете указать ID сетевого интерфейса в Spot Fleet.

LaunchTemplateId -> (строка)

ID шаблона запуска.

Вы должны указать LaunchTemplateId или LaunchTemplateName, но не оба.

LaunchTemplateName -> (строка)

Имя шаблона запуска.

Вы должны указать LaunchTemplateName или LaunchTemplateId, но не оба.

Version -> (строка)

Номер версии шаблона запуска, $Latest или $Default. Вы должны указать значение, в противном случае запрос завершится ошибкой.

Если значение равно $Latest, Amazon EC2 использует последнюю версию шаблона запуска.

Если значение равно $Default, Amazon EC2 использует стандартную версию шаблона запуска.

Overrides -> (список)

Любые параметры, которые вы указываете, переопределяют те же параметры в шаблоне запуска.

(структура)

Описание настроек параметров для шаблона запуска.

InstanceType -> (строка)

Тип экземпляра.

SpotPrice -> (строка)

Максимальная цена за час использования Spot-экземпляра. Мы не рекомендуем использовать этот параметр, так как он может привести к увеличению прерываний. Если вы не укажете этот параметр, вы будете платить текущую цену за Spot.

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

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

SubnetId -> (строка)

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

AvailabilityZone -> (строка)

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

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

Количество единиц, предоставляемых указанным типом экземпляра. Это те же единицы, которые вы выбрали для настройки целевой емкости в терминах экземпляров или характеристик производительности, таких как vCPU, память или ввод/вывод.

Если целевая емкость, деленная на это значение, не является целым числом, Amazon EC2 округляет количество экземпляров до ближайшего целого числа. Если это значение не указано, значение по умолчанию равно 1.

Примечание

При указании весов цена, используемая в стратегиях распределения lowestPrice и priceCapacityOptimized, составляет за единицу час (где цена экземпляра делится на указанный вес). Однако, если все указанные веса превышают запрашиваемый TargetCapacity, что приведет к запуску только 1 экземпляра, цена используется за час работы экземпляра.

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

Приоритет настройки шаблона запуска. Наивысший приоритет запускается в первую очередь.

Если OnDemandAllocationStrategy установлено на prioritized, Spot Fleet использует приоритет, чтобы определить, какую настройку шаблона запуска использовать в первую очередь для выполнения емкости On-Demand.

Если Spot AllocationStrategy установлено на capacityOptimizedPrioritized, Spot Fleet использует приоритет на основе наилучшего результата для определения, какую настройку шаблона запуска использовать для выполнения емкости Spot, но оптимизирует емкость в первую очередь.

Допустимые значения — целые числа, начиная с 0. Чем меньше число, тем выше приоритет. Если значение не установлено, настройка шаблона запуска имеет наименьший приоритет. Вы можете установить одинаковый приоритет для различных настроек шаблонов запуска.

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

Требования к экземпляру. При указании требований к экземпляру Amazon EC2 определит типы экземпляров с указанными требованиями, а затем запустит экземпляры из этих типов экземпляров с помощью ваших стратегий распределения On-Demand и Spot так же, как и при указании списка типов экземпляров.

Примечание

Если вы укажете InstanceRequirements, вы не можете указать InstanceType.

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

Минимальное и максимальное количество виртуальных процессоров.

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

Минимальное количество виртуальных процессоров. Если значение равно 0, ограничение по минимуму отсутствует.

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

Максимальное количество виртуальных процессоров. Если этот параметр не указан, ограничение по максимуму отсутствует.

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

Минимальный и максимальный объем памяти в МиБ.

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

Минимальный объем памяти в МиБ. Если этот параметр не указан, ограничение по минимуму отсутствует.

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

Максимальный объем памяти в МиБ. Если этот параметр не указан, ограничение по максимуму отсутствует.

CpuManufacturers -> (список)

Производители процессоров для включения.

  • Для типов экземпляров с процессорами Intel укажите intel.
  • Для типов экземпляров с процессорами AMD укажите amd.
  • Для типов экземпляров с процессорами Amazon Web Services укажите amazon-web-services.
  • Для типов экземпляров с процессорами Apple укажите apple.

Примечание

Не путайте производителя процессора с архитектурой процессора. Экземпляры будут запускаться с совместимой архитектурой процессора на основе образа Amazon Machine Image (AMI), который вы указываете в шаблоне запуска.

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

(строка)

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

Минимальный и максимальный объем памяти на виртуальный процессор в ГиБ.

По умолчанию: без минимальных или максимальных ограничений

Min -> (вещественное число)

Минимальный объем памяти на виртуальный процессор в ГиБ. Если этот параметр не указан, ограничение по минимуму отсутствует.

Max -> (вещественное число)

Максимальный объем памяти на виртуальный процессор в ГиБ. Если этот параметр не указан, ограничение по максимуму отсутствует.

ExcludedInstanceTypes -> (список)

Типы экземпляров для исключения.

Вы можете использовать строки с одной или несколькими подстановками, представленными звездочкой (*), для исключения типа, размера или поколения экземпляра. Ниже приведены примеры: m5.8xlarge, c5*.*, m5a.*, r*, *3*.

Например, если вы укажете c5*, Amazon EC2 исключит всю семейство экземпляров C5, включая все типы экземпляров C5a и C5n. Если вы укажете m5a.*, Amazon EC2 исключит все типы экземпляров M5a, но не типы экземпляров M5n.

Примечание

Если вы укажете ExcludedInstanceTypes, вы не можете указать AllowedInstanceTypes.

По умолчанию: нет исключенных типов экземпляров

(строка)

InstanceGenerations -> (список)

Указывает, включаются ли типы экземпляров текущего или предыдущего поколения. Типы экземпляров текущего поколения рекомендуются для использования. Типы экземпляров текущего поколения, как правило, являются последними двумя-тремя поколениями в каждой семействе экземпляров. Дополнительные сведения см. в разделе Типы экземпляров в руководстве пользователя Amazon EC2.

Для типов экземпляров текущего поколения укажите current.

Для типов экземпляров предыдущего поколения укажите previous.

По умолчанию: типы экземпляров текущего и предыдущего поколения

(строка)

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

[Защита от цен] Пороговое значение защиты от цен для Spot-экземпляров, выраженное в процентах, превышающее идентифицированную цену Spot. Идентифицированная цена Spot — это цена Spot самого дешевого типа экземпляра текущего поколения C, M или R с указанными вами атрибутами. Если ни один тип экземпляра текущего поколения C, M или R не соответствует вашим атрибутам, тогда идентифицированная цена Spot берется от самого дешевого типа экземпляров текущего поколения, а в случае неудачи — от самого дешевого типа экземпляров предыдущего поколения, которые соответствуют вашим атрибутам. При выборе Amazon EC2 типов экземпляров с вашими атрибутами он будет исключать типы экземпляров, цена Spot которых превышает заданный вами порог.

Параметр принимает целое число, которое Amazon EC2 интерпретирует как процент.

Если вы установите TargetCapacityUnitType на vcpu или memory-mib, порог защиты от цен применяется на основе цены за виртуальный процессор или память вместо цены за экземпляр.

Этот параметр не поддерживается для GetSpotPlacementScores и GetInstanceTypesFromInstanceRequirements.

Примечание

Можно указать только один из параметров SpotMaxPricePercentageOverLowestPrice или MaxSpotPriceAsPercentageOfOptimalOnDemandPrice. Если вы не укажете ни один из них, Amazon EC2 автоматически применит оптимальную защиту от цен, чтобы последовательно выбирать из широкого спектра типов экземпляров. Чтобы указать отсутствие порога защиты от цен для Spot-экземпляров, то есть вы хотите учитывать все типы экземпляров, соответствующие вашим атрибутам, включите один из этих параметров и укажите высокое значение, например 999999.

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

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

[Защита от цен] Пороговое значение защиты от цен для экземпляров On-Demand, выраженное в процентах, превышающее идентифицированную цену On-Demand. Идентифицированная цена On-Demand — это цена самого дешевого типа экземпляра текущего поколения C, M или R с указанными вами атрибутами. При выборе Amazon EC2 типов экземпляров с вашими атрибутами он будет исключать типы экземпляров, цена которых превышает заданный вами порог.

Параметр принимает целое число, которое Amazon EC2 интерпретирует как процент.

Чтобы отключить защиту от цен, укажите высокое значение, например 999999.

Этот параметр не поддерживается для GetSpotPlacementScores и GetInstanceTypesFromInstanceRequirements.

Примечание

Если вы установите TargetCapacityUnitType на vcpu или memory-mib, порог защиты от цен применяется на основе цены за виртуальный процессор или память вместо цены за экземпляр.

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

BareMetal -> (строка)

Указывает, должны ли типы экземпляров bare metal включаться, исключаться или быть обязательными.

  • Чтобы включить типы экземпляров bare metal, укажите included.
  • Чтобы потребовать только типы экземпляров bare metal, укажите required.
  • Чтобы исключить типы экземпляров bare metal, укажите excluded.

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

BurstablePerformance -> (строка)

Указывает, включаются ли типы экземпляров T с возможностью всплеска производительности, исключаются или являются обязательными. Дополнительные сведения см. в разделе Экземпляры с возможностью всплеска производительности.

  • Чтобы включить типы экземпляров с возможностью всплеска производительности, укажите included.
  • Чтобы потребовать только типы экземпляров с возможностью всплеска производительности, укажите required.
  • Чтобы исключить типы экземпляров с возможностью всплеска производительности, укажите excluded.

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

RequireHibernateSupport -> (булево)

Указывает, должны ли типы экземпляров поддерживать гибернацию для экземпляров On-Demand.

Этот параметр не поддерживается для GetSpotPlacementScores.

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

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

Минимальное и максимальное количество сетевых интерфейсов.

По умолчанию: без минимальных или максимальных ограничений

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

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

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

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

LocalStorage -> (строка)

Указывает, включаются ли типы экземпляров с томами хранилища экземпляра, исключаются или являются обязательными. Дополнительные сведения см. в разделе Хранилище экземпляра Amazon EC2 в руководстве пользователя Amazon EC2.

  • Чтобы включить типы экземпляров с томами хранилища экземпляра, укажите included.
  • Чтобы потребовать только типы экземпляров с томами хранилища экземпляра, укажите required.
  • Чтобы исключить типы экземпляров с томами хранилища экземпляра, укажите excluded.

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

LocalStorageTypes -> (список)

Тип локального хранилища, который требуется.

  • Для типов экземпляров с жестким диском (HDD) укажите hdd.
  • Для типов экземпляров с твердотельным накопителем (SSD) укажите ssd.

По умолчанию: hdd и ssd

(строка)

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

Минимальный и максимальный объем общего локального хранилища в ГиБ.

По умолчанию: без минимальных или максимальных ограничений

Min -> (вещественное число)

Минимальный объем общего локального хранилища в ГиБ. Если этот параметр не указан, ограничение по минимуму отсутствует.

Max -> (вещественное число)

Максимальный объем общего локального хранилища в ГиБ. Если этот параметр не указан, ограничение по максимуму отсутствует.

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

Минимальная и максимальная базовая пропускная способность Amazon EBS в Мбит/с. Дополнительные сведения см. в разделе Экземпляры с оптимизацией под Amazon EBS в руководстве пользователя Amazon EC2.

По умолчанию: без минимальных или максимальных ограничений

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

Минимальная базовая пропускная способность в Мбит/с. Если этот параметр не указан, ограничение по минимуму отсутствует.

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

Максимальная базовая пропускная способность в Мбит/с. Если этот параметр не указан, ограничение по максимуму отсутствует.

AcceleratorTypes -> (список)

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

  • Для типов экземпляров с ускорителями FPGA укажите fpga.
  • Для типов экземпляров с ускорителями GPU укажите gpu.
  • Для типов экземпляров с ускорителями Inference укажите inference.

По умолчанию: любой тип ускорителя

(строка)

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

Минимальное и максимальное количество ускорителей (GPU, FPGA или чипы Amazon Web Services Inferentia) на экземпляре.

Чтобы исключить типы экземпляров с поддержкой ускорителей, установите Max на 0.

По умолчанию: без минимальных или максимальных ограничений

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

Минимальное количество ускорителей. Если этот параметр не указан, ограничение по минимуму отсутствует.

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

Максимальное количество ускорителей. Если этот параметр не указан, ограничение по максимуму отсутствует.

AcceleratorManufacturers -> (список)

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

  • Для типов экземпляров с устройствами Amazon Web Services укажите amazon-web-services.
  • Для типов экземпляров с устройствами AMD укажите amd.
  • Для типов экземпляров с устройствами Habana укажите habana.
  • Для типов экземпляров с устройствами NVIDIA укажите nvidia.
  • Для типов экземпляров с устройствами Xilinx укажите xilinx.

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

(строка)

AcceleratorNames -> (список)

Ускорители, которые должны быть на типе экземпляра.

  • Для типов экземпляров с графическими процессорами NVIDIA A10G укажите a10g.
  • Для типов экземпляров с графическими процессорами NVIDIA A100 укажите a100.
  • Для типов экземпляров с графическими процессорами NVIDIA H100 укажите h100.
  • Для типов экземпляров с чипами Inferentia Amazon Web Services укажите inferentia.
  • Для типов экземпляров с графическими процессорами NVIDIA GRID K520 укажите k520.
  • Для типов экземпляров с графическими процессорами NVIDIA K80 укажите k80.
  • Для типов экземпляров с графическими процессорами NVIDIA M60 укажите m60.
  • Для типов экземпляров с графическими процессорами AMD Radeon Pro V520 укажите radeon-pro-v520.
  • Для типов экземпляров с графическими процессорами NVIDIA T4 укажите t4.
  • Для типов экземпляров с графическими процессорами NVIDIA T4G укажите t4g.
  • Для типов экземпляров с FPGA Xilinx VU9P укажите vu9p.
  • Для типов экземпляров с графическими процессорами NVIDIA V100 укажите v100.

По умолчанию: любой ускоритель

(строка)

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

Минимальный и максимальный объём памяти ускорителей в МБ.

По умолчанию: нет минимальных или максимальных ограничений

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

Минимальный объём памяти ускорителя в МБ. Если этот параметр не указан, минимального ограничения нет.

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

Максимальный объём памяти ускорителя в МБ. Если этот параметр не указан, максимального ограничения нет.

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

Минимальный и максимальный объём пропускной способности сети в гигабитах в секунду (Гбит/с).

По умолчанию: нет минимальных или максимальных ограничений

Min -> (вещественное число)

Минимальный объём пропускной способности сети в Гбит/с. Если этот параметр не указан, минимального ограничения нет.

Max -> (вещественное число)

Максимальный объём пропускной способности сети в Гбит/с. Если этот параметр не указан, максимального ограничения нет.

AllowedInstanceTypes -> (список)

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

Вы можете использовать строки с одним или несколькими символами подстановки, представленными звёздочкой (*), для разрешения типа, размера или поколения экземпляра. Ниже приведены примеры: m5.8xlarge, c5*.*, m5a.*, r*, *3*.

Например, если вы укажете c5*, Amazon EC2 разрешит всю семейство экземпляров C5, которое включает все типы экземпляров C5a и C5n. Если вы укажете m5a.*, Amazon EC2 разрешит все типы экземпляров M5a, но не типы экземпляров M5n.

Примечание

Если вы укажете AllowedInstanceTypes, вы не можете указать ExcludedInstanceTypes.

По умолчанию: все типы экземпляров

(строка)

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

[Защита от цен] Пороговое значение защиты от цен для Spot-экземпляров в процентах от установленной цены On-Demand. Установленная цена On-Demand — это цена самого дешёвого типа экземпляра текущего поколения C, M или R с вашими указанными атрибутами. Если ни один тип экземпляра текущего поколения C, M или R не соответствует вашим атрибутам, цена определяется по самому дешёвому типу экземпляра текущего поколения, а в случае отсутствия — по самому дешёвому типу экземпляра предыдущего поколения, соответствующему вашим атрибутам. Когда Amazon EC2 выбирает типы экземпляров с вашими атрибутами, он исключает типы экземпляров, цена которых превышает указанный порог.

Параметр принимает целое число, которое Amazon EC2 интерпретирует как процент.

Если вы установите TargetCapacityUnitType на vcpu или memory-mib, пороговое значение защиты от цен будет основано на цене за процессорное ядро или память, а не на цене за экземпляр.

Примечание

Можно указать только один из SpotMaxPricePercentageOverLowestPrice или MaxSpotPriceAsPercentageOfOptimalOnDemandPrice. Если вы не укажете ни один из них, Amazon EC2 автоматически применит оптимальную защиту от цен, последовательно выбирая из широкого диапазона типов экземпляров. Чтобы указать отсутствие порога защиты от цен для Spot-экземпляров, то есть вы хотите учитывать все типы экземпляров, соответствующие вашим атрибутам, включите один из этих параметров и укажите высокое значение, например 999999.

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

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

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

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

References -> (список)

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

Примечание

В настоящее время в списке можно указать только одно семейство экземпляров.

(структура)

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

Примечание

В настоящее время в списке можно указать только одно семейство экземпляров.

InstanceFamily -> (строка)

Семейство экземпляров, используемое в качестве эталонной ссылки.

Примечание

Убедитесь, что вы указали правильное значение для семейства экземпляров. Семейство экземпляров — это всё до точки (.) в имени типа экземпляра. Например, в типе экземпляра c6i.large семейство экземпляров — c6i, а не c6. Дополнительную информацию см. в руководстве Amazon EC2 по именованию типов экземпляров.

Следующие семейства экземпляров не поддерживаются для защиты производительности:

  • c1
  • g3 | g3s
  • hpc7g
  • m1 | m2
  • mac1 | mac2 | mac2-m1ultra | mac2-m2 | mac2-m2pro
  • p3dn | p4d | p5
  • t1
  • u-12tb1 | u-18tb1 | u-24tb1 | u-3tb1 | u-6tb1 | u-9tb1 | u7i-12tb | u7in-16tb | u7in-24tb | u7in-32tb

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

Если вы укажете неподдерживаемое семейство экземпляров в качестве значения для базовой производительности, API вернёт пустой ответ для GetInstanceTypesFromInstanceRequirements и исключение для CreateFleet , RequestSpotFleet , ModifyFleet и ModifySpotFleetRequest.

SpotPrice -> (строка)

Максимальная цена за час использования Spot-экземпляра. Мы не рекомендуем использовать этот параметр, поскольку это может привести к увеличению прерываний. Если вы не укажете этот параметр, вы будете платить по текущей цене Spot.

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

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

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

Количество единиц, запрашиваемых для Spot Fleet. Вы можете выбрать установку целевой ёмкости в терминах экземпляров или характеристик производительности, важных для вашей рабочей нагрузки приложения, таких как vCPU, память или ввод/вывод. Если тип запроса — maintain, вы можете указать целевую ёмкость 0 и добавить ёмкость позже.

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

Количество единиц On-Demand, запрашиваемых. Вы можете выбрать установку целевой ёмкости в терминах экземпляров или характеристик производительности, важных для вашей рабочей нагрузки приложения, таких как vCPU, память или ввод/вывод. Если тип запроса — maintain, вы можете указать целевую ёмкость 0 и добавить ёмкость позже.

OnDemandMaxTotalPrice -> (строка)

Максимальная сумма в час для экземпляров On-Demand, которую вы готовы оплатить. Вы можете использовать параметр onDemandMaxTotalPrice, параметр spotMaxTotalPrice или оба параметра, чтобы убедиться, что стоимость вашей группы не превысит ваш бюджет. Если вы установите максимальную цену в час для экземпляров On-Demand и Spot в вашем запросе, Spot Fleet будет запускать экземпляры до тех пор, пока не достигнет максимальной суммы, которую вы готовы оплатить. Когда максимальная сумма, которую вы готовы оплатить, будет достигнута, флот перестанет запускать экземпляры, даже если он не достиг целевой ёмкости.

Примечание

Если ваша группа включает экземпляры T, настроенные как unlimited, и если их среднее использование процессора превышает базовый уровень использования, вы понесёте плату за излишки кредитов. onDemandMaxTotalPrice не учитывает излишки кредитов, и в случае использования излишков кредитов ваша конечная стоимость может быть выше, чем та, которую вы указали для onDemandMaxTotalPrice. Дополнительную информацию см. в разделе Излишки кредитов могут повлечь расходы в руководстве пользователя Amazon EC2.

SpotMaxTotalPrice -> (строка)

Максимальная сумма в час за экземпляры Spot Instances, которую вы готовы заплатить. Вы можете использовать параметр spotMaxTotalPrice, параметр onDemandMaxTotalPrice или оба параметра, чтобы убедиться, что стоимость вашего флота не превысит ваш бюджет. Если вы установите максимальную цену в час за экземпляры On-Demand Instances и Spot Instances в вашем запросе, Spot Fleet будет запускать экземпляры до тех пор, пока не достигнет максимальной суммы, которую вы готовы заплатить. Когда максимальная сумма, которую вы готовы заплатить, будет достигнута, флот перестанет запускать экземпляры, даже если он не достиг целевой емкости.

Примечание

Если ваш флот включает экземпляры типа T, которые настроены как unlimited, и если их среднее использование ЦП превышает базовый уровень использования, вы будете платить за избыточные кредиты. Параметр spotMaxTotalPrice не учитывает избыточные кредиты, и если вы используете избыточные кредиты, ваша окончательная стоимость может быть выше, чем та, которую вы указали для spotMaxTotalPrice. Для получения дополнительной информации см. Избыточные кредиты могут повлечь за собой расходы в руководстве пользователя Amazon EC2.

TerminateInstancesWithExpiration -> (boolean)

Указывает, будут ли приостановлены работающие экземпляры Spot Instances при истечении срока действия запроса Spot Fleet.

Type -> (string)

Тип запроса. Указывает, запрашивает ли Spot Fleet только целевую емкость или также пытается ее поддерживать. Когда это значение равно request, Spot Fleet только размещает необходимые запросы. Он не пытается восполнить Spot Instances, если емкость уменьшена, и не подает запросы в альтернативных пулах Spot, если емкость недоступна. Когда это значение равно maintain, Spot Fleet поддерживает целевую емкость. Spot Fleet размещает необходимые запросы для удовлетворения емкости и автоматически восполняет любые прерванные экземпляры. По умолчанию: maintain. instant указан, но не используется Spot Fleet.

ValidFrom -> (timestamp)

Дата и время начала запроса в формате UTC (ГГГГ-ММ-ДД Т*ЧЧ* :ММ :СС Z). По умолчанию Amazon EC2 начинает выполнение запроса немедленно.

ValidUntil -> (timestamp)

Дата и время окончания запроса в формате UTC (ГГГГ-ММ-ДД Т*ЧЧ* :ММ :СС Z). После даты и времени окончания новые запросы на Spot Instances не будут размещены или не смогут удовлетворить запрос. Если значение не указано, запрос Spot Fleet остается до его отмены.

ReplaceUnhealthyInstances -> (boolean)

Указывает, должен ли Spot Fleet заменять неисправные экземпляры.

InstanceInterruptionBehavior -> (string)

Поведение при прерывании экземпляра Spot Instance. По умолчанию terminate.

LoadBalancersConfig -> (structure)

Один или несколько Classic Load Balancers и целевые группы для подключения к запросу Spot Fleet. Spot Fleet регистрирует работающие экземпляры Spot Instances в указанных Classic Load Balancers и целевых группах.

С Network Load Balancers Spot Fleet не может регистрировать экземпляры с такими типами экземпляров: C1, CC1, CC2, CG1, CG2, CR1, CS1, G1, G2, HI1, HS1, M1, M2, M3 и T1.

ClassicLoadBalancersConfig -> (structure)

Classic Load Balancers.

ClassicLoadBalancers -> (list)

Один или несколько Classic Load Balancers.

(structure)

Описание Classic Load Balancer.

Name -> (string)

Название балансировщика.

TargetGroupsConfig -> (structure)

Целевые группы.

TargetGroups -> (list)

Одна или несколько целевых групп.

(structure)

Описание целевой группы балансировщика.

Arn -> (string)

Amazon Resource Name (ARN) целевой группы.

InstancePoolsToUseCount -> (integer)

Количество пулов Spot, в которых необходимо зарезервировать вашу целевую емкость Spot. Действительно только при AllocationStrategy Spot установлено на значение lowest-price. Spot Fleet выбирает самые дешевые пулы Spot и равномерно распределяет вашу целевую емкость Spot по количеству указанных вами пулов Spot.

Обратите внимание, что Spot Fleet пытается извлечь Spot Instances из указанного количества пулов на основе наилучшего результата. Если в пуле закончится емкость Spot до достижения вашей целевой емкости, Spot Fleet продолжит выполнение запроса, извлекая экземпляры из следующего по дешевизне пула. Для обеспечения достижения вашей целевой емкости вы можете получить Spot Instances из большего количества пулов, чем вы указали. Аналогично, если в большинстве пулов нет емкости Spot, вы можете получить всю свою целевую емкость из меньшего количества пулов, чем вы указали.

Context -> (string)

Зарезервировано.

TargetCapacityUnitType -> (string)

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

По умолчанию: units (количество экземпляров)

TagSpecifications -> (list)

Пара ключ-значение для маркировки запроса Spot Fleet при создании. Значение для ResourceType должно быть spot-fleet-request, в противном случае запрос Spot Fleet завершается ошибкой. Для маркировки экземпляров при запуске укажите метки в шаблоне запуска (действительно только если вы используете LaunchTemplateConfigs) или в `` SpotFleetTagSpecification `` (действительно только если вы используете LaunchSpecifications). Сведения о маркировке после запуска см. в разделе «Маркировка ваших ресурсов».

(structure)

Метки, которые необходимо применить к ресурсу при создании. При указании метки необходимо указать тип ресурса, иначе запрос завершится ошибкой.

Примечание

Список Valid Values содержит все типы ресурсов, которые можно маркировать. Однако действие, которое вы используете, может не поддерживать маркировку всех этих типов ресурсов. Если вы попытаетесь маркировать тип ресурса, который не поддерживается используемым действием, вы получите ошибку.

ResourceType -> (string)

Тип ресурса для маркировки при создании.

Tags -> (list)

Метки, которые необходимо применить к ресурсу.

(structure)

Описание метки.

Key -> (string)

Ключ метки.

Ограничения: ключи меток чувствительны к регистру и принимают максимум 127 символов Юникода. Не должны начинаться с aws:.

Value -> (string)

Значение метки.

Ограничения: значения меток чувствительны к регистру и принимают максимум 256 символов Юникода.

SpotFleetRequestId -> (string)

ID запроса Spot Fleet.

SpotFleetRequestState -> (string)

Состояние запроса Spot Fleet.

Tags -> (list)

Метки ресурса Spot Fleet.

(structure)

Описание метки.

Key -> (string)

Ключ метки.

Ограничения: ключи меток чувствительны к регистру и принимают максимум 127 символов Юникода. Не должны начинаться с aws:.

Value -> (string)

Значение метки.

Ограничения: значения меток чувствительны к регистру и принимают максимум 256 символов Юникода.

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

Spec-Zone.ru

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