---
title: stack kb fleet-cloud-onboarding-deployments put-fleet-cloud-onboarding-deployments-id cli command
description: Update cloud onboarding deployment Behaviour flags: --dry-run — validate all inputs and exit without performing any action 
url: https://www.elastic.co/elastic/docs-builder/docs/4302/reference/elastic-cli/cli/stack/kb/fleet-cloud-onboarding-deployments/put-fleet-cloud-onboarding-deployments-id
applies_to:
  - Elastic Cloud Serverless: Preview
  - Elastic Stack: Preview
---

# stack kb fleet-cloud-onboarding-deployments put-fleet-cloud-onboarding-deployments-id cli command
<cli-modifiers>
</cli-modifiers>

```bash
elastic stack kb fleet-cloud-onboarding-deployments put-fleet-cloud-onboarding-deployments-id \
  --id <id> \
  [options]
```

Update cloud onboarding deployment
**Behaviour flags:**
`--dry-run` — validate all inputs and exit without performing any action

## Options

<definitions>
  <definition term="--id string required">
    The saved object ID of the cloud onboarding deployment.
  </definition>
  <definition term="--agent-policy-ids string[]">
    Agent policy IDs for agent_based deployments. Single-element for new-policy deploys; multiple for existing-policy deploys targeting several policies.
    **Repeatable:** pass `--agent-policy-ids` multiple times to supply more than one value
  </definition>
  <definition term="--api-key-id string">
  </definition>
  <definition term="--attempt-count number">
    Incremented by callers performing a retry.
  </definition>
  <definition term="--auth-method enum">
    Authentication method. Refreshed on each successful deploy so a credential-method change between deploys is reflected on resume.
    **Values:** identity_federation, static_keys, temporary_keys, shared_credentials, assume_role
  </definition>
  <definition term="--connector-id string">
  </definition>
  <definition term="--deployment-id string">
    CFN stack ARN (or equivalent); provided by the client after manual deployment.
  </definition>
  <definition term="--deployment-name string">
  </definition>
  <definition term="--ecf-stacks string[]">
    ECF CloudFormation stacks to record for this deployment.
    **Repeatable:** pass `--ecf-stacks` multiple times to supply more than one value
  </definition>
  <definition term="--mechanisms string[]">
    Delivery mechanisms active in this deployment. Replaces the stored mechanisms array.
    **Repeatable:** pass `--mechanisms` multiple times to supply more than one value
  </definition>
  <definition term="--package-policy-ids string[]">
    Package policy IDs created for this deployment (managed_integration and agent_based).
    **Repeatable:** pass `--package-policy-ids` multiple times to supply more than one value
  </definition>
  <definition term="--policy-ids-by-instance string">
  </definition>
  <definition term="--services string[]">
    Current service set for this deployment. Refreshed on each successful deploy so resume after an incremental service addition restores all deployed services.
    **Repeatable:** pass `--services` multiple times to supply more than one value
  </definition>
  <definition term="--service-vars string">
    Per-service config keyed by instance ID.
  </definition>
  <definition term="--status enum">
    Deployment status.
    **Values:** pending, deploying, succeeded, failed
  </definition>
  <definition term="--status-message string">
    Error context; set when transitioning to failed.
  </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>
  <definition term="--no-validate">
    skip input validation and send the request as-is
  </definition>
</definitions>


## Global Options

<definitions>
  <definition term="--output-fields string">
    comma-separated list of fields to include in output (dot-notation supported)
  </definition>
  <definition term="--output-template string">
    Mustache-like template for custom text output (e.g. "{{id}}: {{name}}")
  </definition>
  <definition term="--json">
    output as JSON
  </definition>
</definitions>