Spec-Zone.ru › AWS CLI v2

[ aws . sesv2 ]

put-email-identity-dkim-signing-attributes

Description

Используется для настройки или изменения параметров аутентификации DKIM для идентификатора домена электронной почты. Вы можете использовать эту операцию для выполнения любого из следующих действий:

  • Обновление атрибутов подписи для идентификатора, который использует Bring Your Own DKIM (BYODKIM).
  • Обновление длины ключа, которая должна использоваться для Easy DKIM.
  • Переход от использования аутентификации DKIM к использованию Easy DKIM.
  • Переход от использования аутентификации DKIM к использованию BYODKIM.
  • Переход от использования Easy DKIM к использованию BYODKIM.
  • Переход от использования BYODKIM к использованию Easy DKIM.

См. также: AWS API Documentation

Synopsis

  put-email-identity-dkim-signing-attributes
--email-identity <value>
--signing-attributes-origin <value>
[--signing-attributes <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]

Options

--email-identity (string)

The email identity.

--signing-attributes-origin (string)

Метод, используемый для настройки DKIM для идентификатора. Возможны следующие значения:

  • AWS_SES – Настроить DKIM для идентификатора с помощью Easy DKIM.
  • EXTERNAL – Настроить DKIM для идентификатора с помощью Bring Your Own DKIM (BYODKIM).

Возможные значения:

  • AWS_SES
  • EXTERNAL
  • AWS_SES_AF_SOUTH_1
  • AWS_SES_EU_NORTH_1
  • AWS_SES_AP_SOUTH_1
  • AWS_SES_EU_WEST_3
  • AWS_SES_EU_WEST_2
  • AWS_SES_EU_SOUTH_1
  • AWS_SES_EU_WEST_1
  • AWS_SES_AP_NORTHEAST_3
  • AWS_SES_AP_NORTHEAST_2
  • AWS_SES_ME_SOUTH_1
  • AWS_SES_AP_NORTHEAST_1
  • AWS_SES_IL_CENTRAL_1
  • AWS_SES_SA_EAST_1
  • AWS_SES_CA_CENTRAL_1
  • AWS_SES_AP_SOUTHEAST_1
  • AWS_SES_AP_SOUTHEAST_2
  • AWS_SES_AP_SOUTHEAST_3
  • AWS_SES_EU_CENTRAL_1
  • AWS_SES_US_EAST_1
  • AWS_SES_US_EAST_2
  • AWS_SES_US_WEST_1
  • AWS_SES_US_WEST_2

--signing-attributes (structure)

Объект, содержащий информацию о закрытом ключе и селекторе, которые вы хотите использовать для настройки DKIM для идентификатора Bring Your Own DKIM (BYODKIM) для идентификатора, или настраивает длину ключа, которая должна использоваться для Easy DKIM.

DomainSigningSelector -> (string)

[Bring Your Own DKIM] Строка, используемая для идентификации открытого ключа в конфигурации DNS для домена.

DomainSigningPrivateKey -> (string)

[Bring Your Own DKIM] Закрытый ключ, используемый для генерации подписи DKIM.

Закрытый ключ должен использовать 1024- или 2048-битное RSA-шифрование и должен быть закодирован с использованием кодировки base64.

NextSigningKeyLength -> (string)

[Easy DKIM] Длина ключа будущей пары ключей DKIM, которая будет сгенерирована. Это можно изменить не чаще одного раза в день.

DomainSigningAttributesOrigin -> (string)

