Elenca gli snapshot del database

GET

databases

{database_id}

snapshots

Elenca gli snapshot del database

curl --request GET \
  --url https://api.squarecloud.app/v2/databases/{database_id}/snapshots \
  --header 'Authorization: <authorization>'

import requests

url = "https://api.squarecloud.app/v2/databases/{database_id}/snapshots"

headers = {"Authorization": "<authorization>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://api.squarecloud.app/v2/databases/{database_id}/snapshots', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.squarecloud.app/v2/databases/{database_id}/snapshots",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.squarecloud.app/v2/databases/{database_id}/snapshots"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.squarecloud.app/v2/databases/{database_id}/snapshots")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
  "status":"success",
  "response":[
    {
      "name":"a14b8d5e1cb7405a851eb4c075506121_mongo_manual",
      "size":10644463,
      "modified":"2025-08-13T13:29:11.263Z",
      "key":"AWSAccessKeyId=accesskey&Expires=1757683751&Signature=VZ03MSxcNw3%2FtPezXv0IhTs0jq4%3D&versionId=45ec0b49-9af6-445e-a55c-abd7ec5278b2",
      "version_id":"45ec0b49-9af6-445e-a55c-abd7ec5278b2",
      "url":"https://snapshots.squarecloud.app/databases/<account_id>/<name>.zip?<signed-query-string>",
      "runtime":"mongo",
      "origin":"manual"
    },
    {
      "name":"a14b8d5e1cb7405a851eb4c075506121_mongo_automatic",
      "size":2742383,
      "modified":"2025-08-13T00:01:47.010Z",
      "key":"AWSAccessKeyId=accesskey&Expires=1757683751&Signature=7zw5apjyaOd1xPZl3gRgp8Y4yEs%3D&versionId=f65e1378-8717-45c5-8aec-bb233eedb5ce",
      "version_id":"f65e1378-8717-45c5-8aec-bb233eedb5ce",
      "url":"https://snapshots.squarecloud.app/databases/<account_id>/<name>.zip?<signed-query-string>",
      "runtime":"mongo",
      "origin":"automatic"
    }
  ]
}

string

obbligatorio

La chiave API del tuo account. Puoi trovarla nelle impostazioni del tuo account.

Richiede una chiave API con lo scope snapshots:read. Elenca tutti gli snapshot memorizzati per un database, dal più recente, con dimensione e data dell’ultima modifica per ciascuno. Usalo per costruire un selettore di ripristino in una dashboard, oppure per effettuare polling dopo che una chiamata a Crea Snapshot ha restituito 202 SNAPSHOT_PROCESSING, e confermare che il file sia arrivato. Ogni elemento include un url di download firmato, valido per 30 giorni, e un version_id da passare come versionId durante il ripristino. Le risposte vengono messe in cache per 30 minuti per utente e database, quindi uno snapshot appena generato potrebbe impiegare un po’ di tempo prima di comparire qui. Per ripristinare uno di questi snapshot, consulta Ripristina Snapshot.

Parametri

string

obbligatorio

L’ID del database.

Risposta

string

Indica se la chiamata è andata a buon fine: success in caso affermativo, error in caso contrario.

array

Il contenuto della risposta.

Mostra Espandi oggetto

string

Il nome dello snapshot: l’ID del database con il suffisso _<type> e, negli snapshot più recenti, _<origin>. Passalo invariato come snapshotId al ripristino.

number

Dimensione del backup in byte.

string

Data dell’ultima modifica del backup.

string

La query string firmata dell’URL di download.

string

La versione dello snapshot. Passala come versionId durante il ripristino.

string

Un URL firmato che scarica lo snapshot, valido per 30 giorni.

string | null

Runtime da cui è stato preso lo snapshot: il linguaggio dell’applicazione (javascript, python, rust…) o il motore del database (mongo, mysql, postgres, redis). null negli snapshot presi prima che esistesse questo campo.

string | null

Come è stato creato lo snapshot: manual (richiesto via API, dashboard o CLI) o automatic (lo snapshot giornaliero pianificato). null negli snapshot più vecchi.

