Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

История расширения блока емкости

Описание

Описывает события для указанного расширения блока емкости в течение указанного периода.

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

describe-capacity-block-extension-history является постраничной операцией. Для получения всего набора результатов могут быть выполнены несколько вызовов API. Вы можете отключить постраничную обработку, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничной обработкой аргумент --query должен извлекать данные из результатов следующих выражений запроса: CapacityBlockExtensions

Синтаксис

  describe-capacity-block-extension-history
[--capacity-reservation-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-ids (список)

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

(строка)

Синтаксис:

"string" "string" ...

--filters (список)

Один или несколько фильтров

  • availability-zone - Доступная зона расширения.
  • availability-zone-id - Идентификатор доступной зоны расширения.
  • capacity-block-extension-offering-id - Идентификатор предложения расширения.
  • capacity-block-extension-status - Статус расширения (payment-pending | payment-failed | payment-succeeded).
  • capacity-reservation-id - Идентификатор резервации расширения.
  • instance-type - Тип экземпляра расширения.

(структура)

Пара имя-значение фильтра, используемая для получения более конкретного списка результатов из операции описания. Фильтры могут использоваться для сопоставления набора ресурсов по определенным критериям, таким как метки, атрибуты или идентификаторы.

Если вы укажете несколько фильтров, фильтры будут объединены с помощью AND, и запрос вернёт только результаты, соответствующие всем указанным фильтрам.

Для получения дополнительной информации см. Список и фильтрация с помощью CLI и 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
  • текст
  • таблица
  • yaml
  • yaml-поток

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

Включить/выключить вывод цветным шрифтом.

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

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

Вывод

CapacityBlockExtensions -> (список)

Описывает одно или несколько ваших расширений блоков емкости. Результаты описывают только расширения блоков емкости в регионе Amazon Web Services, который вы в настоящее время используете.

(структура)

Описывает расширение блока емкости. С помощью расширения вы можете продлить срок действия существующего блока емкости.

CapacityReservationId -> (строка)

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

InstanceType -> (строка)

Тип экземпляра расширения блока емкости.

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

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

AvailabilityZone -> (строка)

Доступная зона расширения блока емкости.

AvailabilityZoneId -> (строка)

Идентификатор доступной зоны расширения блока емкости.

CapacityBlockExtensionOfferingId -> (строка)

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

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

Срок расширения блока емкости в часах.

CapacityBlockExtensionStatus -> (строка)

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

  • payment-pending - Платеж за расширение блока емкости обрабатывается. Если ваш платеж не может быть обработан в течение 12 часов, расширение блока емкости становится неуспешным.
  • payment-failed - Платеж за запрос расширения блока емкости не был успешным.
  • payment-succeeded - Платеж за запрос расширения блока емкости был успешным. Вы получаете счёт, отражающий единовременный авансовый платеж. В счёте вы можете связать оплаченную сумму с идентификатором резервации блока емкости.

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

Дата покупки расширения блока емкости.

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

Дата начала расширения блока емкости.

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

Дата окончания расширения блока емкости.

UpfrontFee -> (строка)

Общая сумма, подлежащая оплате авансом.

CurrencyCode -> (строка)

Валюта платежа за расширение блока емкости.

NextToken -> (строка)

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

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

Spec-Zone.ru

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