Атрибут, используемый для настройки DKIM для идентификатора, зависит от операции:

  • Для PutEmailIdentityDkimSigningAttributes :
    • Ни одно из значений не разрешено - используйте параметр ` SigningAttributesOrigin https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_PutEmailIdentityDkimSigningAttributes.html#SES-PutEmailIdentityDkimSigningAttributes-request-SigningAttributesOrigin`__ вместо него
  • Для CreateEmailIdentity при репликации конфигурации DKIM родительского идентификатора:
    • Разрешенные значения: все значения, кроме AWS_SES и EXTERNAL
  • AWS_SES – Настроить DKIM для идентификатора с помощью Easy DKIM.
  • EXTERNAL – Настроить DKIM для идентификатора с помощью Bring Your Own DKIM (BYODKIM).
  • AWS_SES_AF_SOUTH_1 – Настроить DKIM для идентификатора путем репликации из родительского идентификатора в регионе Африки (Кейптаун) с использованием Deterministic Easy-DKIM (DEED).
  • AWS_SES_EU_NORTH_1 – Настроить DKIM для идентификатора путем репликации из родительского идентификатора в регионе Европы (Стокгольм) с использованием Deterministic Easy-DKIM (DEED).
  • AWS_SES_AP_SOUTH_1 – Настроить DKIM для идентификатора путем репликации из родительского идентификатора в регионе Азиатско-Тихоокеанского региона (Мумбаи) с использованием Deterministic Easy-DKIM (DEED).
  • AWS_SES_EU_WEST_3 – Настроить DKIM для идентификатора путем репликации из родительского идентификатора в регионе Европы (Париж) с использованием Deterministic Easy-DKIM (DEED).
  • AWS_SES_EU_WEST_2 – Настроить DKIM для идентификатора путем репликации из родительского идентификатора в регионе Европы (Лондон) с использованием Deterministic Easy-DKIM (DEED).
  • AWS_SES_EU_SOUTH_1 – Настроить DKIM для идентификатора путем репликации из родительского идентификатора в регионе Европы (Милан) с использованием Deterministic Easy-DKIM (DEED).
  • AWS_SES_EU_WEST_1 – Настроить DKIM для идентификатора путем репликации из родительского идентификатора в регионе Европы (Ирландия) с использованием Deterministic Easy-DKIM (DEED).
  • AWS_SES_AP_NORTHEAST_3 – Настроить DKIM для идентификатора путем репликации из родительского идентификатора в регионе Азиатско-Тихоокеанского региона (Осака) с использованием Deterministic Easy-DKIM (DEED).
  • AWS_SES_AP_NORTHEAST_2 – Настроить DKIM для идентификатора путем репликации из родительского идентификатора в регионе Азиатско-Тихоокеанского региона (Сеул) с использованием Deterministic Easy-DKIM (DEED).
  • AWS_SES_ME_SOUTH_1 – Настроить DKIM для идентификатора путем репликации из родительского идентификатора в регионе Ближнего Востока (Бахрейн) с использованием Deterministic Easy-DKIM (DEED).
  • AWS_SES_AP_NORTHEAST_1 – Настроить DKIM для идентификатора путем репликации из родительского идентификатора в регионе Азиатско-Тихоокеанского региона (Токио) с использованием Deterministic Easy-DKIM (DEED).
  • AWS_SES_IL_CENTRAL_1 – Настроить DKIM для идентификатора путем репликации из родительского идентификатора в регионе Израиля (Тель-Авив) с использованием Deterministic Easy-DKIM (DEED).
  • AWS_SES_SA_EAST_1 – Настроить DKIM для идентификатора путем репликации из родительского идентификатора в регионе Южной Америки (Сан-Паулу) с использованием Deterministic Easy-DKIM (DEED).
  • AWS_SES_CA_CENTRAL_1 – Настроить DKIM для идентификатора путем репликации из родительского идентификатора в регионе Канады (Центральный) с использованием Deterministic Easy-DKIM (DEED).
  • AWS_SES_AP_SOUTHEAST_1 – Настроить DKIM для идентификатора путем репликации из родительского идентификатора в регионе Азиатско-Тихоокеанского региона (Сингапур) с использованием Deterministic Easy-DKIM (DEED).
  • AWS_SES_AP_SOUTHEAST_2 – Настроить DKIM для идентификатора путем репликации из родительского идентификатора в регионе Азиатско-Тихоокеанского региона (Сидней) с использованием Deterministic Easy-DKIM (DEED).
  • AWS_SES_AP_SOUTHEAST_3 – Настроить DKIM для идентификатора путем репликации из родительского идентификатора в регионе Азиатско-Тихоокеанского региона (Джакарта) с использованием Deterministic Easy-DKIM (DEED).
  • AWS_SES_EU_CENTRAL_1 – Настроить DKIM для идентификатора путем репликации из родительского идентификатора в регионе Европы (Франкфурт) с использованием Deterministic Easy-DKIM (DEED).
  • AWS_SES_US_EAST_1 – Настроить DKIM для идентификатора путем репликации из родительского идентификатора в регионе США (Восточная Вирджиния) с использованием Deterministic Easy-DKIM (DEED).
  • AWS_SES_US_EAST_2 – Настроить DKIM для идентификатора путем репликации из родительского идентификатора в регионе США (Огайо) с использованием Deterministic Easy-DKIM (DEED).
  • AWS_SES_US_WEST_1 – Настроить DKIM для идентификатора путем репликации из родительского идентификатора в регионе США (Западная Калифорния) с использованием Deterministic Easy-DKIM (DEED).
  • AWS_SES_US_WEST_2 – Настроить DKIM для идентификатора путем репликации из родительского идентификатора в регионе США (Орегон) с использованием Deterministic Easy-DKIM (DEED).

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

