Carica Applicazione - 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

obbligatorio

La chiave API del tuo account. Puoi trovarla nelle impostazioni del tuo account.

Upload crea un’applicazione completamente nuova a partire da un archivio zip: rileva il runtime e la versione, esegue il provisioning di un container sul cluster con l’utilizzo di RAM attualmente più basso e lo avvia. Usa questo endpoint per un primo deploy; per inviare una modifica a un’applicazione già esistente, usa invece Commit Applicazione, che è più veloce perché non ricrea il container. Chi effettua la richiesta deve avere almeno 256 MB di memoria disponibile sul proprio piano prima che il caricamento venga accettato, e lo zip è limitato a 100 MB. I campi della risposta dipendono dal tuo squarecloud.config: description e subdomain sono presenti solo se impostati lì, e language riporta il runtime e la versione rilevati. Le richieste hanno un limite di frequenza di 1 caricamento ogni 3 secondi per utente. Una volta che l’applicazione è in esecuzione, gestiscila con Start, Stop e Restart, e verificane lo stato con Ottieni lo Stato dell’Applicazione.

Parametri

file

obbligatorio

L’applicazione da caricare deve essere compressa in un file zip (.zip) e il Content-Type deve essere multipart/form-data.

Risposta

string

Indica se la chiamata è andata a buon fine. success in caso di successo, error in caso contrario.

object

Il contenuto della risposta.

Mostra Mostra oggetto

string

L’ID dell’applicazione caricata.

string

Il nome dell’applicazione caricata.

string

La descrizione dell’applicazione caricata.

string

Il sottodominio dell’applicazione caricata (null se non applicabile).

number

L’utilizzo di RAM dell’applicazione caricata in MB.

number

L’utilizzo di CPU dell’applicazione caricata.

object

Mostra Mostra oggetto

string

Il linguaggio di programmazione dell’applicazione caricata.

string

La versione consigliata del linguaggio di programmazione.

string

Il cluster su cui l’applicazione è ospitata nel 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"
        }
    }
}

Errori comuni

Codice	HTTP	Significato
`INVALID_CONTENT_TYPE`	415	Il corpo della richiesta non è `multipart/form-data`.
`INVALID_FILE`	400	Nessun campo file trovato nei dati del form.
`INVALID_FILENAME`	400	Il nome del file contiene separatori di percorso, `..` o caratteri di controllo.
`INSUFFICIENT_MEMORY`	400	L’account ha meno di 256 MB di memoria disponibile sul proprio piano.
`UPLOAD_ABORTED`	400	Il client si è disconnesso prima del completamento del caricamento.
`STORAGE_UPLOAD_FAILED`	400	Il caricamento del file nello storage è fallito; riprova più tardi.
`CLUSTER_SELECTION_FAILED`	400	Nessun cluster disponibile per ospitare l’applicazione.
`EMPTY_RESPONSE`	400	Il cluster non ha restituito una risposta utilizzabile.
`UPLOAD_FAILED`	400	Si è verificato un errore imprevisto durante l’elaborazione del caricamento.
`FILE_TOO_LARGE`	413	Il caricamento ha superato il limite di dimensione di 100 MB.
`CLUSTER_MAINTENANCE_TRY_LATER`	503	Il provisioning delle applicazioni è temporaneamente non disponibile per manutenzione.

Stato di Tutte le ApplicazioniRaccoglie informazioni sullo stato di tutte le tue applicazioni in tempo reale. Ha un rate limit di 15 richieste ogni 60 secondi.

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

​Parametri

​Risposta

​Errori comuni

Parametri

Risposta

Errori comuni