get-spot-placement-scores

Описание

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

Вы можете указать свои вычислительные требования, используя InstanceRequirementsWithMetadata и позволяя Amazon EC2 выбрать оптимальные типы экземпляров для выполнения вашего запроса Spot, или вы можете указать типы экземпляров, используя InstanceTypes .

Дополнительную информацию см. в руководстве пользователя Amazon EC2 в разделе «Рейтинг размещения Spot».

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

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

Синтаксис

  get-spot-placement-scores
[--instance-types <value>]
--target-capacity <value>
[--target-capacity-unit-type <value>]
[--single-availability-zone | --no-single-availability-zone]
[--region-names <value>]
[--instance-requirements-with-metadata <value>]
[--dry-run | --no-dry-run]
[--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]

Параметры

--instance-types (список)

Типы экземпляров. Рекомендуется указывать не менее трех типов экземпляров. Если вы укажете один или два типа экземпляров или укажете варианты одного типа экземпляра (например, m3.xlarge с и без хранилища экземпляра), возвращаемый рейтинг размещения всегда будет низким.

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

(строка)

Синтаксис:

"string" "string" ...

--target-capacity (целое число)

Целевая емкость.

--target-capacity-unit-type (строка)

Единица измерения целевой емкости.

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

vcpu
memory-mib
units

--single-availability-zone | --no-single-availability-zone (булево)

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

Список оцененных зон доступности полезен, если вы хотите запустить всю свою емкость Spot в одной зоне доступности.

--region-names (список)

Регионы, используемые для сужения списка регионов, подлежащих оценке. Введите код региона, например, us-east-1.

(строка)

Синтаксис:

"string" "string" ...

--instance-requirements-with-metadata (структура)

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

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

ArchitectureTypes -> (список)

Тип архитектуры.

(строка)

VirtualizationTypes -> (список)

Тип виртуализации.

(строка)

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

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

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

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

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

Минимальное количество vCPU. Чтобы не задавать минимальное ограничение, укажите 0 .

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

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

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

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

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

Минимальный объём памяти в МБ. Чтобы не задавать минимальное ограничение, укажите 0 .

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.

Примечание

По умолчанию: 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 -> (целое число)

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

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 .
Для типов экземпляров с чипами Amazon Web Services Inferentia укажите inferentia .
Для типов экземпляров с графическими процессорами NVIDIA GRID K520 укажите k520 .
Для типов экземпляров с графическими процессорами NVIDIA K80 укажите k80 .
Для типов экземпляров с графическими процессорами NVIDIA M60 укажите m60 .
Для типов экземпляров с графическими процессорами AMD Radeon Pro V520 укажите radeon-pro-v520 .
Для типов экземпляров с графическими процессорами NVIDIA T4 укажите t4 .
Для типов экземпляров с графическими процессорами NVIDIA T4G укажите t4g .
Для типов экземпляров с программируемыми логическими массивами Xilinx VU9P укажите vu9p .
Для типов экземпляров с графическими процессорами NVIDIA V100 укажите v100 .

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

(строка)

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

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

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

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

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

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

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

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

Минимальный и максимальный объем базовой пропускной способности сети в гигабитах в секунду (Гбит/с). Дополнительную информацию см. в разделе «Пропускная способность сети экземпляров Amazon EC2» в руководстве пользователя Amazon EC2.

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

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 по соглашениям об именовании типов экземпляров 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.

Синтаксис JSON:

