Table of Contents
Host interfaceオブジェクト
次のオブジェクトは、hostinterfaceAPIに直接関連しています。
ホストインターフェース
ホストインターフェースオブジェクトには以下のプロパティがあります。
ipとdnsの両方のプロパティは、作成操作時に必須であることに注意してください。 DNSを使用しない場合は、空文字列に設定してください。
| プロパティ | 型 | 説明 |
|---|---|---|
| interfaceid | ID | インターフェースのID。 プロパティの動作: - 読み取り専用 - 更新操作時に必須 |
| available | integer | ホストインターフェースの可用性。 可能な値： 0 - (デフォルト) 不明; 1 - 利用可能; 2 - 利用不可。 プロパティの動作: - 読み取り専用 |
| hostid | ID | インターフェースが属するホストのID。 プロパティの動作: - 定数 - 作成操作時に必須 |
| type | integer | インターフェースのタイプ。 可能な値： 1 - エージェント; 2 - SNMP; 3 - IPMI; 4 - JMX。 プロパティの動作: - 作成操作時に必須 |
| ip | string | インターフェースで使用されるIPアドレス。 DNS経由で接続する場合は空でも可。 プロパティの動作: - 作成操作時に必須 |
| dns | string | インターフェースで使用されるDNS名。 IP経由で接続する場合は空でも可。 プロパティの動作: - 作成操作時に必須 |
| port | string | インターフェースで使用されるポート番号。ユーザーマクロを含めることができます。 プロパティの動作: - 作成操作時に必須 |
| useip | integer | IP経由で接続するかどうか。 可能な値： 0 - ホストのDNS名で接続; 1 - ホストのIPアドレスで接続。 プロパティの動作: - 作成操作時に必須 |
| main | integer | インターフェースがホストのデフォルトとして使用されるかどうか。同じタイプのインターフェースはホストごとに1つだけデフォルトに設定できます。 可能な値： 0 - デフォルトでない; 1 - デフォルト。 プロパティの動作: - 作成操作時に必須 |
| details | object | インターフェースの追加詳細オブジェクト。 プロパティの動作: - typeが"SNMP"に設定されている場合は必須 |
| disable_until | timestamp | 利用不可のホストインターフェースの次回ポーリング時刻。 プロパティの動作: - 読み取り専用 |
| error | string | ホストインターフェースが利用不可の場合のエラーテキスト。 プロパティの動作: - 読み取り専用 |
| errors_from | timestamp | ホストインターフェースが利用不可になった時刻。 プロパティの動作: - 読み取り専用 |
詳細
detailsオブジェクトには以下のプロパティがあります。
| プロパティ | タイプ | 説明 |
|---|---|---|
| version | integer | SNMPインターフェースのバージョン。 可能な値: 1 - SNMPv1; 2 - SNMPv2c; 3 - SNMPv3。 プロパティの動作: - 必須 |
| bulk | integer | バルクSNMPリクエストを使用するかどうか。 可能な値: 0 - バルクリクエストを使用しない; 1 - (デフォルト) - バルクリクエストを使用する。 |
| community | string | SNMPコミュニティ。SNMPv1およびSNMPv2インターフェースでのみ使用されます。 プロパティの動作: - versionが"SNMPv1"または"SNMPv2c"に設定されている場合は必須 |
| max_repetitions | integer | ネイティブSNMPバルクリクエスト（GetBulkRequest-PDUs）の最大繰り返し値。 SNMPv2およびv3の discovery[]およびwalk[]アイテムでのみ使用されます。デフォルト: 10。 |
| 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インターフェースでのみ使用されます。 |