hostgroup.delete

Beschrijving

object hostgroup.delete(array hostGroupIds)

Met deze methode kunnen host groepen worden verwijderd.

Een host groep kan niet worden verwijderd als deze:

  • hosts bevat die alleen tot deze groep behoren;
  • is gemarkeerd als intern;
  • wordt gebruikt door een host-prototype;
  • wordt gebruikt in een globaal script;
  • wordt gebruikt in een correlatieconditie.

Deze methode is alleen beschikbaar voor Admin en Super admin gebruikers typen. Machtigingen om de methode aan te roepen kunnen worden ingetrokken in de gebruikersrol instellingen. Zie Gebruiker rollen voor meer informatie.

Parameters

(array) ID's van de te verwijderen hostgroepen.

Retourwaarden

(object) Retourneert een object dat de ID's van de verwijderde host groepen bevat onder de eigenschap groupids.

Voorbeelden

Meerdere host groepen verwijderen

Verwijder twee host groepen.

Verzoek:

{
           "jsonrpc": "2.0",
           "method": "hostgroup.delete",
           "parameters": [
               "107824",
               "107825"
           ],
           "auth": "3a57200802b24cda67c4e4010b50c065",
           "id": 1
       }

Antwoord:

{
           "jsonrpc": "2.0",
           "resultaat": {
               "groepsleden": [
                   "107824",
                   "107825"
               ]
           },
           "id": 1
       }

Bron

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