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

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

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

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

Diese Methode ermöglicht das Erstellen von Aufgaben.

::: noteclassic
Diese Methode ist für Benutzer aller Typen verfügbar (für Benutzer vom Typ *Admin* und *User* seit Zabbix 7.4.3).
Die Berechtigung zum Aufruf der Methode kann in den Einstellungen der Benutzerrolle widerrufen werden.
Weitere Informationen finden Sie unter [Benutzerrollen](/manual/web_interface/frontend_sections/users/user_roles).
:::

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

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

`(object/array)` Eine zu erstellende Aufgabe.

Die Methode akzeptiert Aufgaben mit den [Standard-Aufgabeneigenschaften](object#task-object).

Beachten Sie, dass Aufgaben vom Typ „Jetzt ausführen“ nur für die folgenden Typen von Datenpunkten/Discovery-Regeln erstellt werden können:

-   Zabbix-Agent (passiv)
-   Einfache Prüfung
-   SNMP-Agent (v1/v2/v3)
-   Zabbix-intern
-   Externe Prüfung
-   Datenbankmonitor
-   HTTP-Agent
-   IPMI-Agent
-   SSH-Agent
-   TELNET-Agent
-   JMX-Agent
-   Berechnet
-   Abhängiger Datenpunkt
-   Skript
-   Browser

Wenn der Datenpunkt/die Discovery-Regel vom Typ „Abhängiger Datenpunkt“ ist, muss auch sein Master-Datenpunkt einer der oben genannten Typen sein.

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

[comment]: # ({ab87ce2a-ab87ce2a})
### Rückgabewerte

`(object)` Gibt ein Objekt zurück, das die IDs der erstellten Aufgaben
unter der Eigenschaft `taskids` enthält. Für jeden Datenpunkt und jede
Low-Level-Discovery-Regel wird eine Aufgabe erstellt. Die Reihenfolge der
zurückgegebenen IDs entspricht der Reihenfolge der übergebenen `itemids`.

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

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

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

[comment]: # ({69ebf78a-5c5fa6f1})
#### Erstellen einer Aufgabe

Erstellen Sie eine Aufgabe vom Typ „Jetzt ausführen“ für einen Datenpunkt und eine Low-Level-Discovery-Regel.

[Anfrage](/manual/api#performing-requests):

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

Antwort:

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

Erstellen Sie eine Aufgabe vom Typ „Proxy-Konfiguration aktualisieren“ für zwei Proxys.

[Anfrage](/manual/api#performing-requests):

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

Antwort:

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

Erstellen Sie eine Aufgabe vom Typ „Diagnoseinformationen“.

[Anfrage](/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
}
```

Antwort:

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

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

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

-   [Aufgabe](/manual/api/reference/task/object)
-   ['Jetzt ausführen'-Anfrageobjekt](/manual/api/reference/task/object#execute-now-request-object)
-   ['Proxy-Konfiguration aktualisieren'-Anfrageobjekt](/manual/api/reference/task/object#refresh-proxy-configuration-request-object)
-   ['Diagnoseinformationen'-Anfrageobjekt](/manual/api/reference/task/object#diagnostic-information-request-object)

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

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

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

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