{
  "ArchitectureTypes": ["i386"|"x86_64"|"arm64"|"x86_64_mac"|"arm64_mac", ...],
  "VirtualizationTypes": ["hvm"|"paravirtual", ...],
  "InstanceRequirements": {
    "VCpuCount": {
      "Min": integer,
      "Max": integer
    },
    "MemoryMiB": {
      "Min": integer,
      "Max": integer
    },
    "CpuManufacturers": ["intel"|"amd"|"amazon-web-services"|"apple", ...],
    "MemoryGiBPerVCpu": {
      "Min": double,
      "Max": double
    },
    "ExcludedInstanceTypes": ["string", ...],
    "InstanceGenerations": ["current"|"previous", ...],
    "SpotMaxPricePercentageOverLowestPrice": integer,
    "OnDemandMaxPricePercentageOverLowestPrice": integer,
    "BareMetal": "included"|"required"|"excluded",
    "BurstablePerformance": "included"|"required"|"excluded",
    "RequireHibernateSupport": true|false,
    "NetworkInterfaceCount": {
      "Min": integer,
      "Max": integer
    },
    "LocalStorage": "included"|"required"|"excluded",
    "LocalStorageTypes": ["hdd"|"ssd", ...],
    "TotalLocalStorageGB": {
      "Min": double,
      "Max": double
    },
    "BaselineEbsBandwidthMbps": {
      "Min": integer,
      "Max": integer
    },
    "AcceleratorTypes": ["gpu"|"fpga"|"inference", ...],
    "AcceleratorCount": {
      "Min": integer,
      "Max": integer
    },
    "AcceleratorManufacturers": ["amazon-web-services"|"amd"|"nvidia"|"xilinx"|"habana", ...],
    "AcceleratorNames": ["a100"|"inferentia"|"k520"|"k80"|"m60"|"radeon-pro-v520"|"t4"|"vu9p"|"v100"|"a10g"|"h100"|"t4g", ...],
    "AcceleratorTotalMemoryMiB": {
      "Min": integer,
      "Max": integer
    },
    "NetworkBandwidthGbps": {
      "Min": double,
      "Max": double
    },
    "AllowedInstanceTypes": ["string", ...],
    "MaxSpotPriceAsPercentageOfOptimalOnDemandPrice": integer,
    "BaselinePerformanceFactors": {
      "Cpu": {
        "References": [
          {
            "InstanceFamily": "string"
          }
          ...
        ]
      }
    }
  }
}

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

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

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

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

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

Примеры использования см. в разделе «Постраничная обработка» в руководстве пользователя AWS CLI.

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

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

Примеры использования см. в разделе «Постраничная обработка» в руководстве пользователя AWS CLI.

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

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

Примеры использования см. в разделе «Постраничная обработка» в руководстве пользователя AWS CLI.

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

Общие параметры

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

Включить отладочную запись в журнал.

--endpoint-url (строка)

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

--no-verify-ssl (логическое значение)

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

--no-paginate (логическое значение)

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

--output (строка)

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

json
text
table
yaml
yaml-stream

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

on
off
auto

--no-sign-request (логическое значение)

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

--ca-bundle (строка)

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

--cli-read-timeout (целое число)

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

--cli-connect-timeout (целое число)

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

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка в кодировке base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, соответствующего двоичному блоку, fileb:// всегда будет обрабатываться как двоичный и будет использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.

base64
raw-in-base64-out

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

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

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

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

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

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

Примеры

Примечание

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

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

Для расчета оценки размещения Spot для указанных требований

Следующий get-spot-placement-scores пример сначала создаёт список всех возможных параметров, которые можно указать для конфигурации оценки размещения Spot, используя параметр --generate-cli-skeleton, и сохраняет список в JSON-файл. Затем JSON-файл используется для настройки требований, которые нужно использовать для расчёта оценки размещения Spot.

Для генерации всех возможных параметров, которые можно указать для конфигурации оценки размещения Spot, и сохранения вывода непосредственно в JSON-файл.

aws ec2 get-spot-placement-scores \
    --region us-east-1 \
    --generate-cli-skeleton input > attributes.json

Вывод:

