Vai al contenuto principale
La v4 è una release con breaking change perché cambiano due firme. Restore degli snapshot ora ti dice se il ripristino è ancora in corso, e Metrics accetta un range. Tutto il resto è un’aggiunta: due nuove operazioni, per un totale di 69, nuovi campi e nuovi codici di errore.

In sintesi

Percorso di import

Cambia solo il percorso di import. New e ogni Option mantengono le loro firme e i loro valori predefiniti, e lo User-Agent predefinito diventa squarecloud-sdk-go/4.0.0.

Breaking change

Gli esempi qui sotto vengono eseguiti all’interno di una funzione che restituisce un error.

Ripristino degli snapshot

Apps.Snapshots.Restore e Databases.Snapshots.Restore restituiscono (SnapshotRestored, error) invece di error. Un ripristino che dura più di circa 90 secondi continua dopo il ritorno della chiamata. La v3 restituiva nil in quel caso, quindi chi chiamava segnalava “ripristinato” mentre era ancora in corso. La v4 restituisce Pending: true in quel caso, e Pending: false per un ripristino terminato.
RestoreState riporta queued o running mentre il ripristino è in corso, con lo Step attuale, poi success o error, con un Code, per 1 ora dopo la fine. Riporta none trascorsa quell’ora o quando non c’è stato un ripristino recente. Consente 30 chiamate al minuto. Vedi Snapshot.

Metriche

Apps.Metrics e Databases.Metrics accettano un range come ultimo argomento. Passa "" per mantenere il comportamento della v3, che copre le ultime 24 ore.
"7d" restituisce punti orari con la media dell’ora e i suoi picchi CPUMax e RAMMax, sui piani Pro ed Enterprise per le app da 512 MB o più. Gli altri piani e le app più piccole ricevono la risposta di 24 ore senza errori, quindi controlla i punti invece di dare per scontati 7 giorni. Qualsiasi altro range restituisce 400 INVALID_PARAMETERS. Per i database, "7d" richiede un piano Pro o Enterprise. Vedi Metriche.

RESTORE_IN_PROGRESS è 409

RESTORE_IN_PROGRESS è passato da 403 a 409 sull’eliminazione di app e database e sull’avvio e l’arresto dei database. È anche nuovo, come 409, sull’avvio, l’arresto e il riavvio delle app e su Create e Restore degli snapshot. Confronta solo il codice:

Nuovi tipi e campi

I nuovi campi rompono solo i literal struct di questi tipi che omettono i nomi dei campi. Usa i nomi dei campi.

Errori

  • Nuove costanti: CodeAIWeeklyLimitReached, CodeEnvBusy (409), CodeGitBranchDeleted e CodeGitRefNotSupported (inviati solo ai webhook di push di GitHub), CodeRestoreInterrupted, CodeSnapshotsUnavailable (503), CodeSnapshotCorrupt, CodeSnapshotInProgress (409), CodeSnapshotRestoreProcessing (riportato come SnapshotRestored.Pending, mai come errore), CodeWriteFailed e CodeWrongHost (421, mai restituito alle chiamate di questo SDK).
  • CodeMetricsNotSupported è deprecato ma resta.
  • Un ripristino può fallire con più codici oltre a SNAPSHOT_RESTORE_FAILED. Vedi Snapshot per l’elenco completo.
  • L’SDK non ripete nessuno dei nuovi codici. SNAPSHOTS_UNAVAILABLE chiede di attendere circa 30 secondi e CLUSTER_MAINTENANCE_TRY_LATER dura alcuni minuti, entrambi più a lungo delle attese dei retry. Un 409 di una risorsa occupata lo gestisci tu.
  • Gli errori propri dell’SDK, INVALID_API_KEY, INVALID_ID e FILE_TOO_LARGE, hanno nuovi messaggi che dicono cosa è andato storto e come risolverlo. Confronta Code, non Message.
Vedi Errori per il riferimento completo.

Cambiamenti di comportamento

  • I link degli snapshot scadono dopo 1 ora. Prima duravano 30 giorni, quindi scarica subito dopo aver elencato o creato uno snapshot. Solo Create può restituire URL e Key vuoti, con Pending: false, quando la chiave API non ha snapshots:read.
  • Gli elenchi di snapshot (Account.Snapshots, Apps.Snapshots.List e Databases.Snapshots.List) restituiscono 503 SNAPSHOTS_UNAVAILABLE invece di un elenco vuoto quando lo storage degli snapshot non riesce a rispondere.
  • Metriche. Le app sotto i 512 MB ora hanno le metriche, con un punto ogni 10 minuti, dove prima ricevevano 400 METRICS_NOT_SUPPORTED.
  • Variabili d’ambiente. Envs.Set, Envs.Replace e Envs.Delete restituiscono 409 ENV_BUSY quando è in corso un’altra scrittura. Con una chiave API priva di envs:read, Envs.Set restituisce solo le variabili che hai inviato, non l’insieme completo, e Envs.Delete restituisce un insieme vuoto.
  • File. Files.Read e Files.Write possono restituire 400 READ_FAILED e WRITE_FAILED, e Commit può restituire 403 BLOCKED_PATH.
  • Upload in parallelo. L’API limita quanti upload grandi un account può inviare contemporaneamente. Superare il limite restituisce 429 RATE_LIMITED, che l’SDK non ripete mai.
  • AI. Un 429 da AI.Chat può essere weekly_limit_reached.
  • User-Agent è squarecloud-sdk-go/4.0.0.

Checklist

1

Cambia il percorso di import

Importa github.com/squarecloudofc/sdk-api-go/v4 ovunque ed esegui go get github.com/squarecloudofc/sdk-api-go/v4@v4.0.0.
2

Segui i ripristini in sospeso

Sostituisci err := c.Apps.Snapshots.Restore(...) con res, err := .... Quando res.Pending è true, interroga RestoreState, ad esempio ogni 10 secondi, finché State non è success o error. Non inviare mai di nuovo il ripristino.
3

Passa un range a Metrics

Aggiungi "", "24h" o "7d" come ultimo argomento di Apps.Metrics e Databases.Metrics.
4

Confronta 409 RESTORE_IN_PROGRESS

Confronta 409 dove confrontavi 403, oppure confronta solo il codice.
5

Gestisci 503 SNAPSHOTS_UNAVAILABLE

Gestiscilo sugli elenchi di snapshot, invece di leggere un elenco vuoto come “nessuno snapshot”.
6

Confronta i codici, non i messaggi

Controlla Code ovunque confrontavi il Message di INVALID_API_KEY, INVALID_ID o FILE_TOO_LARGE.

Prossimi passi

Client

Installa l’SDK e crea un client.

Snapshot

Crea, ripristina e segui gli snapshot.

Errori

Classe di errore, retry e rate limit.