[comment]: # aside: 1

[comment]: # ({0fc3ae4e-92e6c52c})
# タスクオブジェクト

以下のオブジェクトは `task` API に直接関連しています。

### タスク

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

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|taskid|ID|タスクのIDです。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|type|integer|タスクの種類です。<br><br>Possible values:<br>1 - Diagnostic information;<br>2 - Refresh proxy configuration;<br>6 - Execute now.<br><br>Zabbix 7.4.3以降、*Admin* および *User* タイプのユーザーは 'Execute now' タスクを作成できます。<br><br>なお、`task.get` は常に "7"（Task execution summary）を返します。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|status|integer|タスクのステータスです。<br><br>Possible values:<br>1 - new task;<br>2 - task in progress;<br>3 - task is completed;<br>4 - task is expired.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|clock|timestamp|タスクが作成された時刻です。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|ttl|integer|タスクが期限切れになるまでの秒数です。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|proxyid|ID|診断情報の統計が収集されるプロキシのIDです。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "Diagnostic information" or "Refresh proxy configuration"|
|request|object|タスク種別に応じたタスクリクエストオブジェクトです。<br>'Execute now' タスクのオブジェクトは[以下で詳しく説明します](/manual/api/reference/task/object#check-now-request-object);<br>'Refresh proxy configuration' タスクのオブジェクトは[以下で詳しく説明します](/manual/api/reference/task/object#refresh-proxy-configuration);<br>'Diagnostic information' タスクのオブジェクトは[以下で詳しく説明します](/manual/api/reference/task/object#diagnostic-information-request-object).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|result|object|診断情報タスクの結果オブジェクトです。<br>結果がまだ準備できていない場合は NULL を含むことがあります。<br>結果オブジェクトは[以下で詳しく説明します](/manual/api/reference/task/object#statistic-result-object).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|

[comment]: # ({/0fc3ae4e-92e6c52c})

[comment]: # ({4dff159c-cd63c2fd})
#### 'Execute now' リクエストオブジェクト

'Execute now' タスクのリクエストオブジェクトには、次のプロパティがあります。

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|itemid|ID|アイテムおよび low-level discovery ルールのID。<br><br>Zabbix 7.4.3以降、*Admin* および *User* タイプのユーザーは、*read-write* [権限](/manual/api/reference/usergroup/object#permission)を持つホスト、または *read* 権限とロールで `invoke_execute_now` [アクション](/manual/api/reference/role/object#action) が有効になっているホスト上のアイテムに対して 'Execute now' を実行できます。low-level discovery (LLD) ルールについても、同様に *Admin* タイプのユーザーに適用されます。|

[comment]: # ({/4dff159c-cd63c2fd})

[comment]: # ({f395f844-b5d3bd1c})
#### 「プロキシ設定のリフレッシュ」リクエストオブジェクト

「プロキシ設定のリフレッシュ」タスクリクエストオブジェクトには、以下のプロパティがあります。

|プロパティ|[Type](/manual/api/reference_commentary#data-types)|説明|
|--|--|------|
|proxyids|array|プロキシID。|

[comment]: # ({/f395f844-b5d3bd1c})

[comment]: # ({1249a0ab-52d75b77})
#### 「Diagnostic information」リクエストオブジェクト

診断情報タスクリクエストオブジェクトには、以下のプロパティがあります。すべての種類のプロパティに対する統計リクエストオブジェクトについては、[以下で詳しく説明しています](/manual/api/reference/task/object#statistic-request-object)。

|プロパティ|[型](/manual/api/reference_commentary#data-types)|説明|
|--|--|------|
|historycache|object|履歴キャッシュの統計リクエスト。サーバーおよびプロキシで使用できます。|
|valuecache|object|アイテムキャッシュの統計リクエスト。サーバーで使用できます。|
|preprocessing|object|前処理マネージャーの統計リクエスト。サーバーおよびプロキシで使用できます。|
|alerting|object|アラートマネージャーの統計リクエスト。サーバーで使用できます。|
|lld|object|LLDマネージャーの統計リクエスト。サーバーで使用できます。|

[comment]: # ({/1249a0ab-52d75b77})

[comment]: # ({2eb185f8-5149852c})
##### 統計リクエストオブジェクト

統計リクエストオブジェクトは、サーバー/プロキシの内部プロセスについてどの種類の情報を収集するかを定義するために使用されます。以下のプロパティがあります。

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|stats|query|返される統計オブジェクトのプロパティ。<br>診断情報統計の各タイプで利用可能なフィールドの一覧は、[以下で詳しく説明されています](object#list-of-statistic-fields-available-for-each-type-of-diagnostic-information-request)。<br><br>デフォルト: `extend` は利用可能なすべての統計フィールドを返します。|
|top|object|返される統計値をソートおよび制限するためのオブジェクト。<br>診断情報統計の各タイプで利用可能なフィールドの一覧は、[以下で詳しく説明されています](object#list-of-sorting-fields-available-for-each-type-of-diagnostic-information-request)。<br><br>例: { “source.alerts”: 10 }|

[comment]: # ({/2eb185f8-5149852c})

[comment]: # ({50ca4dca-60e59ca2})
###### 各種診断情報リクエストタイプで利用可能な統計フィールドの一覧

各種診断情報リクエストプロパティでリクエスト可能な統計フィールドは以下の通りです。

|診断タイプ|利用可能なフィールド|説明|
|--|--|------|
|historycache|items|キャッシュされたアイテム数|
|^|values|キャッシュされた値の数|
|^|memory|共有メモリの統計情報 (空き領域、使用中チャンク数、空きチャンク数、最大空きチャンクサイズ)|
|^|memory.data|ヒストリデータキャッシュ共有メモリの統計情報|
|^|memory.index|ヒストリインデックスキャッシュ共有メモリの統計情報|
|valuecache|items|キャッシュされたアイテム数|
|^|values|キャッシュされた値の数|
|^|memory|共有メモリの統計情報 (空き領域、使用中チャンク数、空きチャンク数、最大空きチャンクサイズ)|
|^|mode|値キャッシュモード|
|preprocessing|values|キューイングされた値の数|
|^|preproc.values|前処理ステップを持つキューイングされた値の数|
|alerting|alerts|キューイングされたアラートの数|
|lld|rules|キューイングされたルールの数|
|^|values|キューイングされた値の数|

[comment]: # ({/50ca4dca-60e59ca2})

[comment]: # ({a768b834-09dc3377})
###### 各種診断情報リクエストで利用可能なソートフィールドの一覧

以下の統計フィールドを使用して、要求された情報のソートおよび制限を行うことができます。

|診断タイプ|利用可能なフィールド|[Type](/manual/api/reference_commentary#data-types)|
|--|--|------|
|historycache|values|integer|
|valuecache|values|integer|
|^|request.values|integer|
|preprocessing|values|integer|
|alerting|media.alerts|integer|
|^|source.alerts|integer|
|lld|values|integer|

[comment]: # ({/a768b834-09dc3377})

[comment]: # ({13093171-e680be6c})
##### 統計結果オブジェクト

統計結果オブジェクトは、タスクオブジェクトの `result` フィールドで取得されます。

|プロパティ|[Type](/manual/api/reference_commentary#data-types)|説明|
|--|--|------|
|status|integer|タスク結果のステータス。<br><br>指定可能な値:<br>-1 - タスクの実行中にエラーが発生した。<br>0 - タスク結果が作成された。<br><br>[プロパティの動作](/manual/api/reference_commentary#property-behavior):<br>- *読み取り専用*|
|data|string/object|特定の診断情報タスクの統計リクエストオブジェクトに応じた結果。<br>タスクの実行中にエラーが発生した場合は、エラーメッセージ文字列が含まれます。|

[comment]: # ({/13093171-e680be6c})