Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

create-capacity-reservation-by-splitting

Описание

Создайте новую резервацию емкости, разделив емкость исходной резервации емкости. Новая резервация емкости будет иметь те же атрибуты, что и исходная резервация емкости, за исключением тегов. Исходная резервация емкости должна быть active и принадлежать вашему аккаунту Amazon Web Services.

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

Синтаксис

  create-capacity-reservation-by-splitting
[--dry-run | --no-dry-run]
[--client-token <value>]
--source-capacity-reservation-id <value>
--instance-count <value>
[--tag-specifications <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 (логическое значение)

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

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

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

--source-capacity-reservation-id (строка)

Идентификатор резервации емкости, из которой вы хотите разделить емкость.

--instance-count (целое число)

Количество экземпляров для разделения из исходной резервации емкости.

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

--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 (логическое значение)

Включить отладку логов.

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

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

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

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

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

Вывод

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

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

CapacityReservationId -> (строка)

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

OwnerId -> (строка)

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

CapacityReservationArn -> (строка)

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

AvailabilityZoneId -> (строка)

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

InstanceType -> (строка)

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

InstancePlatform -> (строка)

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

AvailabilityZone -> (строка)

Availability Zone, в котором резервируется емкость.

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 - Резервирование емкости принимает все экземпляры, имеющие соответствующие атрибуты (тип экземпляра, платформа и Availability Zone). Экземпляры, имеющие соответствующие атрибуты, запускаются в резервировании емкости автоматически без указания дополнительных параметров.
  • targeted - Резервирование емкости принимает только экземпляры, имеющие соответствующие атрибуты (тип экземпляра, платформа и Availability Zone), и явно нацеленные на резервирование емкости. Это гарантирует, что будут использоваться только разрешенные экземпляры.

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

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

Tags -> (список)

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

(структура)

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

Key -> (строка)

Ключ тега.

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

Value -> (строка)

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

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

OutpostArn -> (строка)

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

CapacityReservationFleetId -> (строка)

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

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

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

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

CapacityReservationId -> (string)

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

OwnerId -> (string)

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

CapacityReservationArn -> (string)

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

AvailabilityZoneId -> (string)

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

InstanceType -> (string)

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

InstancePlatform -> (string)

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

AvailabilityZone -> (string)

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

Tenancy -> (string)

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

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

TotalInstanceCount -> (integer)

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

AvailableInstanceCount -> (integer)

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

EbsOptimized -> (boolean)

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

EphemeralStorage -> (boolean)

Устарело.

State -> (string)

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

  • 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 -> (timestamp)

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

EndDate -> (timestamp)

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

EndDateType -> (string)

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

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

InstanceMatchCriteria -> (string)

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

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

CreateDate -> (timestamp)

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

Tags -> (list)

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

(structure)

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

Key -> (string)

Ключ тега.

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

Value -> (string)

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

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

OutpostArn -> (string)

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

CapacityReservationFleetId -> (string)

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

PlacementGroupArn -> (string)

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

CapacityAllocations -> (list)

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

(structure)

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

AllocationType -> (string)

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

Count -> (integer)

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

ReservationType -> (string)

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

UnusedReservationBillingOwnerId -> (string)

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

CommitmentInfo -> (structure)

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

CommittedInstanceCount -> (integer)

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

CommitmentEndDate -> (timestamp)

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

DeliveryPreference -> (string)

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

InstanceCount -> (integer)

Количество экземпляров в новом резервировании емкости. Количество экземпляров в исходном резервировании емкости было уменьшено на это количество.

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

Spec-Zone.ru

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