[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]: # ({c7de69b4-859da78d})
### ホストインベントリ

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

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

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

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

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

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

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|tag|string|ホストタグ名。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|value|string|ホストタグの値。|
|automatic|integer|ホストタグの種類。<br><br>指定可能な値:<br>0 - *(default)* 手動（ユーザーが作成したタグ）;<br>1 - 自動（low-level discoveryによって作成されたタグ）<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|

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