DomainSigningSelector=string,DomainSigningPrivateKey=string,NextSigningKeyLength=string,DomainSigningAttributesOrigin=string

Синтаксис JSON:

{
  "DomainSigningSelector": "string",
  "DomainSigningPrivateKey": "string",
  "NextSigningKeyLength": "RSA_1024_BIT"|"RSA_2048_BIT",
  "DomainSigningAttributesOrigin": "AWS_SES"|"EXTERNAL"|"AWS_SES_AF_SOUTH_1"|"AWS_SES_EU_NORTH_1"|"AWS_SES_AP_SOUTH_1"|"AWS_SES_EU_WEST_3"|"AWS_SES_EU_WEST_2"|"AWS_SES_EU_SOUTH_1"|"AWS_SES_EU_WEST_1"|"AWS_SES_AP_NORTHEAST_3"|"AWS_SES_AP_NORTHEAST_2"|"AWS_SES_ME_SOUTH_1"|"AWS_SES_AP_NORTHEAST_1"|"AWS_SES_IL_CENTRAL_1"|"AWS_SES_SA_EAST_1"|"AWS_SES_CA_CENTRAL_1"|"AWS_SES_AP_SOUTHEAST_1"|"AWS_SES_AP_SOUTHEAST_2"|"AWS_SES_AP_SOUTHEAST_3"|"AWS_SES_EU_CENTRAL_1"|"AWS_SES_US_EAST_1"|"AWS_SES_US_EAST_2"|"AWS_SES_US_WEST_1"|"AWS_SES_US_WEST_2"
}

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

--generate-cli-skeleton (string) Выводит скелет 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.

Вывод

DkimStatus -> (строка)

Статус аутентификации DKIM для идентификатора. Amazon SES определяет статус аутентификации, выполняя поиск определенных записей в конфигурации DNS для вашего домена. Если вы использовали Easy DKIM для настройки аутентификации DKIM, Amazon SES попытается найти три уникальных записи CNAME в конфигурации DNS вашего домена.

Если вы предоставили открытый ключ для выполнения аутентификации DKIM, Amazon SES попытается найти запись TXT, которая использует указанный вами селектор. Значение записи TXT должно быть открытым ключом, который сопряжен с закрытым ключом, который вы указали в процессе создания идентификатора.

Статус может быть одним из следующих:

  • PENDING – Процесс проверки был начат, но Amazon SES еще не обнаружил записи DKIM в конфигурации DNS для домена.
  • SUCCESS – Проверка успешно завершена.
  • FAILED – Проверка завершилась неудачно. Это обычно происходит, когда Amazon SES не может найти записи DKIM в конфигурации DNS домена.
  • TEMPORARY_FAILURE – Временная проблема препятствует Amazon SES определить статус аутентификации DKIM домена.
  • NOT_STARTED – Проверка DKIM для домена еще не начата.

DkimTokens -> (список)

Если вы использовали Easy DKIM для настройки аутентификации DKIM для домена, то этот объект содержит набор уникальных строк, которые вы используете для создания набора записей CNAME, которые вы добавляете в конфигурацию DNS вашего домена. Когда Amazon SES обнаруживает эти записи в конфигурации DNS для вашего домена, процесс аутентификации DKIM завершается.

Если вы настроили аутентификацию DKIM для домена, предоставив свою пару открыто-закрытого ключа, то этот объект содержит селектор, связанный с вашим открытым ключом.

Независимо от метода аутентификации DKIM, который вы используете, Amazon SES ищет соответствующие записи в конфигурации DNS домена в течение до 72 часов.

(строка)

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

Spec-Zone.ru

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