> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/cli/it/riferimento/exit-codes-and-errors.md).

# Codici di uscita ed errori

Codici di uscita di Devolutions CLI, come gli errori sono segnalati nell’output di testo e JSON, e i codici di errore più comuni con che cosa fare.

Ogni comando `devo` restituisce un codice di uscita, così uno script distingue il successo dal fallimento. Quando un comando non riesce, segnala anche un codice di errore, un identificatore breve come `invalidSecretReference`, e un messaggio.

## Codici di uscita

<table><thead><tr><th width="120">CODICE</th><th>SIGNIFICATO</th></tr></thead><tbody><tr><td><code>0</code></td><td>Il comando è riuscito.</td></tr><tr><td><code>1</code></td><td>Il comando non è riuscito, per esempio perché lo spazio di lavoro ha rifiutato l’operazione o non la supporta.</td></tr><tr><td><code>2</code></td><td>La riga di comando non è valida e non è stato fatto nulla: comando o opzione sconosciuti, valore mancante o non valido, opzioni che non si possono combinare, oppure una modifica senza <code>--yes</code>.</td></tr><tr><td><code>3</code></td><td>Non è stato possibile raggiungere il processo in background, oppure non ha risposto in tempo, oppure ha segnalato un errore. Un profilo locale che non può eseguire un comando di cassaforte o di voce, per esempio una modifica della cassaforte (<code>sqliteVaultLifecycleUnavailable</code>), termina anch’esso con <code>3</code>. Consulti <a href="/cli/it/aiuto/troubleshooting/daemon-wont-start.md">Il processo in background non si avvia</a>.</td></tr><tr><td><code>4</code></td><td>Un elemento richiesto non è stato trovato, come uno spazio di lavoro, una cassaforte, una voce, un utente o un gruppo, oppure un campo con <code>devo secret read</code> e <code>devo secret get</code>. Alcuni comandi segnalano un elemento mancante con <code>1</code>: per esempio, <code>devo secret get</code> su un profilo locale restituisce <code>sqliteSecretNotFound</code> con <code>1</code>. La pagina <a href="/cli/it/riferimento/error-codes.md">Codici di errore</a> indica il codice di uscita di ogni errore.</td></tr><tr><td><code>124</code></td><td>Solo <code>devo secret run</code>: il comando ha superato <code>--timeout-seconds</code> ed è stato arrestato.</td></tr><tr><td><code>130</code></td><td>Il comando è stato interrotto, per esempio con <kbd>Ctrl</kbd>+<kbd>C</kbd>. Con <code>devo secret run</code>, il comando che aveva avviato è stato annullato.</td></tr></tbody></table>

### `devo secret run`

Quando il comando che avvia arriva fino in fondo, `devo secret run` termina con **il codice di uscita di quel comando**, così gli script e le pipeline vedono lo stesso risultato che avrebbero avuto eseguendo il comando direttamente. I codici di uscita `124` e `130` si applicano solo quando il comando viene fermato. Se `devo secret run` non può scrivere il file indicato con `--receipt-file`, termina con `1`.

Prima che il comando parta, un `--env-file` non valido o un riferimento che ha bisogno di una variabile d’ambiente mancante termina con `2`; un altro errore di lettura di un segreto termina con `1`.

## Come vengono segnalati gli errori

* **Output di testo** (il valore predefinito): l’errore è scritto come `<code>: <message>`, di solito nell’output di errore. Gli errori dei comandi che funzionano solo con Devolutions Cloud o Devolutions Server, come la maggior parte dei comandi `devo admin`, vanno nell’output standard. Per una riga di comando non valida segue la guida del comando.
* **Output JSON o YAML**: l’errore va sullo standard output, nella stessa busta di un risultato, con `status` impostato su `error` e un elenco `errors`. Ogni errore ha un `code` e un `message`. Una riga di comando non valida restituisce il codice `usageError`, e `usageSuggestion` quando Devolutions CLI ha una correzione da suggerire. Consulti [Leggere i risultati come JSON](/cli/it/per-devops-e-amministratori/automate/json-output.md).
* **`devo secret run`**: qualunque sia il formato di output, gli errori che si verificano mentre legge i segreti o esegue il comando (timeout, annullamento, input standard) sono scritti come testo `<code>: <message>` semplice nell’output di errore.

## Codici di errore comuni

La tabella sotto elenca i codici di errore che incontrerà più spesso. Per ogni codice di errore, consulti [Codici di errore](/cli/it/riferimento/error-codes.md).

