> 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/fr/reference/exit-codes-and-errors.md).

# Codes de sortie et erreurs

Codes de sortie de Devolutions CLI, façon dont les erreurs sont signalées en sortie texte et JSON, et les codes d’erreur les plus courants avec quoi faire.

Chaque commande `devo` retourne un code de sortie, pour qu’un script distingue la réussite de l’échec. Quand une commande échoue, elle signale aussi un code d’erreur, un court identificateur comme `invalidSecretReference`, et un message.

## Codes de sortie

<table><thead><tr><th width="120">CODE</th><th>SIGNIFICATION</th></tr></thead><tbody><tr><td><code>0</code></td><td>La commande a réussi.</td></tr><tr><td><code>1</code></td><td>La commande a échoué, par exemple parce que l’espace de travail a refusé l’opération ou ne la prend pas en charge.</td></tr><tr><td><code>2</code></td><td>La ligne de commande n’est pas valide, et rien n’a été fait : commande ou option inconnue, valeur manquante ou non valide, options qui ne peuvent pas être combinées, ou une modification sans <code>--yes</code>.</td></tr><tr><td><code>3</code></td><td>Le processus en arrière-plan n’a pas pu être joint ou n’a pas répondu à temps, ou il a signalé une erreur. Un profil local qui ne peut pas exécuter une commande de coffre ou d’entrée, par exemple un changement de coffre (<code>sqliteVaultLifecycleUnavailable</code>), se termine aussi avec <code>3</code>. Consultez <a href="/cli/fr/aide/troubleshooting/daemon-wont-start.md">Le processus en arrière-plan ne démarre pas</a>.</td></tr><tr><td><code>4</code></td><td>Un élément que vous avez demandé n’a pas été trouvé, comme un espace de travail, un coffre, une entrée, un utilisateur ou un groupe, ou un champ avec <code>devo secret read</code> et <code>devo secret get</code>. Certaines commandes signalent un élément manquant avec <code>1</code> à la place : par exemple, <code>devo secret get</code> sur un profil local retourne <code>sqliteSecretNotFound</code> avec <code>1</code>. La page <a href="/cli/fr/reference/error-codes.md">Codes d’erreur</a> donne le code de sortie de chaque erreur.</td></tr><tr><td><code>124</code></td><td><code>devo secret run</code> seulement : la commande a dépassé <code>--timeout-seconds</code> et a été arrêtée.</td></tr><tr><td><code>130</code></td><td>La commande a été interrompue, par exemple avec <kbd>Ctrl</kbd>+<kbd>C</kbd>. Avec <code>devo secret run</code>, la commande qu’elle avait démarrée a été annulée.</td></tr></tbody></table>

### `devo secret run`

Quand la commande qu’il démarre va jusqu’au bout, `devo secret run` se termine avec **le code de sortie de cette commande**, donc vos scripts et vos pipelines voient le même résultat que s’ils avaient exécuté la commande directement. Les codes de sortie `124` et `130` ne s’appliquent que lorsque la commande est arrêtée. Si `devo secret run` ne peut pas écrire le fichier donné avec `--receipt-file`, il se termine avec `1`.

Avant le démarrage de la commande, un `--env-file` non valide ou une référence qui a besoin d’une variable d’environnement manquante se termine avec `2` ; un autre échec de lecture d’un secret se termine avec `1`.

## Comment les erreurs sont signalées

* **Sortie texte** (la valeur par défaut) : l’erreur est écrite sous la forme `<code>: <message>`, en général vers la sortie d’erreur. Les erreurs des commandes qui ne fonctionnent qu’avec Devolutions Cloud ou Devolutions Server, comme la plupart des commandes `devo admin`, vont vers la sortie standard. Pour une ligne de commande non valide, l’aide de la commande suit.
* **Sortie JSON ou YAML** : l’erreur va sur la sortie standard, dans la même enveloppe qu’un résultat, avec `status` réglé à `error` et une liste `errors`. Chaque erreur a un `code` et un `message`. Une ligne de commande invalide retourne le code `usageError`, et `usageSuggestion` quand Devolutions CLI a une correction à suggérer. Consultez [Lire les résultats en JSON](/cli/fr/pour-le-devops-et-les-administrateurs/automate/json-output.md).
* **`devo secret run`** : quel que soit le format de sortie, les erreurs qui surviennent pendant la lecture des secrets ou l’exécution de la commande (délai, annulation, entrée standard) sont écrites en texte `<code>: <message>` brut vers la sortie d’erreur.

## Codes d’erreur courants

Le tableau ci-dessous énumère les codes d’erreur que vous rencontrerez le plus souvent. Pour chaque code d’erreur, consultez [Codes d’erreur](/cli/fr/reference/error-codes.md).

