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
}

関連項目

• Task
• '今すぐ実行' リクエストオブジェクト
• 'プロキシ設定の更新' リクエストオブジェクト
• '診断情報' リクエストオブジェクト

ソース

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