{
    "InstanceTypes": [
        ""
    ],
    "TargetCapacity": 0,
    "TargetCapacityUnitType": "vcpu",
    "SingleAvailabilityZone": true,
    "RegionNames": [
        ""
    ],
    "InstanceRequirementsWithMetadata": {
        "ArchitectureTypes": [
            "x86_64_mac"
        ],
        "VirtualizationTypes": [
            "hvm"
        ],
        "InstanceRequirements": {
            "VCpuCount": {
                "Min": 0,
                "Max": 0
            },
            "MemoryMiB": {
                "Min": 0,
                "Max": 0
            },
            "CpuManufacturers": [
                "amd"
            ],
            "MemoryGiBPerVCpu": {
                "Min": 0.0,
                "Max": 0.0
            },
            "ExcludedInstanceTypes": [
                ""
            ],
            "InstanceGenerations": [
                "previous"
            ],
            "SpotMaxPricePercentageOverLowestPrice": 0,
            "OnDemandMaxPricePercentageOverLowestPrice": 0,
            "BareMetal": "excluded",
            "BurstablePerformance": "excluded",
            "RequireHibernateSupport": true,
            "NetworkInterfaceCount": {
                "Min": 0,
                "Max": 0
            },
            "LocalStorage": "included",
            "LocalStorageTypes": [
                "hdd"
            ],
            "TotalLocalStorageGB": {
                "Min": 0.0,
                "Max": 0.0
            },
            "BaselineEbsBandwidthMbps": {
                "Min": 0,
                "Max": 0
            },
            "AcceleratorTypes": [
                "fpga"
            ],
            "AcceleratorCount": {
                "Min": 0,
                "Max": 0
            },
            "AcceleratorManufacturers": [
                "amd"
            ],
            "AcceleratorNames": [
                "vu9p"
            ],
            "AcceleratorTotalMemoryMiB": {
                "Min": 0,
                "Max": 0
            }
        }
    },
    "DryRun": true,
    "MaxResults": 0,
    "NextToken": ""
}

Настройте JSON-файл. Вам необходимо указать значение для TargetCapacity. Описание каждого параметра и их значений по умолчанию см. в Расчёт оценки размещения Spot (AWS CLI) <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-placement-score.html#calculate-sps-cli>.

Расчёт оценки размещения Spot для требований, указанных в attributes.json. Укажите имя и путь к вашему JSON-файлу, используя параметр --cli-input-json.

aws ec2 get-spot-placement-scores \
    --region us-east-1 \
    --cli-input-json file://attributes.json

Вывод, если SingleAvailabilityZone установлено в false или опущено (если опущено, по умолчанию устанавливается false). Возвращается список регионов с оценкой.

"Recommendation": [
    {
        "Region": "us-east-1",
        "Score": 7
    },
    {
        "Region": "us-west-1",
        "Score": 5
    },
   ...

Вывод, если SingleAvailabilityZone установлено в true. Возвращается список SingleAvailability Zones с оценкой.

"Recommendation": [
    {
        "Region": "us-east-1",
        "AvailabilityZoneId": "use1-az1"
        "Score": 8
    },
    {
        "Region": "us-east-1",
        "AvailabilityZoneId": "usw2-az3"
        "Score": 6
    },
   ...

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

Вывод

SpotPlacementScores -> (список)

Оценка размещения Spot для 10 лучших регионов или Availability Zones, оценивается по шкале от 1 до 10. Каждая оценка отражает вероятность успешного выполнения запрошенной целевой ёмкости в указанном регионе или Availability Zone в момент запроса оценки размещения Spot. Оценка 10 означает, что ваш запрос ёмкости Spot имеет высокую вероятность успеха в этом регионе или Availability Zone.

Если вы запрашиваете оценку размещения Spot для регионов, высокая оценка предполагает, что ваш запрос флота будет настроен на использование всех Availability Zones и стратегии распределения capacity-optimized. Если вы запрашиваете оценку размещения Spot для Availability Zones, высокая оценка предполагает, что ваш запрос флота будет настроен на использование одной Availability Zone и стратегии распределения capacity-optimized.

Разные регионы или Availability Zones могут иметь одинаковую оценку.

Примечание

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

(структура)

Оценка размещения Spot для этого региона или Availability Zone. Оценка рассчитывается на предположении, что используется стратегия распределения capacity-optimized и что могут использоваться все Availability Zones в данном регионе.

Region -> (строка)

Регион.

AvailabilityZoneId -> (строка)

Availability Zone.

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

Оценка размещения по шкале от 1 до 10. Оценка 10 указывает, что ваш запрос Spot с высокой вероятностью будет успешным в этом регионе или Availability Zone. Оценка 1 указывает, что ваш запрос Spot, вероятно, не будет успешным.

NextToken -> (строка)

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