hostgroup.delete

Beschreibung

object hostgroup.delete(array hostGroupIds)

Diese Methode ermöglicht das Löschen von Host-Gruppen.

Eine Host-Gruppe 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 Host-Prototyp 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 Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle entzogen 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.