Documentation
Table of Contents
host.create
Beschrijving
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.
Parameters
(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. |
Retourwaarden
(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.
Voorbeelden
Een gastheer creëren
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:
Een gastheer creëren met SNMP-interface
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:
Een host creëren met PSK-versleuteling
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:
Creating a host monitored by a proxy
Create a host that will be monitored by proxy with ID "1".
{
"jsonrpc": "2.0",
"method": "host.create",
"params": {
"host": "Host monitored by proxy",
"groups": [
{
"groupid": "2"
}
],
"monitored_by": 1,
"proxyid": 1
},
"id": 1
}Response:
Creating a host monitored by a proxy group
Create a host that will be monitored by proxy group with ID "1".
{
"jsonrpc": "2.0",
"method": "host.create",
"params": {
"host": "Host monitored by proxy group",
"groups": [
{
"groupid": "2"
}
],
"monitored_by": 2,
"proxy_groupid": 1
},
"id": 1
}Response:
Zie ook
Bron
CHost::create() in ui/include/classes/api/services/CHost.php.