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 unerror.
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),CodeGitBranchDeletedeCodeGitRefNotSupported(inviati solo ai webhook di push di GitHub),CodeRestoreInterrupted,CodeSnapshotsUnavailable(503),CodeSnapshotCorrupt,CodeSnapshotInProgress(409),CodeSnapshotRestoreProcessing(riportato comeSnapshotRestored.Pending, mai come errore),CodeWriteFailedeCodeWrongHost(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_UNAVAILABLEchiede di attendere circa 30 secondi eCLUSTER_MAINTENANCE_TRY_LATERdura 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_IDeFILE_TOO_LARGE, hanno nuovi messaggi che dicono cosa è andato storto e come risolverlo. ConfrontaCode, nonMessage.
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
Createpuò restituireURLeKeyvuoti, conPending: false, quando la chiave API non hasnapshots:read. - Gli elenchi di snapshot (
Account.Snapshots,Apps.Snapshots.ListeDatabases.Snapshots.List) restituiscono 503SNAPSHOTS_UNAVAILABLEinvece 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.ReplaceeEnvs.Deleterestituiscono 409ENV_BUSYquando è in corso un’altra scrittura. Con una chiave API priva dienvs:read,Envs.Setrestituisce solo le variabili che hai inviato, non l’insieme completo, eEnvs.Deleterestituisce un insieme vuoto. - File.
Files.ReadeFiles.Writepossono restituire 400READ_FAILEDeWRITE_FAILED, eCommitpuò restituire 403BLOCKED_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.Chatpuò essereweekly_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.

