Spec-Zone.ru › AWS CLI v2

[ aws . billingconductor ]

list-custom-line-items

Описание

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

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

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

Синтаксис

  list-custom-line-items
[--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 (строка)

Предпочтительный период выставления счетов для получения пользовательских строк элементов (FFLIs).

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

ListCustomLineItemsFilter, определяющий имена пользовательских строк элементов и/или Amazon Resource Names (ARN) групп выставления счетов для получения информации о FFLI.

Names -> (список)

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

(строка)

BillingGroups -> (список)

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

(строка)

Arns -> (список)

Список Amazon Resource Names (ARN) пользовательских строк элементов, для которых требуется получить информацию.

(строка)

AccountIds -> (список)

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

(строка)

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

Names=string,string,BillingGroups=string,string,Arns=string,string,AccountIds=string,string

Синтаксис JSON:

{
  "Names": ["string", ...],
  "BillingGroups": ["string", ...],
  "Arns": ["string", ...],
  "AccountIds": ["string", ...]
}

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

Вывод

CustomLineItems -> (список)

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

(структура)

Представление пользовательской строки элементов.

Arn -> (строка)

Amazon Resource Names (ARN) пользовательских строк элементов.

Name -> (строка)

Имя пользовательской строки элементов.

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

ListCustomLineItemChargeDetails, описывающий подробности оплаты пользовательской строки элементов.

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

ListCustomLineItemFlatChargeDetails, описывающий подробности оплаты фиксированной пользовательской строки элементов.

ChargeValue -> (двойное значение)

Фиксированное значение оплаты пользовательской строки элементов в USD.

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

ListCustomLineItemPercentageChargeDetails, описывающий подробности оплаты пользовательской строки элементов в процентах.

PercentageValue -> (двойное значение)

Процентное значение пользовательской строки элементов. Это значение будет умножено на совокупное значение связанных ресурсов, чтобы определить значение оплаты.

Type -> (строка)

Тип пользовательской строки элементов, указывающий, является ли оплата fee или credit.

LineItemFilters -> (список)

Представление фильтра строки элементов.

(структура)

Представление фильтра строки элементов для вашей пользовательской строки элементов. Вы можете использовать фильтры строк элементов для включения или исключения определенных значений ресурсов из общей стоимости группы выставления счетов. Например, если вы создаете пользовательскую строку элементов и хотите отфильтровать значение, например, скидки Savings Plan, вы можете обновить LineItemFilter, чтобы исключить его.

Attribute -> (строка)

Атрибут фильтра строки элементов. Это указывает, на какой атрибут можно отфильтровать.

MatchOption -> (строка)

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

Values -> (список)

Значения фильтра строки элементов. Это указывает значения, по которым можно отфильтровать. В настоящее время вы можете только исключить скидки Savings Plan.

(строка)

CurrencyCode -> (строка)

Валюта пользовательской строки элементов.

Description -> (строка)

Описание пользовательской строки элементов. Это отображается на странице "Счета" в связи со значением оплаты.

ProductCode -> (строка)

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

BillingGroupArn -> (строка)

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

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

Время создания.

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

Последнее время изменения пользовательской строки элементов.

AssociationSize -> (длинное целое число)

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

AccountId -> (строка)

Amazon Web Services-аккаунт, к которому будет применена эта пользовательская строка элементов.

NextToken -> (строка)

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

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

Spec-Zone.ru

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