Logo ZenifraZenifra

Atualizar Imagem de Deploy

Aprenda como atualizar a imagem Docker do seu projeto via API.

Atualizar Imagem de Deploy

Atualiza a imagem Docker do projeto para iniciar um novo deploy.

PATCH /project/:id/image

Parâmetros de Path

ParâmetroTipoDescrição
idstringID do projeto (ObjectId)

Body

CampoTipoObrigatórioDescrição
imagestringSimNome da imagem Docker com registry e tag (ex: docker.io/nginx:perl, myregistry.com/myapp:v1.0). Importante: Sempre use uma tag específica e imutável (como v1.0.0) em vez de latest para evitar obter imagens diferentes inesperadamente.

Exemplo

{
  "image": "docker.io/nginx:perl"
}

Resposta

{
  "status": "success",
  "data": {
    "deployment_id": "deploy_abc123",
    "status": "deploying"
  }
}

Exemplos

curl

curl -X PATCH "https://api.zenifra.com/v1/project/507f1f77bcf86cd799439011/image" \
  -H "x-api-key: sua-api-key" \
  -H "Content-Type: application/json" \
  -d '{"image": "docker.io/nginx:perl"}'

Python

import requests

API_KEY = "sua-api-key"
PROJECT_ID = "507f1f77bcf86cd799439011"

response = requests.patch(
    f"https://api.zenifra.com/v1/project/{PROJECT_ID}/image",
    headers={"x-api-key": API_KEY},
    json={"image": "docker.io/nginx:perl"}
)
print(response.json())

Node.js

const axios = require('axios');

const API_KEY = 'sua-api-key';
const PROJECT_ID = '507f1f77bcf86cd799439011';

axios.patch(
  `https://api.zenifra.com/v1/project/${PROJECT_ID}/image`,
  { image: 'docker.io/nginx:perl' },
  { headers: { 'x-api-key': API_KEY } }
).then(res => console.log(res.data));