Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

Блок приобретения емкости

Описание

Приобретите блок емкости для использования со своей учетной записью. С помощью блоков емкости вы гарантируете доступность емкости GPU для задач машинного обучения (ML). Вы должны указать идентификатор предложения блока емкости, который вы приобретаете.

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

Синтаксис

  purchase-capacity-block
[--dry-run | --no-dry-run]
[--tag-specifications <value>]
--capacity-block-offering-id <value>
--instance-platform <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

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

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

--tag-specifications (список)

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

(структура)

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

Примечание

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

ResourceType -> (строка)

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

Tags -> (список)

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

(структура)

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

Key -> (строка)

Ключ тега.

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

Value -> (строка)

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

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

Краткая запись синтаксиса:

ResourceType=string,Tags=[{Key=string,Value=string},{Key=string,Value=string}] ...

Синтаксис JSON:

[
  {
    "ResourceType": "capacity-reservation"|"client-vpn-endpoint"|"customer-gateway"|"carrier-gateway"|"coip-pool"|"declarative-policies-report"|"dedicated-host"|"dhcp-options"|"egress-only-internet-gateway"|"elastic-ip"|"elastic-gpu"|"export-image-task"|"export-instance-task"|"fleet"|"fpga-image"|"host-reservation"|"image"|"import-image-task"|"import-snapshot-task"|"instance"|"instance-event-window"|"internet-gateway"|"ipam"|"ipam-pool"|"ipam-scope"|"ipv4pool-ec2"|"ipv6pool-ec2"|"key-pair"|"launch-template"|"local-gateway"|"local-gateway-route-table"|"local-gateway-virtual-interface"|"local-gateway-virtual-interface-group"|"local-gateway-route-table-vpc-association"|"local-gateway-route-table-virtual-interface-group-association"|"natgateway"|"network-acl"|"network-interface"|"network-insights-analysis"|"network-insights-path"|"network-insights-access-scope"|"network-insights-access-scope-analysis"|"outpost-lag"|"placement-group"|"prefix-list"|"replace-root-volume-task"|"reserved-instances"|"route-table"|"security-group"|"security-group-rule"|"service-link-virtual-interface"|"snapshot"|"spot-fleet-request"|"spot-instances-request"|"subnet"|"subnet-cidr-reservation"|"traffic-mirror-filter"|"traffic-mirror-session"|"traffic-mirror-target"|"transit-gateway"|"transit-gateway-attachment"|"transit-gateway-connect-peer"|"transit-gateway-multicast-domain"|"transit-gateway-policy-table"|"transit-gateway-route-table"|"transit-gateway-route-table-announcement"|"volume"|"vpc"|"vpc-endpoint"|"vpc-endpoint-connection"|"vpc-endpoint-service"|"vpc-endpoint-service-permission"|"vpc-peering-connection"|"vpn-connection"|"vpn-gateway"|"vpc-flow-log"|"capacity-reservation-fleet"|"traffic-mirror-filter-rule"|"vpc-endpoint-connection-device-type"|"verified-access-instance"|"verified-access-group"|"verified-access-endpoint"|"verified-access-policy"|"verified-access-trust-provider"|"vpn-connection-device-type"|"vpc-block-public-access-exclusion"|"route-server"|"route-server-endpoint"|"route-server-peer"|"ipam-resource-discovery"|"ipam-resource-discovery-association"|"instance-connect-endpoint"|"verified-access-endpoint-target"|"ipam-external-resource-verification-token"|"mac-modification-task",
    "Tags": [
      {
        "Key": "string",
        "Value": "string"
      }
      ...
    ]
  }
  ...
]

--capacity-block-offering-id (строка)

Идентификатор предложения блока емкости.

--instance-platform (строка)

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

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

  • Linux/UNIX
  • Red Hat Enterprise Linux
  • SUSE Linux
  • Windows
  • Windows with SQL Server
  • Windows with SQL Server Enterprise
  • Windows with SQL Server Standard
  • Windows with SQL Server Web
  • Linux with SQL Server Standard
  • Linux with SQL Server Web
  • Linux with SQL Server Enterprise
  • RHEL with SQL Server Standard
  • RHEL with SQL Server Enterprise
  • RHEL with SQL Server Web
  • RHEL with HA
  • RHEL with HA and SQL Server Standard
  • RHEL with HA and SQL Server Enterprise
  • Ubuntu Pro

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

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

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

--debug (boolean)

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

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

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

--no-verify-ssl (boolean)

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

--no-paginate (boolean)

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

--output (строка)

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

  • json
  • text
  • таблица
  • yaml
  • yaml-поток

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

  • вкл
  • выкл
  • авто

--no-sign-request (boolean)

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

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

Отключить кли-пагинатор для вывода.

--cli-auto-prompt (boolean)

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

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

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

Вывод

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

Резервирование емкости.

CapacityReservationId -> (строка)

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

OwnerId -> (строка)

Идентификатор учетной записи Amazon Web Services, владеющей резервированием емкости.

CapacityReservationArn -> (строка)

Amazon Resource Name (ARN) резервирования емкости.

AvailabilityZoneId -> (строка)

Идентификатор зоны доступности резервирования емкости.

