Skip to main content
Jede Methode auf dieser Seite befindet sich unter api.apps und nimmt zuerst die App-ID. Eine appId kann auch die zusammengesetzte Form <appId>-<workspaceId> einer App sein, die über einen Workspace geteilt wird.
Um deine Apps aufzulisten, verwende api.account.me(): Sein Array applications enthält jede App, die der Schlüssel sehen kann.

Eine Anwendung abrufen

Status

status(appId) 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 Date.now() - status.uptime für die Laufzeit seit dem Start.

Status aller Anwendungen

statusAll() 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(appId) gibt die neueste Konsolenausgabe als einen String zurück ("", wenn es keine gibt).
Für einen Live-Stream der Logs verwende Realtime.

Metriken

metrics(appId) 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. loadBalancers() 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.