object host.create(object/array hosts)
Deze methode maakt het mogelijk om nieuwe hosts te maken.
Deze methode is alleen beschikbaar voor gebruikerstypes Admin en Superadmin. Rechten om de methode aan te roepen kunnen worden ingetrokken in de instellingen van gebruikersrollen. Zie Gebruikersrollen voor meer informatie.
(object/array)
Gastheren om te creëren.
Naast de standaard gastheereigenschappen, accepteert de methode de volgende parameters.
Parameter | Type | Beschrijving |
---|---|---|
groups | object/array | Gastheer groepen om de gastheer aan toe te voegen. De gastheergroepen moeten de eigenschap groupid gedefinieerd hebben.Gedrag van parameters: - vereist |
interfaces | object/array | Te creëren interfaces voor de gastheer. |
tags | object/array | Gastheer tags. |
templates | object/array | Aan de gastheer te koppelen sjablonen. De sjablonen moeten de eigenschap templateid gedefinieerd hebben. |
macros | object/array | Te creëren gebruikersmacro's voor de gastheer. |
inventory | object | Eigenschappen van gastheer inventaris. |
(object)
Retourneert een object dat de ID's van de gemaakte hosts bevat onder de eigenschap hostids
. De volgorde van de geretourneerde ID's komt overeen met de volgorde van de doorgegeven gastheren.
Maak een gastheer genaamd "Linux server" met een IP-interface en tags, voeg deze toe aan een groep, koppel een sjabloon eraan en stel de MAC-adressen in de gastheer-inventaris in.
{
"jsonrpc": "2.0",
"method": "host.create",
"params": {
"host": "Linux server",
"interfaces": [
{
"type": 1,
"main": 1,
"useip": 1,
"ip": "192.168.3.1",
"dns": "",
"port": "10050"
}
],
"groups": [
{
"groupid": "50"
}
],
"tags": [
{
"tag": "Host name",
"value": "Linux server"
}
],
"templates": [
{
"templateid": "20045"
}
],
"macros": [
{
"macro": "{$USER_ID}",
"value": "123321"
},
{
"macro": "{$USER_LOCATION}",
"value": "0:0:0",
"description": "latitude, longitude and altitude coordinates"
}
],
"inventory_mode": 0,
"inventory": {
"macaddress_a": "01234",
"macaddress_b": "56768"
}
},
"id": 1
}
Antwoord:
Maak een gastheer genaamd "SNMP host" met een SNMPv3-interface met details.
{
"jsonrpc": "2.0",
"method": "host.create",
"params": {
"host": "SNMP host",
"interfaces": [
{
"type": 2,
"main": 1,
"useip": 1,
"ip": "127.0.0.1",
"dns": "",
"port": "161",
"details": {
"version": 3,
"bulk": 0,
"securityname": "mysecurityname",
"contextname": "",
"securitylevel": 1
}
}
],
"groups": [
{
"groupid": "4"
}
]
},
"id": 1
}
Antwoord:
Maak een host genaamd "PSK host" met geconfigureerde PSK-versleuteling. Let op dat de host vooraf geconfigureerd moet zijn om PSK te gebruiken.
{
"jsonrpc": "2.0",
"method": "host.create",
"params": {
"host": "PSK host",
"interfaces": [
{
"type": 1,
"ip": "192.168.3.1",
"dns": "",
"port": "10050",
"useip": 1,
"main": 1
}
],
"groups": [
{
"groupid": "2"
}
],
"tls_accept": 2,
"tls_connect": 2,
"tls_psk_identity": "PSK 001",
"tls_psk": "1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952"
},
"id": 1
}
Antwoord:
CHost::create() in ui/include/classes/api/services/CHost.php.