Spec-Zone.ru › AWS CLI v2

[ aws . billingconductor ]

list-billing-groups

Описание

Операция для получения списка групп выставления счетов за заданный период. Если вы не укажете период, будет использован текущий.

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

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

Синтаксис

  list-billing-groups
[--billing-period <value>]
[--filters <value>]
[--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]

Параметры

--billing-period (строка)

Предпочтительный период выставления счетов для получения групп выставления счетов.

--filters (структура)

ListBillingGroupsFilter, определяющая группу выставления счетов и план ценообразования для получения информации о группе выставления счетов.

Arns -> (список)

Список Amazon Resource Names (ARN) групп выставления счетов для получения информации.

(строка)

PricingPlan -> (строка)

Amazon Resource Name (ARN) плана ценообразования для получения информации.

Statuses -> (список)

Список групп выставления счетов для получения их текущего состояния за определенный период

(строка)

AutoAssociate -> (булево)

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

Сокращённый синтаксис:

Arns=string,string,PricingPlan=string,Statuses=string,string,AutoAssociate=boolean

Синтаксис JSON:

{
  "Arns": ["string", ...],
  "PricingPlan": "string",
  "Statuses": ["ACTIVE"|"PRIMARY_ACCOUNT_MISSING", ...],
  "AutoAssociate": true|false
}

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

Вывод

BillingGroups -> (список)

Список полученных BillingGroupListElement.

(структура)

Представление группы выставления счетов.

Name -> (строка)

Название группы выставления счетов.

Arn -> (строка)

Amazon Resource Number (ARN), который можно использовать для уникальной идентификации группы выставления счетов.

Description -> (строка)

Описание группы выставления счетов.

PrimaryAccountId -> (строка)

Идентификатор учетной записи, являющейся основной учетной записью в группе выставления счетов.

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

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

PricingPlanArn -> (строка)

Amazon Resource Name (ARN) плана ценообразования, используемого для расчета платы за использование Amazon Web Services для группы выставления счетов.

Size -> (длинное целое)

Количество учетных записей в конкретной группе выставления счетов.

CreationTime -> (длинное целое)

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

LastModifiedTime -> (длинное целое)

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

Status -> (строка)

Статус группы выставления счетов. Может быть использовано только одно из допустимых значений.

StatusReason -> (строка)

Причина, по которой группа выставления счетов находится в текущем статусе.

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

Указывает, включено ли автоматическое присоединение учетных записей в группе выставления счетов (AutoAssociate).

AutoAssociate -> (булево)

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

NextToken -> (строка)

Токен постраничной загрузки, используемый в последующих вызовах для получения групп выставления счетов.

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

Spec-Zone.ru

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