添加监视器 API - Servers


本节说明如何使用添加监视器API添加类别服务器类型的监视器。支持以下服务器:

AIX

语法:

http://[Host]:[Port]/AppManager/xml/AddMonitor?apikey=[APIKEY]&type=[TYPE]&displayname=[DISPLAYNAME]&host=[HOST]&os=[OS]&username=[USERNAME]&mode=[MODE]&snmptelnetport=[SNMPTELNETPORT]&password=[PASSWORD]&prompt=[PROMPT]&timeout=[TIMEOUT]

请求参数:

API请求中涉及的参数如下所述。另外,请参阅常见的请求参数列表

字段描述
type 您要添加的监视器的类别类型。该值应为服务器。
host 运行AIX服务器的主机的名称。
os 服务器的操作系统。值是AIX。
username AIX服务器的用户名。
mode 监控AIX服务器的模式。值应为TELNET或SSH。
snmptelnetport 运行Telnet服务的端口号。预设值为23。
password AIX服务器的密码。
Timeout 超时值(以秒为单位)。
prompt 命令提示符值。值是$
forceadd 此参数用于强制Applications Manager绕过可用性和其他与身份验证相关的检查,并添加监视器。可能的值为:
  • True-强制添加监视器
  • False-不强制添加监视器。
addgivenname 指定是否要将监视器的主机名设置为在API中配置的主机名/ IP地址。
passphrase 如果专用密钥受SSH身份验证保护,请指定一个密码短语。

示例请求:

http://prod-server1:9098/AppManager/xml/AddMonitor?apikey=624436f73f9fda2109cc916c8c8be5c1&type=servers&displayname=apmaix&host=adventaix&os=AIX&username=root&mode=TELNET&snmptelnetport=23&password=sankho&prompt=#&timeout=30

AS400

语法:

http://[Host]:[Port]/AppManager/xml/AddMonitor?apikey=[APIKEY]&type=[TYPE]&displayname=[DISPLAYNAME]&host=[HOST]&subnet=[SUBNET]&pollInterval=[POLLINTERVAL]&os=[OS]&username=[USERNAME]&password=[PASSWORD]&timeout=[TIMEOUT]

请求参数:

API请求中涉及的参数如下所述。另外,请参阅常见的请求参数列表

字段描述
type 您要添加的监视器的类别类型。值应为服务器。
host 运行AS400服务器的主机的名称。
subnet 子网掩码值
pollInterval 监视器的轮询间隔。
os 服务器的操作系统。值为AS400 / iSeries。
username AS400 / iSeries服务器的用户名。
Timeout 超时值(以秒为单位)。
password AS400 / iSeries服务器的密码。
forceadd 此参数用于强制Applications Manager绕过可用性和其他与身份验证相关的检查,并添加监视器。可能的值为:
  • True-强制添加监视器
  • False-不强制添加监视器。
addgivenname 指定是否要将监视器的主机名设置为在API中配置的主机名/ IP地址。
passphrase 如果专用密钥受SSH身份验证保护,请指定一个密码短语。

示例请求:

http://prod-server2:9090/AppManager/xml/AddMonitor?apikey=5bc6a8e9a30d5bf894586d4db90282f5&type=servers&displayname=apmas400&host=pub1.rzkh.de&subnet=255.255.255.0&pollInterval=5&os=AS400/iSeries&username=nimda&password=admin&timeout=30

FreeBSD

语法:

http://[Host]:[Port]/AppManager/xml/AddMonitor?apikey=[APIKEY]&type=[TYPE]&displayname=[DISPLAYNAME]&host=[HOST]&subnet=[SUBNET]&pollInterval=[POLLINTERVAL]&os=[OS]&username=[USERNAME]&password=[PASSWORD]&mode=[MODE]&snmptelnetport=[SNMPTELNETPORT]&prompt=[PROMPT]&timeout=[TIMEOUT]&snmpCommunityString=[snmp Community String]

