Get cloud onboarding deployments by connector ID
https://{kibana_url}
- GET /api/fleet/cloud_onboarding_deployments/connector/{connectorId}
- GET /s/{space_id}/api/fleet/cloud_onboarding_deployments/connector/{connectorId}
Refer to Spaces for more information.
List all cloud onboarding deployments for a given connector ID.
[Required authorization] Route required privileges: fleet-agent-policies-read OR integrations-read.
Path Parameters
-
connectorIdstring · min: 1 · max: 255required -
The fleet-cloud-connector ID to list deployments for.
Responses
Successful response
-
itemsobject · max: 100required -
agentPolicyIdsstring · max: 1000 -
Agent policy IDs for agent_based deployments. Single-element for new-policy deploys; multiple for existing-policy deploys targeting several policies.
-
apiKeyIdstring -
Elasticsearch API key ID for push mechanisms (ecf). Set by the backend; used for key rotation/revocation.
-
attemptCountnumber · min: 1required -
Number of deployment attempts, including the current one.
-
authMethod -
Authentication method. Allowed values depend on the delivery mechanism:
- managed_integration: identity_federation | static_keys
- agent_based: static_keys (direct_access_keys) | temporary_keys | shared_credentials | assume_role
-
Values:
identity_federationstatic_keystemporary_keysshared_credentialsassume_role -
connectorIdstring -
ID of the fleet-cloud-connector this deployment belongs to. Absent for static-keys deployments.
-
deploymentIdstring -
Opaque deployment identifier; for AWS, the CFN stack ARN.
-
deploymentNamestring -
Opaque deployment name; for AWS, the CFN stack name.
-
ecfStacksobject · max: 10 -
ECF CloudFormation stacks launched as part of this deployment. Written by the wizard after the user clicks Launch.
-
stackNamestring · min: 1 · max: 128required -
CloudFormation stack name (128-char AWS limit).
-
templateVersionstring · min: 1 · max: 32required -
ECF semantic version resolved at launch time, e.g. "1.10.0".
-
globalRegionstring -
Global AWS region from the Service Settings step.
-
idstringrequired -
mechanisms· max: 10required -
Values:
managed_integrationecfagent_based -
packagePolicyIdsstring · max: 1000 -
Package policy IDs created for this deployment (managed_integration and agent_based).
-
policyIdsByInstancemap string to string -
instanceId → policyId mapping persisted after deploy. Hydrated into the wizard on resume to enable cleanup of stale policies when services are removed.
-
servicesstring · max: 1000required -
Service IDs covered by this deployment.
-
serviceVarsmap string to string to object -
Per-service config keyed by instance ID. Each value is the ServiceVars object from the Service Settings step.
-
statusMessagestring -
Error context when status is failed.
Bad Request
-
attributesobjectrequired -
errorstring -
errorTypestring -
messagestringrequired -
statusCodenumber