Блок приобретения емкости
Описание
Приобретите блок емкости для использования со своей учетной записью. С помощью блоков емкости вы гарантируете доступность емкости 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/UNIXRed Hat Enterprise LinuxSUSE LinuxWindowsWindows with SQL ServerWindows with SQL Server EnterpriseWindows with SQL Server StandardWindows with SQL Server WebLinux with SQL Server StandardLinux with SQL Server WebLinux with SQL Server EnterpriseRHEL with SQL Server StandardRHEL with SQL Server EnterpriseRHEL with SQL Server WebRHEL with HARHEL with HA and SQL Server StandardRHEL with HA and SQL Server EnterpriseUbuntu 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 -> (строка)
CapacityReservationArn -> (строка)
AvailabilityZoneId -> (строка)
InstanceType -> (строка)
InstancePlatform -> (строка)
AvailabilityZone -> (строка)
Tenancy -> (строка)
Указывает тип аренды резервирования емкости. Резервирование емкости может иметь один из следующих типов аренды:
-
default- Резервирование емкости создается на оборудовании, которое совместно используется с другими учетными записями Amazon Web Services. -
dedicated- Резервирование емкости создается на оборудовании с выделенной арендой, которое предназначено для одной учетной записи Amazon Web Services.
TotalInstanceCount -> (целое число)
AvailableInstanceCount -> (целое число)
EbsOptimized -> (булево)
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 -> (строка)
CapacityReservationFleetId -> (строка)
PlacementGroupArn -> (строка)
CapacityAllocations -> (список)
Информация об использовании емкости экземпляров.
(структура)
Информация об использовании емкости экземпляров для резервирования емкости.
AllocationType -> (строка)
used указывает, что емкость экземпляров используется экземплярами, работающими в резервировании емкости.Count -> (целое число)
4 указывает, что емкость экземпляров для 4 экземпляров в настоящее время используется.ReservationType -> (строка)
UnusedReservationBillingOwnerId -> (строка)
CommitmentInfo -> (структура)
Информация о вашем обязательстве по резервированию емкости на будущую дату.
CommittedInstanceCount -> (целое число)
CommitmentEndDate -> (временная метка)
YYYY-MM-DDThh:mm:ss.sssZ). Вы не можете уменьшить количество экземпляров или отменить резервирование емкости до этой даты и времени.DeliveryPreference -> (строка)
incremental указывает, что запрошенная емкость предоставляется в дополнение к любым работающим экземплярам и зарезервированной емкости, которая у вас есть на указанную дату и время.
© Copyright 2025, Amazon Web Services. Created using Sphinx.