定义 SMS 网关
使用 smsgw_define 命令可定义 SMS 网关。
smsgw_define smsgw=SMSGatewayName email_address=email
subject_line=SubjectLineScheme email_body=EmailBodyScheme
[ smtpgw=<SMTPGW1[,SMTPGW2]...|ALL> ]
参数
| 名称 | 类型 | 描述 | 必需 | 缺省值 |
|---|---|---|---|---|
| smsgw | 对象名 | SMS 网关名称。 | Y | 不适用 |
| email_address | 令牌字符串 | 电子邮件地址格式。 | Y | 不适用 |
| subject_line | 令牌字符串 | 主题行格式。 | Y | 不适用 |
| email_body | 令牌字符串 | 电子邮件正文格式。 | Y | 不适用 |
| smtpgw | 对象名 | 要使用的 SMTP 网关列表。 | N | smtpgw_prioritize 命令中定义的 SMTP 网关。 |
SMS 网关用于通过 SMS 消息发送事件通知。 SMS 消息是通过“SMS-电子邮件”服务器发送的。要定义新的 SMS 网关,必须了解 SMS 消息在电子邮件消息中的封装方式。
系统在发送 SMS 消息时,会使用实际的消息文本来描述事件和目标号码。 目标号码由区号和本地号码组成。 这两部分是在定义目标时指定的,如定义新的事件通知目标命令中所述。
可以将消息文本和目标号码嵌入到电子邮件消息的多个部分:目标地址、主题行或者电子邮件正文。 此命令可以定义如何格式化电子邮件消息,以及如何排列特定 SMS 的信息。
定义 SMS 网关时,必须指定以下三个参数以便定义格式:
- email_address:该电子邮件地址用于通过“电子邮件-SMS”网关来发送 SMS。
- subject_line:将转换为 SMS 的传出电子邮件的主题行。
- email_body:将转换为 SMS 的传出电子邮件的正文。
对于上述每个参数,其值要么是固定文本,要么是事件文本或者目标电话号码。 该信息必须嵌入在以下换码序列中:
- {areacode}。 该换码序列将替换为目标的手机号区号。
- {number}。 该换码序列将替换为目标的手机本地号码。
- {message}。 该换码序列将替换为要向用户显示的文本。
- \{, \}, \\. 将分别替换为 {、} 或 \。
缺省情况下,发送给“电子邮件-SMS”服务器的电子邮件将通过已定义的 SMTP 服务器发送,这些 SMTP 服务器已由 smtpgw_prioritize 命令划分了优先级(请参阅划分 SMTP 网关优先级)。 如果需要,用户可以定义特定的 SMTP 网关,以向该“电子邮件-SMS”网关发送电子邮件。
系统会按照 smtpgw_prioritize 命令指定的顺序尝试每个 SMS 网关,直到成功连接到它们中的一个。 可以将特定 SMS 目标与特定 SMS 网关关联(请参阅定义新的事件通知目标)。
示例:
smsgw_define smsgw=SMSGW1
email_address={areacode}{number}@sms2emailserver.yourcompany.com
subject_line=SMS email_body={message}
输出:
Command executed successfully.
访问控制
| 用户类别 | 许可权 |
|---|---|
| 存储管理员 | 允许 |
| 存储集成管理员 | 不允许 |
| 应用程序管理员 | 不允许 |
| 安全性管理员 | 不允许 |
| 只读用户 | 不允许 |
| 技术人员 | 不允许 |
返回码
- GATEWAY_MAX_REACHED
已达到允许的最大网关数。
- SMSGW_CANNOT_BE_DEFINED_WITHOUT_SMTPGW
如果未定义任何 SMTP 网关,那么无法定义 SMS 网关。
- GATEWAY_NAME_DOES_NOT_EXIST
网关名称不存在。
- GATEWAY_NAME_APPEARS_TWICE
此网关名称在列表上出现两次。
- GATEWAY_NAME_ALREADY_EXISTS
网关名称已存在。