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à.
ImportHostKey
Aggiunge una chiave host al server specificata dal ServerId
parametro.
Sintassi della richiesta
{
"Description": "string
",
"HostKeyBody": "string
",
"ServerId": "string
",
"Tags": [
{
"Key": "string
",
"Value": "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.
- Description
-
La descrizione testuale che identifica questa chiave host.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.
Modello:
[\p{Print}]*
Campo obbligatorio: no
- HostKeyBody
-
La parte relativa alla chiave privata di una coppia di SSH chiavi.
AWS Transfer Family accetta RSA ECDSA e ED25519 chiavi.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 4096.
Campo obbligatorio: sì
- ServerId
-
L'identificatore del server che contiene la chiave host che si sta importando.
Tipo: stringa
Vincoli di lunghezza: lunghezza fissa di 19.
Modello:
s-([0-9a-f]{17})
Campo obbligatorio: sì
- Tags
-
Coppie chiave-valore che possono essere utilizzate per raggruppare e cercare chiavi host.
Tipo: matrice di oggetti Tag
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 50 item.
Campo obbligatorio: no
Sintassi della risposta
{
"HostKeyId": "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.
- HostKeyId
-
Restituisce l'identificatore della chiave host per la chiave importata.
Tipo: stringa
Vincoli di lunghezza: lunghezza fissa di 25.
Modello:
hostkey-[0-9a-f]{17}
- ServerId
-
Restituisce l'identificatore del server che contiene la chiave importata.
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
- InvalidRequestException
-
Questa eccezione viene generata quando il client invia una richiesta non valida.
HTTPCodice di stato: 400
- ResourceExistsException
-
La risorsa richiesta non esiste o esiste in una regione diversa da quella specificata per il comando.
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
- ThrottlingException
-
La richiesta è stata negata a causa del throttling della richiesta.
HTTPCodice di stato: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo API in una delle lingue specifiche AWS SDKs, consulta quanto segue: