docs-v2/content/v2.0/process-data/manage-tasks/create-task.md

3.5 KiB

title seotitle description menu weight related
Create a task Create a task for processing data in InfluxDB Create a data processing task in InfluxDB using the InfluxDB UI or the `influx` CLI.
v2_0
name parent
Create a task Manage tasks
201
/v2.0/reference/cli/influx/task/create

InfluxDB provides multiple ways to create tasks both in the InfluxDB user interface (UI) and the influx command line interface (CLI).

Before creating a task, review the basics criteria for writing a task.

Create a task in the InfluxDB UI

The InfluxDB UI provides multiple ways to create a task:

Create a task from the Data Explorer

  1. Click on the Data Explorer icon in the left navigation menu.

    {{< nav-icon "data-explorer" >}}

  2. Building a query and click Save As in the upper right.

  3. Select the Task option.

  4. Specify the task options. See Task options for detailed information about each option.

  5. Select a token to use from the Token dropdown.

  6. Click Save as Task.

Create a task in the Task UI

  1. Click on the Tasks icon in the left navigation menu.

    {{< nav-icon "tasks" >}}

  2. Click {{< icon "plus" >}} Create Task in the upper right.

  3. Select New Task.

  4. In the left panel, specify the task options. See Task options for detailed information about each option.

  5. Select a token to use from the Token dropdown.

  6. In the right panel, enter your task script.

  7. Click Save in the upper right.

{{< img-hd src="/img/2-0-tasks-create-edit.png" title="Create a task" />}}

Import a task

  1. Click on the Tasks icon in the left navigation menu.

    {{< nav-icon "tasks" >}}

  2. Click + Create Task in the upper right.

  3. Select Import Task.

  4. Upload a JSON task file using one of the following options:

    • Drag and drop a JSON task file in the specified area.
    • Click to upload and the area to select the JSON task from from your file manager.
    • Select the JSON option and paste in raw task JSON.
  5. Click Import JSON as Task.

Create a task from a template

  1. Click on the Settings icon in the left navigation menu.

    {{< nav-icon "Settings" >}}

  2. Select Templates.

  3. Hover over the template to use to create the task and click Create.

Clone a task

  1. Click on the Tasks icon in the left navigation menu.

    {{< nav-icon "tasks" >}}

  2. Hover over the task you would like to clone and click the {{< icon "duplicate" >}} icon that appears.

  3. Click Clone.

Create a task using the influx CLI

Use influx task create command to create a new task. It accepts either a file path or raw Flux.

Create a task using a file
# Pattern
influx task create --org <org-name> @</path/to/task-script>

# Example
influx task create --org my-org @/tasks/cq-mean-1h.flux
Create a task using raw Flux
influx task create --org my-org - # <return> to open stdin pipe

options task = {
  name: "task-name",
  every: 6h
}

# ... Task script ...

# <ctrl-d> to close the pipe and submit the command