describe-subscribers-for-notification
Описание
Отображает подписчиков, связанных с уведомлением.
См. также: Документацию API AWS
describe-subscribers-for-notification — это постраничная операция. Для получения всего набора результатов могут потребоваться несколько вызовов API. Вы можете отключить постраничность, указав аргумент --no-paginate. При использовании --output text и аргумента --query в постраничном ответе, аргумент --query должен извлекать данные из результатов следующих выражений запроса: Subscribers
Синтаксис
describe-subscribers-for-notification
--account-id <value>
--budget-name <value>
--notification <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 (строка)
--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"
}
--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 для вывода.
--cli-auto-prompt (булево)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (булево)
Отключение автоматического запроса параметров ввода CLI.
Примеры
Примечание
Чтобы использовать следующие примеры, у вас должна быть установлена и настроена AWS CLI. Дополнительную информацию см. в руководстве по началу работы в Руководстве пользователя AWS CLI.
Если не указано иное, во всех примерах используются правила цитирования Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.
Получение подписчиков для уведомления о бюджете
В этом примере извлекаются подписчики для уведомления о бюджете затрат и использования.
Команда:
aws budgets describe-subscribers-for-notification --account-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --max-results 5
Вывод:
{
"Subscribers": [
{
"SubscriptionType": "EMAIL",
"Address": "example2@example.com"
},
{
"SubscriptionType": "EMAIL",
"Address": "example@example.com"
}
]
}
Вывод
Subscribers -> (список)
Список подписчиков, связанных с уведомлением.
(структура)
Подписчик на уведомление о бюджете. Подписчик состоит из типа подписки и либо темы Amazon SNS, либо адреса электронной почты.
Например, подписчик по электронной почте имеет следующие параметры:
- Тип
subscriptionType—EMAIL - Адрес
address—example@example.com
SubscriptionType -> (строка)
Address -> (строка)
Адрес, которому Amazon Web Services отправляет уведомления о бюджете, либо тема SNS, либо адрес электронной почты.
При создании подписчика значение Address не может содержать символы новой строки.
NextToken -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.