describe-capacity-reservation-fleets
Описание
Описывает один или несколько резервируемых емкостных флотов.
См. также: Документацию AWS API
describe-capacity-reservation-fleets является постраничной операцией. Для получения всего набора результатов могут потребоваться несколько вызовов API. Вы можете отключить постраничную обработку, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответ с постраничной обработкой, аргумент --query должен извлекать данные из результатов следующих выражений запроса: CapacityReservationFleets
Синтаксис
describe-capacity-reservation-fleets
[--capacity-reservation-fleet-ids <value>]
[--filters <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]
Параметры
--capacity-reservation-fleet-ids (список)
Идентификаторы резервируемых емкостных флотов, которые необходимо описать.
(строка)
Синтаксис:
"string" "string" ...
--filters (список)
Один или несколько фильтров.
-
state- Состояние флота (submitted|modifying|active|partially_fulfilled|expiring|expired|cancelling|cancelled|failed). -
instance-match-criteria- Критерии соответствия экземпляров для флота. Поддерживается толькоopen. -
tenancy- Тип аренды флота (default|dedicated). -
allocation-strategy- Стратегия распределения, используемая флотом. Поддерживается толькоprioritized.
(структура)
Пара имя-значение фильтра, используемая для возврата более конкретного списка результатов из операции описания. Фильтры могут использоваться для сопоставления набора ресурсов по определенным критериям, таким как теги, атрибуты или идентификаторы.
Если вы укажете несколько фильтров, фильтры объединяются с помощью AND , и запрос возвращает только результаты, которые соответствуют всем указанным фильтрам.
Дополнительную информацию см. в разделе Список и фильтрация с помощью командной строки и API в руководстве пользователя Amazon EC2.
Имя -> (строка)
Значения -> (список)
Значения фильтра. Значения фильтров чувствительны к регистру. Если вы укажете несколько значений для фильтра, значения объединяются с помощью OR , и запрос возвращает все результаты, которые соответствуют любому из указанных значений.
(строка)
Сокращенный синтаксис:
Name=string,Values=string,string ...
Синтаксис JSON:
[
{
"Name": "string",
"Values": ["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 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 (логическое значение)
Включить отладку регистрации.
--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.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы в руководстве пользователя AWS CLI.
За исключением случаев, когда указано иначе, все примеры используют правила цитирования в стиле Unix. Эти примеры необходимо адаптировать к правилам цитирования вашего терминала. См. Использование кавычек со строками в руководстве пользователя AWS CLI.
Просмотр резервируемого емкостного флота
В следующем describe-capacity-reservation-fleets примере отображается конфигурация и информация о емкости для указанного резервируемого емкостного флота. Он также отображает подробности об отдельных резервируемых емкостях, которые находятся внутри флота.
aws ec2 describe-capacity-reservation-fleets \
--capacity-reservation-fleet-ids crf-abcdef01234567890
Вывод:
{
"CapacityReservationFleets": [
{
"State": "active",
"EndDate": "2022-12-31T23:59:59.000Z",
"InstanceMatchCriteria": "open",
"Tags": [],
"CapacityReservationFleetId": "crf-abcdef01234567890",
"Tenancy": "default",
"InstanceTypeSpecifications": [
{
"CapacityReservationId": "cr-1234567890abcdef0",
"AvailabilityZone": "us-east-1a",
"FulfilledCapacity": 5.0,
"Weight": 1.0,
"CreateDate": "2022-07-02T08:34:33.398Z",
"InstancePlatform": "Linux/UNIX",
"TotalInstanceCount": 5,
"Priority": 1,
"EbsOptimized": true,
"InstanceType": "m5.xlarge"
}
],
"TotalTargetCapacity": 5,
"TotalFulfilledCapacity": 5.0,
"CreateTime": "2022-07-02T08:34:33.397Z",
"AllocationStrategy": "prioritized"
}
]
}
Дополнительную информацию о резервируемых емкостных флотах см. в разделе Резервируемые емкостные флоты в руководстве пользователя Amazon EC2.
Вывод
CapacityReservationFleets -> (список)
Информация о резервировании емкости флотов.
(структура)
Информация о резервировании емкости флота.
CapacityReservationFleetId -> (строка)
CapacityReservationFleetArn -> (строка)
Состояние -> (строка)
Состояние резервирования емкости флота. Возможные состояния:
-
submitted- Запрос на резервирование емкости флота отправлен, и Amazon Elastic Compute Cloud готовится создать резервы емкости. -
modifying- Резервирование емкости флота изменяется. Флот остается в этом состоянии до завершения изменения. -
active- Резервирование емкости флота выполнило свой общий целевой объем и пытается поддерживать этот объем. Флот остается в этом состоянии до тех пор, пока он не будет изменен или удален. -
partially_fulfilled- Резервирование емкости флота частично выполнило свой общий целевой объем. Недостаточно ресурсов Amazon EC2 для выполнения общего целевого объема. Флот пытается асинхронно выполнить свой общий целевой объем. -
expiring- Резервирование емкости флота достигло своей конечной даты и находится в процессе истечения срока действия. Один или несколько резервов емкости могут быть еще активны. -
expired- Резервирование емкости флота достигло своей конечной даты. Флот и его резервы емкости истекли. Флот не может создавать новые резервы емкости. -
cancelling- Резервирование емкости флота находится в процессе отмены. Один или несколько резервов емкости могут быть еще активны. -
cancelled- Резервирование емкости флота было отменено вручную. Флот и его резервы емкости отменены, и флот не может создавать новые резервы емкости. -
failed- Резервирование емкости флота не смогло зарезервировать емкость для указанных типов экземпляров.
Общий целевой объем -> (целое число)
Общий фактически предоставленный объем -> (двойное число)
Тип аренды -> (строка)
Тип аренды для резервирования емкости флота. Типы аренды:
-
default- Резервирование емкости флота создано на оборудовании, совместно используемом с другими учетными записями Amazon Web Services. -
dedicated- Резервирование емкости флота создано на выделенном оборудовании, предназначенном для одной учетной записи Amazon Web Services.
Конечная дата -> (временная метка)
Дата создания -> (временная метка)
Критерии соответствия экземпляров -> (строка)
Указывает тип запусков экземпляров, которые принимает резервирование емкости флота. Все резервы емкости в флоте наследуют эти критерии соответствия экземпляров.
В настоящее время резервирование емкости флота поддерживает только критерии соответствия экземпляров open. Это означает, что экземпляры, имеющие совпадающие атрибуты (тип экземпляра, платформа и зона доступности), автоматически запускаются в резервах емкости. Экземплярам не нужно явно указывать резервирование емкости флота, чтобы использовать его зарезервированную емкость.
Стратегия распределения -> (строка)
Характеристики типов экземпляров -> (список)
Информация о типах экземпляров, для которых необходимо зарезервировать емкость.
(структура)
Информация о резервировании емкости в резервировании емкости флота.
CapacityReservationId -> (строка)
AvailabilityZoneId -> (строка)
Тип экземпляра -> (строка)
Платформа экземпляра -> (строка)
Зона доступности -> (строка)
Общее количество экземпляров -> (целое число)
Фактически предоставленная емкость -> (двойное число)
EbsOptimized -> (булево значение)
Дата создания -> (временная метка)
Вес -> (двойное число)
Приоритет -> (целое число)
Теги -> (список)
Теги, назначенные резервированию емкости флота.
(структура)
Описание тега.
Ключ -> (строка)
Ключ тега.
Ограничения: ключи тегов чувствительны к регистру и принимают максимум 127 символов Юникода. Не могут начинаться с aws:.
Значение -> (строка)
Значение тега.
Ограничения: значения тегов чувствительны к регистру и принимают максимум 256 символов Юникода.
NextToken -> (строка)
null, если больше результатов нет.
© Copyright 2025, Amazon Web Services. Created using Sphinx.