sendgrid – Отправка электронного письма с помощью API SendGrid

Новое в версии 2.0.

Обзор
Требования
Параметры
Примечания
Примеры
Статус

Обзор

Отправляет электронное письмо с учетной записью SendGrid через их API, а не через SMTP-сервис.

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

библиотека sendgrid для Python

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_key - добавлен в 2.2		ключ API SendGrid для использования вместо имени пользователя/пароля
attachments - добавлен в 2.2		список относительных или полных путей к файлам, которые нужно прикрепить (предел 7 МБ, согласно документации SendGrid)
bcc - добавлен в 2.2		список адресов электронной почты для рассылки по копии
cc - добавлен в 2.2		список адресов электронной почты для отправки копии
from_address - / обязательно		адрес в поле "от" для электронного письма
from_name - добавлен в 2.2		имя, которое вы хотите видеть в поле "от", например, "Иван Иванов"
headers - добавлен в 2.2		словарь для передачи в качестве заголовков
html_body булево добавлен в 2.2	Варианты: нет ← да	является ли тело содержимым HTML, которое должно быть отображено
password -		пароль, соответствующий имени пользователя С версии 2.2 требуется только в том случае, если не указан api_key.
subject - / обязательно		желаемый предмет электронного письма
to_addresses - / обязательно		список с одним или несколькими адресами электронной почты получателей
username -		имя пользователя для входа в учетную запись SendGrid. С версии 2.2 требуется только в том случае, если не указан api_key.

Примечания

Примечание

Этот модуль не идемпотентен, потому что он отправляет электронное письмо через внешний API. Он идемпотентен только в случае сбоя модуля.
Как и другие модули уведомлений, этот требует внешней зависимости для работы. В данном случае вам потребуется активная учетная запись SendGrid.
Для использования api_key, cc, bcc, attachments, from_name, html_body, headers необходимо установить sendgrid с помощью pip
С версии 2.2 имя пользователя и пароль не требуются, если указан api_key

Примеры

# send an email to a single recipient that the deployment was successful
- sendgrid:
    username: "{{ sendgrid_username }}"
    password: "{{ sendgrid_password }}"
    from_address: "ansible@mycompany.com"
    to_addresses:
      - "ops@mycompany.com"
    subject: "Deployment success."
    body: "The most recent Ansible deployment was successful."
  delegate_to: localhost

# send an email to more than one recipient that the build failed
- sendgrid:
      username: "{{ sendgrid_username }}"
      password: "{{ sendgrid_password }}"
      from_address: "build@mycompany.com"
      to_addresses:
        - "ops@mycompany.com"
        - "devteam@mycompany.com"
      subject: "Build failure!."
      body: "Unable to pull source repository from Git server."
  delegate_to: localhost

Статус

Гарантия обратной совместимости интерфейса этого модуля не предоставляется. [превью]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

Matt Makai (@makaimc)

Подсказка

Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать его, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/sendgrid_module.html