[comment]: # aside:1

[comment]: # ({ee4a2645-28092341})
# Obiekt makra użytkownika

Następujące obiekty są bezpośrednio powiązane z API `usermacro`.

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

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

Obiekt globalnego macro ma następujące właściwości.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|globalmacroid|ID|ID globalnego macro.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *tylko do odczytu*<br>- *wymagane* dla operacji aktualizacji|
|macro|string|Łańcuch macro.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* dla operacji tworzenia|
|value|string|Wartość macro.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *tylko do zapisu* jeśli `type` jest ustawione na "Secret macro"<br>- *wymagane* dla operacji tworzenia|
|type|integer|Typ macro.<br><br>Możliwe wartości:<br>0 - *(domyślnie)* Text macro;<br>1 - Secret macro;<br>2 - Vault secret.|
|description|string|Opis macro.|

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

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

Obiekt makra hosta definiuje makro dostępne na hoście, prototypie hosta lub szablonie. Ma następujące właściwości.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|hostmacroid|ID|ID makra hosta.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *tylko do odczytu*<br>- *wymagane* dla operacji aktualizacji|
|hostid|ID|ID hosta, do którego należy makro.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *stała*<br>- *wymagane* dla operacji tworzenia|
|macro|string|Łańcuch makra.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* dla operacji tworzenia|
|value|string|Wartość makra.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *tylko do zapisu* jeśli `type` jest ustawione na "Secret macro"<br>- *wymagane* dla operacji tworzenia|
|type|integer|Typ makra.<br><br>Możliwe wartości:<br>0 - *(domyślnie)* Makro tekstowe;<br>1 - Secret macro;<br>2 - Sekret z vault.|
|description|string|Opis makra.|
|automatic|integer|Określa, czy makro jest kontrolowane przez regułę wykrywania.<br><br>Możliwe wartości:<br>0 - *(domyślnie)* Makro jest zarządzane przez użytkownika;<br>1 - Makro jest zarządzane przez regułę wykrywania.<br><br>Użytkownik nie może utworzyć automatycznego makra.<br>Aby zaktualizować automatyczne makro, musi ono zostać [przekonwertowane na ręczne](/manual/api/reference/usermacro/update#change-macro-value-that-was-created-by-discovery-rule).|

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