ListAccesses - AWS Transfer Family
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à.

ListAccesses

Elenca i dettagli di tutti gli accessi che hai sul tuo server.

Sintassi della richiesta

{
   "MaxResults": number,
   "NextToken": "string",
   "ServerId": "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 SID di accesso da restituire.

Tipo: integer

Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.

Campo obbligatorio: no

NextToken

Quando è possibile ottenere risultati aggiuntivi dalla ListAccesses chiamata, nell'output viene restituito un NextToken parametro. È quindi possibile passare un comando successivo al NextToken parametro per continuare a elencare gli accessi aggiuntivi.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 6144.

Campo obbligatorio: no

ServerId

Un identificatore univoco assegnato dal sistema per un server a cui sono assegnati utenti.

▬Tipo: stringa

Vincoli di lunghezza: lunghezza fissa di 19.

Modello: s-([0-9a-f]{17})

Campo obbligatorio: sì

Sintassi della risposta

{
   "Accesses": [ 
      { 
         "ExternalId": "string",
         "HomeDirectory": "string",
         "HomeDirectoryType": "string",
         "Role": "string"
      }
   ],
   "NextToken": "string",
   "ServerId": "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.

Accesses

Restituisce gli accessi e le relative proprietà per il ServerId valore specificato.

Tipo: matrice di oggetti ListedAccess

NextToken

Quando è possibile ottenere risultati aggiuntivi dalla ListAccesses chiamata, viene restituito un NextToken parametro nell'output. È quindi possibile passare un comando successivo al NextToken parametro per continuare a elencare gli accessi aggiuntivi.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 6144.

ServerId

Un identificatore univoco assegnato dal sistema per un server a cui sono assegnati utenti.

▬Tipo: stringa

Vincoli di lunghezza: lunghezza fissa di 19.

Modello: s-([0-9a-f]{17})

Errori

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

InternalServiceError

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

Codice di stato HTTP: 500

InvalidNextTokenException

Il NextToken parametro passato non è valido.

Codice di stato HTTP: 400

InvalidRequestException

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

Codice di stato HTTP: 400

ResourceNotFoundException

Questa eccezione viene generata quando una risorsa non viene trovata dal servizio AWS Transfer Family.

Codice di stato HTTP: 400

ServiceUnavailableException

La richiesta non è riuscita perché il servizio AWS Transfer Family non è disponibile.

Codice di stato HTTP: 500

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue: