deploy.deployments.build-logRead the log of a deployment's image build, line by line
Lines as the builder printed them (colours stripped, URL credentials masked), kept with the deployment. Pass the previous answer's `next` as `after` to tail it while it runs; `done` is true once the builder reported its `exitCode` or the build step is over.
Request syntax
GET /deploy/api/deployments/{id}/build-logPath parameters
idRequiredstring
Constraints: uuid
Query parameters
afterOptionalnumber
The previous answer’s next: only lines after this byte offset; omitted, from the start
Constraints: integer, min 0
limitOptionalnumber
Most lines to return; default 2000
Constraints: integer, 1-5000
Response
200 with `data`: `lines` (offset, ts, line), `next` (the offset to pass as after, or null before any line), `exitCode` (the builder’s, or null) and `done`.
A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.
Fields of data
linesAlwaysarray of object
Lines after `after`, in orderlines[].offsetAlwaysnumber
Byte offset where the line startslines[].tsAlwaysstring
When it was printedlines[].lineAlwaysstring
The linenextAlwaysnumber, may be null
Offset to pass as after next time; null before any lineexitCodeAlwaysnumber, may be null
The builder’s exit code; null until it finisheddoneAlwaysboolean
True once no more lines will come
Checked against the handlers: every route test validates their answers against this schema.
Errors
- 400The request does not pass the schema above. The body is { "error": …, "issues": […] }, one issue per field.
- 401No credentials, or an access key that is unknown, revoked or expired.
- 403The caller's policies do not allow deploy:GetBuildLogs on this resource. The body names the action and the resource, and the refusal is recorded in the audit log.
- 404The resource does not exist in your organization.
Examples
The required parameters only, with example values. Replace id and the other placeholders with your own.
dcloud deploy deployments build-log idcurl -X GET "https://console.platform-development.deutschecloud.app/deploy/api/deployments/id/build-log" \
-H "Authorization: EWS-ACCESS-KEY $ACCESS_KEY"Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_deploy_deployments_build-log.