Lifecycle Management-APIs
CI Lifecycle Management bietet eine Reihe von Statusverwaltungs-APIs zum Bearbeiten von CI-Betriebsstatus und zum Anwenden von CI-Aktionen.
Statusverwaltungs-APIs halten sich an Einschränkungen und Berechtigungen, die durch nicht zulässige CI-Aktionen, kompatible CI-Aktionen und nicht zulässige Betriebsübergänge angegeben werden. Wenn eine API versucht, eine eingeschränkte Operation auszuführen, wird die Operation blockiert, ein Fehler wird protokolliert, und eine Aufgabe wird ggf. automatisch erstellt.
Lifecycle Management-APIs können Betriebsstatus und CI-Aktionen für CMDB-Gruppen festlegen, indem sie Lifecycle Management-Massen-APIs verwenden.
Registrierungs-APIs
- registerOperator() - Methode zum Registrieren von Operatoren bei der Statusverwaltung für Nicht-Workflow-Benutzer.
- unregisterOperator(Zeichenfolge requestorId) - Methode zum Aufheben der Registrierung von Operatoren für Nicht-Workflow-Benutzer.
- isValidRequestor(Zeichenfolge requestorId) - Methode, um festzustellen, ob der angegebene Anforderer ein gültiger aktiver Workflow-Benutzer oder ein registrierter Benutzer ist.
- isLeaseExpired(Zeichenfolge requestorId, String ciSysId, String ciActionName) - Methode, um zu prüfen, ob die registrierte Benutzer-Miete abgelaufen ist.
- extendCIActionLease(Zeichenfolge requestorId, ciSysId, ciActionName, leaseTime) - Methode zur Verlängerung der CI-Aktion-Mietdauer für registrierte Benutzer. Wenn der vorherige Mietvertrag bereits abgelaufen ist, verlängern Sie ihn jetzt.
Betriebsstatus-APIs
- setBulkCIOperationalState(Zeichenfolge requestorId, sysIdList, opsLabel, opsStateListOld) - Methode zum Festlegen des Betriebsstatus für ein Array von CIs.
- getOperationalState(Zeichenfolge ciSysId) - Methode zum Abrufen des CI-Betriebsstatus.
CI-Aktionen-APIs
- addBulkCIAction(Zeichenfolge requestorId, sysIdList, ciActionName, ciActionListOld, leaseTime) - Methode zum Hinzufügen einer CI-Aktion für ein Array von CIs.
- removeBulkCIAction(Zeichenfolge requestorId, sysIdList, ciActionName) - Methode zum Entfernen einer CI-Aktion für eine Liste von CIs.
- getCIActions (Zeichenfolge ciSysId) - Methode zum Abrufen von CI-Aktionen.
Nicht zulässige Aktion basierend auf der Betriebsstatus-API
isNotAllowedAction(Zeichenfolge ciType, opsLabel, actionName) - Methode, um zu prüfen, ob eine bestimmte CI-Aktion für einen bestimmten Betriebsstatus eines CI-Typs nicht zulässig ist.
API für nicht zulässige Betriebsstatusübergänge
isNotAllowedOpsTransition(Zeichenfolge ciType, opsLabel, transitionOpsLabel) - Methode, die überprüft, ob ein bestimmter Betriebsstatusübergang für einen CI-Typ nicht zulässig ist.
API für kompatible Aktionen
isCompatibleCIAction(Zeichenfolge actionName, otherActionName) - Methode zur Überprüfung, ob zwei bestimmte Aktionen miteinander kompatibel sind.
Statusverwaltungs-APIs verwenden
// 1. Register Operator with State Mgmt
var output = SNC.StateManagementScriptableApi.registerOperator();
var jsonUntil = new JSON();
var result = jsonUntil.decode(output);
var requestorId = result.requestorId;
// Get list of sys_ids to update
var sys_ids;
// 2. Set list of sys_ids's Operational State to 'Repair in Progress'
output = SNC.StateManagementScriptableApi.setBulkCIOperationalState(requestorId, sys_ids,'Repair in Progress');
gs.print(output);
// 3. Set list of sys_ids's CI Action State to 'Patching'
output = SNC.StateManagementScriptableApi.addBulkCIAction(requestorId, sys_ids, 'Patching');
gs.print(output);