设置邮件 本节主要介绍如何使用API设置邮件。 此操作用来设置或者修改邮件配置信息。 注意 如果邮件服务器地址是IPv6地址,为了确保邮件能发送成功,建议每台HBlock服务器上都有一个能连接到邮件服务器的IPv6地址。 请求语法 plaintext PUT /rest/v1/system/config/notification HTTP/1.1 Date: date ContentType: application/json; charsetutf8 ContentLength: length Host: ip:port Authorization: authorization { "status": status, "smtpHost": smtpHost, "smtpPort": smtpPort, "SSL": ssl, "senderEmail": senderEmail, "password": password, "receiverEmail": reciverEmail } 请求参数 参数 类型 描述 是否必须 status String 是否启用邮件通知功能。 取值: Enabled:启用。 Disabled:禁用。 是 smtpHost String SMTP服务器。 取值:SMTP服务器域名或IP。 注意 如果启用邮件通知时,未在服务端保存过邮件配置,此项必填。 否 smtpPort Integer SMTP端口号。 取值:[1,65535]。 说明 如果启用SSL,默认端口为465。 如果禁用SSL,默认端口为25。 否 SSL String 是否启用SSL。 取值: Enabled:启用SSL。 Disabled:禁用SSL。 默认值为Disabled。 否 senderEmail String 发件箱。 邮箱格式localpart@domain: localpart:字符串形式,长度1~64,可包含字母、数字、特殊字符(! $ % & + / ? ^ { }~ .),字母区分大小写。句点(.)不能作为首尾字符,也不能连续出现。 domain:以句点 (.)分隔的字符串形式,长度1~255。通过句点(.)分隔开的每个字符串需要满足如下要求: 长度1~63。 可包含字母、数字、短横线(),字母区分大小写。 顶级域名不能是纯数字。 短横线()不能作为首尾字符。 注意 如果启用邮件通知时,未在服务端保存过邮件配置,此项必填。 否 password String 邮箱授权码。 说明 授权码是邮箱推出的,用于第三方客户端登录的专用密码。 注意 如果启用邮件通知时,未在服务端保存过邮件配置,此项必填。 否 receiverEmail String 收件箱。可以填写多个收件箱。 邮箱格式localpart@domain: localpart:字符串形式,长度1~64,可包含字母、数字、特殊字符(!