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à.
ImportSshPublicKey
Aggiunge una chiave pubblica Secure Shell (SSH) a un utente Transfer Family identificato da un UserName
valore assegnato allo specifico server abilitato al protocollo di trasferimento file, identificato da. ServerId
La risposta restituisce il UserName
valore, il ServerId
valore e il nome di. SshPublicKeyId
Sintassi della richiesta
{
"ServerId": "string
",
"SshPublicKeyBody": "string
",
"UserName": "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.
- ServerId
-
Un identificatore univoco assegnato dal sistema per un server.
▬Tipo: stringa
Vincoli di lunghezza: lunghezza fissa di 19.
Modello:
s-([0-9a-f]{17})
Campo obbligatorio: sì
- SshPublicKeyBody
-
La parte della chiave pubblica di una coppia di chiavi SSH.
AWS Transfer Family accetta le chiavi RSA, ECDSA ed ED25519.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 2048 caratteri.
Campo obbligatorio: sì
- UserName
-
Il nome dell'utente Transfer Family assegnato a uno o più server.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 3. Lunghezza massima di 100.
Modello:
[\w][\w@.-]{2,99}
Campo obbligatorio: sì
Sintassi della risposta
{
"ServerId": "string",
"SshPublicKeyId": "string",
"UserName": "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.
- ServerId
-
Un identificatore univoco assegnato dal sistema per un server.
▬Tipo: stringa
Vincoli di lunghezza: lunghezza fissa di 19.
Modello:
s-([0-9a-f]{17})
- SshPublicKeyId
-
Il nome assegnato a una chiave pubblica dal sistema che è stata importata.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza fissa di 21.
Modello:
key-[0-9a-f]{17}
- UserName
-
Un nome utente assegnato al
ServerID
valore specificato.▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 3. Lunghezza massima di 100.
Modello:
[\w][\w@.-]{2,99}
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.
Codice di stato HTTP: 500
- InvalidRequestException
-
Questa eccezione viene generata quando il client invia una richiesta non valida.
Codice di stato HTTP: 400
- ResourceExistsException
-
La risorsa richiesta non esiste o esiste in una regione diversa da quella specificata per il comando.
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
- ThrottlingException
-
La richiesta è stata negata a causa del throttling della richiesta.
Codice di stato HTTP: 400
Esempi
Esempio
Questo comando importa una chiave ECDSA memorizzata nel id_ecdsa.pub
file.
aws transfer import-ssh-public-key --server-id s-021345abcdef6789 --ssh-public-key-body file://id_ecdsa.pub --user-name jane-doe
Esempio
Se si esegue il comando precedente, il sistema restituisce le seguenti informazioni.
{ "ServerId": "s-021345abcdef6789", "SshPublicKeyId": "key-1234567890abcdef0", "UserName": "jane-doe" }
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue: