task.create

説明

object task.create(object/array tasks)

このメソッドはタスクを作成するためのものです。

このメソッドはすべてのタイプのユーザーが利用できます。ユーザーロールの設定でメソッドの呼び出し権限を取り消すことができます。詳細はユーザーロールを参照してください。

パラメータ

(object/array) 作成するタスク。

このメソッドは標準タスクプロパティを持つタスクを受け付けます。

「今すぐ実行」タスクは、以下のタイプのアイテム/ディスカバリールールに対してのみ作成できます:

Zabbixエージェント（パッシブ）
シンプルチェック
SNMPエージェント（v1/v2/v3）
Zabbix内部
外部チェック
データベース監視
HTTPエージェント
IPMIエージェント
SSHエージェント
TELNETエージェント
JMXエージェント
計算
従属アイテム
スクリプト
ブラウザ

アイテム/ディスカバリールールが「従属アイテム」タイプの場合、そのマスターアイテムも上記のいずれかのタイプである必要があります。

戻り値

(object) taskidsプロパティの下で作成されたタスクのIDを含むオブジェクトを返します。アイテムおよびローレベルディスカバリルールごとに1つのタスクが作成されます。返されるIDの順序は、渡されたitemidsの順序と一致します。

例

タスクの作成

アイテムとローレベルディスカバリールールの「今すぐ実行」タスクを作成します。

リクエスト:

{
           "jsonrpc": "2.0",
           "method": "task.create",
           "params": [
               {
                   "type": 6,
                   "request": {
                       "itemid": "10092"
                   }
               },
               {
                   "type": 6,
                   "request": {
                       "itemid": "10093"
                   }
               }
           ],
           "id": 1
       }

レスポンス:

{
           "jsonrpc": "2.0",
           "result": {
               "taskids": [
                   "1",
                   "2"
               ]
           },
           "id": 1
       }

2つのプロキシの「プロキシ設定のリフレッシュ」タスクを作成します。

リクエスト:

{
           "jsonrpc": "2.0",
           "method": "task.create",
           "params": [
               {
                   "type": 2,
                   "request": {
                       "proxyids": ["10459", "10460"]
                   }
               }
           ],
           "id": 1
       }

レスポンス:

{
           "jsonrpc": "2.0",
           "result": {
               "taskids": [
                   "1"
               ]
           },
           "id": 1
       }

「診断情報」タスクを作成します。

リクエスト:

{
           "jsonrpc": "2.0",
           "method": "task.create",
           "params": [
               {
                   "type": 1,
                   "request": {
                       "alerting": {
                           "stats": [
                               "alerts"
                           ],
                           "top": {
                               "media.alerts": 10
                           }
                       },
                       "lld": {
                           "stats": "extend",
                           "top": {
                               "values": 5
                           }
                       }
                   },
                   "proxyid": 0
               }
           ],
           "id": 1
       }

レスポンス:

{
           "jsonrpc": "2.0",
           "result": {
               "taskids": [
                   "3"
               ]
           },
           "id": 1
       }

参考

ソース

CTask::create() in ui/include/classes/api/services/CTask.php.

Documentation

task.create

説明

パラメータ

戻り値

例

タスクの作成

参考

ソース