Anwendung hochladen - Square Cloud

curl --request POST \
  --url https://api.squarecloud.app/v2/apps \
  --header 'Authorization: YOUR_API_KEY' \
  --form 'file=@./application.zip'

import fs from 'node:fs';

const form = new FormData();
form.append('file', new Blob([fs.readFileSync('./application.zip')]), 'application.zip');

const response = await fetch('https://api.squarecloud.app/v2/apps', {
  method: 'POST',
  headers: { Authorization: 'YOUR_API_KEY' },
  body: form,
});

import requests

with open('application.zip', 'rb') as f:
    response = requests.post(
        'https://api.squarecloud.app/v2/apps',
        headers={'Authorization': 'YOUR_API_KEY'},
        files={'file': ('application.zip', f, 'application/zip')},
    )

{
    "status": "success",
    "response": {
        "id": "945f574e6cc14ea6818f91d7d56de101",
        "name": "Estrelinha Legal",
        "description": "Nossa, fui enviada na velocidade da luz! ✨",
        "domain": null,
        "ram": 1024,
        "cpu": 6,
        "language": {
            "name": "JavaScript",
            "version": "recommended"
        }
    }
}

string

erforderlich

Der API-Schlüssel für Ihr Konto. Sie finden ihn in Ihren Kontoeinstellungen.

Upload erstellt eine brandneue Anwendung aus einem Zip-Archiv: Es erkennt Laufzeitumgebung und Version, provisioniert einen Container auf dem Cluster mit der aktuell niedrigsten RAM-Auslastung und startet ihn. Verwende dies für die erste Bereitstellung; um eine Änderung an einer bereits bestehenden Anwendung zu übertragen, verwende stattdessen Anwendung committen, was schneller ist, da der Container nicht neu provisioniert wird. Der Aufrufer benötigt mindestens 256 MB verfügbaren Speicher in seinem Plan, damit der Upload akzeptiert wird, und das Zip ist auf 100 MB begrenzt. Die Felder der Antwort hängen von deiner squarecloud.config ab: description und subdomain sind nur vorhanden, wenn dort gesetzt, und language meldet die erkannte Laufzeitumgebung und Version. Anfragen sind auf 1 Upload alle 3 Sekunden pro Benutzer begrenzt. Sobald die Anwendung läuft, verwalte sie mit Start, Stopp und Neustart und überprüfe sie mit Anwendungsstatus abrufen.

Parameter

file

erforderlich

Die hochzuladende Anwendung muss in einer ZIP-Datei (.zip) komprimiert sein und der Content-Type muss multipart/form-data sein.

Antwort

string

Gibt an, ob der Aufruf erfolgreich war. success bei Erfolg, error andernfalls.

object

Der Inhalt der Antwort.

Anzeigen Objekt umschalten

string

Die ID der hochgeladenen Anwendung.

string

Der Name der hochgeladenen Anwendung.

string

Die Beschreibung der hochgeladenen Anwendung.

string

Die Subdomain der hochgeladenen Anwendung (null, falls nicht zutreffend).

number

Der RAM-Verbrauch der hochgeladenen Anwendung in MB.

number

Der CPU-Verbrauch der hochgeladenen Anwendung.

object

Anzeigen Objekt umschalten

string

Die Programmiersprache der hochgeladenen Anwendung.

string

Die empfohlene Version der Programmiersprache.

string

Der Cluster, in dem die Anwendung in der Cloud gehostet wird.

curl --request POST \
  --url https://api.squarecloud.app/v2/apps \
  --header 'Authorization: YOUR_API_KEY' \
  --form 'file=@./application.zip'

import fs from 'node:fs';

const form = new FormData();
form.append('file', new Blob([fs.readFileSync('./application.zip')]), 'application.zip');

const response = await fetch('https://api.squarecloud.app/v2/apps', {
  method: 'POST',
  headers: { Authorization: 'YOUR_API_KEY' },
  body: form,
});

import requests

with open('application.zip', 'rb') as f:
    response = requests.post(
        'https://api.squarecloud.app/v2/apps',
        headers={'Authorization': 'YOUR_API_KEY'},
        files={'file': ('application.zip', f, 'application/zip')},
    )

{
    "status": "success",
    "response": {
        "id": "945f574e6cc14ea6818f91d7d56de101",
        "name": "Estrelinha Legal",
        "description": "Nossa, fui enviada na velocidade da luz! ✨",
        "domain": null,
        "ram": 1024,
        "cpu": 6,
        "language": {
            "name": "JavaScript",
            "version": "recommended"
        }
    }
}

Häufige Fehler

Code	HTTP	Bedeutung
`INVALID_CONTENT_TYPE`	415	Der Request-Body ist kein `multipart/form-data`.
`INVALID_FILE`	400	Im Formulardatensatz wurde kein Dateifeld gefunden.
`INVALID_FILENAME`	400	Der Dateiname enthält Pfadtrennzeichen, `..` oder Steuerzeichen.
`INSUFFICIENT_MEMORY`	400	Das Konto hat weniger als 256 MB verfügbaren Speicher in seinem Plan.
`UPLOAD_ABORTED`	400	Der Client hat die Verbindung getrennt, bevor der Upload abgeschlossen war.
`STORAGE_UPLOAD_FAILED`	400	Die Datei konnte nicht in den Speicher hochgeladen werden; versuche es später erneut.
`CLUSTER_SELECTION_FAILED`	400	Es war kein Cluster verfügbar, um die Anwendung zu hosten.
`EMPTY_RESPONSE`	400	Der Cluster hat keine verwertbare Antwort zurückgegeben.
`UPLOAD_FAILED`	400	Beim Verarbeiten des Uploads ist ein unerwarteter Fehler aufgetreten.
`FILE_TOO_LARGE`	413	Der Upload hat das Größenlimit von 100 MB überschritten.
`CLUSTER_MAINTENANCE_TRY_LATER`	503	Die Anwendungsbereitstellung ist aufgrund von Wartungsarbeiten vorübergehend nicht verfügbar.

Zurück

Status aller AnwendungenErfasst Statusinformationen zu all deinen Anwendungen in Echtzeit. Es gilt ein Rate-Limit von 15 Anfragen alle 60 Sekunden.

Weiter

curl --request POST \
  --url https://api.squarecloud.app/v2/apps \
  --header 'Authorization: YOUR_API_KEY' \
  --form 'file=@./application.zip'

import fs from 'node:fs';

const form = new FormData();
form.append('file', new Blob([fs.readFileSync('./application.zip')]), 'application.zip');

const response = await fetch('https://api.squarecloud.app/v2/apps', {
  method: 'POST',
  headers: { Authorization: 'YOUR_API_KEY' },
  body: form,
});

import requests

with open('application.zip', 'rb') as f:
    response = requests.post(
        'https://api.squarecloud.app/v2/apps',
        headers={'Authorization': 'YOUR_API_KEY'},
        files={'file': ('application.zip', f, 'application/zip')},
    )

{
    "status": "success",
    "response": {
        "id": "945f574e6cc14ea6818f91d7d56de101",
        "name": "Estrelinha Legal",
        "description": "Nossa, fui enviada na velocidade da luz! ✨",
        "domain": null,
        "ram": 1024,
        "cpu": 6,
        "language": {
            "name": "JavaScript",
            "version": "recommended"
        }
    }
}

​Parameter

​Antwort

​Häufige Fehler

Parameter

Antwort

Häufige Fehler