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 diAWS DataSync agenti che appartengonoAccount AWS a unRegione AWS elemento specificato nella richiesta.
Con l'impaginazione, è possibile ridurre il numero di Amazon Resource Name in una risposta. Se ricevi un elenco troncato di agenti in una risposta, la risposta contiene un indicatore che puoi specificare nella tua prossima richiesta per recuperare la pagina successiva degli agenti.
ListAgents
è a consistenza finale. Ciò significa che il risultato dell'esecuzione dell'operazione potrebbe non riflettere la creazione o l'eliminazione di un agente appena creato o eliminato. Ad esempio, se crei un agente con CreateAgente poi lo esegui immediatamenteListAgents
, quell'agente potrebbe non essere visualizzato 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 a tutte le azioni, vedere Parametri comuni.
La richiesta accetta i seguenti dati in formato JSON.
- MaxResults
-
Specifica il numero massimoDataSync di Amazon di 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.
Required: No
- NextToken
-
Specifica una stringa opaca che indica la posizione in cui iniziare l'elenco successivo di risultati nella risposta.
Tipo: String
Vincoli di lunghezza: lunghezza: lunghezza: lunghezza: lunghezza: 65535.
Modello:
[a-zA-Z0-9=_-]+
Required: No
Sintassi della risposta
{
"Agents": [
{
"AgentArn": "string",
"Name": "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 degliDataSync agentiAccount AWS a tua disposizione comeRegione AWS specificato nella richiesta. L'elenco è ordinato in Amazon Resource Name (ARN) degli Amazon Resource Name (ARN) 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: String
Vincoli di lunghezza: lunghezza: lunghezza: lunghezza: lunghezza: 65535.
Pattern:
[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 nelAWS DataSync servizio.
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 uno degli SDK AWS specifici della lingua, consulta quanto segue: