curl -X POST https://api.vertracloud.app/v1/stacks \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "shop",
"members": [
{ "resource_type": "application", "resource_id": "app-abc123def456" },
{ "resource_type": "database", "resource_id": "db-abc123def456" }
],
"bindings": [{ "app_id": "app-abc123def456", "database_id": "db-abc123def456" }]
}'
{
"response": {
"id": "stk-abc123def456",
"name": "shop",
"network_mode": "public",
"members": [],
"bindings": [],
"restart_required": true,
"apps_to_restart": ["app-abc123def456"]
}
}
Stacks
Crear stack
Crea un stack a partir de aplicaciones y bases de datos que ya tienes, y opcionalmente las conecta entre sí.
POST
/
v1
/
stacks
curl -X POST https://api.vertracloud.app/v1/stacks \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "shop",
"members": [
{ "resource_type": "application", "resource_id": "app-abc123def456" },
{ "resource_type": "database", "resource_id": "db-abc123def456" }
],
"bindings": [{ "app_id": "app-abc123def456", "database_id": "db-abc123def456" }]
}'
{
"response": {
"id": "stk-abc123def456",
"name": "shop",
"network_mode": "public",
"members": [],
"bindings": [],
"restart_required": true,
"apps_to_restart": ["app-abc123def456"]
}
}
Agrupa aplicaciones y bases de datos que ya existen en un solo stack. Todos los miembros deben pertenecer a la misma cuenta o al mismo workspace, y ninguno puede estar ya en otro stack. Para crear un stack a partir de una carpeta en un solo paso, consulta Convertir carpeta en stack. Requiere el scope
Esos mismos dos campos vuelven en cada cambio que pueda alterar las variables o los certificados de una aplicación: transformar, añadir o quitar un miembro, crear o cambiar una conexión, añadir una base de datos o una carpeta de Blob.
stacks:write cuando se llama con una clave de API. Solo el propietario de un workspace puede crear stacks en él.
string
requerido
El nombre del stack.
string | null
Descripción opcional.
string
predeterminado:"public"
Solo se acepta
public. Cualquier otro valor falla con STACK_NETWORK_MODE_UNAVAILABLE.object[]
Los recursos que se incluyen en el stack. Cada elemento tiene
resource_type (application o database) y resource_id. Una carpeta de Blob se añade después con Añadir carpeta de Blob.object[]
Conexiones que se crean entre los miembros. Cada elemento tiene
app_id (la aplicación que recibe las variables), exactamente uno de database_id o target_app_id, y un env_map opcional (nombre de variable y lo que recibe; consulta Crear conexión). Sin env_map se usan los nombres estándar del motor.string
El workspace que será propietario del stack.
Response
object
El stack creado (
201), con los mismos campos que Obtener stack, más:Mostrar Mostrar objeto
Mostrar Mostrar objeto
boolean
true cuando al menos una aplicación debe reiniciarse para leer las variables o los certificados que crearon las nuevas conexiones. Una aplicación los lee solo al arrancar, así que la plataforma no la reinicia por ti.string[]
Las aplicaciones que necesitan un reinicio. Vacío cuando
restart_required es false. Reinícialas con Reiniciar aplicación.{
"response": {
"id": "stk-abc123def456",
"name": "shop",
"network_mode": "public",
"members": [],
"bindings": [],
"restart_required": true,
"apps_to_restart": ["app-abc123def456"]
}
}
curl -X POST https://api.vertracloud.app/v1/stacks \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "shop",
"members": [
{ "resource_type": "application", "resource_id": "app-abc123def456" },
{ "resource_type": "database", "resource_id": "db-abc123def456" }
],
"bindings": [{ "app_id": "app-abc123def456", "database_id": "db-abc123def456" }]
}'
Errores
| Estado | Código | Cuándo |
|---|---|---|
| 400 | STACK_NETWORK_MODE_UNAVAILABLE | network_mode no es public. |
| 409 | STACK_MEMBER_CONFLICT | Un recurso ya está en otro stack, o no está en la misma cuenta o workspace que el stack. |
| 403 | WORKSPACE_OWNER_ONLY | Eres miembro del workspace, no su propietario. |
| 404 | APP_NOT_FOUND | Una aplicación no existe o no es tuya. |
| 404 | DATABASE_NOT_FOUND | Una base de datos no existe o no es tuya. |
Última modificación el 30 de octubre de 2026