Esta página foi traduzida automaticamente. Se você notar um erro, selecione-o e pressione Ctrl+Enter para reportá-lo aos editores.

Objeto de macro de usuário

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

Macro global

O objeto macro global possui as seguintes propriedades.

Propriedade Tipo Descrição
globalmacroid ID ID da macro global.

Comportamento da propriedade:
- somente leitura
- obrigatório para operações de atualização
macro string String da macro.

Comportamento da propriedade:
- obrigatório para operações de criação
value string Valor da macro.

Comportamento da propriedade:
- somente escrita se type estiver definido como "Macro secreta"
- obrigatório para operações de criação
type integer Tipo de macro.

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

Macro de host

O objeto macro de host define uma macro disponível em um host, protótipo de host ou template. Possui as seguintes propriedades.

Propriedade Tipo Descrição
hostmacroid ID ID da macro de host.

Comportamento da propriedade:
- somente leitura
- obrigatório para operações de atualização
hostid ID ID do host ao qual a macro pertence.

Comportamento da propriedade:
- constante
- obrigatório para operações de criação
macro string String da macro.

Comportamento da propriedade:
- obrigatório para operações de criação
value string Valor da macro.

Comportamento da propriedade:
- somente gravação se type estiver definido como "Macro secreta"
- obrigatório para operações de criação
type integer Tipo de macro.

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

Valores possíveis:
0 - (padrão) Macro é gerenciada pelo usuário;
1 - Macro é gerenciada por 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.