ListLocations - AWS DataSync
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à.

ListLocations

Restituisce un elenco di percorsi di origine e di destinazione.

Se hai più sedi di quelle restituite in una risposta (ovvero, la risposta restituisce solo un elenco troncato dei tuoi agenti), la risposta contiene un token che puoi specificare nella tua prossima richiesta per recuperare la pagina successiva di sedi.

Sintassi della richiesta

{
   "Filters": [ 
      { 
         "Name": "string",
         "Operator": "string",
         "Values": [ "string" ]
      }
   ],
   "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.

Filters

È possibile immettere filtri API per restringere l'elenco delle risorse restituite daListLocations. Ad esempio, per recuperare tutte le attività in una posizione di origine specifica, puoi utilizzareListLocations con il nome del filtroLocationType S3 eOperator Equals.

Tipo: matrice di oggetti LocationFilter

Required: No

MaxResults

Il numero massimo di luoghi da restituire.

Tipo: integer

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

Required: No

NextToken

Una stringa opaca che indica la posizione da cui iniziare il prossimo elenco di località.

Tipo: String

Limitazioni di lunghezza: lunghezza massima di 65535.

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

Required: No

Sintassi della risposta

{
   "Locations": [ 
      { 
         "LocationArn": "string",
         "LocationUri": "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.

Locations

Un array che contiene un elenco di posizioni.

Tipo: matrice di oggetti LocationListEntry

NextToken

Una stringa opaca che indica la posizione da cui iniziare a restituire il prossimo elenco di posizioni.

Tipo: String

Limitazioni di lunghezza: lunghezza massima di 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: