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

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

[comment]: # ({6f504964-0daa0d1b})
### Description

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

Cette méthode permet de créer de nouvelles macros d'hôtes.

[comment]: # ({/6f504964-0daa0d1b})

[comment]: # ({305520a5-7c7df9b5})
### PAramètres

`(object/array)` Macros d'hôtes à créer.

La méthode accepte les macros d’hôte avec les [propriétés de macro
d’hôte
standard](/fr/manual/api/reference/usermacro/object#macro_d_hote).

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

[comment]: # ({7119fbd0-bd0c3c49})
### Valeurs retournées

`(object)` Retourne un objet contenant les identifiants des macros
d'hôtes créées sous la propriété `hostmacroids`. L'ordre des ID
retournés correspond à l'ordre des macros d'hôtes transmises.

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

[comment]: # ({88e43968-b41637d2})
### Exemples

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

[comment]: # ({a1915678-c6bccbc9})
#### Créer une macro d'hôte

Créer une macro d'hôte "{$SNMP\_COMMUNITY}" avec pour valeur "public"
sur l'hôte "10198".

Requête :

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

Réponse :

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

[comment]: # ({/a1915678-c6bccbc9})

[comment]: # ({e294be67-bfbf7a63})
### Source

CUserMacro::create() dans
*frontends/php/include/classes/api/services/CUserMacro.php*.

[comment]: # ({/e294be67-bfbf7a63})