ListCertificates - 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à.

ListCertificates

Restituisce un elenco dei certificati correnti in cui sono stati importati AWS Transfer Family. Se desideri limitare i risultati a un determinato numero, fornisci un valore per il MaxResults parametro. Se hai eseguito il comando in precedenza e hai ricevuto un valore per il NextToken parametro, puoi fornire quel valore per continuare a elencare i certificati da dove avevi interrotto.

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 nel JSON formato.

MaxResults

Il numero massimo di certificati 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 ListCertificates chiamata, viene restituito un NextToken parametro nell'output. È quindi possibile passare un comando successivo al NextToken parametro per continuare a elencare certificati aggiuntivi.

Tipo: stringa

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

Campo obbligatorio: no

Sintassi della risposta

{
   "Certificates": [ 
      { 
         "ActiveDate": number,
         "Arn": "string",
         "CertificateId": "string",
         "Description": "string",
         "InactiveDate": number,
         "Status": "string",
         "Type": "string",
         "Usage": "string"
      }
   ],
   "NextToken": "string"
}

Elementi di risposta

Se l'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.

I seguenti dati vengono restituiti in JSON formato dal servizio.

Certificates

Restituisce una matrice dei certificati specificati nella ListCertificates chiamata.

Tipo: matrice di oggetti ListedCertificate

NextToken

Restituisce il token successivo, che è possibile utilizzare per elencare il certificato successivo.

Tipo: stringa

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

Errori

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

InternalServiceError

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

HTTPCodice di stato: 500

InvalidNextTokenException

Il NextToken parametro passato non è valido.

HTTPCodice di stato: 400

InvalidRequestException

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

HTTPCodice di stato: 400

ResourceNotFoundException

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

HTTPCodice di stato: 400

ServiceUnavailableException

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

HTTPCodice di stato: 500

Vedi anche

Per ulteriori informazioni sull'utilizzo API in una delle lingue specifiche AWS SDKs, consulta quanto segue: