Saltar al contenido principal
La v4 es una versión con cambios incompatibles porque cambian dos firmas. 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 un error.

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), CodeGitBranchDeleted y CodeGitRefNotSupported (solo se envían a los webhooks de push de GitHub), CodeRestoreInterrupted, CodeSnapshotsUnavailable (503), CodeSnapshotCorrupt, CodeSnapshotInProgress (409), CodeSnapshotRestoreProcessing (se informa como SnapshotRestored.Pending, nunca como error), CodeWriteFailed y CodeWrongHost (421, nunca se devuelve a las llamadas de este SDK).
  • CodeMetricsNotSupported está 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_UNAVAILABLE pide esperar unos 30 segundos y CLUSTER_MAINTENANCE_TRY_LATER dura 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_ID y FILE_TOO_LARGE, tienen mensajes nuevos que dicen qué salió mal y cómo resolverlo. Compara Code, no Message.
Consulta Errores para ver la referencia completa.

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 Create puede devolver URL y Key vacíos, con Pending: false, cuando la clave de API no tiene snapshots:read.
  • Los listados de snapshots (Account.Snapshots, Apps.Snapshots.List y Databases.Snapshots.List) devuelven 503 SNAPSHOTS_UNAVAILABLE en 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.Replace y Envs.Delete devuelven 409 ENV_BUSY cuando hay otra escritura en curso. Con una clave de API sin envs:read, Envs.Set devuelve solo las variables que enviaste, no el conjunto completo, y Envs.Delete devuelve un conjunto vacío.
  • Archivos. Files.Read y Files.Write pueden devolver 400 READ_FAILED y WRITE_FAILED, y Commit puede devolver 403 BLOCKED_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.Chat puede ser weekly_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.