task.create
説明
object task.create(object/array tasks)
このメソッドを使用すると、タスクを作成できます。
このメソッドは、あらゆる種類のユーザーが利用できます。 このメソッドを呼び出す権限は、ユーザーのロール設定で取り消すことができます。 詳細は User roles を参照してください。
パラメータ
(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.