SMTP Policy

An SMTP Policy configures the email alert service on UCS servers, enabling the Cisco IMC to send fault notifications to specified recipients via an SMTP server with optional TLS encryption.

Note: Intersight does not support SMTP authentication (auth, username, password) on server SMTP policies. Use an unauthenticated relay or a relay that accepts connections from the IMC management network.

Location in Intersight GUI: Policies » SMTP

Diagram

Classes

policies (compute.intersight.organizations)

Name	Type	Constraint	Mandatory	Default Value
smtp	List	[smtp]	No

smtp (compute.intersight.organizations.policies)

Name	Type	Constraint	Mandatory	Default Value
name	String	Regex: ^[a-zA-Z0-9_.:-]{1,64}$	Yes
description	String		No
managed	Boolean	true, false	No	true
tags	List	[tags]	No
enabled	Boolean	true, false	No	true
smtp_server	String		No
smtp_port	Integer	min: 1, max: 65535	No	25
sender_email	String		No
recipients	List	String	No
min_severity	Choice	critical, major, minor, warning, condition	No	critical
tls	Boolean	true, false	No	false

tags (compute.intersight.organizations.policies.smtp)

Name	Type	Constraint	Mandatory	Default Value
key	String		Yes
value	String		Yes

Examples

Example-1: Configure SMTP with a relay server and critical fault notifications, with environment tags.

compute:
  intersight:
    organizations:
      - name: MyOrg
        policies:
          smtp:
            - name: MySmtpPolicy
              enabled: true
              smtp_server: smtp.example.com
              smtp_port: 25
              sender_email: intersight-alerts@example.com
              recipients:
                - admin@example.com
                - ops@example.com
              min_severity: critical
              tags:
                - key: env
                  value: prod

Example-2: Configure SMTP with TLS and warning-level notifications.

compute:
  intersight:
    organizations:
      - name: MyOrg
        policies:
          smtp:
            - name: MySmtpTls
              enabled: true
              smtp_server: smtp.example.com
              smtp_port: 587
              sender_email: alerts@example.com
              recipients:
                - ops@example.com
              min_severity: warning
              tls: true

Example-3: Disable SMTP alerting for servers that use an alternative alerting method.

compute:
  intersight:
    organizations:
      - name: MyOrg
        policies:
          smtp:
            - name: MySmtpDisabled
              enabled: false