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:
