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

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

[comment]: # ({0e3179d3-0e3179d3})
### Descripció

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

Aquest mètode permet crear una tasca nova (com ara recopilar dades de diagnòstic o verificar elements o regles de descoberta de baix nivell) sense tornar a carregar la configuració.

:::noteclassic
Aquest mètode només és disponible per a usuaris del tipus *Super admin*. Els permisos per invocar el mètode es poden revocar a la configuració del rol d'usuari. Consulteu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles) per obtindre més informació.
:::

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

[comment]: # ({4ce7d9ef-2574c234})
### Paràmetres

`(object/array)` Crear una tasca.

El mètode admet els següents paràmetres.

|Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|**type**<br>(obligatori)|integer|Tipus de tasca.<br><br>Valors possibles:<br>1 - Informació de diagnòstic;<br>6 - Comprovar ara.|
|**request**<br>(obligatori)|object|Objecte de sol·licitud de tasca segons el tipus de tasca. El format correcte de l'objecte de sol·licitud es descriu a la secció [Objecte de la tasca](/manual/api/reference/task/object).|
|proxy\_hostid|integer|Proxy per al qual la tasca d'informació de diagnòstic recopilarà dades.<br><br>S'ignora per a les tasques 'Comprovar ara'.|

*Tingueu en compte* que les tasques 'Comprovar ara' només es poden crear per als tipus d'objectes/regles de descoberta següents:

- Agent Zabbix
- Agent SNMPv1/v2/v3
- Comprovació simple
- Control intern
- Control extern
- Monitor de base de dades
- Agent HTTP
- Agent IPMI
- Agent SSH
- Agent TELNET
- Verificació calculada
- Agent JMX

[comment]: # ({/4ce7d9ef-2574c234})

[comment]: # ({ab87ce2a-ab87ce2a})
### Valors retornats

`(object)` Retorna un objecte que conté els ID de les tasques creades sota la propietat `taskids`. L'ordre dels ID retornats correspon a l'ordre de les tasques transmeses.

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

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

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

[comment]: # ({86771e73-5c5fa6f1})
#### Crear una tasca

Crear una tasca `check now` per a dos elements. Un es un element, l'altre és una regla de descoberta de baix nivell.

Petició:

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

Resposta:

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

Crear una tasca `diagnostic information`.

Petició:

```json
{
    "jsonrpc": "2.0",
    "method": "task.create",
    "params": [
        {
            "type": 1,
            "request": {
                "alerting": {
                    "stats": [
                        "alerts"
                    ],
                    "top": {
                        "media.alerts": 10
                    }
                },
                "lld": {
                    "stats": "extend",
                    "top": {
                        "values": 5
                    }
                }
            },
            "proxy_hostid": 0
        }
    ],
    "auth": "700ca65537074ec963db7efabda78259",
    "id": 2
}
```

Resposta:

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

[comment]: # ({/86771e73-5c5fa6f1})

[comment]: # ({9ab591a9-d87c906b})
### Veieu també

-   [Tasca](/manual/api/reference/task/object)
-   [Objecte de consulta 'Executar ara'](/manual/api/reference/task/object)
-   [Objecte de consulta 'Informació de diagnòstic'](/manual/api/reference/task/object)
-   [Objecte de consulta estadístic](/manual/api/reference/task/object)

[comment]: # ({/9ab591a9-d87c906b})

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

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

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