Objeto macro de usuário

Os seguintes objetos estão diretamente relacionados à API usermacro.

Macro global

O objeto de macro global possui as seguintes propriedades.

Property Type Description
globalmacroid ID ID da macro global.

Property behavior:
- read-only
- required for update operations
macro string String da macro.

Property behavior:
- required for create operations
value string Valor da macro.

Property behavior:
- write-only if type is set to "Secret macro"
- required for create operations
type integer Tipo da macro.

Valores possíveis:
0 - (default) Macro de texto;
1 - Macro secreta;
2 - Segredo do cofre.
description string Descrição da macro.

Macro de host

O objeto macro de host define uma macro disponível em um host, host prototype ou template. Ele possui as seguintes propriedades.

Property Type Description
hostmacroid ID ID da macro de host.

Property behavior:
- read-only
- required para operações de atualização
hostid ID ID do host ao qual a macro pertence.

Property behavior:
- constant
- required para operações de criação
macro string String da macro.

Property behavior:
- required para operações de criação
value string Valor da macro.

Property behavior:
- write-only se type estiver definido como "Secret macro"
- required para operações de criação
type integer Tipo de macro.

Valores possíveis:
0 - (default) Macro de texto;
1 - Macro secreta;
2 - Segredo do vault.
description string Descrição da macro.
automatic integer Define se a macro é controlada pela regra de descoberta.

Valores possíveis:
0 - (default) A macro é gerenciada pelo usuário;
1 - A macro é gerenciada pela regra de descoberta.

O usuário não tem permissão para criar macro automática.
Para atualizar uma macro automática, ela deve ser convertida para manual.