[comment]: # aside: 1

[comment]: # ({70b8d6b4-b7ea8d04})
# Hostオブジェクト

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

[comment]: # ({/70b8d6b4-b7ea8d04})

[comment]: # ({7d75bf76-2f6c5c76})
### ホスト

ホストオブジェクトには以下のプロパティがあります。

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|hostid|ID|ホストのID。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- 更新操作で *required*|
|host|string|ホストの技術名。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- 作成操作で *required*|
|description|text|ホストの説明。|
|flags|integer|ホストの[生成元](/manual/api/reference_commentary#entity-origin-flags)。<br><br>使用可能な値:<br>0 - 通常のホスト;<br>4 - プロトタイプから変換されたホスト。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|inventory\_mode|integer|ホストインベントリの投入モード。<br><br>使用可能な値:<br>-1 - *(デフォルト)* 無効;<br>0 - 手動;<br>1 - 自動。|
|ipmi\_authtype|integer|IPMI認証アルゴリズム。<br><br>使用可能な値:<br>-1 - *(デフォルト)* デフォルト;<br>0 - なし;<br>1 - MD2;<br>2 - MD5<br>4 - straight;<br>5 - OEM;<br>6 - RMCP+。|
|ipmi\_password|string|IPMIパスワード。|
|ipmi\_privilege|integer|IPMI権限レベル。<br><br>使用可能な値:<br>1 - callback;<br>2 - *(デフォルト)* user;<br>3 - operator;<br>4 - admin;<br>5 - OEM。|
|ipmi\_username|string|IPMIユーザー名。|
|maintenance\_from|timestamp|有効なメンテナンスの開始時刻。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|maintenance\_status|integer|有効なメンテナンス状態。<br><br>使用可能な値:<br>0 - *(デフォルト)* メンテナンスなし;<br>1 - メンテナンス有効。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|maintenance\_type|integer|有効なメンテナンスタイプ。<br><br>使用可能な値:<br>0 - *(デフォルト)* データ収集ありのメンテナンス;<br>1 - データ収集なしのメンテナンス。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|maintenanceid|ID|現在ホストに対して有効なメンテナンスのID。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|name|string|ホストの表示名。<br><br>デフォルト: `host` プロパティの値。|
|monitored_by|integer|ホストの監視に使用されるソース。<br><br>使用可能な値:<br>0 - *(デフォルト)* Zabbixサーバー;<br>1 - プロキシ;<br>2 - プロキシグループ。|
|proxyid|ID|ホストの監視に使用されるプロキシのID。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- `monitored_by` が "Proxy" に設定されている場合は *required*|
|proxy_groupid|ID|ホストの監視に使用されるプロキシグループのID。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- `monitored_by` が "Proxy group" に設定されている場合は *required*|
|status|integer|ホストの状態と機能。<br><br>使用可能な値:<br>0 - *(デフォルト)* 有効;<br>1 - 無効。|
|tls\_connect|integer|ホストへの接続。<br><br>使用可能な値:<br>1 - *(デフォルト)* 暗号化なし;<br>2 - PSK;<br>4 - 証明書。|
|tls\_accept|integer|ホストからの接続。<br><br>使用可能なビットマップ値:<br>1 - *(デフォルト)* 暗号化なし;<br>2 - PSK;<br>4 - 証明書。<br><br>これはビットマスクフィールドです。使用可能なビットマップ値の任意の合計を指定できます（たとえば、PSK と証明書の場合は 6）。|
|tls\_issuer|string|証明書の発行者。|
|tls\_subject|string|証明書のサブジェクト。|
|tls\_psk\_identity|string|PSK ID。1 つの PSK に対して 1 つだけ対応付ける必要があります（[autoregistration](/manual/api/reference/autoregistration/object)、[hosts](/manual/api/reference/host/object)、[proxies](/manual/api/reference/proxy/object) 全体で一意）。<br><br>受信側にどの PSK を使用するかを通知するため、PSK ID はネットワーク上を暗号化されずに送信されます。そのため、PSK ID には機密情報を含めないでください。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *write-only*<br>- `tls_connect` が "PSK" に設定されている場合、または `tls_accept` に "PSK" ビットが含まれている場合は *required*|
|tls\_psk|string|事前共有鍵 (PSK)。32 桁以上の16進数である必要があります。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *write-only*<br>- `tls_connect` が "PSK" に設定されている場合、または `tls_accept` に "PSK" ビットが含まれている場合は *required*|
|active_available|integer|ホストのアクティブインターフェースの可用性状態。<br><br>使用可能な値:<br>0 - インターフェース状態は不明;<br>1 - インターフェースは利用可能;<br>2 - インターフェースは利用不可。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|assigned_proxyid|ID|ホストがプロキシグループによって監視されている場合に、Zabbixサーバーによって割り当てられたプロキシのID。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|

[comment]: # ({/7d75bf76-2f6c5c76})

[comment]: # ({53fce8b7-859da78d})
### ホストインベントリ

ホストインベントリオブジェクトには、以下のプロパティがあります。

::: notetip
各プロパティには固有のID番号があり、ホストインベントリフィールドをアイテムに関連付けるために使用されます。
:::

|ID|プロパティ|[Type](/manual/api/reference_commentary#data-types)|説明|最大長|
|-|--|-|-----|-----|
|4|alias|string|別名。|128文字|
|11|asset\_tag|string|資産タグ。|64文字|
|28|chassis|string|シャーシ。|64文字|
|23|contact|string|連絡担当者。|SQLデータベースでは65535文字|
|32|contract\_number|string|契約番号。|64文字|
|47|date\_hw\_decomm|string|HW廃止日。|64文字|
|46|date\_hw\_expiry|string|HW保守期限日。|64文字|
|45|date\_hw\_install|string|HW設置日。|64文字|
|44|date\_hw\_purchase|string|HW購入日。|64文字|
|34|deployment\_status|string|展開ステータス。|64文字|
|14|hardware|string|ハードウェア。|255文字|
|15|hardware\_full|string|ハードウェア詳細。|SQLデータベースでは65535文字|
|39|host\_netmask|string|ホストサブネットマスク。|39文字|
|38|host\_networks|string|ホストネットワーク。|SQLデータベースでは65535文字|
|40|host\_router|string|ホストルーター。|39文字|
|30|hw\_arch|string|HWアーキテクチャ。|32文字|
|33|installer\_name|string|設置担当者名。|64文字|
|24|location|string|場所。|SQLデータベースでは65535文字|
|25|location\_lat|string|場所の緯度。|16文字|
|26|location\_lon|string|場所の経度。|16文字|
|12|macaddress\_a|string|MACアドレスA。|64文字|
|13|macaddress\_b|string|MACアドレスB。|64文字|
|29|model|string|モデル。|64文字|
|3|name|string|名前。|128文字|
|27|notes|string|メモ。|SQLデータベースでは65535文字|
|41|oob\_ip|string|OOB IPアドレス。|39文字|
|42|oob\_netmask|string|OOBホストサブネットマスク。|39文字|
|43|oob\_router|string|OOBルーター。|39文字|
|5|os|string|OS名。|128文字|
|6|os\_full|string|詳細OS名。|255文字|
|7|os\_short|string|短縮OS名。|128文字|
|61|poc\_1\_cell|string|主POC携帯電話番号。|64文字|
|58|poc\_1\_email|string|主メールアドレス。|128文字|
|57|poc\_1\_name|string|主POC名。|128文字|
|63|poc\_1\_notes|string|主POCメモ。|SQLデータベースでは65535文字|
|59|poc\_1\_phone\_a|string|主POC電話A。|64文字|
|60|poc\_1\_phone\_b|string|主POC電話B。|64文字|
|62|poc\_1\_screen|string|主POCスクリーン名。|64文字|
|68|poc\_2\_cell|string|副POC携帯電話番号。|64文字|
|65|poc\_2\_email|string|副POCメールアドレス。|128文字|
|64|poc\_2\_name|string|副POC名。|128文字|
|70|poc\_2\_notes|string|副POCメモ。|SQLデータベースでは65535文字|
|66|poc\_2\_phone\_a|string|副POC電話A。|64文字|
|67|poc\_2\_phone\_b|string|副POC電話B。|64文字|
|69|poc\_2\_screen|string|副POCスクリーン名。|64文字|
|8|serialno\_a|string|シリアル番号A。|64文字|
|9|serialno\_b|string|シリアル番号B。|64文字|
|48|site\_address\_a|string|サイト住所A。|128文字|
|49|site\_address\_b|string|サイト住所B。|128文字|
|50|site\_address\_c|string|サイト住所C。|128文字|
|51|site\_city|string|サイト市区町村。|128文字|
|53|site\_country|string|サイト国。|64文字|
|56|site\_notes|string|サイトメモ。|SQLデータベースでは65535文字|
|55|site\_rack|string|サイトラック位置。|128文字|
|52|site\_state|string|サイト都道府県/州。|64文字|
|54|site\_zip|string|サイトZIP/郵便番号。|64文字|
|16|software|string|ソフトウェア。|255文字|
|18|software\_app\_a|string|ソフトウェアアプリケーションA。|64文字|
|19|software\_app\_b|string|ソフトウェアアプリケーションB。|64文字|
|20|software\_app\_c|string|ソフトウェアアプリケーションC。|64文字|
|21|software\_app\_d|string|ソフトウェアアプリケーションD。|64文字|
|22|software\_app\_e|string|ソフトウェアアプリケーションE。|64文字|
|17|software\_full|string|ソフトウェア詳細。|SQLデータベースでは65535文字|
|10|tag|string|タグ。|64文字|
|1|type|string|タイプ。|64文字|
|2|type\_full|string|タイプ詳細。|64文字|
|35|url\_a|string|URL A。|2048文字|
|36|url\_b|string|URL B。|2048文字|
|37|url\_c|string|URL C。|2048文字|
|31|vendor|string|ベンダー。|64文字|

[comment]: # ({/53fce8b7-859da78d})

[comment]: # ({c531ae6d-0ae1807e})
### ホストタグ

ホストタグオブジェクトには、以下のプロパティがあります。

|プロパティ|[型](/manual/api/reference_commentary#data-types)|説明|
|--|--|------|
|tag|string|ホストタグ名。<br><br>[プロパティの動作](/manual/api/reference_commentary#property-behavior):<br>- *必須*|
|value|string|ホストタグの値。<br><br>[プロパティの動作](/manual/api/reference_commentary#property-behavior):<br>- *読み取り専用*。|
|automatic|integer|ホストタグの種類。<br><br>指定可能な値:<br>0 - *(デフォルト)* 手動（ユーザーが作成したタグ）;<br>1 - 自動（ローレベルディスカバリによって作成されたタグ）<br><br>[プロパティの動作](/manual/api/reference_commentary#property-behavior):<br>- *読み取り専用*|
|object|integer|タグの継承元オブジェクトの種類。<br><br>指定可能な値:<br>0 - テンプレート。<br><br>[プロパティの動作](/manual/api/reference_commentary#property-behavior):<br>- *読み取り専用*。|
|objectid|ID|タグの継承元オブジェクトのID。<br><br>[プロパティの動作](/manual/api/reference_commentary#property-behavior):<br>- *読み取り専用*。|

[comment]: # ({/c531ae6d-0ae1807e})