请求参数:

API请求中涉及的参数如下所述。另外,请参阅常见的请求参数列表

字段描述
type 您要添加的监视器的类别类型。值应为服务器。
host FreeBSD服务器运行所在的主机名。
subnet 子网掩码值
pollInterval 监视器的轮询间隔。
os 服务器的操作系统。值是FreeBSD。
username FreeBSD服务器的用户名。
password FreeBSD服务器的密码。
mode 监控方式。值应为SNMP,TELNET或SSH。
snmpCommunityString  服务器上SNMP数据的只读访问所需的SNMP团体字符串。使用SNMP模式时必选。默认值为public。
snmptelnetport 运行Telnet服务的端口。预设值为23。
Timeout 超时值(以秒为单位)。
prompt 命令提示符值。值是$。
forceadd 此参数用于强制Applications Manager绕过可用性和其他与身份验证相关的检查,并添加监视器。可能的值为:
  • True-强制添加监视器
  • False-不强制添加监视器。
addgivenname 指定是否要将监视器的主机名设置为在API中配置的主机名/ IP地址。
passphrase 如果专用密钥受SSH身份验证保护,请指定一个密码短语。

示例请求:

http://prod-server4:9090/AppManager/xml/AddMonitor?apikey=5bc6a8e9a30d5bf894586d4db90282f5&type=servers&displayname=apmfreebsd&host=cm-bsd&subnet=255.255.255.0&pollInterval=5&os=FreeBSD&username=test&password=test&mode=TELNET&snmptelnetport=23&prompt=$&timeout=30

HP-UX/Tru64

语法:

http://[Host]:[Port]/AppManager/xml/AddMonitor?apikey=[APIKEY]&type=[TYPE]&displayname=[DISPLAYNAME]&username=[USERNAME]&password=[PASSWORD]&os=[OS]&mode=[MODE]&snmptelnetport=[SNMPTELNETPORT]&host=[HOST]&timeout=[TIMEOUT]

请求参数:

API请求中涉及的参数如下所述。另外,请参阅常见的请求参数列表

字段描述
type 您要添加的监视器的类别类型。值应为服务器。
username HP-UX服务器的用户名。
password HP-UX服务器的密码。
os 服务器的操作系统。值为HP-UX。
mode 监控方式。值是SSH或TELNET
snmptelnetport 运行SSH / Telnet服务的端口。默认值为23(对于Telnet)和22(对于SSH)​​。
Timeout 超时值(以秒为单位)。
host 运行HP-UX服务器的主机的名称。
forceadd 此参数用于强制Applications Manager绕过可用性和其他与身份验证相关的检查,并添加监视器。可能的值为:
  • True-强制添加监视器
  • False-不强制添加监视器。
addgivenname 指定是否要将监视器的主机名设置为在API中配置的主机名/ IP地址。
passphrase 如果专用密钥受SSH身份验证保护,请指定一个密码短语。

示例请求:

http://prod-server5:9090/AppManager/xml/AddMonitor?apikey=5bc6a8e9a30d5bf894586d4db90282f5&type=servers&displayname=apmhpux&username=test&password=test&os=HP-UX&mode=SSH&snmptelnetport=22&host=hpuxtests&timeout=30

Linux

语法:

http://[Host]:[Port]/AppManager/xml/AddMonitor?apikey=[APIKEY]&type=[TYPE]&displayname=[DISPLAYNAME]&host=[HOST]&snmptelnetport=[SNMPTELNETPORT]&os=[OS]&mode=[MODE]&timeout=[TIMEOUT]&username=[USERNAME]&password=[PASSWORD]&snmpCommunityString=[snmp Community String]

请求参数:

API请求中涉及的参数如下所述。另外,请参阅常见的请求参数列表

