Skip to main content
Jede Methode auf dieser Seite befindet sich unter client.apps und nimmt zuerst die App-ID. Eine app_id kann auch die zusammengesetzte Form <appId>-<workspaceId> einer App sein, die über einen Workspace geteilt wird.
Mit AsyncSquareCloud ist jeder der folgenden Aufrufe gleich, nur mit vorangestelltem await. Um deine Apps aufzulisten, verwende client.account.me(): Seine Liste applications enthält jede App, die der Schlüssel sehen kann.

Eine Anwendung abrufen

Optionale Felder können im Dict fehlen: Lies sie mit app.get("domain").

Status

status(app_id) gibt den aktuellen Zustand mit formatierten Werten zurück:
Übergib raw=True, um stattdessen Zahlen zu erhalten (cpu in %, ram in MB, network["total"] und network["now"] als Bytepaare [in, out]):
uptime ist ein Zeitstempel (wann die App gestartet wurde), keine Dauer. Verwende time.time() * 1000 - status["uptime"] für die Laufzeit seit dem Start, in ms.

Status aller Anwendungen

status_all() gibt in einer einzigen Anfrage eine Zusammenfassung pro App zurück, die der Schlüssel sehen kann. cpu und ram sind nur vorhanden, solange die App läuft.

Starten, Stoppen und Neustarten

Der Server hält diese Aufrufe offen, bis der Container reagiert, daher warten sie mindestens 120 s, bevor ein Timeout eintritt. Lehnt die Plattform die Aktion ab, wirft der Aufruf einen SquareCloudAPIError mit Status 409, einem code und einer leeren Nachricht (''): „Bereits gestartet“ und „bereits gestoppt“ sind ebenfalls Fehler. Wenn sie für dich einen Erfolg bedeuten, behandle sie:

Logs

logs(app_id) gibt die neueste Konsolenausgabe als einen String zurück ('', wenn es keine gibt).
Für einen Live-Stream der Logs verwende Realtime.

Metriken

metrics(app_id) gibt die letzten 24 Stunden zurück, einen Punkt alle 5 Minuten, der neueste zuerst.

Domains und Load Balancer

domains() listet die Standard- und eigenen Hostnamen aller Apps auf. load_balancers() listet die Domains, die sich mehrere Apps teilen, zusammen mit dem Limit deines Plans.
Um eine eigene Domain festzulegen, siehe Netzwerk.

Eine Anwendung löschen

Das Löschen ist endgültig. Erstelle zuerst einen Snapshot, wenn du die Dateien eventuell noch einmal brauchst.

Nächste Schritte

Commit und Upload

Eine App aus einer ZIP-Datei erstellen oder Dateien an eine App senden.

API-Referenz für Anwendungen

Die REST-Endpunkte hinter diesen Methoden.

Apps über die CLI verwalten

Dieselben Aktionen im Terminal.