定义新事件通知目标
使用 dest_define 命令为事件通知定义新目标。
dest_define
dest=DestName type=<SNMP|EMAIL|SMS|HTTPS>
< snmp_manager=SNMPManager | < uri=HTTPSaddress
[ proxy=ProxyAddress [ proxy_port=ProxyPortNum ] ]
> | email_address=email |
<area_code=AreaCode number=PhoneNumber> | user=UserName>
[ smtpgws=<SMTPGW1[,SMTPGW2]...|ALL> | smsgws=<SMSGW1[,SMSGW2]...|ALL> ]
[ heartbeat_test_hour=HH:MM
[ heartbeat_test_days=Day ] ] [ domain=DomainList ]
参数
| 名称 | 类型 | 描述 | 必需 | 缺省值 |
|---|---|---|---|---|
| dest | 对象名 | 目标名称。 | Y | 不适用 |
| type | 枚举 | 事件通知的目标类型:电子邮件、SMS、HTTPS 或 SNMP。 | Y | 不适用 |
| snmp_manager | 不适用 | SNMP 管理器的 IP 地址或 DNS 名称。 | N | 不适用 |
| uri | 不适用 | HTTPS 服务器的 IP 地址或 DNS 名称。 如果要使用非缺省端口,请在此处指定。 | N | 不适用 |
| proxy | 不适用 | 要通过其发送 HTTPS 的代理服务器的 IP 地址或 DNS 名称。 | N | None |
| proxy_port | 整数 | 要通过其发送 HTTPS 的代理端口号。 缺省值为 1080。 | N | None |
| email_address | 不适用 | 电子邮件地址。 | N | 不适用 |
| smtpgws | 对象名 | 要使用的 SMTP 网关列表。 | N | ALL(所有网关)。 |
| area_code | 不适用 | 用于 SMS 通知的手机号码的区号。 请使用数字,“-”或“.” | N | 不适用 |
| number | 不适用 | 用于 SMS 通知的手机号码。 请使用数字,“-”或“.” | N | 不适用 |
| smsgws | 对象名 | 要用于此目标的 SMS 网关。 | N | ALL(所有网关)。 |
| user | 对象名 | 用户名,将在其中使用用户的电子邮件或电话。 | N | 不适用 |
| heartbeat_test_ hour | 不适用 | 定期脉动信号测试的小时,采用格式 HH:MM | N | 无脉动信号 |
| heartbeat_test_ days | 不适用 | 用于脉动信号测试的日列表:逗号分隔的 3 字母日名称列表(如“mon”、“mon,fri”等)。 | N | 无脉动信号 |
| domain | 不适用 | 将目标连接到指定的域。 要定义多个域,请用逗号分隔。 要指定所有现有的域,请使用“*”。 | N | none |
该命令将定义事件通知的目标。 存在四种类型的目标:电子邮件、SMS、HTTPS 和 SNMP。
- 电子邮件目标用于通过电子邮件发送通知。 在定义类型为电子邮件的新目标时,必须在 email_address 中指定收件人的电子邮件地址,或者必须在 user 中指定用户名(在此情况下,将使用该用户的电子邮件地址)。
- SMS 目标用于通过 SMS 将通知发送至手机。 在定义类型为 SMS 的新目标时,必须在 number 中指定目标的手机号码,或者必须在 user 中指定用户名(在此情况下,将使用该用户的手机号码)。 为确保正确的格式,必须将区号与本地号码分隔。
- SNMP 目标用于通过 SNMP 陷阱将通知发送至 SNMP 管理器。 当定义类型为 SNMP 的新目标时,必须指定 SNMP 管理器的 IP 地址。
- HTTPS 目标用于将通知发送至 HTTPS 服务器。 当定义类型为 HTTPS 的新目标时,必须指定 HTTPS 服务器的 IP 地址。
缺省情况下,在发送电子邮件通知时,将根据 smtpgw_prioritize 命令中指定的顺序来使用该命令中指定的所有 SMTP 网关(请参阅对 SMTP 网关划分优先顺序)。 可以定义将电子邮件发送至特定的目标将使用特定的 SMTP 网关。 通过指定 smtpgws 参数来实现。
同样的逻辑适用于发送 SMS 消息。 缺省情况下,将根据 smtpgw_prioritize 命令中指定的顺序来使用该命令中指定的 SMS 网关。 可以定义将通过特定的 SMS 网关将消息发送至特定的 SMS 目标。
示例:
dest_define dest=adminemail type=EMAIL
email_address=storageadmin@yourcompany.com
输出:
Command executed successfully.
示例:
dest_define dest=monitoringserver type=SNMP
snmp_manager=10.170.68.111
输出:
Command executed successfully.
访问控制
| 用户类别 | 许可权 |
|---|---|
| 存储管理员 | 允许 |
| 存储集成管理员 | 不允许 |
| 应用程序管理员 | 不允许 |
| 安全性管理员 | 不允许 |
| 只读用户 | 不允许 |
| 技术人员 | 不允许 |
返回码
- DEST_MAX_REACHED
已达到允许的最大目标数。
- DEST_NAME_ALREADY_EXISTS
目标名称已存在。
- DEST_NAME_IS_DESTGROUP_NAME
目标名称已作为目标组名称存在。
- EMAIL_NOT_ALLOWED_FOR_DEST_TYPE
此类型的目标不能具有电子邮件地址。
- GATEWAY_NAME_APPEARS_TWICE
此网关名称在列表上显示了两次。
- GATEWAY_NAME_DOES_NOT_EXIST
网关名称不存在。
- SMSGWS_NOT_ALLOWED_FOR_DEST_TYPE
此类型的目标不能具有 SMS 网关。
- SMTPGWS_NOT_ALLOWED_FOR_DEST_TYPE
此类型的目标不能具有 SMTP 网关。
- SNMP_MANAGER_MUST_BE_SPECIFIED_FOR_DEST_TYPE
此类型的目标必须具有 SNMP 管理器。
- SNMP_MANAGER_NOT_ALLOWED_FOR_DEST_TYPE
此类型的目标不能具有 SNMP 管理器。
- NO_SMS_GATEWAYS_ARE_DEFINED
如果未定义任何 SMS 网关,那么不能定义 SMS 目标。
- HTTPS_ADDRESS_NOT_ALLOWED_FOR_DEST_TYPE
此类型的目标不能具有 HTTPS 地址。
- PROXY_ADDRESS_NOT_ALLOWED_FOR_DEST_TYPE
此类型的目标不能具有代理地址。
- SNMP_DESTS_CANNOT_REFER_TO_USERS
SNMP 目标不能引用用户。
- HTTPS_DESTS_CANNOT_REFER_TO_USERS
HTTPS 目标不能引用用户。
- NO_SMTP_GATEWAYS_ARE_DEFINED
如果未定义任何 SMTP 网关,那么不能定义电子邮件目标。
- USER_EMAIL_ADDRESS_IS_NOT_DEFINED
未定义用户的电子邮件地址。
- USER_PHONE_NUMBER_IS_NOT_DEFINED
未定义用户的电话号码。
- USER_NAME_DOES_NOT_EXIST
用户名不存在。
- INTERNAL_DESTS_CANNOT_REFER_TO_USERS
内部目标不能引用用户。
- DAY_APPEARS_TWICE
日“Day”在列表中出现了两次。
故障诊断:确保每个日期仅在列表中出现一次。
- HTTPS_ADDRESS_MUST_BE_SPECIFIED_FOR_DEST_TYPE
此类型的目标必须具有 HTTPS 地址。
- DEST_TYPE_NOT_SUPPORTED
不支持此目标类型。
故障诊断:请联系 IBM 支持人员
- USER_IS_NOT_IN_DESTINATION_DOMAINS
用户必须包含在目标域中。
- DOMAIN_DOESNT_EXIST
域不存在。