Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

describe-capacity-reservation-billing-requests

Описание

Описывает запрос на назначение выставления счетов за неиспользованную емкость резерва емкости. Дополнительную информацию можно найти в разделе Назначение выставления счетов для совместных резервов емкости Amazon EC2 .

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

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

Синтаксис

  describe-capacity-reservation-billing-requests
[--capacity-reservation-ids <value>]
--role <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" ...

--role (строка)

Укажите один из следующих вариантов:

  • odcr-owner — если вы владелец резерва емкости, укажите это значение, чтобы просмотреть запросы, инициированные вами. Не поддерживается с фильтром requested-by.
  • unused-reservation-billing-owner — если вы учетная запись потребителя, укажите это значение, чтобы просмотреть запросы, отправленные вам. Не поддерживается с фильтром unused-reservation-billing-owner.

Возможные значения:

  • odcr-owner
  • unused-reservation-billing-owner

--filters (список)

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

  • status — состояние запроса (pending | accepted | rejected | cancelled | revoked | expired).
  • requested-by — идентификатор учетной записи владельца резерва емкости, инициировавшего запрос. Не поддерживается, если вы указываете requested-by для Роли.
  • unused-reservation-billing-owner — идентификатор учетной записи потребителя, которому был отправлен запрос. Не поддерживается, если вы указываете unused-reservation-billing-owner для Роли.

(структура)

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

Если вы указываете несколько фильтров, они соединяются с 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
  • текст
  • таблица
  • 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-auto-prompt (логическое значение)

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

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

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

Вывод

NextToken -> (строка)

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

CapacityReservationBillingRequests -> (список)

Информация о запросе.

(структура)

Информация о запросе на назначение выставления счетов за неиспользованную емкость резерва емкости.

CapacityReservationId -> (строка)

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

RequestedBy -> (строка)

Идентификатор учетной записи Amazon Web Services, инициировавшей запрос.

UnusedReservationBillingOwnerId -> (строка)

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

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

Дата и время инициирования запроса в формате UTC.

Status -> (строка)

Состояние запроса. Дополнительную информацию см. в разделе Просмотр запросов на назначение выставления счетов для совместного резерва емкости Amazon EC2 .

StatusMessage -> (строка)

Информация о состоянии.

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

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

InstanceType -> (строка)

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

AvailabilityZone -> (строка)

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

Tenancy -> (строка)

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

AvailabilityZoneId -> (строка)

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

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

Spec-Zone.ru

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