Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

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 -> (строка)

ARN резервирования емкости флота.

Состояние -> (строка)

Состояние резервирования емкости флота. Возможные состояния:

  • submitted - Запрос на резервирование емкости флота отправлен, и Amazon Elastic Compute Cloud готовится создать резервы емкости.
  • modifying - Резервирование емкости флота изменяется. Флот остается в этом состоянии до завершения изменения.
  • active - Резервирование емкости флота выполнило свой общий целевой объем и пытается поддерживать этот объем. Флот остается в этом состоянии до тех пор, пока он не будет изменен или удален.
  • partially_fulfilled - Резервирование емкости флота частично выполнило свой общий целевой объем. Недостаточно ресурсов Amazon EC2 для выполнения общего целевого объема. Флот пытается асинхронно выполнить свой общий целевой объем.
  • expiring - Резервирование емкости флота достигло своей конечной даты и находится в процессе истечения срока действия. Один или несколько резервов емкости могут быть еще активны.
  • expired - Резервирование емкости флота достигло своей конечной даты. Флот и его резервы емкости истекли. Флот не может создавать новые резервы емкости.
  • cancelling - Резервирование емкости флота находится в процессе отмены. Один или несколько резервов емкости могут быть еще активны.
  • cancelled - Резервирование емкости флота было отменено вручную. Флот и его резервы емкости отменены, и флот не может создавать новые резервы емкости.
  • failed - Резервирование емкости флота не смогло зарезервировать емкость для указанных типов экземпляров.

Общий целевой объем -> (целое число)

Общее количество единиц емкости, для которых флот резервирует емкость. Дополнительная информация в разделе «Общий целевой объем» руководства пользователя Amazon EC2.

Общий фактически предоставленный объем -> (двойное число)

Единицы емкости, которые были предоставлены.

Тип аренды -> (строка)

Тип аренды для резервирования емкости флота. Типы аренды:

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

Конечная дата -> (временная метка)

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

Дата создания -> (временная метка)

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

Критерии соответствия экземпляров -> (строка)

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

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

Стратегия распределения -> (строка)

Стратегия, используемая резервированием емкости флота для определения того, какие из указанных типов экземпляров использовать. Дополнительная информация в разделе «Стратегия распределения» руководства пользователя Amazon EC2.

Характеристики типов экземпляров -> (список)

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

(структура)

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

CapacityReservationId -> (строка)

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

AvailabilityZoneId -> (строка)

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

Тип экземпляра -> (строка)

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

Платформа экземпляра -> (строка)

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

Зона доступности -> (строка)

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

Общее количество экземпляров -> (целое число)

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

Фактически предоставленная емкость -> (двойное число)

Количество единиц емкости, предоставленных резервированием емкости. Дополнительная информация в разделе «Общий целевой объем» руководства пользователя Amazon EC2.

EbsOptimized -> (булево значение)

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

Дата создания -> (временная метка)

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

Вес -> (двойное число)

Вес типа экземпляра в резервировании емкости флота. Дополнительная информация в разделе «Вес типа экземпляра» руководства пользователя Amazon EC2.

Приоритет -> (целое число)

Приоритет типа экземпляра в резервировании емкости флота. Дополнительная информация в разделе «Приоритет типа экземпляра» руководства пользователя Amazon EC2.

Теги -> (список)

Теги, назначенные резервированию емкости флота.

(структура)

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

Ключ -> (строка)

Ключ тега.

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

Значение -> (строка)

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

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

NextToken -> (строка)

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

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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