Utilizzo dei codici di ritorno

Un codice restituito è in genere, ma non sempre, un codice nascosto inviato dopo l'esecuzione di un comando CLI di Amazon DCV Session Manager che ne descrive lo stato.

Per visualizzare questi codici di ritorno, puoi usare il comando. echo Viene visualizzato il codice inviato dall'ultimo comando CLI di Session Manager. YOu può utilizzare questi codici per determinare se un comando ha avuto successo o meno e perché un comando può avere un errore.

Oltre ai codici restituiti, è possibile visualizzare ulteriori dettagli su un errore eseguendo i comandi con--debug. Questo produce un rapporto dettagliato dei passaggi utilizzati dalla CLI di Session Manager per elaborare il comando e il risultato di ogni passaggio.

Per determinare il codice restituito da un comando CLI DCV SM, esegui uno dei seguenti comandi subito dopo aver eseguito il comando CLI.

• Linux e macOS

  $  echo $?
  0

• Windows PowerShell

  $  echo $lastexitcode
  0

• Prompt dei comandi di Windows

  $  echo %errorlevel%
  0

I seguenti codici restituiti vengono visualizzati al termine dell'esecuzione di un comando CLI:

• 0Il comando ha avuto successo. Non sono stati generati errori né dalla CLI né dal servizio a cui è stata effettuata la richiesta.

• 1Il file di configurazione analizzato nella CLI non è stato trovato o potrebbe essere danneggiato.

• 2Il comando immesso nella riga di comando non è stato analizzato. Gli errori di analisi possono essere causati, a titolo esemplificativo, dalla mancanza di sottocomandi o argomenti richiesti o dall'utilizzo di comandi o argomenti sconosciuti. Nota che questo significato del codice restituito è applicabile a tutti i comandi CLI.

• 130Il processo ha ricevuto un SIGINT (Ctrl-C).

• 252La sintassi del comando non era valida, era stato fornito un parametro sconosciuto oppure il valore di un parametro non era corretto e impediva l'esecuzione del comando.

• 253L'ambiente o la configurazione del sistema non erano validi. Sebbene il comando fornito possa essere valido dal punto di vista sintattico, la configurazione o le credenziali mancanti ne hanno impedito l'esecuzione.

• 254Il comando è stato analizzato correttamente ed è stata inoltrata una richiesta al servizio specificato, ma il servizio ha restituito un errore. Ciò indica in genere un utilizzo errato dell'API o altri problemi specifici del servizio.

• 255Errore generico di tipo catch-all. È possibile che il comando sia stato analizzato correttamente, ma si è verificato un errore di runtime non specificato durante l'esecuzione del comando. Poiché si tratta di un codice di errore generale, un errore può passare da 255 a un codice restituito più specifico. Non si dovrebbe fare affidamento su un codice restituito pari a 255 per determinare un caso di errore specifico.