Web-Services

Neue Operationen

Diese neuen Operationen sind im Modul Webservices in der Gruppe Prozess & Automation verfügbar:

• ConfigItem::ConfigItemCreate

• ConfigItem::ConfigItemDelete

• ConfigItem::ConfigItemGet

• ConfigItem::ConfigItemSearch

• ConfigItem::ConfigItemUpdate

So nutzen Sie diese Operationen:

1. Einen Webservice hinzufügen oder bearbeiten.

2. Wählen Sie im Widget OTRS als Provider einen Netzwerktransport und speichern Sie den Webservice.

3. Die neuen Operationen sind im Feld Operation hinzufügen im Widget OTRS als Provider verfügbar.

Anwendungsbeispiele

Die folgenden Beispiele geben einen kurzen Einblick in die Verwendung der API für grundlegende Aktionen.

1. Configuration Item erstellen

   • URL: /api/agent/config-item/create

   • Methode: POST

   • Payload:

     {
         "ConfigItem": {
             "Class": "Computer",
             "Name": "test name for new config item",
             "DeplState": "Production",
             "InciState": "Operational",
             "CIXMLData": {
                 "Seriennummer": "SNR1"
                 "NIC": {
                      "NIC": "test",
                      "IPoverDHCP": "Yes"
                 }
             }
         }
     }
     

2. Configuration Item aktualisieren

   • URL: /api/agent/config-item/4/update, wobei 4 die ID des zu aktualisierenden Configuration Items ist

   • Methode: POST

   • Payload:

     {
         "ConfigItemID": "4",
         "ConfigItem": {
             "Class": "Computer",
             "Name": "test name for new config item",
             "DeplState": "Production",
             "InciState": "Operational",
             "CIXMLData": {
                 "Seriennummer": "SNR2"
                 "NIC": {
                      "NIC": "test",
                      "IPoverDHCP": "Yes"
                 }
             }
         }
     }
     

   Bemerkung

   The Class is required to be transmitted but will not affect the configuration item when updating. If you update a configuration item in the class Location and transmit the class Computer the configuration item will stay in the class Location.

3. Configuration Item abrufen

   • URL: /api/agent/config-item/4, wobei 4 die ID des abzurufenden Configuration Items ist

   • Methode: GET

4. Configuration Items auflisten

   • URL: /api/agent/config-item/list

   • Methode: POST