字段描述
type 您要添加的监视器的类别类型。值应为服务器。
host Linux服务器运行所在的主机的名称。
snmptelnetport 运行SSH / Telnet / SNMP的端口。默认值为23(对于Telnet),22(对于SSH)​​和161(对于SNMP)。
os 服务器的操作系统。值是Linux。
Timeout 超时值(以秒为单位)。
mode 监控方式。值为SNMP,SSH或TELNET。(对于SNMP模式,必须在API请求参数中添加团体字符串。)
forceadd 此参数用于强制Applications Manager绕过可用性和其他与身份验证相关的检查,并添加监视器。可能的值为:
  • True-强制添加监视器
  • False-不强制添加监视器。
addgivenname 指定是否要将监视器的主机名设置为在API中配置的主机名/ IP地址。
passphrase 如果专用密钥受SSH身份验证保护,请指定一个密码短语。
username 使用Telnet / ssh监控模式的用户名。
password 使用Telnet / ssh监控模式的密码。
snmpCommunityString  服务器上SNMP数据的只读访问所需的SNMP团体字符串。使用SNMP模式时必选。默认值为public。

示例请求s:

SSH 模式:

http://prod-server:9090/AppManager/xml/AddMonitor?apikey=cfb48066f523d94c18fd0a99bc4faa10&type=servers&displayname=APILINUX &host=app-centos32-1&snmptelnetport=22&os=Linux&mode=SSH&timeout=10&username=test&password=Zoho123

SNMP 模式:

http://prod-server:9090/AppManager/xml/AddMonitor?apikey=cfb48066f5fdvgf94c18fd0a99bc4faa10&type=servers&displayname=APILINUX &host=app-centos32-1&snmptelnetport=161&os=Linux&mode=SNMP&timeout=10&snmpCommunityString=Public

示例响应:

<?xml version="1.0" encoding="UTF-8"?>
<AppManager-response uri="/AppManager/xml/AddMonitor">
<result>
<response resourceid="10005717" response-code="4000">
<message>Monitor added successfully.</message>
</response>
</result></AppManager-response>

Mac OS

语法:

http://[Host]:[Port]/AppManager/xml/AddMonitor?apikey=[APIKEY]&type=[TYPE]&displayname=[DISPLAYNAME]&host=[HOST]&snmptelnetport=[SNMPTELNETPORT]&os=[OS]&mode=[MODE]&username=[USERNAME]&password=[PASSWORD]&snmpCommunityString=[snmp Community String]&timeout=[TIMEOUT]

请求参数:

API请求中涉及的参数如下所述。另外,请参阅常见的请求参数列表

字段描述
type 您要添加的监视器的类别类型。值应为服务器。
host Mac OS运行所在的主机的名称。
snmptelnetport 运行SSH / Telnet / SNMP的端口。默认值为23(对于Telnet),22(对于SSH)​​和161(对于SNMP)。
os 服务器的操作系统。值是Mac OS。
mode 监控方式。值为SNMP,SSH或TELNET。
username Mac OS服务器的用户名。
Timeout 超时值(以秒为单位)。
password Mac OS服务器的密码。
snmpCommunityString  服务器上SNMP数据的只读访问所需的SNMP团体字符串。使用SNMP模式时必选。默认值为public。
forceadd 此参数用于强制Applications Manager绕过可用性和其他与身份验证相关的检查,并添加监视器。可能的值为:
  • True-强制添加监视器
  • False-不强制添加监视器。
addgivenname 指定是否要将监视器的主机名设置为在API中配置的主机名/ IP地址。
passphrase 如果专用密钥受SSH身份验证保护,请指定一个密码短语。

示例请求:

http://prod-server3:9090/AppManager/xml/AddMonitor?apikey=5bc6a8e9a30d5bf894586d4db90282f5&type=servers&displayname=apmmac&host=apptest-mac&snmptelnetport=23&os=Mac OS&mode=TELNET&username=administrator&password=admin123&timeout=30

Novell

