Skip to main content
api.databases gestiona las bases de datos gestionadas de Square Cloud (MongoDB, MySQL, PostgreSQL y Redis). Todos los métodos salvo create y statusAll reciben primero el id de la base de datos. Para listar tus bases de datos, usa api.account.me(): su array databases contiene todas las bases de datos que la clave puede ver. El alojamiento de bases de datos requiere un plan Standard, Pro o Enterprise. Los ejemplos usan el cliente api de Crear el cliente. databaseId es el id de una de tus bases de datos: api.account.me() las lista.

Crear una base de datos

El password y el certificate solo los devuelve create() (y resetCredentials()). La llamada espera al menos 120 s antes de agotar el tiempo.

Obtener una base de datos

Actualizar una base de datos

update(databaseId, { name, ram }) renombra o redimensiona una base de datos. Pasa al menos un campo (en caso contrario, 400 NO_UPDATE_DATA).

Iniciar y detener

Al igual que las llamadas del ciclo de vida de las aplicaciones, esperan al menos 120 s, y un rechazo es un 409 con un código y un mensaje vacío: CONTAINER_ALREADY_STARTED, CONTAINER_ALREADY_STOPPED, CONTAINER_NOT_FOUND, CONTAINER_INSUFFICIENT_DISK_SPACE, CONTAINER_NETWORK_CONFLICT o ACTION_FAILED. Mientras se ejecuta la restauración de un snapshot, dan 403 RESTORE_IN_PROGRESS.

Estado y métricas

status(databaseId) devuelve valores formateados; { raw: true } devuelve números. statusAll() devuelve un resumen por base de datos. metrics(databaseId) devuelve las últimas 24 horas, un punto cada 5 minutos, del más reciente al más antiguo.
Los campos de estado son los mismos que los del estado de las aplicaciones.

Credenciales

certificate(databaseId) devuelve el certificado TLS como PEM codificado en base64. resetCredentials(databaseId, type) rota la contraseña (y devuelve la nueva) o el certificado (y devuelve ""). La base de datos debe estar en ejecución (400 DATABASE_NOT_RUNNING).

Eliminar una base de datos

La eliminación es permanente. Toma primero un snapshot si es posible que vuelvas a necesitar los datos.

Snapshots

api.databases.snapshots tiene los mismos list, create y restore que las aplicaciones. Consulta Snapshots.

Próximos pasos

Workspaces

Comparte aplicaciones con tu equipo.

Referencia de la API de bases de datos

Los endpoints REST detrás de estos métodos.

Bases de datos desde la CLI

Las mismas acciones desde la terminal.