Logs de build de la imagen
curl --request GET \
--url https://api.vertracloud.app/v1/images/{image_id}/logs \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/images/{image_id}/logs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/images/{image_id}/logs"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/images/{image_id}/logs"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}event: log
data: Step 1/6 : FROM node:22-slim
event: log
data: Step 2/6 : WORKDIR /srv
Imágenes Docker
Logs de build de la imagen
Transmite el log de build de una imagen como un flujo de eventos de texto.
GET
/
v1
/
images
/
{image_id}
/
logs
Logs de build de la imagen
curl --request GET \
--url https://api.vertracloud.app/v1/images/{image_id}/logs \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/images/{image_id}/logs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/images/{image_id}/logs"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/images/{image_id}/logs"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}event: log
data: Step 1/6 : FROM node:22-slim
event: log
data: Step 2/6 : WORKDIR /srv
Requiere el scope
images:read cuando se llama con una clave de API.
string
requerido
El ID de la imagen.
string
La versión cuyo log de build quieres leer. Si no se indica, se lee el build más reciente.
string
Si la imagen pertenece a un workspace, el ID del workspace. Es obligatorio para los miembros del workspace que actúen sobre una imagen que no les pertenece.
Response
La respuesta es un flujo de Server-Sent Events (text/event-stream), no JSON. Primero repite el log que ya se había generado y después sigue el build en directo, con heartbeats de keep-alive. Cada evento log contiene una línea del log de build en texto plano. Se pueden tener abiertos hasta 2 flujos por imagen al mismo tiempo. Una vez terminado el build, el log del último build y el de cada versión siguen disponibles.
event: log
data: Step 1/6 : FROM node:22-slim
event: log
data: Step 2/6 : WORKDIR /srv
Error Responses
string
El código de error que indica el motivo del fallo. Valores posibles:
API_KEY_SCOPE_DENIED: La clave de API no tiene el scope necesario (403).IMAGE_NOT_FOUND: La imagen no existe o no puedes acceder a ella (404).IMAGE_VERSION_NOT_FOUND: La imagen no tiene ninguna versión con eseversion_id(404).INTERNAL_SERVER_ERROR: Fallo inesperado (500).
{
"code": "IMAGE_VERSION_NOT_FOUND"
}
Última modificación el 28 de octubre de 2026