Snapshots einer Anwendung auflisten

GET

apps

{app_id}

snapshots

Snapshots einer Anwendung auflisten

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

erforderlich

Der API-Schlüssel für dein Konto. Du findest ihn in deinen Kontoeinstellungen.

Erfordert einen API-Schlüssel mit dem Scope snapshots:read. Snapshots auflisten liefert jeden für eine Anwendung gespeicherten Snapshot zurück, jeweils mit Größe, Datum der letzten Änderung und einer signierten url zum Herunterladen. Nutze es, um eine Wiederherstellungsauswahl zu erstellen oder um zu bestätigen, dass ein mit Snapshot erstellen erzeugter Snapshot nach einer 202 SNAPSHOT_PROCESSING-Antwort fertig generiert wurde. Frage dazu diesen Endpoint ab, anstatt erneut bei „create“ zu posten. Das Ergebnis wird 30 Minuten lang pro Kombination aus Eigentümer und Anwendung zwischengespeichert. Ein Snapshot, der im Hintergrund gerade fertiggestellt wurde, kann daher noch eine kurze Weile brauchen, bis er hier erscheint, selbst nachdem der Cluster ihn bereits geschrieben hat. Sobald du name und version_id eines Snapshots hast, übergib sie als snapshotId und versionId an Snapshot wiederherstellen, um die Anwendung auf diesen Zeitpunkt zurückzusetzen. Snapshots sind nur mit einem aktiven Plan verfügbar, das tägliche Snapshot-Kontingent skaliert mit der RAM-Zuteilung der Anwendung. Bei Workspace-geteilten Anwendungen benötigt der Aufrufer die Rolle admin.

Parameter

string

erforderlich

Die ID der Anwendung. Du findest sie in der URL des Dashboards deiner Anwendung.

Antwort

string

Gibt an, ob der Aufruf erfolgreich war: success, wenn ja, error, wenn nicht.

object

Der Inhalt der Antwort.

Anzeigen Objekt umschalten

string

Der Name des Snapshots: die Anwendungs-ID, optional mit den Suffixen _<runtime> und _<origin>. Übergib ihn beim Wiederherstellen unverändert als snapshotId.

number

Größe des Backups in Bytes.

string

Datum der letzten Änderung des Backups.

string

Der signierte Query-String der Download-URL.

string

Die Version des Snapshots. Übergib sie beim Wiederherstellen als versionId.

string

Eine signierte URL, die den Snapshot herunterlädt, 30 Tage lang gültig.

string | null

Runtime, von der der Snapshot stammt: die Sprache der Anwendung (javascript, python, rust…) oder die Datenbank-Engine (mongo, mysql, postgres, redis). null bei Snapshots, die vor Einführung dieses Feldes erstellt wurden.

string | null

Wie der Snapshot erstellt wurde: manual (über API, Dashboard oder CLI angefordert) oder automatic (der täglich geplante Snapshot). null bei älteren Snapshots.

{
  "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
    }
  ]
}

Lade einen Snapshot über seine url herunter. Der Link bleibt 30 Tage lang gültig.

Häufige Fehler

Code	HTTP	Bedeutung
`APP_NOT_FOUND`	404	Für die aufgelöste Eigentümer-ID existiert keine Anwendung mit dieser ID.

Siehe auch

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

Snapshots einer Anwendung auflisten

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
    }
  ]
}

Erste Schritte

Konto

Anwendungen

Datenbanken

Workspaces

KI

Snapshots einer Anwendung auflisten

Parameter

Antwort

Häufige Fehler

Siehe auch

​Parameter

​Antwort

​Häufige Fehler

​Siehe auch

Parameter

Antwort

Häufige Fehler

Siehe auch