语法:

http://[Host]:[Port]/AppManager/xml/AddMonitor?apikey=[APIKEY]&type=[TYPE]&displayname=[DISPLAYNAME]&host=[HOST]&snmptelnetport=[SNMPTELNETPORT]&os=[OS]&mode=[MODE]&snmpCommunityString=[snmp Community String]&timeout=[TIMEOUT]

请求参数:

API请求中涉及的参数如下所述。另外,请参阅常见的请求参数列表

字段描述
type 您要添加的监视器的类别类型。值应为服务器。
host 运行Novell服务器的主机的名称。
snmptelnetport 运行SNMP的端口。预设值为161。
os 服务器的操作系统。值是Novell。
Timeout 超时值(以秒为单位)。
mode 为服务器指定的监控方式。值为SNMP。
snmpCommunityString  服务器上SNMP数据的只读访问所需的SNMP团体字符串。默认值为public。
forceadd 此参数用于强制Applications Manager绕过可用性和其他与身份验证相关的检查,并添加监视器。可能的值为:
  • True-强制添加监视器
  • False-不强制添加监视器。
addgivenname 指定是否要将监视器的主机名设置为在API中配置的主机名/ IP地址。

示例请求:

http://production-server2:9090/AppManager/xml/AddMonitor?apikey=5bc6a8e9a30d5bf894586d4db90282f5&type=servers&displayname=apmnovell&host=smrithil&snmptelnetport=161&os=Novell&mode=SNMP&snmpCommunityString=public&timeout=30

Sun Solaris

语法:

http://[Host]:[Port]/AppManager/xml/AddMonitor?apikey=[APIKEY]&type=[TYPE]&displayname=[DISPLAYNAME]&host=[HOST]&snmptelnetport=[SNMPTELNETPORT]&os=[OS]&mode=[MODE]&username=[USERNAME]&password=[PASSWORD]&snmpCommunityString=[snmp Community String]&timeout=[TIMEOUT]

请求参数:

API请求中涉及的参数如下所述。另外,请参阅常见的请求参数列表

字段描述
type 您要添加的监视器的类别类型。值应为服务器。
host 运行Sun Solaris服务器的主机的名称。
snmptelnetport 运行SSH / Telnet / SNMP的端口。默认值为23(对于Telnet),22(对于SSH)​​和161(对于SNMP)。
os 服务器的操作系统。值是SUN。
mode 为服务器指定的监控方式。值应为SNMP,TELNET或SSH。
username Sun Solaris服务器的用户名。
Timeout 超时值(以秒为单位)。
password Sun Solaris服务器的密码。
snmpCommunityString  服务器上SNMP数据的只读访问所需的SNMP团体字符串。使用SNMP模式时必选。默认值为public。
forceadd 此参数用于强制Applications Manager绕过可用性和其他与身份验证相关的检查,并添加监视器。可能的值为:
  • True-强制添加监视器
  • False-不强制添加监视器。
addgivenname 指定是否要将监视器的主机名设置为在API中配置的主机名/ IP地址。
passphrase 如果专用密钥受SSH身份验证保护,请指定一个密码短语。

示例请求:

http://prod-server7:9090/AppManager/xml/AddMonitor?apikey=5bc6a8e9a30d5bf894586d4db90282f5&type=servers&displayname=apmsolaris&host=cagent-solaris2&snmptelnetport=23&os=SUN&mode=TELNET&username=guest&password=guest&timeout=30

Windows

语法:

http://[Host]:[Port]/AppManager/xml/AddMonitor?apikey=[APIKEY]&type=[TYPE]&displayname=[DISPLAYNAME]&host=[HOST]&snmptelnetport=[SNMPTELNETPORT]&os=[OS]&mode=[MODE]&username=[USERNAME]&password=[PASSWORD]&snmpCommunityString=[snmp Community String]&timeout=[TIMEOUT]&kerberos_status=[ KERBEROS STATUS ]

