User macroオブジェクト

次のオブジェクトは、usermacroAPIに直接関連しています。

グローバルマクロ

グローバルマクロオブジェクトには、以下のプロパティがあります。

プロパティ 型 説明
globalmacroid ID グローバルマクロのID。

プロパティの動作:
- 読み取り専用
- 更新操作では必須
description string マクロの説明。
macro string マクロ文字列。

プロパティの動作:
- 作成操作では必須
type integer マクロのタイプ。

指定可能な値:
0 - (デフォルト) テキストマクロ;
1 - シークレットマクロ;
2 - Vaultシークレット。
value string マクロの値。

プロパティの動作:
- type が「シークレットマクロ」に設定されている場合は 書き込み専用
- 作成操作では必須

ホストマクロ

ホストマクロオブジェクトは、ホスト、ホストプロトタイプ、またはテンプレートで使用可能なマクロを定義します。以下のプロパティがあります。

Property Type Description
hostmacroid ID マクロのID。

Property behavior:
- 読み取り専用
- 更新操作で 必須
automatic integer マクロがディスカバリルールによって制御されるかどうかを定義します。

使用可能な値:
0 - (デフォルト) マクロはユーザーによって管理されます。
1 - マクロはディスカバリルールによって管理されます。

ユーザーは自動マクロを作成できません。
自動マクロを更新するには、手動に変換する必要があります。
config object/array ホストウィザードでマクロをどのように表示するかを制御する#macro-configurationマクロ設定。
description string マクロの説明。
hostid ID このマクロが属するホスト、ホストプロトタイプ、またはテンプレートのID。

Property behavior:
- 定数
- 作成操作で 必須
macro string マクロ文字列。

Property behavior:
- 作成操作で 必須
type integer マクロのタイプ。

使用可能な値:
0 - (デフォルト) テキストマクロ。
1 - シークレットマクロ。
2 - Vaultシークレット。
value string マクロの値。

Property behavior:
- type が "Secret macro" に設定されている場合は 書き込み専用
- 作成操作で 必須

マクロ設定

マクロ設定オブジェクトは、ホストウィザードでマクロがどのように表示されるかを定義します。

プロパティ 型 説明
type integer マクロ入力フィールドのタイプ。

使用可能な値:
0 - マクロはホストウィザードで使用されない;
1 - テキストボックス;
2 - リスト;
3 - チェックボックス。

プロパティの動作:
- 必須
label string マクロ入力フィールドのラベル。

プロパティの動作:
- type が "Textbox"、"List"、または "Checkbox" に設定されている場合は 必須
description text マクロ入力フィールドの横に表示されるヘルプテキスト。Markdown形式をサポートします。
priority integer マクロリスト内でのマクロ入力フィールドの位置。

priority が設定されていない場合、マクロはグループ化されていないマクロリストの末尾に追加されます。
required integer マクロを必須としてマークします。

使用可能な値:
0 - 必須ではない;
1 - 必須。

プロパティの動作:
- type が "Textbox" または "List" に設定されている場合に サポート
regex string テキストボックスフィールド内のユーザー入力を検証するための正規表現。

プロパティの動作:
- type が "Textbox" に設定されている場合に サポート
section_name string マクロがグループ化される折りたたみ可能なセクションのラベル。

section_name が設定されていない場合、マクロはグループ化されません。グループ化されていないマクロが最初に表示され、グループ化されたマクロはその下に、各折りたたみ可能セクション内で priority 順に表示されます。
options text リスト項目またはチェックボックスの値を定義するJSON文字列。

リストの場合: value および text プロパティを持つオブジェクトの配列。
例: [{"value": "http", "text": "HTTP"}, {"value": "https", "text": "HTTPS"}]

チェックボックスの場合: checked および unchecked プロパティを持つオブジェクト。
例: {"checked": true, "unchecked": false}

プロパティの動作:
- type が "List" または "Checkbox" に設定されている場合は 必須