<table><thead><tr><th width="270">CODE D’ERREUR</th><th>CE QUE CELA SIGNIFIE</th><th>QUOI FAIRE</th></tr></thead><tbody><tr><td><code>usageError</code></td><td>Commande ou option inconnue, ou argument manquant.</td><td>Vérifiez l’orthographe avec <code>devo &#x3C;command> --help</code>. Consultez <a href="/cli/fr/reference/commands.md">Commandes</a>.</td></tr><tr><td><code>conflictingOptions</code></td><td>Deux options qui ne peuvent pas être utilisées ensemble, telles que <code>--json</code> et <code>--yaml</code>, ou <code>--quiet</code> et <code>--verbose</code>.</td><td>Gardez-en un. Consultez <a href="/cli/fr/reference/global-options.md#options-that-cant-be-combined">Options globales</a>.</td></tr><tr><td><code>missingParameter</code>, <code>invalidParameterValue</code></td><td>Une valeur obligatoire est absente, ou une valeur n’est pas permise.</td><td>Lisez le message : il nomme l’option. Vérifiez les valeurs permises avec <code>--help</code>.</td></tr><tr><td><code>invalidSource</code></td><td>La valeur <code>--source</code> n’est pas valide.</td><td>Utilisez <code>sqlite</code>, <code>cloud[:&#x3C;context>]</code> ou <code>server[:&#x3C;context>]</code>.</td></tr><tr><td><code>confirmationRequired</code>, <code>mutationConfirmationRequired</code></td><td>La commande modifie ou supprime quelque chose et n’a pas été confirmée.</td><td>Ajoutez <code>--yes</code> une fois que vous êtes certain.</td></tr><tr><td><code>rawSensitiveValueRejected</code></td><td>Un secret a été passé d’une façon qui pourrait l’exposer, comme un mot de passe en valeur de champ en clair.</td><td>Utilisez <code>devo secret set</code> avec <code>--value-env</code> ou <code>--value-file</code>. Consultez <a href="/cli/fr/guides/secrets/update-a-secret.md">Mettre à jour un secret depuis un script</a>.</td></tr><tr><td><code>invalidSecretReference</code></td><td>La référence n’est pas écrite correctement.</td><td>Consultez les messages dans <a href="/cli/fr/reference/secret-references.md#rules-and-errors">Syntaxe des références de secret</a>.</td></tr><tr><td><code>unsupportedSecretAttribute</code></td><td>La valeur <code>?attribute=</code> n’est pas connue.</td><td>Utilisez <code>value</code>, <code>type</code>, <code>id</code>, <code>title</code> ou <code>purpose</code>. <code>otp</code> est accepté dans une référence, mais aucun type d’espace de travail ne retourne de valeur pour lui. Consultez <a href="/cli/fr/reference/secret-references.md#attributes">Attributs</a>.</td></tr><tr><td><code>missingSecretReferenceVariable</code></td><td>Une référence dans un modèle utilise une variable d’environnement qui n’est pas définie.</td><td>Définissez la variable, ou donnez-lui une valeur par défaut avec <code>${NAME:-default}</code>. Consultez <a href="/cli/fr/reference/secret-references.md#references-inside-a-text">Références dans un texte</a>.</td></tr><tr><td><code>secretLaunchArgumentReference</code></td><td>Une référence <code>devo://</code> a été écrite comme argument de la commande à exécuter.</td><td>Passez-la avec <code>--env-ref</code>, <code>--stdin-reference</code> ou <code>--manifest</code>. Consultez <a href="/cli/fr/guides/secrets/run-with-secrets.md">Exécuter une commande avec ses secrets</a>.</td></tr><tr><td><code>secretLaunchTimedOut</code></td><td>La commande démarrée par <code>devo secret run</code> a dépassé <code>--timeout-seconds</code>.</td><td>Augmentez le délai d’expiration, ou cherchez pourquoi la commande prend autant de temps.</td></tr><tr><td><code>secretLaunchCancelled</code>, <code>interrupted</code></td><td>La commande a été interrompue.</td><td>Exécutez-la de nouveau.</td></tr><tr><td><code>operationNotSupportedBySource</code></td><td>Le type d’espace de travail sélectionné ne peut pas exécuter cette commande.</td><td>Sélectionnez un autre espace de travail avec <code>--context</code>. Consultez <a href="/cli/fr/aide/troubleshooting/not-supported.md">Une commande dit que l’espace de travail ne la prend pas en charge</a>.</td></tr><tr><td><code>cloudContextNotFound</code></td><td>Aucun contexte Devolutions Cloud portant ce nom, ou aucun contexte actuel.</td><td>Vérifiez <code>devo context list</code>, ou connectez-vous avec <code>devo login</code>. Consultez <a href="/cli/fr/aide/troubleshooting/sign-in-fails.md">La connexion échoue ou la session a expiré</a>.</td></tr><tr><td><code>daemonUnavailable</code>, <code>daemonTimeout</code>, <code>daemonIoError</code></td><td>Le processus en arrière-plan n’a pas pu être joint, n’a pas répondu à temps, ou la connexion s’est interrompue.</td><td>Exécutez <code>devo daemon status</code>, puis <code>devo daemon restart</code>. Consultez <a href="/cli/fr/aide/troubleshooting/daemon-wont-start.md">Le processus en arrière-plan ne démarre pas</a>.</td></tr><tr><td><code>unexpectedError</code></td><td>Une erreur que Devolutions CLI n’attendait pas.</td><td>Exécutez <code>devo doctor</code> et communiquez avec le soutien. Consultez <a href="/cli/fr/aide/troubleshooting/collect-diagnostics.md">Collecter les diagnostics pour le soutien</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/fr/reference/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.
