---
title: cloud hosted deployments create-deployment cli command
description: Create Deployment Behaviour flags: --dry-run — validate all inputs and exit without performing any action 
url: https://www.elastic.co/elastic/docs-builder/docs/4120/reference/elastic-cli/cli/cloud/hosted/deployments/create-deployment
applies_to:
  - Elastic Cloud Serverless: Preview
  - Elastic Stack: Preview
---

# cloud hosted deployments create-deployment cli command
<cli-modifiers>
</cli-modifiers>

```bash
elastic cloud hosted deployments create-deployment [options]
```

Create Deployment
**Behaviour flags:**
`--dry-run` — validate all inputs and exit without performing any action

## Options

<definitions>
  <definition term="--request-id string">
    An optional idempotency token - if two create requests share the same request_id token (min size 32 characters, max 128) then only one deployment will be created, the second request will return the info of that deployment (in the same format described below, but with blanks for auth-related fields)
  </definition>
  <definition term="--validate-only">
    If true, will just validate the Deployment definition but will not perform the creation
  </definition>
  <definition term="--template-id string">
    An optional template id - if present, the referenced template will be used to fill in the resources field of the deployment creation request. If any resources are present in the request together with the template, the ones coming in the request will prevail and no merging with the template will be performed.
  </definition>
  <definition term="--name string">
  </definition>
  <definition term="--resources string">
  </definition>
  <definition term="--settings string">
  </definition>
  <definition term="--metadata string">
  </definition>
  <definition term="--alias string">
  </definition>
  <definition term="--region string">
  </definition>
  <definition term="--version string">
  </definition>
  <definition term="--input-file string">
    path to a JSON file to use as command input
  </definition>
  <definition term="--dry-run">
    validate all inputs and exit without performing any action (preview changes without applying them)
  </definition>
</definitions>


## Global Options

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