NBAPI を使用したデバイス管理
Prime Performance Manager North Bound API(NBAPI)ではデバイスの追加や更新、削除、およびデバイス レポートの状態の設定などのいくつかのデバイス管理機能を実行することができます。
URL: https:// ppm_gateway :4440/nbapi/admin
(注) Prime Performance Manager が Cisco Prime キャリア管理スイートに統合されている場合、インターフェイスは https://ppm_gateway:4440/nbapi/event です。
(注) ユーザ アクセスが有効な場合、SOAP 要求は、HTTP Basic Authorization ヘッダーを介して Prime Performance Manager ユーザ名とパスワードを入力する必要があります。ユーザには要求された SOAP アクションを実行するために必要な権限がある必要があります。
プロジェクトの wsdl:
/opt/CSCOppm-gw/tomcat/webapps/nbapi/WEB-INF/wsdl/AdminAPI.wsdl
API 方式:
• addDevice:デバイスを追加します。「addDevice の例」の例を参考にしてください。
• updateDevice:デバイスを更新します。「updateDevice の例」の例を参考にしてください。
• deleteDevice:デバイスを削除します。「deleteDevice の例」の例を参考にしてください。
• setReportStatus:デバイスのレポートの状態を設定します。「setReportStatus の例」の例を参考にしてください。
addDevice の例
NBAPI の addDevice 方式の例を次に示します。
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ppm="http://cisco.com/ppm">
<isSendingAlarms></isSendingAlarms>
<reportPolicy></reportPolicy>
<pollingGroup></pollingGroup>
<snmpVersion></snmpVersion>
<snmpReadCommunity></snmpReadCommunity>
<snmpAuthProtocol></snmpAuthProtocol>
<snmpAuthPwd></snmpAuthPwd>
<snmpPrivProtocol></snmpPrivProtocol>
<snmpPrivPwd></snmpPrivPwd>
<snmpUserName></snmpUserName>
<loginProtocol></loginProtocol>
<loginPortNumber></loginPortNumber>
<loginUserName></loginUserName>
<loginPassword></loginPassword>
<loginEnableUserName></loginEnableUserName>
<loginEnablePassword></loginEnablePassword>
<loginSubsystem></loginSubsystem>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ppm="http://cisco.com/ppm">
<ipaddress>10.81.82.99</ipaddress>
<snmpReadCommunity>public</snmpReadCommunity>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ppm="http://cisco.com/ppm">
<ipaddress>10.81.82.98</ipaddress>
<name>somethingunique</name>
<location>righthere</location>
<isManaged>false</isManaged>
<isSendingAlarms>false</isSendingAlarms>
<reportPolicy>report-policy-1</reportPolicy>
<pollingGroup>polling-group-1</pollingGroup>
<snmpVersion>3</snmpVersion>
<snmpReadCommunity>ro-string</snmpReadCommunity>
<snmpAuthProtocol>md5</snmpAuthProtocol>
<snmpAuthPwd>authpassword</snmpAuthPwd>
<snmpPrivProtocol>3des</snmpPrivProtocol>
<snmpPrivPwd>privpassword</snmpPrivPwd>
<snmpUserName>snmpusername</snmpUserName>
<loginProtocol>SSH_V2</loginProtocol>
<loginPortNumber>99</loginPortNumber>
<loginUserName>login-username</loginUserName>
<loginPassword>login-password</loginPassword>
<loginEnableUserName>login-enable-username</loginEnableUserName>
<loginEnablePassword>login-enable-password</loginEnablePassword>
<loginSubsystem>login-subsystem</loginSubsystem>
updateDevice の例
NBAPI の updateDevice 方式の例を次に示します。
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ppm="http://cisco.com/ppm">
<isSendingAlarms></isSendingAlarms>
<reportPolicy></reportPolicy>
<pollingGroup></pollingGroup>
<snmpVersion></snmpVersion>
<snmpReadCommunity></snmpReadCommunity>
<snmpAuthProtocol></snmpAuthProtocol>
<snmpAuthPwd></snmpAuthPwd>
<snmpPrivProtocol></snmpPrivProtocol>
<snmpPrivPwd></snmpPrivPwd>
<snmpUserName></snmpUserName>
<loginProtocol></loginProtocol>
<loginPortNumber></loginPortNumber>
<loginUserName></loginUserName>
<loginPassword></loginPassword>
<loginEnableUserName></loginEnableUserName>
<loginEnablePassword></loginEnablePassword>
<loginSubsystem></loginSubsystem>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ppm="http://cisco.com/ppm">
<ipaddress>10.81.82.98</ipaddress>
<name>totallyunique</name>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ppm="http://cisco.com/ppm">
<ipaddress>10.81.82.98</ipaddress>
<snmpVersion>2c</snmpVersion>
<snmpReadCommunity>snmp-string</snmpReadCommunity>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ppm="http://cisco.com/ppm">
<ipaddress>10.81.82.98</ipaddress>
<loginProtocol>Telnet</loginProtocol>
<loginPortNumber>24</loginPortNumber>
<loginUserName>un1</loginUserName>
<loginPassword>pw1</loginPassword>
<loginEnableUserName>un2</loginEnableUserName>
<loginEnablePassword>pw2</loginEnablePassword>
<loginSubsystem>test</loginSubsystem>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ppm="http://cisco.com/ppm">
<ipaddress>10.81.82.98</ipaddress>
<loginUserName>username</loginUserName>
<loginPassword>password</loginPassword>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ppm="http://cisco.com/ppm">
<ipaddress>10.81.82.98</ipaddress>
<isManaged>true</isManaged>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ppm="http://cisco.com/ppm">
<ipaddress>10.81.82.98</ipaddress>
<loginPortNumber>30</loginPortNumber>
deleteDevice の例
deleteDevice 方式の例を次に示します。
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ppm="http://cisco.com/ppm">
<ipaddress>10.81.82.98</ipaddress>
setReportStatus の例
NBAPI の setReportStatus 方式の例を次に示します。
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ppm="http://cisco.com/ppm">
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ppm="http://cisco.com/ppm">
<category>Availability: ICMP Ping</category>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ppm="http://cisco.com/ppm">
<category>Availability: ICMP Ping</category>
<intervals>hourly daily</intervals>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ppm="http://cisco.com/ppm">
<category>Availability: ICMP Ping</category>
<device>ppm-ucs-vm20</device>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ppm="http://cisco.com/ppm">
<category>Availability: ICMP Ping</category>
<device>10.81.82.99</device>
<intervals>15min hourly monthly</intervals>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ppm="http://cisco.com/ppm">
<device>ppm-ucs-vm20</device>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ppm="http://cisco.com/ppm">