ListExecutions - AWS Transfer Family
Sintassi della richiestaParametri della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

ListExecutions

Elenca tutte le esecuzioni in corso per il flusso di lavoro specificato.

Nota

Se l'ID del flusso di lavoro specificato non può essere trovato, ListExecutions restituisce un'ResourceNotFoundeccezione.

Sintassi della richiesta

{
   "MaxResults": number,
   "NextToken": "string",
   "WorkflowId": "string"
}

Parametri della richiesta

Per informazioni sui parametri comuni per tutte le azioni, consulta Parametri comuni.

La richiesta accetta i seguenti dati nel JSON formato.

MaxResults

Speciifica il numero massimo di esecuzioni da restituire.

Tipo: integer

Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.

Campo obbligatorio: no

NextToken

ListExecutionsrestituisce il NextToken parametro nell'output. È quindi possibile passare il NextToken parametro in un comando successivo per continuare a elencare le esecuzioni aggiuntive.

Ciò è utile, ad esempio, per l'impaginazione. Se hai 100 esecuzioni per un flusso di lavoro, potresti voler elencare solo le prime 10. In tal caso, chiamali API specificando: max-results

aws transfer list-executions --max-results 10

Ciò restituisce i dettagli per le prime 10 esecuzioni, nonché il puntatore (NextToken) all'undicesima esecuzione. Ora puoi richiamarlo, fornendo il API valore che hai ricevuto: NextToken

aws transfer list-executions --max-results 10 --next-token $somePointerReturnedFromPreviousListResult

Questa chiamata restituisce le successive 10 esecuzioni, dall'undicesima alla ventesima. È quindi possibile ripetere la chiamata fino a quando non saranno stati restituiti i dettagli di tutte le 100 esecuzioni.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 6144.

Campo obbligatorio: no

WorkflowId

Un identificatore univoco per il flusso di lavoro.

Tipo: stringa

Vincoli di lunghezza: lunghezza fissa di 19.

Modello: w-([a-z0-9]{17})

Campo obbligatorio: sì

Sintassi della risposta

{
   "Executions": [ 
      { 
         "ExecutionId": "string",
         "InitialFileLocation": { 
            "EfsFileLocation": { 
               "FileSystemId": "string",
               "Path": "string"
            },
            "S3FileLocation": { 
               "Bucket": "string",
               "Etag": "string",
               "Key": "string",
               "VersionId": "string"
            }
         },
         "ServiceMetadata": { 
            "UserDetails": { 
               "ServerId": "string",
               "SessionId": "string",
               "UserName": "string"
            }
         },
         "Status": "string"
      }
   ],
   "NextToken": "string",
   "WorkflowId": "string"
}

Elementi di risposta

Se l'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.

I seguenti dati vengono restituiti in JSON formato dal servizio.

Executions

Restituisce i dettagli per ogni esecuzione, in un ListedExecution array.

Tipo: matrice di oggetti ListedExecution

NextToken

ListExecutionsrestituisce il NextToken parametro nell'output. È quindi possibile passare il NextToken parametro in un comando successivo per continuare a elencare le esecuzioni aggiuntive.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 6144.

WorkflowId

Un identificatore univoco per il flusso di lavoro.

Tipo: stringa

Vincoli di lunghezza: lunghezza fissa di 19.

Modello: w-([a-z0-9]{17})

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

InternalServiceError

Questa eccezione viene generata quando si verifica un errore nel servizio. AWS Transfer Family

HTTPCodice di stato: 500

InvalidNextTokenException

Il NextToken parametro passato non è valido.

HTTPCodice di stato: 400

InvalidRequestException

Questa eccezione viene generata quando il client invia una richiesta non valida.

HTTPCodice di stato: 400

ResourceNotFoundException

Questa eccezione viene generata quando una risorsa non viene trovata dal servizio AWS Transfer Family.

HTTPCodice di stato: 400

ServiceUnavailableException

La richiesta non è riuscita perché il servizio AWS Transfer Family non è disponibile.

HTTPCodice di stato: 500

Vedi anche

Per ulteriori informazioni sull'utilizzo API in una delle lingue specifiche AWS SDKs, consulta quanto segue: