ListAgents - AWS DataSync

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

ListAgents

Restituisce un elenco di AWS DataSync agenti che appartengono Account AWS a uno dei Regione AWS specificati nella richiesta.

Con l'impaginazione, è possibile ridurre il numero di agenti restituiti in una risposta. Se in una risposta viene visualizzato un elenco troncato di agenti, la risposta contiene un marker che è possibile specificare nella richiesta successiva per recuperare la pagina successiva di agenti.

ListAgentsalla fine è coerente. Ciò significa che il risultato dell'esecuzione dell'operazione potrebbe non rispecchiare la creazione o l'eliminazione di un agente da parte dell'utente. Ad esempio, se si crea un agente con CreateAgente poi lo si esegue immediatamenteListAgents, tale agente potrebbe non comparire immediatamente nell'elenco. In situazioni come questa, puoi sempre confermare se un agente è stato creato (o eliminato) utilizzando DescribeAgent.

Sintassi della richiesta

{ "MaxResults": number, "NextToken": "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 DataSync agenti da elencare in una risposta. Per impostazione predefinita, una risposta mostra un massimo di 100 agenti.

Tipo: integer

Intervallo valido: valore minimo di 0. valore massimo pari a 100.

Campo obbligatorio: no

NextToken

Specifica una stringa opaca che indica la posizione in cui iniziare l'elenco successivo di risultati nella risposta.

Tipo: stringa

Vincoli di lunghezza: lunghezza massima di 65535.

Modello: [a-zA-Z0-9=_-]+

Campo obbligatorio: no

Sintassi della risposta

{ "Agents": [ { "AgentArn": "string", "Name": "string", "Platform": { "Version": "string" }, "Status": "string" } ], "NextToken": "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.

Agents

Un elenco degli DataSync agenti presenti nel tuo account come Regione AWS specificato Account AWS nella richiesta. L'elenco è ordinato in base agli Amazon Resource Names () ARNs degli agenti.

Tipo: matrice di oggetti AgentListEntry

NextToken

La stringa opaca che indica la posizione in cui iniziare l'elenco successivo di risultati nella risposta.

Tipo: stringa

Vincoli di lunghezza: lunghezza massima di 65535.

Modello: [a-zA-Z0-9=_-]+

Errori

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

InternalException

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

Codice di stato HTTP: 500

InvalidRequestException

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

Codice di stato HTTP: 400

Vedi anche

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