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'ResourceNotFound
eccezione.
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 in formato JSON.
- 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
-
ListExecutions
restituisce ilNextToken
parametro nell'output. È quindi possibile passare ilNextToken
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, chiama l'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 richiamare nuovamente l'API, fornendo il 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'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- Executions
-
Restituisce i dettagli per ogni esecuzione, in un
ListedExecution
array.Tipo: matrice di oggetti ListedExecution
- NextToken
-
ListExecutions
restituisce ilNextToken
parametro nell'output. È quindi possibile passare ilNextToken
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
Codice di stato HTTP: 500
- InvalidNextTokenException
-
Il
NextToken
parametro passato non è valido.Codice di stato HTTP: 400
- InvalidRequestException
-
Questa eccezione viene generata quando il client invia una richiesta non valida.
Codice di stato HTTP: 400
- ResourceNotFoundException
-
Questa eccezione viene generata quando una risorsa non viene trovata dal servizio AWS Transfer Family.
Codice di stato HTTP: 400
- ServiceUnavailableException
-
La richiesta non è riuscita perché il servizio AWS Transfer Family non è disponibile.
Codice di stato HTTP: 500
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue: