Type to search.

stack kb elastic-agent-policies post-fleet-agent-policies cli command

Serverless Preview

Elastic Cloud Serverless projects are autoscaled environments, fully managed by Elastic and available on Elastic Cloud.

Availability

  • Preview

    This functionality is in technical preview and is ready for evaluation. Use with caution in production; it is not recommended for mission-critical workloads. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features. Specific Support terms apply.

Serverless interfaces and procedures might differ from classic Elastic Stack deployments.

Stack Preview

The Elastic Stack includes Elastic's core products such as Elasticsearch, Kibana, Logstash, and Beats.

Availability

  • Preview

    This functionality is in technical preview and is ready for evaluation. Use with caution in production; it is not recommended for mission-critical workloads. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features. Specific Support terms apply.

Unless stated otherwise on the page, this functionality is available when your Elastic Stack is deployed on Elastic Cloud Hosted, Elastic Cloud Enterprise, Elastic Cloud on Kubernetes, and self-managed environments.

This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.

Auth required
Shell
elastic stack kb elastic-agent-policies post-fleet-agent-policies \
  --name <name> \
  --namespace <namespace> \
  [options]

Create an agent policy

Behaviour flags:

--dry-run — validate all inputs and exit without performing any action

--name string required
--namespace string required
--sys-monitoring
Whether to add the system integration to the new agent policy
--advanced-settings string
--agent-features string[]

Repeatable: pass --agent-features multiple times to supply more than one value

--agentless string
--data-output-id string
--description string
--download-source-id string
Use download_source_ids instead
--download-source-ids string[]

Repeatable: pass --download-source-ids multiple times to supply more than one value

--fleet-server-host-id string
--force
--global-data-tags string[]

User defined data tags that are added to all of the inputs. The values can be strings or numbers.

Repeatable: pass --global-data-tags multiple times to supply more than one value

--has-agent-version-conditions
--has-fleet-server
--id string
--inactivity-timeout number
--is-default
--is-default-fleet-server
--is-managed
--is-protected
--is-verifier
--keep-monitoring-alive
When set to true, monitoring will be enabled but logs/metrics collection will be disabled
--min-agent-version string
--monitoring-diagnostics string
--monitoring-enabled string[]

Repeatable: pass --monitoring-enabled multiple times to supply more than one value

--monitoring-http string
--monitoring-output-id string
--monitoring-pprof-enabled
--overrides string
Override settings that are defined in the agent policy. Input settings cannot be overridden. The override option should be used only in unusual circumstances and not as a routine procedure.
--package-agent-version-conditions string[]

Repeatable: pass --package-agent-version-conditions multiple times to supply more than one value

--required-versions string[]

Repeatable: pass --required-versions multiple times to supply more than one value

--space-ids string[]

Repeatable: pass --space-ids multiple times to supply more than one value

--supports-agentless
Indicates whether the agent policy supports agentless integrations. Deprecated in favor of the Fleet managed integrations API.
--unenroll-timeout number
--input-file string
path to a JSON file to use as command input
--dry-run
validate all inputs and exit without performing any action (preview changes without applying them)
--no-validate
skip input validation and send the request as-is
--output-fields string
comma-separated list of fields to include in output (dot-notation supported)
--output-template string
Mustache-like template for custom text output (e.g. "{{id}}: {{name}}")
--json

output as JSON