﻿---
title: ecctl deployment search
description: Performs advanced deployment search using the Elasticsearch Query DSL. Read more about Query DSL. ecctl deployment	 - Manages deployments. 
url: https://www.elastic.co/elastic/docs-builder/docs/2777/reference/ecctl/ecctl_deployment_search
products:
  - Elastic Cloud Control
applies_to:
  - Elastic Cloud Hosted: Generally available
  - Elastic Cloud Enterprise: Generally available
---

# ecctl deployment search
Performs advanced deployment search using the Elasticsearch Query DSL.

## Synopsis

Read more about [Query DSL](https://docs-v3-preview.elastic.dev/elastic/docs-builder/docs/2777/reference/query-languages/querydsl).
```
ecctl deployment search -f <query file.json> [flags]
```


## Examples

```
$ cat query_string_query.json
{
    "query": {
        "query_string": {
            "query": "name: admin"
        }
    }
}
$ ecctl deployment search -f query_string_query.json
[...]
```


## Options

```
  -a, --all-matches   Uses a cursor to return all matches of the query (ignoring the size in the query). This can be used to query more than 10k results.
  -f, --file string   JSON file that contains JSON-style domain-specific language query
  -h, --help          help for search
      --size int32    Defines the size per request when using the --all-matches option. (default 500)
```


## Options inherited from parent commands

```
      --api-key string        API key to use to authenticate (If empty will look for EC_API_KEY environment variable)
      --config string         Config name, used to have multiple configs in $HOME/.ecctl/<env> (default "config")
      --force                 Do not ask for confirmation
      --format string         Formats the output using a Go template
      --host string           Base URL to use
      --insecure              Skips all TLS validation
      --message string        A message to set on cluster operation
      --output string         Output format [text|json] (default "text")
      --pass string           Password to use to authenticate (If empty will look for EC_PASS environment variable)
      --pprof                 Enables pprofing and saves the profile to pprof-20060102150405
  -q, --quiet                 Suppresses the configuration file used for the run, if any
      --region string         Elastic Cloud Hosted region
      --timeout duration      Timeout to use on all HTTP calls (default 30s)
      --trace                 Enables tracing saves the trace to trace-20060102150405
      --user string           Username to use to authenticate (If empty will look for EC_USER environment variable)
      --verbose               Enable verbose mode
      --verbose-credentials   When set, Authorization headers on the request/response trail will be displayed as plain text
      --verbose-file string   When set, the verbose request/response trail will be written to the defined file
```


## See also

- [ecctl deployment](https://www.elastic.co/elastic/docs-builder/docs/2777/reference/ecctl/ecctl_deployment)	 - Manages deployments