--json per ottenere un solo oggetto risultato o errore su stdout. La diagnostica va su stderr. Il successo conserva data e paginazione e aggiunge meta.http_status, meta.request_id e meta.idempotent_replayed.
Gli errori includono code, message, http_status, request_id, retry_after e mutation_may_have_succeeded. Usa stato di uscita e codice, senza interpretare il testo del messaggio.
Limita l’automazione
Le liste non leggono automaticamente tutte le pagine. Letture e modifiche non riprovano da sole. Rispetta i budget e conserva le chiavi delle operazioni logiche. Con timeout o risultato in attesa, controlla la risorsa prima di decidere come riprovare. Un’uscita zero da--dry-run dimostra solo la validazione locale. Un errore dopo una modifica può corrispondere a dati già salvati: controlla mutation_may_have_succeeded e la guida al recupero.
Un job shell di sola lettura
jq è uno strumento esterno opzionale. Report e anteprime oscurate possono contenere dati dei clienti: conserva l’output in modo adeguato e non stampare chiavi nei log.