Get cloud onboarding deployment

Base URL
https://{kibana_url}
  • GET /api/fleet/cloud_onboarding_deployments/{id}
Auth

Get a cloud onboarding deployment by ID.

Required authorization

Privileges fleet-agent-policies-read or integrations-read

Path parameters

id string · max length: 255 required

The saved object ID of the cloud onboarding deployment.

Responses

Successful response

application/json
item object required
agentPolicyId string

Agent policy ID created for agent-based deployments. Present only when agent_based is in mechanisms.

apiKeyId string

Elasticsearch API key ID for push mechanisms (ecf). Set by the backend; used for key rotation/revocation.

attemptCount number · min: 1 required

Number of deployment attempts, including the current one.

authMethod enum

Authentication method for managed integrations.

Values: identity_federation static_keys
connectorId string

ID of the fleet-cloud-connector this deployment belongs to. Absent for static-keys deployments.

dataFormat enum

Data format: ecs or otel.

Values: ecs otel
deploymentId string

Opaque deployment identifier; for AWS, the CFN stack ARN.

deploymentName string

Opaque deployment name; for AWS, the CFN stack name.

ecfStacks object[] · max items: 10

ECF CloudFormation stacks launched as part of this deployment. Written by the wizard after the user clicks Launch.

family enum required

ECF template family.

Values: unified otel crowdstrike
stackName string · min length: 1 · max length: 128 required

CloudFormation stack name (128-char AWS limit).

templateVersion string · min length: 1 · max length: 32 required

ECF semantic version resolved at launch time, e.g. "1.10.0".

globalRegion string

Global AWS region from the Service Settings step.

id string required
mechanisms enum[] · max items: 10 required
Values: managed_integration ecf agent_based
packagePolicyIds string[] · max items: 100

Package policy IDs created for managed_integration services.

provider enum required

Cloud provider.

Values: aws azure gcp
services string[] · max items: 1000 required

Service IDs covered by this deployment.

serviceVars map string to string to object

Per-service config keyed by instance ID. Each value is the ServiceVars object from the Service Settings step.

status enum required

Deployment status.

Values: pending deploying succeeded failed
statusMessage string

Error context when status is failed.

Bad Request

application/json
attributes object required
error string
errorType string
message string required
statusCode number

Not Found

application/json
message string required
Base URL
https://{kibana_url}