---
title: stack es ml start-data-frame-analytics cli command
description: Start a data frame analytics job. Behaviour flags: --dry-run — validate all inputs and exit without performing any action 
url: https://docs-v3-preview.elastic.dev/elastic/cli/pull/480/cli/stack/es/ml/start-data-frame-analytics
---

# stack es ml start-data-frame-analytics cli command
<cli-modifiers>
</cli-modifiers>

```bash
elastic stack es ml start-data-frame-analytics --id <id> [options]
```

Start a data frame analytics job.
**Behaviour flags:**
`--dry-run` — validate all inputs and exit without performing any action

## Options

<definitions>
  <definition term="--id string required">
    Identifier for the data frame analytics job. This identifier can contain lowercase alphanumeric characters (a-z and 0-9), hyphens, and underscores. It must start and end with alphanumeric characters.
  </definition>
  <definition term="--timeout string">
    Controls the amount of time to wait until the data frame analytics job starts.
  </definition>
  <definition term="--input-file string">
    path to a JSON file to use as command input
  </definition>
  <definition term="--[no-]dry-run">
    validate all inputs and exit without performing any action (preview changes without applying them)
  </definition>
</definitions>


## Global Options

<definitions>
  <definition term="--[no-]json">
    output as JSON
  </definition>
</definitions>