Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

получение типов экземпляров по требованиям к экземплярам

Описание

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

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

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

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

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

Синтаксис

  get-instance-types-from-instance-requirements
[--dry-run | --no-dry-run]
--architecture-types <value>
--virtualization-types <value>
--instance-requirements <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 (boolean)

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

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

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

(строка)

Синтаксис:

"string" "string" ...

Where valid values are:
  i386
  x86_64
  arm64
  x86_64_mac
  arm64_mac

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

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

(строка)

Синтаксис:

"string" "string" ...

Where valid values are:
  hvm
  paravirtual

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

Атрибуты, необходимые для типов экземпляров.

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

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

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

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

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

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

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

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

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

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

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

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

CpuManufacturers -> (список)

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

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

Примечание

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

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

(строка)

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

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

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

Min -> (дробное число)

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

Max -> (дробное число)

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

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 с производительностью burst, исключены или требуются. Для получения дополнительной информации см. экземпляры с производительностью burst.

  • Чтобы включить типы экземпляров с производительностью burst, укажите included .
  • Чтобы потребовать только типы экземпляров с производительностью burst, укажите required .
  • Чтобы исключить типы экземпляров с производительностью burst, укажите 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 .
  • Для типов экземпляров с чипами 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). Дополнительную информацию см. в руководстве пользователя Amazon EC2, раздел «Пропускная способность сети экземпляров Amazon EC2».

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

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 .

Синтаксис JSON:

{
  "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"
        }
        ...
      ]
    }
  }
}

--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 (boolean)

Включить отладку регистрации.

--endpoint-url (string)

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

--no-verify-ssl (boolean)

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

--no-paginate (boolean)

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

--output (string)

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

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

--query (string)

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

--profile (string)

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

--region (string)

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

--version (string)

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

--color (string)

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

  • on
  • off
  • auto

--no-sign-request (boolean)

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

--ca-bundle (string)

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

--cli-read-timeout (int)

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

--cli-connect-timeout (int)

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

--cli-binary-format (string)

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

  • base64
  • raw-in-base64-out

--no-cli-pager (boolean)

Отключить вывод страницы CLI.

--cli-auto-prompt (boolean)

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

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

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

Примеры

Примечание

Чтобы использовать следующие примеры, вы должны установить и настроить AWS CLI. Подробнее см. руководство по началу работы в руководстве пользователя AWS CLI.

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

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

Следующий пример get-instance-types-from-instance-requirements сначала генерирует список всех возможных атрибутов, которые можно указать с помощью параметра --generate-cli-skeleton, и сохраняет этот список в JSON-файл. Затем JSON-файл используется для настройки атрибутов, для которых необходимо просмотреть соответствующие типы экземпляров.

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

aws ec2 get-instance-types-from-instance-requirements \
    --region us-east-1 \
    --generate-cli-skeleton input > attributes.json

Вывод:

{
    "DryRun": true,
    "ArchitectureTypes": [
        "x86_64_mac"
    ],
    "VirtualizationTypes": [
        "paravirtual"
    ],
    "InstanceRequirements": {
        "VCpuCount": {
            "Min": 0,
            "Max": 0
        },
        "MemoryMiB": {
            "Min": 0,
            "Max": 0
        },
        "CpuManufacturers": [
            "intel"
        ],
        "MemoryGiBPerVCpu": {
            "Min": 0.0,
            "Max": 0.0
        },
        "ExcludedInstanceTypes": [
            ""
        ],
        "InstanceGenerations": [
            "current"
        ],
        "SpotMaxPricePercentageOverLowestPrice": 0,
        "OnDemandMaxPricePercentageOverLowestPrice": 0,
        "BareMetal": "included",
        "BurstablePerformance": "excluded",
        "RequireHibernateSupport": true,
        "NetworkInterfaceCount": {
            "Min": 0,
            "Max": 0
        },
        "LocalStorage": "required",
        "LocalStorageTypes": [
            "hdd"
        ],
        "TotalLocalStorageGB": {
            "Min": 0.0,
            "Max": 0.0
        },
        "BaselineEbsBandwidthMbps": {
            "Min": 0,
            "Max": 0
        },
        "AcceleratorTypes": [
            "inference"
        ],
        "AcceleratorCount": {
            "Min": 0,
            "Max": 0
        },
        "AcceleratorManufacturers": [
            "xilinx"
        ],
        "AcceleratorNames": [
            "t4"
        ],
        "AcceleratorTotalMemoryMiB": {
            "Min": 0,
            "Max": 0
        }
    },
    "MaxResults": 0,
    "NextToken": ""
}

Настройте JSON-файл. Вы должны указать значения для ArchitectureTypes, VirtualizationTypes, VCpuCount и MemoryMiB. Другие атрибуты можно опустить. При опускании используются значения по умолчанию. Описание каждого атрибута и их значений по умолчанию см. в get-instance-types-from-instance-requirements <https://docs.aws.amazon.com/cli/latest/reference/ec2/get-instance-types-from-instance-requirements.html>.

Предварительный просмотр типов экземпляров, имеющих указанные в attributes.json атрибуты. Укажите имя и путь к своему JSON-файлу, используя параметр --cli-input-json. В следующем запросе вывод отформатирован как таблица.

aws ec2 get-instance-types-from-instance-requirements \
    --cli-input-json file://attributes.json \
    --output table

Содержание файла attributes.json:

{

    "ArchitectureTypes": [
        "x86_64"
    ],
    "VirtualizationTypes": [
        "hvm"
    ],
    "InstanceRequirements": {
        "VCpuCount": {
            "Min": 4,
            "Max": 6
        },
        "MemoryMiB": {
            "Min": 2048
        },
        "InstanceGenerations": [
            "current"
        ]
    }
}

Вывод:

------------------------------------------
|GetInstanceTypesFromInstanceRequirements|
+----------------------------------------+
||             InstanceTypes            ||
|+--------------------------------------+|
||             InstanceType             ||
|+--------------------------------------+|
||  c4.xlarge                           ||
||  c5.xlarge                           ||
||  c5a.xlarge                          ||
||  c5ad.xlarge                         ||
||  c5d.xlarge                          ||
||  c5n.xlarge                          ||
||  d2.xlarge                           ||
...

Дополнительную информацию об отборе типов экземпляров на основе атрибутов см. в разделе Как работает выбор типов экземпляров на основе атрибутов в руководстве пользователя Amazon EC2.

Вывод

InstanceTypes -> (список)

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

(структура)

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

InstanceType -> (строка)

Соответствующий тип экземпляра.

NextToken -> (строка)

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

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

Spec-Zone.ru

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