hostgroup.delete

Beschreibung

object hostgroup.delete(array hostGroupIds)

Diese Methode ermöglicht das Löschen von Hostgruppen.

Eine Hostgruppe kann nicht gelöscht werden, wenn:

  • sie Hosts enthält, die nur zu dieser Gruppe gehören;
  • sie als intern markiert ist;
  • sie von einem Hostprototyp verwendet wird;
  • sie in einem globalen Skript verwendet wird;
  • sie in einer Korrelationsbedingung verwendet wird.

Diese Methode ist nur für die Benutzertypen Admin und Super admin verfügbar. Die Berechtigung zum Aufruf der Methode kann in den Benutzerrolleneinstellungen widerrufen werden. Weitere Informationen finden Sie unter Benutzerrollen.

Parameter

(array) IDs der zu löschenden Hostgruppen.

Rückgabewerte

(object) Gibt ein Objekt zurück, das die IDs der gelöschten Host-Gruppen unter der Eigenschaft groupids enthält.

Beispiele

Mehrere Host-Gruppen löschen

Löschen Sie zwei Host-Gruppen.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "hostgroup.delete",
    "params": [
        "107824",
        "107825"
    ],
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": {
        "groupids": [
            "107824",
            "107825"
        ]
    },
    "id": 1
}

Quelle

CHostGroup::delete() in ui/include/classes/api/services/CHostGroup.php.