Carica Applicazione

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": "My Website",
        "description": "My first website on Square Cloud",
        "domain": "my-website.squareweb.app",
        "ram": 1024,
        "cpu": 6,
        "language": {
            "name": "javascript",
            "version": "recommended"
        }
    }
}

string

obbligatorio

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

Richiede una chiave API con lo scope apps:write. 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 domain 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. Il corpo della richiesta è limitato a 101 MB (un file fino a 100 MB più l’overhead del form): una richiesta più grande viene rifiutata con 413 FILE_TOO_LARGE mentre è ancora in fase di caricamento. Viene letta solo la prima parte di tipo file; gli altri campi del form vengono ignorati. 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 affermativo, 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

L’host completo dell’applicazione, ad esempio my-app.squareweb.app. Presente solo quando squarecloud.config imposta SUBDOMAIN. È lo stesso campo restituito da Ottieni Informazioni Applicazione.

number

La memoria allocata all’applicazione, in MB.

number

La CPU allocata all’applicazione.

object

Mostra Mostra oggetto

string

Il runtime rilevato, in minuscolo (ad esempio javascript), come in Ottieni Informazioni Applicazione.

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": "My Website",
        "description": "My first website on Square Cloud",
        "domain": "my-website.squareweb.app",
        "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 file ha superato 100 MB o il corpo della richiesta ha superato 101 MB.
`CLUSTER_MAINTENANCE_TRY_LATER`	503	Il provisioning delle applicazioni è temporaneamente non disponibile per manutenzione.
`UPLOAD_BUSY`	503	Troppi caricamenti in elaborazione in questo momento; riprova tra un istante.

Vedi anche

CLI: squarecloud upload
SDK: api.apps.create() (JavaScript), client.apps.create() (Python), c.Apps.Create() (Go)

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": "My Website",
        "description": "My first website on Square Cloud",
        "domain": "my-website.squareweb.app",
        "ram": 1024,
        "cpu": 6,
        "language": {
            "name": "javascript",
            "version": "recommended"
        }
    }
}

Primi passi

Account

Applicazioni

Database

Workspace

IA

Parametri

Risposta

Errori comuni

Vedi anche

​Parametri

​Risposta

​Errori comuni

​Vedi anche

Parametri

Risposta

Errori comuni

Vedi anche