[ aws . mailmanager ]
обновить-набор-правил
Описание
Обновление атрибутов уже предоставленного набора правил.
См. также: Документация API AWS
Синтаксис
update-rule-set
--rule-set-id <value>
[--rule-set-name <value>]
[--rules <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]
Параметры
--rule-set-id (строка)
--rule-set-name (строка)
--rules (список)
Новый набор правил для замены текущих правил набора правил — эти правила переопределят все правила набора правил.
(структура)
Правило содержит условия, «исключающие условия» и действия. Для каждого получателя электронного письма, если все условия совпадают, и ни одно из «исключающих условий» не совпадает, то все действия выполняются последовательно. Если условия не указаны, правило всегда применяется, и действия неявно выполняются. Если указаны только «исключающие условия», правило применяется, если электронное письмо не соответствует оценке «исключающих условий».
Действия -> (список)
Список действий, которые необходимо выполнить, когда условия соответствуют входящему электронному письму, и ни одно из «исключающих условий» не соответствует.
(структура помеченного объединения)
Действие, которое должно выполнить правило. Можно задать только одно из действий.
Примечание
Это структура помеченного объединения. Можно установить только один из следующих ключевых элементов верхнего уровня:AddHeader, Archive, DeliverToMailbox, DeliverToQBusiness, Drop, PublishToSns, Relay, ReplaceRecipient, Send, WriteToS3.Добавить заголовок -> (структура)
Это действие добавляет заголовок. Это можно использовать для добавления произвольных заголовков электронных писем.
Имя заголовка -> (строка)
Значение заголовка -> (строка)
Архивировать -> (структура)
Это действие архивирует электронное письмо. Это можно использовать для отправки электронного письма в архив.
Политика отказа действия -> (строка)
Целевой архив -> (строка)
Отправить в почтовый ящик -> (структура)
Это действие отправляет электронное письмо в почтовый ящик WorkMail.
Политика отказа действия -> (строка)
MailboxArn -> (строка)
RoleArn -> (строка)
Отправить в приложение Q Business -> (структура)
Это действие отправляет электронное письмо в приложение Amazon Q Business для обработки в базе знаний.
Политика отказа действия -> (строка)
qbusiness:BatchPutDocument.Идентификатор приложения -> (строка)
Идентификатор индекса -> (строка)
RoleArn -> (строка)
qbusiness:BatchPutDocument для данного приложения и индекса.Отклонить -> (структура)
Опубликовать в SNS -> (структура)
Это действие публикует содержимое электронного письма в тему Amazon SNS.
Политика отказа действия -> (строка)
sns:Publish.Кодировка -> (строка)
UTF-8. Используйте BASE64, если нужно сохранить все специальные символы, особенно если исходное сообщение использует другой формат кодировки.Тип данных полезной нагрузки -> (строка)
CONTENT пытается опубликовать все содержимое электронного письма с 20 КБ заголовков. HEADERS извлекает до 100 КБ заголовков для включения в уведомление, содержимое электронного письма не будет включено в уведомление. Значение по умолчанию — CONTENT.RoleArn -> (строка)
sns:Publish для данной темы.TopicArn -> (строка)
Переслать -> (структура)
Это действие пересылает электронное письмо на другой SMTP-сервер.
Политика отказа действия -> (строка)
MailFrom -> (строка)
Пересылка -> (строка)
Заменить получателя -> (структура)
Действие заменяет определенных или всех получателей на другой набор получателей.
Заменить на -> (список)
Это действие указывает заменяющие адреса электронной почты получателей для вставки.
(строка)
Отправить -> (структура)
Это действие отправляет электронное письмо по сети.
Политика отказа действия -> (строка)
RoleArn -> (строка)
Записать в S3 -> (структура)
Это действие записывает MIME-содержимое электронного письма в хранилище S3.
Политика отказа действия -> (строка)
RoleArn -> (строка)
S3Bucket -> (строка)
S3Prefix -> (строка)
S3SseKmsKeyId -> (строка)
Условия -> (список)
Условия этой правила. Все условия должны соответствовать электронной почте, для того чтобы действия были выполнены. Пустой список условий означает, что все электронные письма соответствуют, но все равно подлежат условиям «исключая»
(структура помеченного объединения)
Условное выражение, используемое для оценки электронного письма, чтобы определить, следует ли выполнить действие правила.
Примечание
Это структура помеченного объединения. Только один из следующих ключей верхнего уровня может быть задан:BooleanExpression, DmarcExpression, IpExpression, NumberExpression, StringExpression, VerdictExpression.BooleanExpression -> (структура)
Условие относится к булевому выражению, переданному в этом поле.
Evaluate -> (структура помеченного объединения)
Операнд, над которым нужно выполнить операцию булевого условия.
Примечание
Это структура помеченного объединения. Только один из следующих ключей верхнего уровня может быть задан:Analysis, Attribute, IsInAddressList.Analysis -> (структура)
ARN плагина и его возвращаемое значение для оценки в выражении булевого условия.
Analyzer -> (строка)
ResultField -> (строка)
Attribute -> (строка)
IsInAddressList -> (структура)
Структура, представляющая списки адресов и атрибут списка адресов, который будет использоваться для оценки булевого выражения.
AddressLists -> (список)
Списки адресов, которые будут использоваться для оценки.
(строка)
Attribute -> (строка)
Operator -> (строка)
DmarcExpression -> (структура)
Условие относится к выражению политики DMARC, переданному в этом поле.
Operator -> (строка)
Values -> (список)
Значения, используемые для данного оператора политики DMARC. Для оператора EQUALS, если указано несколько значений, они оцениваются как OR. То есть, если какое-либо из указанных значений соответствует, условие считается соответствующим. Для оператора NOT_EQUALS, если указано несколько значений, они оцениваются как AND. То есть, только если политика DMARC электронной почты не равна ни одному из указанных значений, то условие считается соответствующим.
(строка)
IpExpression -> (структура)
Условие относится к выражению IP-адреса, переданному в этом поле.
Evaluate -> (структура помеченного объединения)
IP-адрес для оценки в этом условии.
Примечание
Это структура помеченного объединения. Только один из следующих ключей верхнего уровня может быть задан:Attribute.Attribute -> (строка)
Operator -> (строка)
Values -> (список)
IP-блоки CIDR в формате «x.y.z.w/n» (например, 10.0.0.0/8) для сопоставления с IP-адресом электронной почты. Для оператора CIDR_MATCHES, если указано несколько значений, они оцениваются как OR. То есть, если IP-адрес содержится в любом из заданных диапазонов CIDR, условие считается соответствующим. Для NOT_CIDR_MATCHES, если указано несколько диапазонов CIDR, условие считается соответствующим, если IP-адрес не содержится ни в одном из заданных диапазонов CIDR.
(строка)
NumberExpression -> (структура)
Условие относится к числовому выражению, переданному в этом поле.
Evaluate -> (структура помеченного объединения)
Число для оценки в числовом выражении условия.
Примечание
Это структура помеченного объединения. Только один из следующих ключей верхнего уровня может быть задан:Attribute.Attribute -> (строка)
Operator -> (строка)
Value -> (двойное)
StringExpression -> (структура)
Условие относится к строковому выражению, переданному в этом поле.
Evaluate -> (структура помеченного объединения)
Строка для оценки в строковом выражении условия.
Примечание
Это структура помеченного объединения. Только один из следующих ключей верхнего уровня может быть задан:Analysis, Attribute, MimeHeaderAttribute.Analysis -> (структура)
ARN плагина и его возвращаемое значение для оценки в строковом выражении условия.
Analyzer -> (строка)
ResultField -> (строка)
Attribute -> (строка)
MimeHeaderAttribute -> (строка)
Operator -> (строка)
Values -> (список)
Строка(и) для оценки в строковом выражении условия. Для всех операторов, кроме NOT_EQUALS, если указано несколько значений, значения обрабатываются как OR. То есть, если какое-либо из значений соответствует строке электронной почты с использованием указанного оператора, условие считается соответствующим. Однако для NOT_EQUALS условие считается соответствующим только в том случае, если ни одна из заданных строк не соответствует строке электронной почты.
(строка)
VerdictExpression -> (структура)
Условие относится к выражению вердикта, переданному в этом поле.
Evaluate -> (структура помеченного объединения)
Вердикт для оценки в выражении условия вердикта.
Примечание
Это структура помеченного объединения. Только один из следующих ключей верхнего уровня может быть задан:Analysis, Attribute.Analysis -> (структура)
ARN плагина и его возвращаемое значение для оценки в выражении условия вердикта.
Analyzer -> (строка)
ResultField -> (строка)
Attribute -> (строка)
Operator -> (строка)
Values -> (список)
Значения для сопоставления с вердиктом электронной почты с использованием указанного оператора. Для оператора EQUALS, если указано несколько значений, условие считается соответствующим, если какой-либо из указанных вердиктов соответствует вердикту электронной почты. Для оператора NOT_EQUALS, если указано несколько значений, условие считается соответствующим, если ни один из указанных вердиктов не соответствует вердикту электронной почты.
(строка)
Name -> (строка)
Unless -> (список)
«Условия исключения» для этого правила. Ни одно из условий не должно соответствовать адресу электронной почты для выполнения действий. Если какое-либо из этих условий соответствует адресу электронной почты, действия не выполняются.
(структура помеченного объединения)
Условное выражение, используемое для оценки адреса электронной почты, чтобы определить, следует ли выполнить действие правила.
Примечание
Это структура помеченного объединения. Только один из следующих ключей верхнего уровня может быть задан:BooleanExpression, DmarcExpression, IpExpression, NumberExpression, StringExpression, VerdictExpression.BooleanExpression -> (структура)
Условие относится к логическому выражению, переданному в этом поле.
Evaluate -> (структура помеченного объединения)
Операнд, над которым необходимо выполнить операцию логического условия.
Примечание
Это структура помеченного объединения. Только один из следующих ключей верхнего уровня может быть задан:Analysis, Attribute, IsInAddressList.Analysis -> (структура)
ARN дочернего ресурса и его возвращаемое значение для оценки в логическом условном выражении.
Analyzer -> (строка)
ResultField -> (строка)
Attribute -> (строка)
IsInAddressList -> (структура)
Структура, представляющая списки адресов и атрибуты списков адресов, которые будут использованы для оценки логического выражения.
AddressLists -> (список)
Списки адресов, которые будут использованы для оценки.
(строка)
Attribute -> (строка)
Operator -> (строка)
DmarcExpression -> (структура)
Условие относится к выражению политики DMARC, переданному в этом поле.
Operator -> (строка)
Values -> (список)
Значения, используемые для данного оператора политики DMARC. Для оператора РАВНО, если указано несколько значений, они оцениваются как ИЛИ. То есть, если какое-либо из заданных значений совпадает, условие считается выполненным. Для оператора НЕ РАВНО, если указано несколько значений, они оцениваются как И. То есть, только если политика DMARC электронной почты не равна ни одному из заданных значений, условие считается выполненным.
(строка)
IpExpression -> (структура)
Условие относится к выражению IP-адреса, переданному в этом поле.
Evaluate -> (структура помеченного объединения)
IP-адрес для оценки в этом условии.
Примечание
Это структура помеченного объединения. Только один из следующих ключей верхнего уровня может быть задан:Attribute.Attribute -> (строка)
Operator -> (строка)
Values -> (список)
Блоки IP CIDR в формате «x.y.z.w/n» (например, 10.0.0.0/8) для сопоставления с IP-адресом электронной почты. Для оператора CIDR_MATCHES, если указано несколько значений, они оцениваются как ИЛИ. То есть, если IP-адрес содержится в любом из заданных диапазонов CIDR, условие считается выполненным. Для NOT_CIDR_MATCHES, если указано несколько диапазонов CIDR, условие считается выполненным, если IP-адрес не содержится ни в одном из заданных диапазонов CIDR.
(строка)
NumberExpression -> (структура)
Условие относится к числовому выражению, переданному в этом поле.
Evaluate -> (структура помеченного объединения)
Число для оценки в числовом условном выражении.
Примечание
Это структура помеченного объединения. Только один из следующих ключей верхнего уровня может быть задан:Attribute.Attribute -> (строка)
Operator -> (строка)
Value -> (двойное)
StringExpression -> (структура)
Условие относится к строковому выражению, переданному в этом поле.
Evaluate -> (структура помеченного объединения)
Строка для оценки в строковом условном выражении.
Примечание
Это структура помеченного объединения. Только один из следующих ключей верхнего уровня может быть задан:Analysis, Attribute, MimeHeaderAttribute.Analysis -> (структура)
ARN дочернего ресурса и его возвращаемое значение для оценки в строковом условном выражении.
Analyzer -> (строка)
ResultField -> (строка)
Attribute -> (строка)
MimeHeaderAttribute -> (строка)
Operator -> (строка)
Values -> (список)
Строка(и) для оценки в строковом условном выражении. Для всех операторов, кроме НЕ РАВНО, если указано несколько значений, значения обрабатываются как ИЛИ. То есть, если какое-либо из значений соответствует строке электронной почты с использованием данного оператора, условие считается выполненным. Однако для НЕ РАВНО условие считается выполненным только в том случае, если ни одно из заданных строк не соответствует строке электронной почты.
(строка)
VerdictExpression -> (структура)
Условие относится к выражению вердикта, переданному в этом поле.
Evaluate -> (структура помеченного объединения)
Вердикт для оценки в условном выражении вердикта.
Примечание
Это структура помеченного объединения. Только один из следующих ключей верхнего уровня может быть задан:Analysis, Attribute.Analysis -> (структура)
ARN дочернего ресурса и его возвращаемое значение для оценки в условном выражении вердикта.
Analyzer -> (строка)
ResultField -> (строка)
Attribute -> (строка)
Operator -> (строка)
Values -> (список)
Значения для сопоставления с вердиктом электронной почты с использованием указанного оператора. Для оператора РАВНО, если указано несколько значений, условие считается выполненным, если какое-либо из заданных вердиктов соответствует вердикту электронной почты. Для оператора НЕ РАВНО, если указано несколько значений, условие считается выполненным, если ни один из заданных вердиктов не соответствует вердикту электронной почты.
(строка)
Синтаксис JSON:
[
{
"Actions": [
{
"AddHeader": {
"HeaderName": "string",
"HeaderValue": "string"
},
"Archive": {
"ActionFailurePolicy": "CONTINUE"|"DROP",
"TargetArchive": "string"
},
"DeliverToMailbox": {
"ActionFailurePolicy": "CONTINUE"|"DROP",
"MailboxArn": "string",
"RoleArn": "string"
},
"DeliverToQBusiness": {
"ActionFailurePolicy": "CONTINUE"|"DROP",
"ApplicationId": "string",
"IndexId": "string",
"RoleArn": "string"
},
"Drop": {
},
"PublishToSns": {
"ActionFailurePolicy": "CONTINUE"|"DROP",
"Encoding": "UTF-8"|"BASE64",
"PayloadType": "HEADERS"|"CONTENT",
"RoleArn": "string",
"TopicArn": "string"
},
"Relay": {
"ActionFailurePolicy": "CONTINUE"|"DROP",
"MailFrom": "REPLACE"|"PRESERVE",
"Relay": "string"
},
"ReplaceRecipient": {
"ReplaceWith": ["string", ...]
},
"Send": {
"ActionFailurePolicy": "CONTINUE"|"DROP",
"RoleArn": "string"
},
"WriteToS3": {
"ActionFailurePolicy": "CONTINUE"|"DROP",
"RoleArn": "string",
"S3Bucket": "string",
"S3Prefix": "string",
"S3SseKmsKeyId": "string"
}
}
...
],
"Conditions": [
{
"BooleanExpression": {
"Evaluate": {
"Analysis": {
"Analyzer": "string",
"ResultField": "string"
},
"Attribute": "READ_RECEIPT_REQUESTED"|"TLS"|"TLS_WRAPPED",
"IsInAddressList": {
"AddressLists": ["string", ...],
"Attribute": "RECIPIENT"|"MAIL_FROM"|"SENDER"|"FROM"|"TO"|"CC"
}
},
"Operator": "IS_TRUE"|"IS_FALSE"
},
"DmarcExpression": {
"Operator": "EQUALS"|"NOT_EQUALS",
"Values": ["NONE"|"QUARANTINE"|"REJECT", ...]
},
"IpExpression": {
"Evaluate": {
"Attribute": "SOURCE_IP"
},
"Operator": "CIDR_MATCHES"|"NOT_CIDR_MATCHES",
"Values": ["string", ...]
},
"NumberExpression": {
"Evaluate": {
"Attribute": "MESSAGE_SIZE"
},
"Operator": "EQUALS"|"NOT_EQUALS"|"LESS_THAN"|"GREATER_THAN"|"LESS_THAN_OR_EQUAL"|"GREATER_THAN_OR_EQUAL",
"Value": double
},
"StringExpression": {
"Evaluate": {
"Analysis": {
"Analyzer": "string",
"ResultField": "string"
},
"Attribute": "MAIL_FROM"|"HELO"|"RECIPIENT"|"SENDER"|"FROM"|"SUBJECT"|"TO"|"CC",
"MimeHeaderAttribute": "string"
},
"Operator": "EQUALS"|"NOT_EQUALS"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS",
"Values": ["string", ...]
},
"VerdictExpression": {
"Evaluate": {
"Analysis": {
"Analyzer": "string",
"ResultField": "string"
},
"Attribute": "SPF"|"DKIM"
},
"Operator": "EQUALS"|"NOT_EQUALS",
"Values": ["PASS"|"FAIL"|"GRAY"|"PROCESSING_FAILED", ...]
}
}
...
],
"Name": "string",
"Unless": [
{
"BooleanExpression": {
"Evaluate": {
"Analysis": {
"Analyzer": "string",
"ResultField": "string"
},
"Attribute": "READ_RECEIPT_REQUESTED"|"TLS"|"TLS_WRAPPED",
"IsInAddressList": {
"AddressLists": ["string", ...],
"Attribute": "RECIPIENT"|"MAIL_FROM"|"SENDER"|"FROM"|"TO"|"CC"
}
},
"Operator": "IS_TRUE"|"IS_FALSE"
},
"DmarcExpression": {
"Operator": "EQUALS"|"NOT_EQUALS",
"Values": ["NONE"|"QUARANTINE"|"REJECT", ...]
},
"IpExpression": {
"Evaluate": {
"Attribute": "SOURCE_IP"
},
"Operator": "CIDR_MATCHES"|"NOT_CIDR_MATCHES",
"Values": ["string", ...]
},
"NumberExpression": {
"Evaluate": {
"Attribute": "MESSAGE_SIZE"
},
"Operator": "EQUALS"|"NOT_EQUALS"|"LESS_THAN"|"GREATER_THAN"|"LESS_THAN_OR_EQUAL"|"GREATER_THAN_OR_EQUAL",
"Value": double
},
"StringExpression": {
"Evaluate": {
"Analysis": {
"Analyzer": "string",
"ResultField": "string"
},
"Attribute": "MAIL_FROM"|"HELO"|"RECIPIENT"|"SENDER"|"FROM"|"SUBJECT"|"TO"|"CC",
"MimeHeaderAttribute": "string"
},
"Operator": "EQUALS"|"NOT_EQUALS"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS",
"Values": ["string", ...]
},
"VerdictExpression": {
"Evaluate": {
"Analysis": {
"Analyzer": "string",
"ResultField": "string"
},
"Attribute": "SPF"|"DKIM"
},
"Operator": "EQUALS"|"NOT_EQUALS",
"Values": ["PASS"|"FAIL"|"GRAY"|"PROCESSING_FAILED", ...]
}
}
...
]
}
...
]
--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 (boolean)
Включить отладовую запись в журнал.
--endpoint-url (string)
Переопределить URL по умолчанию команды заданным URL.
--no-verify-ssl (boolean)
По умолчанию, AWS CLI использует SSL при общении с AWS-сервисами. Для каждого подключения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение по умолчанию проверки сертификатов SSL.
--no-paginate (boolean)
Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (string)
Стиль форматирования вывода команд.
- json
- text
- table
- yaml
- yaml-stream
--query (string)
Запрос JMESPath для фильтрации данных ответа.
--profile (string)
Использовать определённый профиль из файла учетных данных.
--region (string)
Регион для использования. Переопределяет параметры из конфигурации/среды.
--version (string)
Показать версию этого инструмента.
--color (string)
Включить/выключить цветной вывод.
- on
- off
- auto
--no-sign-request (boolean)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент указан.
--ca-bundle (string)
Файл с сертификатами CA для проверки SSL-сертификатов. Переопределяет параметры из конфигурации/среды.
--cli-read-timeout (int)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и без таймаута. Значение по умолчанию составляет 60 секунд.
--cli-connect-timeout (int)
Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и без таймаута. Значение по умолчанию составляет 60 секунд.
--cli-binary-format (string)
Стиль форматирования для двоичных блоков. По умолчанию используется формат 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 (boolean)
Отключить паджинг CLI для вывода.
--cli-auto-prompt (boolean)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (boolean)
Отключить автоматическое запроса параметров ввода CLI.
Вывод
Нет
© Copyright 2025, Amazon Web Services. Created using Sphinx.