Obter imagem
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"
}
}
Imagens Docker
Obter imagem
Retorna uma imagem Docker personalizada pelo seu ID, com a versão atual e as aplicações que a usam.
GET
/
v1
/
images
/
{image_id}
Obter imagem
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"
}
}
Exige o escopo
images:read quando chamada com uma chave de API.
string
obrigatório
O ID da imagem.
string
Se a imagem pertencer a um workspace, o ID do workspace. Obrigatório para membros do workspace que atuam sobre uma imagem que não lhes pertence.
Resposta
object
A imagem.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
O ID da imagem.
string
O nome da imagem.
string | null
A descrição da imagem (texto livre, de até 128 caracteres), ou
null quando não tem uma.string
account para as suas imagens, system para imagens fornecidas pela plataforma (estas não podem ser alteradas nem excluídas).string
own para uma imagem que você criou, ou template_copy para a cópia da imagem de um template que usar um template colocou na sua conta. Uma cópia ocupa um slot de imagem e só pode ser usada por meio do seu template.object | null
Para um
template_copy, o template de origem: template_id, template_name (por idioma) e author_display (null para um template da plataforma). null para as suas próprias imagens.string
Estado do build mais recente:
building, success ou failed. Um rebuild que falha não altera a versão atual: as aplicações continuam rodando a última versão boa.string | null
Motivo legível do build mais recente que falhou, ou
null.string | null
Digest (
sha256:...) da versão atual, ou null enquanto nenhum build teve sucesso.integer | null
Tamanho da versão atual, descompactada, em bytes.
integer | null
Número de camadas da versão atual.
integer | null
Porta sugerida para uma nova aplicação nesta imagem: o primeiro
EXPOSE do Dockerfile do contexto do build mais recente, ou 80. null para uma imagem criada antes deste campo existir.object[]
As aplicações criadas a partir desta imagem. Cada uma tem
id, name, version_id (a versão da imagem que ela executa, ou null) e outdated (true quando a imagem tem uma versão mais nova; a aplicação passa para ela no próximo restart ou deploy que você pedir).object | null
O repositório e o branch do GitHub vinculados (
repository como owner/name, branch), ou null quando a imagem não está vinculada.string | null
A versão atual da imagem, ou
null enquanto nenhum build teve sucesso.string
Quando a imagem foi criada.
string
Quando a imagem foi atualizada pela última vez.
{
"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"
}
}
Respostas de erro
string
O código de erro que indica o motivo da falha. Valores possíveis:
API_KEY_SCOPE_DENIED: A chave de API não tem o escopo exigido (403).IMAGE_NOT_FOUND: A imagem não existe ou você não tem acesso a ela (404).INTERNAL_SERVER_ERROR: Falha inesperada (500).
{
"code": "IMAGE_NOT_FOUND"
}
Última modificação em 28 de outubro de 2026