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.
ListAgents
alla 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: