Skip to main content
Toutes les méthodes de cette page se trouvent sur api.apps et prennent d’abord l’identifiant de l’application. Un appId peut aussi être l’identifiant composite <appId>-<workspaceId> d’une application partagée via un workspace.
Pour lister vos applications, utilisez api.account.me() : son tableau applications contient toutes les applications que la clé peut voir.

Récupérer une application

Statut

status(appId) renvoie l’état en direct avec des valeurs formatées :
Passez { raw: true } pour obtenir des nombres à la place (cpu en %, ram en Mo, network.total et network.now sous forme de paires d’octets [in, out]) :
uptime est un horodatage (le moment où l’application a démarré), pas une durée. Utilisez Date.now() - status.uptime pour savoir depuis combien de temps elle tourne.

Statut de toutes les applications

statusAll() renvoie un résumé par application que la clé peut voir, en une seule requête. cpu et ram ne sont présents que pendant que l’application s’exécute.

Démarrer, arrêter et redémarrer

Le serveur maintient ces appels ouverts jusqu’à ce que le conteneur agisse : ils attendent donc au moins 120 s avant d’expirer. Lorsque la plateforme refuse l’action, l’appel lève une SquareCloudAPIError avec le statut 409, un code et un message vide : « Déjà démarrée » et « déjà arrêtée » sont aussi des erreurs. Si elles signifient un succès pour vous, gérez-les :

Logs

logs(appId) renvoie la dernière sortie de la console sous forme d’une seule chaîne ("" lorsqu’il n’y en a pas).
Pour un flux de logs en direct, utilisez le Temps réel.

Métriques

metrics(appId) renvoie les dernières 24 heures, un point toutes les 5 minutes, du plus récent au plus ancien.

Domaines et load balancers

domains() liste les noms d’hôte par défaut et personnalisés de chaque application. loadBalancers() liste les domaines partagés par plusieurs applications, avec la limite de votre plan.
Pour définir un domaine personnalisé, voir Réseau.

Supprimer une application

La suppression est définitive. Créez d’abord un snapshot si vous risquez d’avoir de nouveau besoin des fichiers.

Prochaines étapes

Commit et envoi

Créez une application à partir d’un zip ou envoyez-lui des fichiers.

Référence de l'API des applications

Les endpoints REST derrière ces méthodes.

Gérer les applications depuis la CLI

Les mêmes actions depuis le terminal.