Obtener una imagen
curl --request GET \
--url https://api.vertracloud.app/v1/images/{image_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/images/{image_id}', 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}"
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}"
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))
}{
"response": {
"id": "img-abc123def456",
"name": "my-api",
"description": "Node 22 with our base packages",
"owner": "account",
"status": "success",
"error": null,
"digest": "sha256:3f1c0a9d5b7e2c4a8d6f1b0e9c3a7d5f2b4e6a8c0d1f3b5a7c9e2d4f6a8b0c1e",
"uncompressed_bytes": 187432960,
"layer_count": 9,
"suggested_port": 3000,
"apps": [
{
"id": "app-abc123def456",
"name": "my-api-prod",
"version_id": "imgv-111aaa222bbb",
"outdated": false
}
],
"github": null,
"current_version_id": "imgv-111aaa222bbb",
"created_at": "2026-10-23T14:02:00Z",
"updated_at": "2026-10-23T14:09:00Z"
}
}
Imágenes Docker
Obtener una imagen
Obtiene una imagen Docker personalizada por su ID, con su versión actual y las aplicaciones que la usan.
GET
/
v1
/
images
/
{image_id}
Obtener una imagen
curl --request GET \
--url https://api.vertracloud.app/v1/images/{image_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/images/{image_id}', 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}"
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}"
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))
}{
"response": {
"id": "img-abc123def456",
"name": "my-api",
"description": "Node 22 with our base packages",
"owner": "account",
"status": "success",
"error": null,
"digest": "sha256:3f1c0a9d5b7e2c4a8d6f1b0e9c3a7d5f2b4e6a8c0d1f3b5a7c9e2d4f6a8b0c1e",
"uncompressed_bytes": 187432960,
"layer_count": 9,
"suggested_port": 3000,
"apps": [
{
"id": "app-abc123def456",
"name": "my-api-prod",
"version_id": "imgv-111aaa222bbb",
"outdated": false
}
],
"github": null,
"current_version_id": "imgv-111aaa222bbb",
"created_at": "2026-10-23T14:02:00Z",
"updated_at": "2026-10-23T14:09:00Z"
}
}
Necesita el ámbito
images:read cuando se llama con una clave de API.
string
requerido
El ID de la imagen.
string
Si la imagen pertenece a un workspace, el ID del workspace. Es obligatorio para los miembros del workspace que actúan sobre una imagen que no les pertenece.
Respuesta
object
La imagen.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
El ID de la imagen.
string
El nombre de la imagen.
string | null
La descripción de la imagen (texto libre, de hasta 128 caracteres), o
null cuando no tiene.string
account para tus propias imágenes, system para las imágenes que proporciona la plataforma (estas no se pueden modificar ni eliminar).string
own para una imagen que construiste tú, o template_copy para la copia de la imagen de una plantilla que usar una plantilla puso en tu cuenta. Una copia ocupa una ranura de imagen y solo se puede usar a través de su plantilla.object | null
Para una
template_copy, la plantilla de la que procede: template_id, template_name (por idioma) y author_display (null para una plantilla de la plataforma). null para tus propias imágenes.string
Estado del último build:
building, success o failed. Un rebuild fallido no cambia la versión actual: las aplicaciones siguen ejecutando la última versión correcta.string | null
Motivo legible del último build fallido, o
null.string | null
Digest (
sha256:...) de la versión actual, o null mientras ningún build haya tenido éxito.integer | null
Tamaño de la versión actual, sin comprimir, en bytes.
integer | null
Número de capas de la versión actual.
integer | null
Puerto sugerido para una aplicación nueva sobre esta imagen: el primer
EXPOSE del Dockerfile del último contexto de build, o 80. null en una imagen creada antes de que existiera este campo.object[]
Las aplicaciones creadas a partir de esta imagen. Cada una tiene
id, name, version_id (la versión de la imagen que ejecuta, o null) y outdated (true cuando la imagen tiene una versión más reciente; la aplicación pasa a ella en el siguiente reinicio o despliegue que pidas).object | null
El repositorio y la rama de GitHub vinculados (
repository como owner/name, branch), o null cuando la imagen no está vinculada.string | null
La versión actual de la imagen, o
null mientras ningún build haya tenido éxito.string
Cuándo se creó la imagen.
string
Cuándo se actualizó por última vez la imagen.
{
"response": {
"id": "img-abc123def456",
"name": "my-api",
"description": "Node 22 with our base packages",
"owner": "account",
"status": "success",
"error": null,
"digest": "sha256:3f1c0a9d5b7e2c4a8d6f1b0e9c3a7d5f2b4e6a8c0d1f3b5a7c9e2d4f6a8b0c1e",
"uncompressed_bytes": 187432960,
"layer_count": 9,
"suggested_port": 3000,
"apps": [
{
"id": "app-abc123def456",
"name": "my-api-prod",
"version_id": "imgv-111aaa222bbb",
"outdated": false
}
],
"github": null,
"current_version_id": "imgv-111aaa222bbb",
"created_at": "2026-10-23T14:02:00Z",
"updated_at": "2026-10-23T14:09:00Z"
}
}
Respuestas de error
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 ámbito requerido (403).IMAGE_NOT_FOUND: La imagen no existe o no puedes acceder a ella (404).INTERNAL_SERVER_ERROR: Fallo inesperado (500).
{
"code": "IMAGE_NOT_FOUND"
}
Última modificación el 28 de octubre de 2026