[comment]: # ({c9bc126a-c9bc126a})
# task.create

[comment]: # ({/c9bc126a-c9bc126a})

[comment]: # ({9a39d714-0e3179d3})
### 説明

`object task.create(object/array tasks)`

このメソッドでは、タスクを作成できます。

::: noteclassic
このメソッドは、すべてのユーザータイプで利用できます（*Admin* および *User* タイプのユーザーは Zabbix 7.4.3 以降）。
このメソッドを呼び出す権限は、ユーザーロールの設定で取り消すことができます。
詳細は [ユーザーロール](/manual/web_interface/frontend_sections/users/user_roles) を参照してください。
:::

[comment]: # ({/9a39d714-0e3179d3})

[comment]: # ({8628e056-2574c234})
### パラメータ

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

このメソッドは、[標準のタスクプロパティ](object#task-object)を持つタスクを受け付けます。

なお、「今すぐ実行」タスクを作成できるのは、次の種類のアイテム/ディスカバリルールに対してのみです。

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

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

[comment]: # ({/8628e056-2574c234})

[comment]: # ({ab87ce2a-ab87ce2a})
### 戻り値

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

[comment]: # ({/ab87ce2a-ab87ce2a})

[comment]: # ({b41637d2-b41637d2})
### 例

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({69ebf78a-5c5fa6f1})
#### タスクの作成

アイテムおよびローレベルディスカバリルールに対して「今すぐ実行」タスクを作成します。

[リクエスト](/manual/api#performing-requests):

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

レスポンス:

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

2つのプロキシに対して「プロキシ設定の更新」タスクを作成します。

[リクエスト](/manual/api#performing-requests):

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

レスポンス:

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

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

[リクエスト](/manual/api#performing-requests):

```json
{
    "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
}
```

レスポンス:

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

[comment]: # ({/69ebf78a-5c5fa6f1})

[comment]: # ({58f08e8d-d87c906b})
### 関連項目

-   [Task](/manual/api/reference/task/object)
-   ['今すぐ実行' リクエストオブジェクト](/manual/api/reference/task/object#execute-now-request-object)
-   ['プロキシ設定の更新' リクエストオブジェクト](/manual/api/reference/task/object#refresh-proxy-configuration-request-object)
-   ['診断情報' リクエストオブジェクト](/manual/api/reference/task/object#diagnostic-information-request-object)

[comment]: # ({/58f08e8d-d87c906b})

[comment]: # ({be350bd3-be350bd3})
### ソース

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

[comment]: # ({/be350bd3-be350bd3})