Usare l’output JSON della CLI dosya

Passa --json o -j per richiedere output JSON formattato su stdout. dosya non racchiude ogni comando in uno schema universale {ok,data}: whoami restituisce l’oggetto utente, i comandi di elenco mantengono la struttura API e il comando usage crea il proprio rapporto.

Prima di iniziare

• Verifica che il comando scelto supporti i campi necessari allo script, eseguendolo una volta su dati temporanei o in sola lettura.
• Acquisisci stderr separatamente: avvisi e informazioni di debug restano lì anche in modalità JSON.
• config get oscura la chiave API salvata: il suo output JSON è sicuro per la diagnosi, ma non permette di recuperare la credenziale.

Procedura

1. Esegui una prova in sola lettura, ad esempio dosya whoami --json, reindirizzando stdout e stderr in file separati.
2. Salva il codice di uscita prima dell’analisi. Un comando con codice di uscita diverso da zero può lasciare stdout vuoto o incompleto anche se stderr spiega chiaramente l’errore.
3. Analizza la struttura effettiva al livello principale. Per whoami, leggi direttamente i campi utente; per ls, esamina il contenitore dell’elenco invece di aspettarti le stesse chiavi.
4. Scegli solo i valori necessari con jq -e, così lo script segnala un errore se manca un campo. Evita di salvare l’intera risposta dell’account o del file quando basta un ID.
5. Conserva stderr nel registro del processo e l’output JSON di stdout come ricevuta per il sistema. Non unirli mai con 2>&1 prima di passarli a un parser JSON.
6. Verifica il significato del risultato, ad esempio l’ID dello spazio di lavoro desiderato o del file restituito, prima di avviare un comando che dipende da esso.

Risultato previsto

Un comando eseguito correttamente scrive su stdout un documento JSON valido specifico del comando, mentre avanzamento e avvisi restano su stderr. Lo script controlla sia il codice di uscita sia i campi richiesti.

Risoluzione dei problemi

jq segnala JSON non valido. Verifica che stdout e stderr non siano stati uniti, poi controlla il codice di uscita originale.

Manca un campo presente in un altro comando. Leggi la struttura dell’output di questo comando: non esiste un contenitore universale dei risultati.

Il valore della chiave è mascherato. È previsto per config get. Recupera i segreti dall’archivio che li ha forniti, non dall’output diagnostico della CLI.

Guide correlate

• Installare la CLI
• Trasferire file con la CLI