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 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

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, 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

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

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: