Restaurar snapshot da aplicação
curl --request POST \
--url https://api.vertracloud.app/v1/users/{id}/snapshots/{snapshot_id}/restore \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"resource_id": "<string>",
"restore_image_version": true
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({resource_id: '<string>', restore_image_version: true})
};
fetch('https://api.vertracloud.app/v1/users/{id}/snapshots/{snapshot_id}/restore', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/users/{id}/snapshots/{snapshot_id}/restore"
payload = {
"resource_id": "<string>",
"restore_image_version": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/users/{id}/snapshots/{snapshot_id}/restore"
payload := strings.NewReader("{\n \"resource_id\": \"<string>\",\n \"restore_image_version\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"response": {
"message": "Restoration started and rebuild triggered"
}
}
Snapshots
Restaurar snapshot da aplicação
Restaura um snapshot especificado em uma aplicação ou banco de dados e, em seguida, refaz o build e reinicia o recurso automaticamente.
POST
/
v1
/
users
/
{id}
/
snapshots
/
{snapshot_id}
/
restore
Restaurar snapshot da aplicação
curl --request POST \
--url https://api.vertracloud.app/v1/users/{id}/snapshots/{snapshot_id}/restore \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"resource_id": "<string>",
"restore_image_version": true
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({resource_id: '<string>', restore_image_version: true})
};
fetch('https://api.vertracloud.app/v1/users/{id}/snapshots/{snapshot_id}/restore', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/users/{id}/snapshots/{snapshot_id}/restore"
payload = {
"resource_id": "<string>",
"restore_image_version": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/users/{id}/snapshots/{snapshot_id}/restore"
payload := strings.NewReader("{\n \"resource_id\": \"<string>\",\n \"restore_image_version\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"response": {
"message": "Restoration started and rebuild triggered"
}
}
string
obrigatório
O ID da aplicação ou do banco de dados para o qual o snapshot será restaurado.
string
obrigatório
O ID do snapshot a restaurar.
string
obrigatório
O tipo do recurso. Valores possíveis:
applications, databases.string
Opcional. Substitui o recurso de destino para restauração entre recursos. Se omitido, restaura no recurso informado em
id.boolean
Somente para uma aplicação que roda uma imagem Docker personalizada. Quando
true, a restauração também volta para a versão da imagem que a aplicação rodava no momento do snapshot, se ela ainda existir. Padrão false: só os dados são restaurados e a aplicação mantém a versão atual da imagem.Resposta
object
Confirmação de que o processo de restauração foi iniciado.
{
"response": {
"message": "Restoration started and rebuild triggered"
}
}
Respostas de erro
string
O código de erro que indica o motivo da falha. Valores possíveis:
AUTH_TOKEN_MISSING,API_KEY_INVALID,SESSION_REVOKED: o headerAuthorizationestá ausente, a chave de API é inválida ou a sessão do painel foi revogada (401).API_KEY_IP_DENIED,API_KEY_SCOPE_DENIED: a chave de API é usada a partir de um IP fora da sua allowlist, ou não tem o escopo que a rota exige (403).USER_NOT_FOUND: o usuário autenticado não foi encontrado.APP_NOT_FOUND: a aplicação informada não existe.DATABASE_NOT_FOUND: o banco de dados informado não existe.ACCESS_DENIED: o usuário não é dono do recurso ou do snapshot.RESTORE_COOLDOWN: uma operação de restauração foi feita neste recurso há pouco tempo. Aguarde antes de tentar de novo.TYPE_MISMATCH: o tipo do recurso do snapshot não corresponde ao tipo do recurso de destino.SNAPSHOT_ENGINE_MISMATCH: o snapshot pertence a um motor de banco de dados diferente do de destino (400).SNAPSHOT_VERSION_NEWER: o snapshot foi feito em uma versão principal mais nova do que a do banco de dados de destino; nada é alterado (400).SNAPSHOT_NOT_FOUND: o snapshot informado não existe.INVALID_ZIP_STRUCTURE: o arquivo do snapshot está danificado, ou um snapshot de aplicação não tem arquivos (400). A restauração é recusada antes de qualquer alteração: os arquivos da aplicação e o banco de dados permanecem como estavam.OPERATION_IN_PROGRESS: outra operação de ciclo de vida no mesmo recurso já está em execução (409). Nada foi restaurado — aguarde alguns segundos e tente de novo. Veja Códigos de erro comuns.SNAPSHOT_IMPORT_FAILED: a restauração falhou ao carregar os dados (500). O banco de dados fica em execução e vazio; o snapshot continua disponível para tentar de novo.INTERNAL_SERVER_ERROR: ocorreu um erro inesperado no servidor.
{
"code": "AUTH_TOKEN_MISSING"
}
{
"code": "ACCESS_DENIED"
}
{
"code": "APP_NOT_FOUND"
}
{
"code": "SNAPSHOT_NOT_FOUND"
}
{
"code": "RESTORE_COOLDOWN"
}
{
"code": "TYPE_MISMATCH",
"message": "Cannot restore snapshot to a different resource type"
}
{
"code": "SNAPSHOT_ENGINE_MISMATCH"
}
{
"code": "SNAPSHOT_IMPORT_FAILED"
}
Última modificação em 28 de outubro de 2026