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 privileges

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.

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.

Base URL
https://{kibana_url}