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à.
ListHostKeys
Restituisce un elenco di chiavi host per il server specificato dal ServerId parametro.
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 nel JSON formato.
- MaxResults
-
Il numero massimo di chiavi host da restituire.
Tipo: integer
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
Campo obbligatorio: no
- NextToken
-
Se ci sono risultati aggiuntivi che non sono stati restituiti, viene restituito un
NextTokenparametro. È possibile utilizzare quel valore per una chiamata successiva per continuareListHostKeysa elencare i risultati.Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 6144.
Campo obbligatorio: no
- ServerId
-
L'identificatore del server che contiene le chiavi host che si desidera visualizzare.
Tipo: stringa
Vincoli di lunghezza: lunghezza fissa di 19.
Modello:
s-([0-9a-f]{17})Campo obbligatorio: sì
Sintassi della risposta
{
"HostKeys": [
{
"Arn": "string",
"DateImported": number,
"Description": "string",
"Fingerprint": "string",
"HostKeyId": "string",
"Type": "string"
}
],
"NextToken": "string",
"ServerId": "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.
- HostKeys
-
Restituisce un array, in cui ogni elemento contiene i dettagli di una chiave host.
Tipo: matrice di oggetti ListedHostKey
- NextToken
-
Restituisce un token che è possibile utilizzare per chiamare
ListHostKeysnuovamente e ricevere risultati aggiuntivi, se presenti.Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 6144.
- ServerId
-
Restituisce l'identificatore del server che contiene le chiavi host elencate.
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
HTTPCodice di stato: 500
- InvalidNextTokenException
-
Il
NextTokenparametro 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:
