Documentation
Table of Contents
> Host prototypeオブジェクト
次のオブジェクトは、hostprototypeAPIに直接関連しています。
Host prototype
host prototype オブジェクトには、次のプロパティがあります。
| プロパティ | タイプ | 説明 |
|---|---|---|
| hostid | string | （読み取り専用）ホストプロトタイプのID。 |
| host (必須) |
string | ホストプロトタイプの名前 |
| name | string | ホストプロトタイプの表示名 デフォルト: hostプロパティ値 |
| status | integer | ホストプロトタイプのステータス 値は次のとおり 0 - （デフォルト）監視対象ホスト 1 - 監視対象外ホスト |
| inventory_mode | integer | ホストインベントリ作成モード 値は次のとおり -1 - （デフォルト）無効 0 - 手動 1 - 自動 |
| templateid | string | （読み取り専用）親テンプレートホストプロトタイプのID |
| discover | integer | ホストプロトタイプの検出ステータス 値: 0 - （デフォルト）新しいホストが検出されます 1 - 新しいホストは検出されず、既存のホストは失われたものとしてマークされます |
| custom_interfaces | integer | ホストプロトタイプによって作成されたホストのインターフェースのソース 値: 0 - （デフォルト）親ホストからインターフェースを継承 1 - ホストプロトタイプのカスタムインターフェースを使用 |
| uuid | string | インポートされたホストプロトタイプを既存のプロトタイプにリンクするために使用されるユニバーサル一意識別子。 テンプレートのホストプロトタイプにのみ使用されます。指定されていない場合は自動生成されます。 updateの場合、このフィールドは読み取り専用です。 |
Group link
group linkオブジェクトは、ホストプロトタイプをホストグループにリンクし、次のプロパティを持ちます。
| プロパティ | タイプ | 説明 |
|---|---|---|
| groupid (必須) |
string | ホストグループのID。 |
Group prototype
グループプロトタイプオブジェクトは、検出されたホスト用に作成されるグループを設定し、次のプロパティを持ちます。
| プロパティ | タイプ | 説明 |
|---|---|---|
| group_prototypeid | string | （読み取り専用）グループプロトタイプのID |
| name (必須) |
string | グループプロトタイプの名前 |
| hostid | string | （読み取り専用）ホストプロトタイプのID |
| templateid | string | （読み取り専用）親テンプレートグループのプロトタイプのID。 |
Host prototype tag
Host prototype tagオブジェクトには、次のプロパティがあります。
| プロパティ | タイプ | 説明 |
|---|---|---|
| tag (必須) |
string | ホストプロトタイプタグ名 |
| value | string | ホストプロトタイプタグ値 |
Custom interface
custom interface オブジェクトには、次のプロパティがあります。
| プロパティ | タイプ | 説明 |
|---|---|---|
| dns | string | インターフェースで使用されるDNS名 接続がDNS経由で行われる場合は必須。マクロを含めることができます。 |
| ip | string | インターフェースで使用されるIPアドレス 接続がIP経由で行われる場合は必須。マクロを含めることができます。 |
| main (必須) |
integer | インターフェイスがホストでデフォルトとして使用されているかどうか。 ホストでデフォルトとして設定できるインターフェースは1つだけです 値は次のとおり 0 - デフォルトではありません 1 - デフォルトです |
| port (必須) |
string | インターフェイスで使用されるポート番号。 ユーザーマクロとLLDマクロを含めることができます。 |
| type (必須) |
integer | インターフェイスタイプ 値は次のとおり 1 - エージェント 2 - SNMP 3 - IPMI 4 - JMX |
| useip (必須) |
integer | IP経由で接続するかどうか 値は次のとおり 0 - ホストDNS名を使用して接続 1 - ホストIPアドレスを使用して接続 |
| details | array | インターフェイスの追加オブジェクト。 インターフェイス'タイプ'がSNMPの場合は必須。 |
Custom interface details
Custom interface detailsオブジェクトには、次のプロパティがあります。
| プロパティ | タイプ | 説明 |
|---|---|---|
| version (必須) |
integer | SNMPインターフェースのバージョン。 値は次のとおりです。 1 - SNMPv1 2 - SNMPv2c 3 - SNMPv3 |
| bulk | integer | バルクSNMPリクエストを使用するかどうか。 値は次のとおりです。 0 - バルクリクエストを使用しない 1 -（デフォルト）- バルクリクエストを使用する |
| community | string | SNMPコミュニティ。 SNMPv1およびSNMPv2インターフェースでのみ使用されます。 |
| securityname | string | SNMPv3セキュリティ名。 SNMPv3インターフェースでのみ使用されます。 |
| securitylevel | integer | SNMPv3セキュリティレベル。 SNMPv3インターフェースでのみ使用されます。 値は次のとおりです。 0 -（デフォルト）- noAuthNoPriv 1 - authNoPriv 2 - authPriv |
| authpassphrase | string | SNMPv3認証パスフレーズ。 SNMPv3インターフェースでのみ使用されます。 |
| privpassphrase | string | SNMPv3プライバシーパスフレーズ。 SNMPv3インターフェースでのみ使用されます。 |
| authprotocol | integer | SNMPv3認証プロトコル。 SNMPv3インターフェースでのみ使用されます。 値は次のとおりです。 0 - （デフォルト）- MD5 1 - SHA1 2 - SHA224 3 - SHA256 4 - SHA384 5 - SHA512 |
| privprotocol | integer | SNMPv3プライバシープロトコル。 SNMPv3インターフェースでのみ使用されます。 値は次のとおりです。 0 -（デフォルト）- DES 1 - AES128 2 - AES192 3 - AES256 4 - AES192C 5 - AES256C |
| contextname | string | SNMPv3コンテキスト名。 SNMPv3インターフェースでのみ使用されます。 |