[comment]: # translation:outdated

[comment]: # ({83b3ff24-83b3ff24})
# usermacro.create

[comment]: # ({/83b3ff24-83b3ff24})

[comment]: # ({51763cd1-db3d5c68})
### Beschrijving

`object usermacro.create(object/array hostMacros)`

Met deze methode kunnen nieuwe hostmacro's worden gemaakt.

::: noteclassic
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](/manual/web_interface/frontend_sections/users/user_roles)
voor meer informatie.
:::

[comment]: # ({/51763cd1-db3d5c68})

[comment]: # ({7c7df9b5-7c7df9b5})
### Parameters

`(object/array)` Hostmacro's om te maken.

De methode accepteert hostmacro's met de [standaard hostmacro
eigenschappen](object#host_macro).

[comment]: # ({/7c7df9b5-7c7df9b5})

[comment]: # ({bd0c3c49-bd0c3c49})
### Retourwaarden

`(object)` Retourneert een object dat de ID's van de gemaakte host bevat
macro's onder de eigenschap 'hostmacroids'. De volgorde van de geretourneerde ID's
komt overeen met de volgorde van de doorgegeven hostmacro's.

[comment]: # ({/bd0c3c49-bd0c3c49})

[comment]: # ({b41637d2-b41637d2})
### Voorbeelden

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({b1d03639-7c0da88a})
#### Het aanmaken van een hostmacro

Maak een hostmacro "{$SNMP_COMMUNITY}" aan met de waarde "public" op host "10198".

[Request](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "usermacro.create",
    "params": {
        "hostid": "10198",
        "macro": "{$SNMP_COMMUNITY}",
        "value": "public"
    },
    "id": 1
}
```

Respons:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "hostmacroids": [
            "11"
        ]
    },
    "id": 1
}
```

[comment]: # ({/b1d03639-7c0da88a})

[comment]: # ({084b8f3c-084b8f3c})
### Bron

CUserMacro::create() in
*ui/include/classes/api/services/CUserMacro.php*.

[comment]: # ({/084b8f3c-084b8f3c})