Elenca gli snapshot dell'applicazione

GET

apps

{app_id}

snapshots

Elenca gli snapshot dell'applicazione

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

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

fetch('https://api.squarecloud.app/v2/apps/{app_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/apps/{app_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/apps/{app_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/apps/{app_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": "1d2cdc0d6ebd435c91315c6329d12eab_javascript_manual",
      "size": 12900705,
      "modified": "2024-06-27T06:23:42.326Z",
      "key": "AWSAccessKeyId=access key",
      "version_id": "3HL4kqtJlcpXroDTDmJ.rmSpXd3dIbrHY",
      "url": "https://snapshots.squarecloud.app/applications/<account_id>/<name>.zip?<signed-query-string>",
      "runtime": "javascript",
      "origin": "manual"
    },
    {
      "name": "1d2cdc0d6ebd435c91315c6329d12eab_javascript_automatic",
      "size": 12900705,
      "modified": "2024-06-26T07:05:40.000Z",
      "key": "AWSAccessKeyId=access key",
      "version_id": "Qm8cFZ2vY1tBn4LhXw0e.KpR7sUjD9aGz",
      "url": "https://snapshots.squarecloud.app/applications/<account_id>/<name>.zip?<signed-query-string>",
      "runtime": "javascript",
      "origin": "automatic"
    },
    {
      "name": "1d2cdc0d6ebd435c91315c6329d12eab",
      "size": 12900705,
      "modified": "2024-06-25T05:15:51.533Z",
      "key": "AWSAccessKeyId=access key",
      "version_id": "yT5wN0cE3hJ.bV8mLq2XoZr6dAiK4sPf",
      "url": "https://snapshots.squarecloud.app/applications/<account_id>/<name>.zip?<signed-query-string>",
      "runtime": null,
      "origin": null
    }
  ]
}

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 Snapshot restituisce ogni snapshot memorizzato per un’applicazione, ciascuno con la sua dimensione, la data dell’ultima modifica e un url firmato per scaricarlo. Usalo per creare un selettore di ripristino, oppure per confermare che uno snapshot creato con Crea Snapshot abbia terminato la generazione dopo una risposta 202 SNAPSHOT_PROCESSING: effettua il polling di questo endpoint invece di rieseguire la richiesta di creazione. Il risultato viene memorizzato nella cache per 30 minuti per coppia proprietario/applicazione, quindi uno snapshot appena generato in background potrebbe impiegare un po’ di tempo prima di comparire qui, anche dopo che il cluster lo ha scritto. Una volta ottenuti il name e il version_id di uno snapshot, passali come snapshotId e versionId a Ripristina Snapshot per riportare l’applicazione a quel punto. Gli snapshot sono disponibili solo con un piano attivo; la quota giornaliera di snapshot scala in base all’allocazione di RAM dell’applicazione. Sulle applicazioni condivise in un workspace, il chiamante deve avere il ruolo admin.

Parametri

string

obbligatorio

L’ID dell’applicazione. Puoi trovarlo nell’URL della dashboard della tua applicazione.

Risposta

string

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

object

Il contenuto della risposta.

Mostra Mostra oggetto

string

Il nome dello snapshot: l’ID dell’applicazione, opzionalmente con i suffissi _<runtime> e _<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": "1d2cdc0d6ebd435c91315c6329d12eab_javascript_manual",
      "size": 12900705,
      "modified": "2024-06-27T06:23:42.326Z",
      "key": "AWSAccessKeyId=access key",
      "version_id": "3HL4kqtJlcpXroDTDmJ.rmSpXd3dIbrHY",
      "url": "https://snapshots.squarecloud.app/applications/<account_id>/<name>.zip?<signed-query-string>",
      "runtime": "javascript",
      "origin": "manual"
    },
    {
      "name": "1d2cdc0d6ebd435c91315c6329d12eab_javascript_automatic",
      "size": 12900705,
      "modified": "2024-06-26T07:05:40.000Z",
      "key": "AWSAccessKeyId=access key",
      "version_id": "Qm8cFZ2vY1tBn4LhXw0e.KpR7sUjD9aGz",
      "url": "https://snapshots.squarecloud.app/applications/<account_id>/<name>.zip?<signed-query-string>",
      "runtime": "javascript",
      "origin": "automatic"
    },
    {
      "name": "1d2cdc0d6ebd435c91315c6329d12eab",
      "size": 12900705,
      "modified": "2024-06-25T05:15:51.533Z",
      "key": "AWSAccessKeyId=access key",
      "version_id": "yT5wN0cE3hJ.bV8mLq2XoZr6dAiK4sPf",
      "url": "https://snapshots.squarecloud.app/applications/<account_id>/<name>.zip?<signed-query-string>",
      "runtime": null,
      "origin": null
    }
  ]
}

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

Errori comuni

Codice	HTTP	Significato
`APP_NOT_FOUND`	404	Non esiste nessuna applicazione con questo ID per il proprietario risolto.

Vedi anche

CLI: squarecloud app snapshot list
SDK: api.apps.snapshots.list() (JavaScript), client.apps.snapshots.list() (Python), c.Apps.Snapshots.List() (Go)

Elenca gli snapshot dell'applicazione

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

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

fetch('https://api.squarecloud.app/v2/apps/{app_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/apps/{app_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/apps/{app_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/apps/{app_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": "1d2cdc0d6ebd435c91315c6329d12eab_javascript_manual",
      "size": 12900705,
      "modified": "2024-06-27T06:23:42.326Z",
      "key": "AWSAccessKeyId=access key",
      "version_id": "3HL4kqtJlcpXroDTDmJ.rmSpXd3dIbrHY",
      "url": "https://snapshots.squarecloud.app/applications/<account_id>/<name>.zip?<signed-query-string>",
      "runtime": "javascript",
      "origin": "manual"
    },
    {
      "name": "1d2cdc0d6ebd435c91315c6329d12eab_javascript_automatic",
      "size": 12900705,
      "modified": "2024-06-26T07:05:40.000Z",
      "key": "AWSAccessKeyId=access key",
      "version_id": "Qm8cFZ2vY1tBn4LhXw0e.KpR7sUjD9aGz",
      "url": "https://snapshots.squarecloud.app/applications/<account_id>/<name>.zip?<signed-query-string>",
      "runtime": "javascript",
      "origin": "automatic"
    },
    {
      "name": "1d2cdc0d6ebd435c91315c6329d12eab",
      "size": 12900705,
      "modified": "2024-06-25T05:15:51.533Z",
      "key": "AWSAccessKeyId=access key",
      "version_id": "yT5wN0cE3hJ.bV8mLq2XoZr6dAiK4sPf",
      "url": "https://snapshots.squarecloud.app/applications/<account_id>/<name>.zip?<signed-query-string>",
      "runtime": null,
      "origin": null
    }
  ]
}

Primi passi

Account

Applicazioni

Database

Workspace

IA

Elenca gli snapshot dell'applicazione

Parametri

Risposta

Errori comuni

Vedi anche

​Parametri

​Risposta

​Errori comuni

​Vedi anche

Parametri

Risposta

Errori comuni

Vedi anche