Spec-Zone.ru › AWS CLI v2

[ aws . budgets ]

describe-budget-action-histories

Описание

Описывает подробную историю действий по бюджету.

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

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

Синтаксис

  describe-budget-action-histories
--account-id <value>
--budget-name <value>
--action-id <value>
[--time-period <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]

Параметры

--account-id (строка)

Идентификатор учётной записи пользователя. Представляет собой 12-значное число.

--budget-name (строка)

Строка, представляющая имя бюджета. Символы «:» и «"», а также подстрока «/action/» недопустимы.

--action-id (строка)

Сгенерированный системой уникальный идентификатор (UUID) действия.

--time-period (структура)

Период времени, охватываемый бюджетом. Период имеет начальную и конечную дату. Начальная дата должна предшествовать конечной. Для конечной даты ограничений нет.

Начало -> (метка времени)

Начальная дата бюджета. Если вы создали бюджет, не указав начальную дату, Amazon Web Services по умолчанию устанавливает её в начало выбранного периода (DAILY, MONTHLY, QUARTERLY или ANNUALLY). Например, если вы создали свой бюджет 24 января 2018 года, выбрали DAILY и не задали начальную дату, Amazon Web Services установили начальную дату на 01/24/18 00:00 UTC. Если вы выбрали MONTHLY, Amazon Web Services установили начальную дату на 01/01/18 00:00 UTC. Значения по умолчанию одинаковы для консоли Billing and Cost Management и API.

Вы можете изменить начальную дату с помощью операции UpdateBudget.

Конец -> (метка времени)

Конечная дата бюджета. Если вы не указали конечную дату, Amazon Web Services установили её на 06/15/87 00:00 UTC. Значения по умолчанию одинаковы для консоли Billing and Cost Management и API.

После конечной даты Amazon Web Services удаляет бюджет и все связанные уведомления и подписчиков. Вы можете изменить конечную дату с помощью операции UpdateBudget.

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

Start=timestamp,End=timestamp

Синтаксис JSON:

{
  "Start": timestamp,
  "End": timestamp
}

--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
  • таблица
  • 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.

Вывод

ActionHistories -> (список)

Исторический отчет о ресурсе действия бюджета.

(структура)

Исторические записи для действия бюджета.

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

Общая метка времени. В Java она преобразуется в объект Date.

Статус -> (строка)

Статус действия на момент события.

ТипСобытия -> (строка)

Различает события, инициированные пользователем, и генерируемые системой.

ПодробностиДействия -> (структура)

Описание деталей события.

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

Общая строка.

Действие -> (структура)

Ресурс действия бюджета.

IdДействия -> (строка)

Генерируемый системой универсальный уникальный идентификатор (UUID) действия.

НазваниеБюджета -> (строка)

Строка, представляющая название бюджета. Символы “:” и “"”, а также подстрока “/action/”, запрещены.

ТипУведомления -> (строка)

Тип уведомления. Должно быть ACTUAL или FORECASTED.

ТипДействия -> (строка)

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

ПороговоеЗначениеДействия -> (структура)

Пороговое значение срабатывания действия.

ЗначениеПороговогоДействия -> (число с плавающей точкой)

Порог уведомления.

ТипПороговогоЗначения -> (строка)

Тип порога для уведомления.

Определение -> (структура)

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

ОпределениеДействияIAM -> (структура)

Подробности определения действия управления идентификацией и доступом (IAM).

ArnПолитики -> (строка)

Amazon Resource Name (ARN) политики, которая должна быть прикреплена.

Роли -> (список)

Список ролей, которые должны быть прикреплены. Должна быть хотя бы одна роль.

(строка)

Группы -> (список)

Список групп, которые должны быть прикреплены. Должна быть хотя бы одна группа.

(строка)

Пользователи -> (список)

Список пользователей, которые должны быть прикреплены. Должен быть хотя бы один пользователь.

(строка)

ОпределениеДействияSCP -> (структура)

Подробности определения действия политики управления службами (SCP).

IdПолитики -> (строка)

Прикрепленный идентификатор политики.

ИдентификаторыЦелей -> (список)

Список идентификаторов целей.

(строка)

ОпределениеДействияSSM -> (структура)

Подробности определения действия Amazon Web Services Systems Manager (SSM).

ПодтипДействия -> (строка)

Подтип действия.

Регион -> (строка)

Регион для запуска документа SSM.

ИдентификаторыИнстанций -> (список)

Идентификаторы EC2 и RDS экземпляров.

(строка)

ArnРолиВыполнения -> (строка)

Роль, используемая для выполнения и отмены действия. Роли и действия должны находиться в одной учетной записи.

МодельУтверждения -> (строка)

Указывает, требуется ли ручное или автоматическое утверждение для действия.

Статус -> (строка)

Статус действия.

Подписчики -> (список)

Список подписчиков.

(структура)

Подписчик на уведомления о бюджете. Подписчик состоит из типа подписки и либо темы Amazon SNS, либо адреса электронной почты.

Например, подписчик по электронной почте имеет следующие параметры:

  • A subscriptionType of EMAIL
  • An address of example@example.com

ТипПодписки -> (строка)

Тип уведомления, отправляемого Amazon Web Services подписчику.

Адрес -> (строка)

Адрес, по которому Amazon Web Services отправляет уведомления о бюджете, либо тема SNS, либо адрес электронной почты.

При создании подписчика значение Address не может содержать символы перевода строки.

NextToken -> (строка)

Общая строка.

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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