hostgroup.delete

Beschreibung

object hostgroup.delete(array hostGroupIds)

Mit dieser Methode können Hostgruppen gelöscht werden.

Eine Hostgruppe kann nicht gelöscht werden, wenn:

  • sie Hosts enthält, die ausschließlich dieser Gruppe angehören;
  • sie als intern gekennzeichnet 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 Berechtigung zum Aufrufen der Methode kann 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.