[comment]: # aside: 1

[comment]: # ({ee4a2645-28092341})
# Benutzer-Makro-Objekt

Die folgenden Objekte stehen in direktem Zusammenhang mit der `usermacro` API.

[comment]: # ({/ee4a2645-28092341})

[comment]: # ({2f5f2156-e654cd12})
### Globale Makro

Das globale Makro-Objekt hat die folgenden Eigenschaften.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|globalmacroid|ID|ID des globalen Makros.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* für Update-Operationen|
|macro|string|Makro-String.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* für Create-Operationen|
|value|string|Wert des Makros.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *write-only* wenn `type` auf "Secret macro" gesetzt ist<br>- *required* für Create-Operationen|
|type|integer|Typ des Makros.<br><br>Mögliche Werte:<br>0 - *(default)* Text-Makro;<br>1 - Secret macro;<br>2 - Vault secret.|
|description|string|Beschreibung des Makros.|

[comment]: # ({/2f5f2156-e654cd12})

[comment]: # ({c73e8f15-5a3a9f9f})
### Host-Makro

Das Host-Makro-Objekt definiert ein Makro, das auf einem Host, Host-Prototyp oder einer Vorlage verfügbar ist. Es hat die folgenden Eigenschaften.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|hostmacroid|ID|ID des Host-Makros.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* für Update-Operationen|
|hostid|ID|ID des Hosts, zu dem das Makro gehört.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *constant*<br>- *required* für Create-Operationen|
|macro|string|Makro-String.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* für Create-Operationen|
|value|string|Wert des Makros.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *write-only* wenn `type` auf "Secret macro" gesetzt ist<br>- *required* für Create-Operationen|
|type|integer|Typ des Makros.<br><br>Mögliche Werte:<br>0 - *(default)* Text-Makro;<br>1 - Secret macro;<br>2 - Vault secret.|
|description|string|Beschreibung des Makros.|
|automatic|integer|Legt fest, ob das Makro durch eine Erkennungsregel gesteuert wird.<br><br>Mögliche Werte:<br>0 - *(default)* Makro wird vom Benutzer verwaltet;<br>1 - Makro wird durch eine Erkennungsregel verwaltet.<br><br>Der Benutzer darf kein automatisches Makro erstellen.<br>Um ein automatisches Makro zu aktualisieren, muss es [in manuell umgewandelt werden](/manual/api/reference/usermacro/update#change-macro-value-that-was-created-by-discovery-rule).|

[comment]: # ({/c73e8f15-5a3a9f9f})