create-subscriber
Описание
Создаёт подписчика. Вы должны создать связанный бюджет и уведомление перед созданием подписчика.
См. также: Документацию API AWS
Синтаксис
create-subscriber
--account-id <value>
--budget-name <value>
--notification <value>
--subscriber <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 (строка)
--notification (структура)
Уведомление, для которого вы хотите создать подписчика.
NotificationType -> (строка)
ACTUAL ) или к тому, сколько вы прогнозируете потратить (FORECASTED ).ComparisonOperator -> (строка)
Threshold -> (двойное число)
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"
}
--subscriber (структура)
Подписчик, который вы хотите связать с уведомлением о бюджете.
SubscriptionType -> (строка)
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
- text
- table
- yaml
- yaml-stream
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использовать определённый профиль из файла конфигурации.
--region (строка)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/выключить вывод цвета.
- on
- off
- auto
--no-sign-request (булево)
Не подписывать запросы. Кредиты не будут загружены, если этот параметр предоставлен.
--ca-bundle (строка)
Файл с корневым сертификатом для использования при проверке 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.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. См. руководство по началу работы в руководстве пользователя AWS CLI для получения дополнительной информации.
Если не указано иное, все примеры имеют правила цитирования Unix-подобных систем. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки терминала. См. Использование кавычек со строками в руководстве пользователя AWS CLI.
Для создания подписчика для уведомления, связанного с бюджетом затрат и использования
В этом примере создаётся подписчик для указанного уведомления.
Команда:
aws budgets create-subscriber --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.