Lebenszyklusmanagement-APIs

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 1 Minute Lesedauer

    • CI-Lebenszyklusmanagement bietet eine Reihe von Statusmanagement-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 sind. Wenn eine API versucht, einen eingeschränkten Vorgang auszuführen, wird der Vorgang blockiert, ein Fehler wird protokolliert, und gegebenenfalls wird automatisch eine Aufgabe erstellt.

    Lebenszyklusmanagement-APIs können betriebsstatus und CI-Aktionen für CMDB-Gruppen festlegen, indem sie Massen-APIs für Lebenszyklusmanagement verwenden.

    Registrierungs-APIs

    • RegisterOperator(): Methode zum Registrieren des Operators bei der Statusverwaltung für nicht-Workflow-Anwender.
    • UnregisterOperator(String requestorId): Methode zum Aufheben der Registrierung des Operators für nicht-Workflow-Anwender.
    • IsValidRequestor(String requestorId): Methode, um zu bestimmen, ob die angegebene anfordernde Person ein gültiger aktiver Workflow-Anwender oder ein registrierter Anwender ist.
    • IsLeaseExpired (Zeichenfolge requestorId, Zeichenfolge ciSysId, Zeichenfolge ciActionName): Methode, um zu überprüfen, ob der Mietvertrag des registrierten Anwenders abgelaufen ist.
    • ExtendCIActionLease(Zeichenfolge requestorId, Zeichenfolge ciSysId, Zeichenfolge ciActionName, Zeichenfolge leaseTime): Methode zum verlängern der Leasingzeit der CI-Aktion für registrierte Anwender. Wenn der vorherige Mietvertrag bereits abgelaufen ist, verlängern Sie den Mietvertrag ab jetzt.

    Betriebsstatus-APIs

    • SetBulkCIOperationalState(Zeichenfolge requestorId, Zeichenfolge sysIdList, Zeichenfolge opsLabel, Zeichenfolge 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, Zeichenfolge sysIdList, Zeichenfolge ciActionName, Zeichenfolge ciActionListOld, Zeichenfolge leaseTime): Methode zum Hinzufügen einer CI-Aktion für ein Array von CIs.
    • RemoveBulkCIAction (Zeichenfolge requestorId, Zeichenfolge sysIdList, Zeichenfolge 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, Zeichenfolge opsLabel, Zeichenfolge actionName): Methode zum Überprüfen, ob eine bestimmte CI-Aktion für einen bestimmten Betriebsstatus für einen CI-Typ nicht zulässig ist.

    Unzulässige API für den Übergang des Betriebsstatus

    IsNotAllowedOpsTransition (Zeichenfolge ciType, Zeichenfolge opsLabel, Zeichenfolge transitionOpsLabel): Methode zum Überprüfen, ob der Übergang eines bestimmten Betriebsstatus für einen CI-Typ nicht zulässig ist.

    Kompatible Aktions-API

    IsCompatibleCIAction (String actionName, String otherActionName): Methode zum Überprüfen, ob zwei bestimmte Aktionen miteinander kompatibel sind.

    Statusmanagement-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);