Subir Aplicación

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

requerido

La clave de API de tu cuenta. Puedes encontrarla en la configuración de tu cuenta.

Requiere una clave de API con el scope apps:write. Upload crea una aplicación totalmente nueva a partir de un archivo zip: detecta el runtime y la versión, aprovisiona un contenedor en el cluster que actualmente tenga el menor uso de RAM, y lo inicia. Úsalo para un primer deploy; para enviar un cambio a una aplicación que ya existe, usa Enviar Commit a la Aplicación en su lugar, que es más rápido porque no vuelve a aprovisionar el contenedor. Quien realiza la llamada necesita al menos 256 MB de memoria disponible en su plan antes de que se acepte la subida, y el zip tiene un límite de 100 MB. Los campos de la respuesta dependen de tu squarecloud.config: description y domain solo están presentes cuando se configuran allí, y language reporta el runtime y la versión detectados. Las solicitudes tienen un límite de 1 subida cada 3 segundos por usuario. El cuerpo de la solicitud está limitado a 101 MB (un archivo de hasta 100 MB más la sobrecarga del formulario): una solicitud mayor se rechaza con 413 FILE_TOO_LARGE mientras aún se está subiendo. Solo se lee la primera parte de archivo; los campos adicionales del formulario se ignoran. Una vez que la aplicación esté en ejecución, gestiónala con Iniciar, Detener y Reiniciar, y consulta su estado con Obtener Estado de la Aplicación.

Parámetros

file

requerido

La aplicación que se va a subir debe estar comprimida en un archivo zip (.zip) y el Content-Type debe ser multipart/form-data.

Respuesta

string

Indica si la llamada fue exitosa: success si lo fue, error si no.

object

El contenido de la respuesta.

Mostrar Alternar objeto

string

El ID de la aplicación subida.

string

El nombre de la aplicación subida.

string

La descripción de la aplicación subida.

string

El host completo de la aplicación, por ejemplo my-app.squareweb.app. Solo está presente cuando squarecloud.config define SUBDOMAIN. Es el mismo campo que devuelve Obtener información de la aplicación.

number

La memoria asignada a la aplicación, en MB.

number

La CPU asignada a la aplicación.

object

Mostrar Alternar objeto

string

El runtime detectado, en minúsculas (por ejemplo javascript), como en Obtener información de la aplicación.

string

La versión recomendada del lenguaje de programación.

string

El cluster donde la aplicación está alojada en la nube.

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

Errores comunes

Código	HTTP	Significado
`INVALID_CONTENT_TYPE`	415	El cuerpo de la solicitud no es `multipart/form-data`.
`INVALID_FILE`	400	No se encontró ningún campo de archivo en los datos del formulario.
`INVALID_FILENAME`	400	El nombre del archivo contiene separadores de ruta, `..` o caracteres de control.
`INSUFFICIENT_MEMORY`	400	La cuenta tiene menos de 256 MB de memoria disponible en su plan.
`UPLOAD_ABORTED`	400	El cliente se desconectó antes de que terminara la subida.
`STORAGE_UPLOAD_FAILED`	400	El archivo no se pudo subir al almacenamiento; vuelve a intentarlo más tarde.
`CLUSTER_SELECTION_FAILED`	400	No había ningún cluster disponible para alojar la aplicación.
`EMPTY_RESPONSE`	400	El cluster no devolvió una respuesta utilizable.
`UPLOAD_FAILED`	400	Ocurrió un error inesperado al procesar la subida.
`FILE_TOO_LARGE`	413	El archivo superó los 100 MB o el cuerpo de la solicitud superó los 101 MB.
`CLUSTER_MAINTENANCE_TRY_LATER`	503	El aprovisionamiento de aplicaciones no está disponible temporalmente por mantenimiento.
`UPLOAD_BUSY`	503	Se están procesando demasiadas subidas en este momento; inténtalo de nuevo en un momento.

Relacionado

CLI: squarecloud upload
SDKs: 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"
        }
    }
}

Primeros pasos

Cuenta

Aplicaciones

Bases de datos

Workspaces

IA

Parámetros

Respuesta

Errores comunes

Relacionado

​Parámetros

​Respuesta

​Errores comunes

​Relacionado

Parámetros

Respuesta

Errores comunes

Relacionado