<table><thead><tr><th width="270">CODICE DI ERRORE</th><th>CHE COSA SIGNIFICA</th><th>CHE COSA FARE</th></tr></thead><tbody><tr><td><code>usageError</code></td><td>Comando o opzione sconosciuti, oppure argomento mancante.</td><td>Controlli l’ortografia con <code>devo &#x3C;command> --help</code>. Consulti <a href="/cli/it/riferimento/commands.md">Comandi</a>.</td></tr><tr><td><code>conflictingOptions</code></td><td>Due opzioni che non possono essere usate insieme, come <code>--json</code> e <code>--yaml</code>, oppure <code>--quiet</code> e <code>--verbose</code>.</td><td>Ne tenga uno. Consulti <a href="/cli/it/riferimento/global-options.md#options-that-cant-be-combined">Opzioni globali</a>.</td></tr><tr><td><code>missingParameter</code>, <code>invalidParameterValue</code></td><td>Manca un valore obbligatorio, oppure un valore non è consentito.</td><td>Legga il messaggio: indica l’opzione. Controlli i valori consentiti con <code>--help</code>.</td></tr><tr><td><code>invalidSource</code></td><td>Il valore <code>--source</code> non è valido.</td><td>Usi <code>sqlite</code>, <code>cloud[:&#x3C;context>]</code> o <code>server[:&#x3C;context>]</code>.</td></tr><tr><td><code>confirmationRequired</code>, <code>mutationConfirmationRequired</code></td><td>Il comando modifica o elimina qualcosa e non è stato confermato.</td><td>Aggiunga <code>--yes</code> quando è certo.</td></tr><tr><td><code>rawSensitiveValueRejected</code></td><td>Un segreto è stato passato in un modo che potrebbe esporlo, come una password come valore di campo in chiaro.</td><td>Usi <code>devo secret set</code> con <code>--value-env</code> o <code>--value-file</code>. Consulti <a href="/cli/it/guide/secrets/update-a-secret.md">Aggiornare un segreto da uno script</a>.</td></tr><tr><td><code>invalidSecretReference</code></td><td>Il riferimento non è scritto correttamente.</td><td>Consulti i messaggi in <a href="/cli/it/riferimento/secret-references.md#rules-and-errors">Sintassi dei riferimenti al segreto</a>.</td></tr><tr><td><code>unsupportedSecretAttribute</code></td><td>Il valore <code>?attribute=</code> non è noto.</td><td>Usi <code>value</code>, <code>type</code>, <code>id</code>, <code>title</code> o <code>purpose</code>. <code>otp</code> è accettato in un riferimento, ma nessun tipo di spazio di lavoro restituisce un valore per esso. Consulti <a href="/cli/it/riferimento/secret-references.md#attributes">Attributi</a>.</td></tr><tr><td><code>missingSecretReferenceVariable</code></td><td>Un riferimento in un modello usa una variabile d’ambiente che non è impostata.</td><td>Imposti la variabile, oppure le dia un valore predefinito con <code>${NAME:-default}</code>. Consulti <a href="/cli/it/riferimento/secret-references.md#references-inside-a-text">Riferimenti dentro un testo</a>.</td></tr><tr><td><code>secretLaunchArgumentReference</code></td><td>Un riferimento <code>devo://</code> è stato scritto come argomento del comando da eseguire.</td><td>Lo passi con <code>--env-ref</code>, <code>--stdin-reference</code> o <code>--manifest</code>. Consulti <a href="/cli/it/guide/secrets/run-with-secrets.md">Eseguire un comando con i suoi segreti</a>.</td></tr><tr><td><code>secretLaunchTimedOut</code></td><td>Il comando avviato da <code>devo secret run</code> ha superato <code>--timeout-seconds</code>.</td><td>Aumenti il timeout, oppure scopra perché il comando impiega così tanto.</td></tr><tr><td><code>secretLaunchCancelled</code>, <code>interrupted</code></td><td>Il comando è stato interrotto.</td><td>Lo esegua di nuovo.</td></tr><tr><td><code>operationNotSupportedBySource</code></td><td>Il tipo di spazio di lavoro selezionato non può eseguire questo comando.</td><td>Selezioni un altro spazio di lavoro con <code>--context</code>. Consulti <a href="/cli/it/aiuto/troubleshooting/not-supported.md">Un comando dice che lo spazio di lavoro non lo supporta</a>.</td></tr><tr><td><code>cloudContextNotFound</code></td><td>Nessun contesto di Devolutions Cloud con quel nome, oppure nessuno corrente.</td><td>Controlli <code>devo context list</code>, oppure acceda con <code>devo login</code>. Consulti <a href="/cli/it/aiuto/troubleshooting/sign-in-fails.md">L’accesso non riesce o la sessione è scaduta</a>.</td></tr><tr><td><code>daemonUnavailable</code>, <code>daemonTimeout</code>, <code>daemonIoError</code></td><td>Il processo in background non è stato raggiungibile, non ha risposto in tempo oppure la connessione si è interrotta.</td><td>Esegua <code>devo daemon status</code>, poi <code>devo daemon restart</code>. Consulti <a href="/cli/it/aiuto/troubleshooting/daemon-wont-start.md">Il processo in background non si avvia</a>.</td></tr><tr><td><code>unexpectedError</code></td><td>Un errore che Devolutions CLI non si aspettava.</td><td>Esegua <code>devo doctor</code> e contatti il supporto. Consulti <a href="/cli/it/aiuto/troubleshooting/collect-diagnostics.md">Raccogliere la diagnostica per il supporto</a>.</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/cli/it/riferimento/exit-codes-and-errors.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