请求参数:

API请求中涉及的参数如下所述。另外,请参阅常见的请求参数列表

字段描述
type 您要添加的监视器的类别类型。值应为服务器。
host Windows服务器运行所在的主机的名称。
snmptelnetport 运行SNMP的端口。预设值为161。
os 服务器的操作系统。值可以是Windows 2000,Windows 2003,Windows 2008,Windows 2012,Windows 7,Windows 8,Windows XP,WindowsNT或Windows Vista
mode 为服务器指定的监控方式。值应为SNMP或WMI。
username Windows服务器的用户名。
password Windows服务器的密码。
Timeout 超时值(以秒为单位)。
eventlog_status 指定是否启用事件日志监控。参数值为true / false。
snmpCommunityString 服务器上SNMP数据的只读访问所需的SNMP团体字符串。使用SNMP模式时必选。默认值为public。
forceadd 此参数用于强制Applications Manager绕过可用性和其他与身份验证相关的检查,并添加监视器。可能的值为:
  • True-强制添加监视器
  • False-不强制添加监视器。
addgivenname 指定是否要将监视器的主机名设置为在API中配置的主机名/ IP地址。
passphrase 如果专用密钥受SSH身份验证保护,请指定一个密码短语。
kerberos_status 指定是否启用Kerberos身份验证。可能的值为true / false。

示例请求:

要以SNMP模式添加Windows服务器:

http://prod-server6:8080/AppManager/xml/AddMonitor?apikey=5bc6a8e9a30d5bf894586d4db90282f5 &type=servers&displayname=apmwindows&host=app-xp5&os=Windows XP&mode=SNMP&snmptelnetport=161&snmpCommunityString=public&timeout=30

要以WMI模式添加Windows服务器

http://prod-server6:8080/AppManager/xml/AddMonitor?apikey=5bc6a8e9a30d5bf894586d4db90282f5&type=servers&displayname=apmwindows&host=app-xp5&os=Windows XP&mode=WMI&username=administrator&password=pass&timeout=300&kerberos_status=true

Windows Clusters

语法:

http://[Host]:[Port]/AppManager/xml/AddMonitor?apikey=[APIKEY]&type=[TYPE]&displayname=[DISPLAYNAME]&host=[HOST NAME]&Version=[VERSION NO]&username=[USERNAME]&password=[PASSWORD]&DiscoverNodes=[NO OF NODES]&EventLog=[YES/NO]&pollinterval=[INTERVAL]

请求参数:

API请求中涉及的参数如下所述。另外,请参阅常见的请求参数列表

字段描述
type 您要添加的监视器的类别类型。值应为 Windows集群
host Windows服务器集群运行所在的主机的名称。
Version Windows Server集群的版本。可能的值为:
  • 2008(默认)
  • 2008 R2
DiscoverNodes 指定是否需要发现节点。可能的值为:
  • 0-否(默认)
  • 1-是
EventLog 指定是否需要显示事件日志。可能的值为:
  • 否(默认)
pollInterval 服务器需要轮询的时间间隔。此变量是可选的。如果未提及任何值,将采用默认值5分钟。
forceadd 此参数用于强制Applications Manager绕过可用性和其他与身份验证相关的检查,并添加监视器。可能的值为:
  • True-强制添加监视器
  • False-不强制添加监视器。
addgivenname 指定是否要将监视器的主机名设置为在API中配置的主机名/ IP地址。
passphrase 如果专用密钥受SSH身份验证保护,请指定一个密码短语。

示例请求:

https://prod-server6:8080/AppManager/xml/AddMonitor?apikey=5bc6a8e9a30d5bf894586d4db90282f5&type=Windows Cluster&displayname=clusterApi&host=apmcluster&Version=2008 R2&username=apmcluster2012\administrator&password=12345&DiscoverNodes=1&EventLog=No&pollinterval=5