Update cloud onboarding deployment
https://{kibana_url}
- PUT /api/fleet/cloud_onboarding_deployments/{id}
Update a cloud onboarding deployment by ID.
[Required authorization] Route required privileges: fleet-agent-policies-all OR integrations-all.
Path Parameters
-
idstring · max: 255required -
The saved object ID of the cloud onboarding deployment.
Request
-
agentPolicyIdstring · max: 255 -
apiKeyIdstring · max: 255 -
attemptCountnumber · min: 1 -
Incremented by callers performing a retry.
-
deploymentIdstring · max: 2048 -
CFN stack ARN (or equivalent); provided by the client after manual deployment.
-
deploymentNamestring · max: 255 -
ecfStacksobject · max: 10 -
ECF CloudFormation stacks to record for this deployment.
-
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".
-
packagePolicyIdsstring · max: 100 -
serviceVarsmap string to string to object -
Per-service config keyed by instance ID.
-
statusMessagestring · max: 1000 -
Error context; set when transitioning to failed.
Responses
Successful response
-
itemobjectrequired -
agentPolicyIdstring -
Agent policy ID created for agent-based deployments. Present only when agent_based is in mechanisms.
-
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.
-
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: 100 -
Package policy IDs created for managed_integration services.
-
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
Not Found
-
messagestringrequired