{
  "status":"success",
  "response":[
    {
      "name":"a14b8d5e1cb7405a851eb4c075506121_mongo_manual",
      "size":10644463,
      "modified":"2025-08-13T13:29:11.263Z",
      "key":"AWSAccessKeyId=accesskey&Expires=1757683751&Signature=VZ03MSxcNw3%2FtPezXv0IhTs0jq4%3D&versionId=45ec0b49-9af6-445e-a55c-abd7ec5278b2",
      "version_id":"45ec0b49-9af6-445e-a55c-abd7ec5278b2",
      "url":"https://snapshots.squarecloud.app/databases/<account_id>/<name>.zip?<signed-query-string>",
      "runtime":"mongo",
      "origin":"manual"
    },
    {
      "name":"a14b8d5e1cb7405a851eb4c075506121_mongo_automatic",
      "size":2742383,
      "modified":"2025-08-13T00:01:47.010Z",
      "key":"AWSAccessKeyId=accesskey&Expires=1757683751&Signature=7zw5apjyaOd1xPZl3gRgp8Y4yEs%3D&versionId=f65e1378-8717-45c5-8aec-bb233eedb5ce",
      "version_id":"f65e1378-8717-45c5-8aec-bb233eedb5ce",
      "url":"https://snapshots.squarecloud.app/databases/<account_id>/<name>.zip?<signed-query-string>",
      "runtime":"mongo",
      "origin":"automatic"
    }
  ]
}

Scarica uno snapshot dal suo url. Il link resta valido per 30 giorni.

Errori comuni

Codice	HTTP	Significato
`DATABASE_NOT_FOUND`	404	Il database non esiste o non appartiene al chiamante.

Vedi anche

CLI: squarecloud db snapshot list
SDK: api.databases.snapshots.list() (JavaScript), client.databases.snapshots.list() (Python), c.Databases.Snapshots.List() (Go)

Elenca gli snapshot del database

curl --request GET \
  --url https://api.squarecloud.app/v2/databases/{database_id}/snapshots \
  --header 'Authorization: <authorization>'

import requests

url = "https://api.squarecloud.app/v2/databases/{database_id}/snapshots"

headers = {"Authorization": "<authorization>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://api.squarecloud.app/v2/databases/{database_id}/snapshots', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.squarecloud.app/v2/databases/{database_id}/snapshots",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.squarecloud.app/v2/databases/{database_id}/snapshots"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.squarecloud.app/v2/databases/{database_id}/snapshots")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
  "status":"success",
  "response":[
    {
      "name":"a14b8d5e1cb7405a851eb4c075506121_mongo_manual",
      "size":10644463,
      "modified":"2025-08-13T13:29:11.263Z",
      "key":"AWSAccessKeyId=accesskey&Expires=1757683751&Signature=VZ03MSxcNw3%2FtPezXv0IhTs0jq4%3D&versionId=45ec0b49-9af6-445e-a55c-abd7ec5278b2",
      "version_id":"45ec0b49-9af6-445e-a55c-abd7ec5278b2",
      "url":"https://snapshots.squarecloud.app/databases/<account_id>/<name>.zip?<signed-query-string>",
      "runtime":"mongo",
      "origin":"manual"
    },
    {
      "name":"a14b8d5e1cb7405a851eb4c075506121_mongo_automatic",
      "size":2742383,
      "modified":"2025-08-13T00:01:47.010Z",
      "key":"AWSAccessKeyId=accesskey&Expires=1757683751&Signature=7zw5apjyaOd1xPZl3gRgp8Y4yEs%3D&versionId=f65e1378-8717-45c5-8aec-bb233eedb5ce",
      "version_id":"f65e1378-8717-45c5-8aec-bb233eedb5ce",
      "url":"https://snapshots.squarecloud.app/databases/<account_id>/<name>.zip?<signed-query-string>",
      "runtime":"mongo",
      "origin":"automatic"
    }
  ]
}

Primi passi

Account

Applicazioni

Database

Workspace

IA

Elenca gli snapshot del database

Parametri

Risposta

Errori comuni

Vedi anche

​Parametri

​Risposta

​Errori comuni

​Vedi anche

Parametri

Risposta

Errori comuni

Vedi anche