InstanceType -> (строка)

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

InstancePlatform -> (строка)

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

AvailabilityZone -> (строка)

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

Tenancy -> (строка)

Указывает тип аренды резервирования емкости. Резервирование емкости может иметь один из следующих типов аренды:

  • default - Резервирование емкости создается на оборудовании, которое совместно используется с другими учетными записями Amazon Web Services.
  • dedicated - Резервирование емкости создается на оборудовании с выделенной арендой, которое предназначено для одной учетной записи Amazon Web Services.

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

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

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

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

EbsOptimized -> (булево)

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

EphemeralStorage -> (булево)

Устарело.

State -> (строка)

Текущее состояние резервирования емкости. Резервирование емкости может находиться в одном из следующих состояний:

  • active - Емкость доступна для использования.
  • expired - Резервирование емкости истекло автоматически в указанную в запросе дату и время. Зарезервированная емкость больше недоступна для использования.
  • cancelled - Резервирование емкости было отменено. Зарезервированная емкость больше недоступна для использования.
  • pending - Запрос на резервирование емкости был успешным, но предоставление емкости все еще ожидается.
  • failed - Запрос на резервирование емкости завершился неудачей. Запрос может завершиться неудачей из-за некорректных параметров запроса, ограничений емкости или ограничений на количество экземпляров. Вы можете просмотреть неудачный запрос в течение 60 минут.
  • scheduled - (Резервирование емкости на будущую дату ) Запрос на резервирование емкости на будущую дату был одобрен, и резервирование емкости запланировано на указанную дату начала.
  • payment-pending - (Блоки емкости ) Предварительная оплата еще не была обработана.
  • payment-failed - (Блоки емкости ) Предварительная оплата не была обработана в течение 12-часового периода. Ваш блок емкости был освобожден.
  • assessing - (Резервирование емкости на будущую дату ) Amazon EC2 оценивает ваш запрос на резервирование емкости на будущую дату.
  • delayed - (Резервирование емкости на будущую дату ) Amazon EC2 столкнулся с задержкой при предоставлении запрошенного резервирования емкости на будущую дату. Amazon EC2 не может предоставить запрошенную емкость к указанной дате и времени начала.
  • unsupported - (Резервирование емкости на будущую дату ) Amazon EC2 не может удовлетворить запрос на резервирование емкости на будущую дату из-за ограничений емкости. Вы можете просмотреть неподдерживаемые запросы в течение 30 дней. Резервирование емкости не будет предоставлено.

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

Дата и время начала резервирования емкости.

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

Дата и время окончания резервирования емкости. Когда резервирование емкости истекает, зарезервированная емкость высвобождается, и вы больше не можете запускать экземпляры в нее. Состояние резервирования емкости изменяется на expired при достижении даты и времени окончания.

EndDateType -> (строка)

Указывает способ окончания резервирования емкости. Резервирование емкости может иметь один из следующих типов окончания:

  • unlimited - Резервирование емкости остается активным до тех пор, пока вы его явно не отменяете.
  • limited - Резервирование емкости истекает автоматически в указанную дату и время.

InstanceMatchCriteria -> (строка)

Указывает тип запусков экземпляров, которые принимает резервирование емкости. Доступные варианты:

  • open - Резервирование емкости принимает все экземпляры, у которых соответствуют атрибуты (тип экземпляра, платформа и зона доступности). Экземпляры с соответствующими атрибутами запускаются в резервировании емкости автоматически без указания дополнительных параметров.
  • targeted - Резервирование емкости принимает только экземпляры, у которых соответствуют атрибуты (тип экземпляра, платформа и зона доступности), и которые явно указывают на резервирование емкости. Это гарантирует, что будут использоваться только разрешенные экземпляры.

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

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

Tags -> (список)

Любые теги, назначенные резервированию емкости.

(структура)

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

Key -> (строка)

Ключ тега.

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

Value -> (строка)

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

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

OutpostArn -> (строка)

Amazon Resource Name (ARN) региона Outpost, на котором было создано резервирование емкости.

CapacityReservationFleetId -> (строка)

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

PlacementGroupArn -> (строка)

Amazon Resource Name (ARN) группы размещения кластера, в которой было создано резервирование емкости. Дополнительную информацию можно найти в разделе «Резервирование емкости для групп размещения кластеров» в руководстве пользователя Amazon EC2.

CapacityAllocations -> (список)

Информация об использовании емкости экземпляров.

(структура)

Информация об использовании емкости экземпляров для резервирования емкости.

AllocationType -> (строка)

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

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

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

ReservationType -> (строка)

Тип резервирования емкости.

UnusedReservationBillingOwnerId -> (строка)

Идентификатор учетной записи Amazon Web Services, которой назначена оплата за неиспользуемую емкость резервирования емкости.

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

Информация о вашем обязательстве по резервированию емкости на будущую дату.

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

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

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

Дата и время окончания срока действия обязательства, в формате ISO8601 в часовом поясе UTC (YYYY-MM-DDThh:mm:ss.sssZ). Вы не можете уменьшить количество экземпляров или отменить резервирование емкости до этой даты и времени.

DeliveryPreference -> (строка)

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

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

Spec-Zone.ru

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