Spec-Zone.ru › AWS CLI v2

[ aws . budgets ]

создать-уведомление

Описание

Создаёт уведомление. Вам необходимо создать бюджет, прежде чем создать связанное с ним уведомление.

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

Синтаксис

  create-notification
--account-id <value>
--budget-name <value>
--notification <value>
--subscribers <value>
[--cli-input-json | --cli-input-yaml]
[--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 (строка)

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

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

Имя бюджета, о котором вы хотите получать уведомления от Amazon Web Services. Имена бюджетов должны быть уникальными в рамках аккаунта.

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

Уведомление, которое вы хотите создать.

NotificationType -> (строка)

Указывает, за сколько потрачено (ACTUAL ) или за сколько прогнозируется потратить (FORECASTED ) уведомление.

ComparisonOperator -> (строка)

Оператор сравнения для этого уведомления.

Threshold -> (двойное)

Порог, связанный с уведомлением. Пороги всегда являются процентами, и многие клиенты находят полезным получать уведомления при отклонении от запланированной суммы на 50% - 200%. Максимальное значение порога составляет 1 000 000% превышения запланированной суммы.

ThresholdType -> (строка)

Тип порога уведомления. Для порогов ABSOLUTE_VALUE, Amazon Web Services уведомляет вас при превышении или прогнозируемом превышении общего порога затрат. Для порогов PERCENTAGE Amazon Web Services уведомляет вас при превышении или прогнозируемом превышении определенного процента прогнозируемых затрат. Например, если у вас есть бюджет на 200 долларов и порог PERCENTAGE составляет 80%, Amazon Web Services уведомит вас, когда затраты превысят 160 долларов.

NotificationState -> (строка)

Указывает, находится ли это уведомление в состоянии тревоги. Если уведомление о бюджете находится в состоянии ALARM, вы превысили установленный порог бюджета.

Краткая запись:

NotificationType=string,ComparisonOperator=string,Threshold=double,ThresholdType=string,NotificationState=string

Синтаксис JSON:

{
  "NotificationType": "ACTUAL"|"FORECASTED",
  "ComparisonOperator": "GREATER_THAN"|"LESS_THAN"|"EQUAL_TO",
  "Threshold": double,
  "ThresholdType": "PERCENTAGE"|"ABSOLUTE_VALUE",
  "NotificationState": "OK"|"ALARM"
}

--subscribers (список)

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

(структура)

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

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

  • Тип subscriptionType - EMAIL
  • Адрес address - example@example.com

SubscriptionType -> (строка)

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

Address -> (строка)

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

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

Краткая запись:

SubscriptionType=string,Address=string ...

Синтаксис JSON:

[
  {
    "SubscriptionType": "SNS"|"EMAIL",
    "Address": "string"
  }
  ...
]

--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной строки JSON. Строка JSON следует формату, предоставленному --generate-cli-skeleton. Если на командной строке предоставлены другие аргументы, эти значения перекроют значения из JSON. Невозможно передавать произвольные двоичные значения с помощью JSON-значения, так как строка будет интерпретирована буквально. Это не может быть указано вместе с --cli-input-yaml.

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

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы в руководстве пользователя AWS CLI.

Если не указано иное, во всех примерах используются правила кавычек, характерные для Unix. Эти примеры необходимо адаптировать к правилам кавычек вашей оболочки. См. Использование кавычек со строками в руководстве пользователя AWS CLI .

Для создания уведомления для указанного бюджета расходов и использования

В этом примере создается уведомление для указанного бюджета расходов и использования.

Команда:

aws budgets create-notification --account-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --subscriber SubscriptionType=EMAIL,Address=example@example.com

Вывод

Нет

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

Spec-Zone.ru

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