Restore de snapshots ahora te dice si la restauración sigue en curso, y Metrics recibe un rango. Todo lo demás se añade encima: dos operaciones nuevas, 69 en total, campos nuevos y códigos de error nuevos.
De un vistazo
Ruta de importación
Solo cambia la ruta de importación.New y todas las Option conservan sus firmas y sus valores por defecto, y el User-Agent por defecto pasa a ser squarecloud-sdk-go/4.0.0.
Cambios incompatibles
Los ejemplos de abajo se ejecutan dentro de una función que devuelve unerror.
Restauración de snapshots
Apps.Snapshots.Restore y Databases.Snapshots.Restore devuelven (SnapshotRestored, error) en lugar de error. Una restauración que tarda más de unos 90 segundos sigue ejecutándose después de que la llamada vuelva. La v3 devolvía nil en ese caso, así que quien la llamaba informaba “restaurado” mientras seguía en curso. La v4 devuelve Pending: true en ese caso, y Pending: false para una restauración terminada.
RestoreState informa queued o running mientras se ejecuta la restauración, con el Step actual, y después success o error, con un Code, durante 1 hora tras terminar. Informa none pasada esa hora o cuando no hubo ninguna restauración reciente. Admite 30 llamadas por minuto. Consulta Snapshots.
Métricas
Apps.Metrics y Databases.Metrics reciben un rango como último argumento. Pasa "" para mantener el comportamiento de la v3, que cubre las últimas 24 horas.
"7d" devuelve puntos por hora con la media de la hora y sus picos CPUMax y RAMMax, en los planes Pro y Enterprise para aplicaciones de 512 MB o más. Los demás planes y las aplicaciones más pequeñas reciben la respuesta de 24 horas sin error, así que comprueba los puntos en lugar de dar por hecho que son 7 días. Cualquier otro rango devuelve 400 INVALID_PARAMETERS. En las bases de datos, "7d" requiere un plan Pro o Enterprise. Consulta Métricas.
RESTORE_IN_PROGRESS es 409
RESTORE_IN_PROGRESS pasó de 403 a 409 al eliminar aplicaciones y bases de datos y al iniciar y detener bases de datos. También es nuevo, como 409, al iniciar, detener y reiniciar aplicaciones y en Create y Restore de snapshots. Compara solo el código:
Tipos y campos nuevos
Los campos nuevos solo rompen los literales de struct de estos tipos que omiten los nombres de los campos. Usa nombres de campo.
Errores
- Constantes nuevas:
CodeAIWeeklyLimitReached,CodeEnvBusy(409),CodeGitBranchDeletedyCodeGitRefNotSupported(solo se envían a los webhooks de push de GitHub),CodeRestoreInterrupted,CodeSnapshotsUnavailable(503),CodeSnapshotCorrupt,CodeSnapshotInProgress(409),CodeSnapshotRestoreProcessing(se informa comoSnapshotRestored.Pending, nunca como error),CodeWriteFailedyCodeWrongHost(421, nunca se devuelve a las llamadas de este SDK). CodeMetricsNotSupportedestá obsoleto, pero se mantiene.- Una restauración puede fallar con más códigos que
SNAPSHOT_RESTORE_FAILED. Consulta Snapshots para ver la lista completa. - El SDK no reintenta ninguno de los códigos nuevos.
SNAPSHOTS_UNAVAILABLEpide esperar unos 30 segundos yCLUSTER_MAINTENANCE_TRY_LATERdura minutos, ambos más que las esperas de los reintentos. Un 409 de un recurso ocupado lo decides tú. - Los errores propios del SDK,
INVALID_API_KEY,INVALID_IDyFILE_TOO_LARGE, tienen mensajes nuevos que dicen qué salió mal y cómo resolverlo. ComparaCode, noMessage.
Cambios de comportamiento
- Los enlaces de los snapshots caducan tras 1 hora. Antes duraban 30 días, así que descarga justo después de listar o crear un snapshot. Solo
Createpuede devolverURLyKeyvacíos, conPending: false, cuando la clave de API no tienesnapshots:read. - Los listados de snapshots (
Account.Snapshots,Apps.Snapshots.ListyDatabases.Snapshots.List) devuelven 503SNAPSHOTS_UNAVAILABLEen lugar de una lista vacía cuando el almacenamiento de snapshots no puede responder. - Métricas. Las aplicaciones de menos de 512 MB ahora tienen métricas, con un punto cada 10 minutos, donde antes recibían 400
METRICS_NOT_SUPPORTED. - Variables de entorno.
Envs.Set,Envs.ReplaceyEnvs.Deletedevuelven 409ENV_BUSYcuando hay otra escritura en curso. Con una clave de API sinenvs:read,Envs.Setdevuelve solo las variables que enviaste, no el conjunto completo, yEnvs.Deletedevuelve un conjunto vacío. - Archivos.
Files.ReadyFiles.Writepueden devolver 400READ_FAILEDyWRITE_FAILED, yCommitpuede devolver 403BLOCKED_PATH. - Subidas en paralelo. La API limita cuántas subidas grandes puede enviar una cuenta a la vez. Superar el límite devuelve 429
RATE_LIMITED, que el SDK nunca reintenta. - IA. Un 429 de
AI.Chatpuede serweekly_limit_reached. - User-Agent es
squarecloud-sdk-go/4.0.0.
Lista de comprobación
1
Cambia la ruta de importación
Importa
github.com/squarecloudofc/sdk-api-go/v4 en todas partes y ejecuta go get github.com/squarecloudofc/sdk-api-go/v4@v4.0.0.2
Sigue las restauraciones pendientes
Sustituye
err := c.Apps.Snapshots.Restore(...) por res, err := .... Cuando res.Pending sea true, consulta RestoreState, por ejemplo cada 10 segundos, hasta que State sea success o error. Nunca vuelvas a enviar la restauración.3
Pasa un rango a Metrics
Añade
"", "24h" o "7d" como último argumento de Apps.Metrics y Databases.Metrics.4
Compara 409 RESTORE_IN_PROGRESS
Compara
409 donde comparabas 403, o compara solo el código.5
Gestiona 503 SNAPSHOTS_UNAVAILABLE
Gestiónalo en los listados de snapshots, en lugar de interpretar una lista vacía como “no hay snapshots”.
6
Compara códigos, no mensajes
Comprueba
Code dondequiera que compararas el Message de INVALID_API_KEY, INVALID_ID o FILE_TOO_LARGE.Próximos pasos
Cliente
Instala el SDK y crea un cliente.
Snapshots
Crea, restaura y sigue snapshots.
Errores
Clase de error, reintentos y límites de tasa.

