Eine Übersicht über die Management API. Die API stellt Managementfunktionen für Clouds und für Integrationseinheiten (Integration Appliances) bereit.
Die Management API wird als Web-Service implementiert. Über diesen Web-Service erhalten Sie die Möglichkeit, Projekte mit WebSphere DataPower Cast Iron Appliances (Integrationseinheiten bzw. Integrationseinheiten) und WebSphere Cast Iron Cloud (Cloud) über Ihre Anwendungen oder Scripts zu verwalten.
Die API ermöglicht die Verwaltung von Integrationseinheiten (Integration Appliances) und Clouds in den folgenden Bereichen:
Die Management API entspricht den folgenden Standards für Web-Services:
Sie können Clientanwendungen erstellen, die Web-Service-Operationen zum Verwalten und Überwachen von Projekten mit Integrationseinheiten (Integration Appliances) und Clouds aufrufen. Die Kommunikation zwischen der Clientanwendung und dem Integrationseinheits- oder Cloud-Projekt wird über HTTP oder HTTPS sichergestellt.
Die Management API wird in WSDL-Dateien definiert. Clientanwendungen rufen Web-Service-Operationen durch Senden von SOAP-Nachrichten auf. SOAP-Nachrichten werden in XML formatiert und sind somit programmiersprachenneutral.
Dieser Abschnitt enthält Beispiele für das Anmelden, das Abrufen eines Benutzers und das Abmelden anhand der Security-WSDL der Management API.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:sec="http://www.approuter.com/schemas/2008/1/security">
<soapenv:Header/>
<soapenv:Body>
<sec:login>
<sec:username>webuser@mycompany.com</sec:username>
<sec:password>D3nu9noB</sec:password>
</sec:login>
</soapenv:Body>
</soapenv:Envelope>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body>
<ns2:loginResponse xmlns:ns2="http://www.approuter.com/schemas/2008/1/
security" xmlns:ns3="http://www.approuter.com/schema/router/1000/security/03">
<ns2:sessionId>8F059BEEA3611033D277773A95404641</ns2:sessionId>
</ns2:loginResponse>
</S:Body>
</S:Envelope>
Die sessionId ist erforderlich, um nach der erfolgten Anmeldung bei einer Integrationseinheit (Integration Appliance) oder der Cloud weitere SOAP-Operationen ausführen zu können.<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:sec="http://www.approuter.com/schemas/2008/1/security">
<soapenv:Header>
<sec:sessionId>8F059BEEA3611033D277773A95404641</sec:sessionId>
</soapenv:Header>
<soapenv:Body>
<sec:getUser>
<sec:username>webuser</sec:username>
</sec:getUser>
</soapenv:Body>
</soapenv:Envelope>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body>
<ns2:getUserResponse xmlns:ns2="http://www.approuter.com/schemas/2008/1/
security" xmlns:ns3="http://www.approuter.com/schema/router/1000/security/03">
<ns2:user>
<ns3:id>8F059BEEA3611033D277773A95404641</ns3:id>
<ns3:name>webuser</ns3:name>
<ns3:encPasswd>{SHA}clO20r2ZJMJcDrNwXQzhWB8YcdI=</ns3:encPasswd>
<ns3:displayName>WebServiceUser</ns3:displayName>
<ns3:isActive>true</ns3:isActive>
<ns3:isMutable>true</ns3:isMutable>
<ns3:isVisible>true</ns3:isVisible>
<ns3:email>webuser@mycompany.com</ns3:email>
<ns3:createdTime>2010-03-02T22:11:32.935Z</ns3:createdTime>
<ns3:failedLoginCount>0</ns3:failedLoginCount>
<ns3:scopeId>B47EAECF6AD14AA028B4EA038CB742D0</ns3:scopeId>
<ns3:scopeType>Tenant</ns3:scopeType>
</ns2:user>
</ns2:getUserResponse>
</S:Body>
</S:Envelope>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:sec="http://www.approuter.com/schemas/2008/1/security">
<soapenv:Header>
<sec:sessionId>8F059BEEA3611033D277773A95404641</sec:sessionId>
</soapenv:Header>
<soapenv:Body>
<sec:logout/>
</soapenv:Body>
</soapenv:Envelope>
Bei den vorherigen Beispielen wurden SOAP-Operationen verwendet, deren Ausführung in einem Nutzer in der Cloud (Integration Appliance) oder einer Integrationseinheit erfolgte. Um Operationen in Umgebungen mit einem Nutzer in der Cloud ausführen zu können, definieren Sie anhand der Operation setCurrentScope als Geltungsbereich (Wirkungsbereich) diejenige Umgebung, in der Sie SOAP-Operationen ausführen wollen.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:sec="http://www.approuter.com/schemas/2008/1/security">
<soapenv:Header>
<sec:sessionId>63Y93HD6D856EB5812EB71216C3547W7</sec:sessionId>
</soapenv:Header>
<soapenv:Body>
<sec:setCurrentScope>
<sec:scopeName>Development</sec:scopeName>
</sec:setCurrentScope>
</soapenv:Body>
</soapenv:Envelope>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body>
<ns2:setCurrentScopeResponse xmlns:ns2="http://www.approuter.com/
schemas/2008/1/security" xmlns:ns3="http://www.approuter.com/schema/
router/1000/security/03">
<ns2:success>true</ns2:success>
</ns2:setCurrentScopeResponse>
</S:Body>
</S:Envelope>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:dep="http://www.approuter.com/schemas/2008/1/deployment">
<soapenv:Header>
<dep:sessionId>63Y93HD6D856EB5812EB71216C3547W7</dep:sessionId>
</soapenv:Header>
<soapenv:Body>
<dep:start>
<dep:projectName>HTTP_363i</dep:projectName>
<dep:version>1.0</dep:version>
<dep:configName>HTTP_363j</dep:configName>
</dep:start>
</soapenv:Body>
</soapenv:Envelope>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body>
<ns2:startResponse xmlns:ns2="http://www.approuter.com/schemas/2008/1/
deployment" xmlns:ns3="http://www.approuter.com/schemas/2008/1/deployment/
types" xmlns:ns4="http://www.approuter.com/schema/router/1000/security/03"
xmlns:ns5="http://www.approuter.com/schemas/2008/1/util/types">
<ns2:success>true</ns2:success>
</ns2:startResponse>
</S:Body>
</S:Envelope>