Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
ImportSshPublicKey
Menambahkan kunci publik Secure Shell (SSH) ke pengguna Transfer Family yang diidentifikasi oleh UserName
nilai yang ditetapkan ke server berkemampuan protokol transfer file tertentu, yang diidentifikasi oleh. ServerId
Respons mengembalikan UserName
nilai, ServerId
nilai, dan namaSshPublicKeyId
.
Sintaksis Permintaan
{
"ServerId": "string
",
"SshPublicKeyBody": "string
",
"UserName": "string
"
}
Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat Parameter Umum.
Permintaan menerima data berikut dalam format JSON.
- ServerId
-
Pengidentifikasi unik yang ditetapkan sistem untuk server.
Jenis: String
Kendala Panjang: Panjang tetap 19.
Pola:
s-([0-9a-f]{17})
Wajib: Ya
- SshPublicKeyBody
-
Bagian kunci publik dari SSH key pair.
AWS Transfer Family menerima kunci RSA, ECDSA, dan ED25519.
Jenis: String
Batasan Panjang: Panjang minimum sebesar 0. Panjang maksimum 2048.
Wajib: Ya
- UserName
-
Nama pengguna Transfer Family yang ditetapkan ke satu atau beberapa server.
Jenis: String
Batasan Panjang: Panjang minimum 3. Panjang maksimum 100.
Pola:
[\w][\w@.-]{2,99}
Diperlukan: Ya
Sintaksis Respons
{
"ServerId": "string",
"SshPublicKeyId": "string",
"UserName": "string"
}
Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
- ServerId
-
Pengidentifikasi unik yang ditetapkan sistem untuk server.
Jenis: String
Kendala Panjang: Panjang tetap 19.
Pola:
s-([0-9a-f]{17})
- SshPublicKeyId
-
Nama yang diberikan untuk kunci publik oleh sistem yang diimpor.
Jenis: String
Kendala Panjang: Panjang tetap 21.
Pola:
key-[0-9a-f]{17}
- UserName
-
Nama pengguna yang ditetapkan ke
ServerID
nilai yang Anda tentukan.Jenis: String
Batasan Panjang: Panjang minimum 3. Panjang maksimum 100.
Pola:
[\w][\w@.-]{2,99}
Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.
- InternalServiceError
-
Pengecualian ini dilemparkan ketika kesalahan terjadi dalam AWS Transfer Family layanan.
Kode Status HTTP: 500
- InvalidRequestException
-
Pengecualian ini dilontarkan ketika klien mengirimkan permintaan yang salah format.
Kode Status HTTP: 400
- ResourceExistsException
-
Sumber daya yang diminta tidak ada, atau ada di wilayah selain yang ditentukan untuk perintah.
Kode Status HTTP: 400
- ResourceNotFoundException
-
Pengecualian ini dilemparkan ketika sumber daya tidak ditemukan oleh layanan AWS Transfer Family.
Kode Status HTTP: 400
- ServiceUnavailableException
-
Permintaan gagal karena layanan AWS Transfer Family tidak tersedia.
Kode Status HTTP: 500
- ThrottlingException
-
Permintaan ditolak karena throttling permintaan.
Kode Status HTTP: 400
Contoh
Contoh
Perintah ini mengimpor kunci ECDSA yang disimpan dalam file. id_ecdsa.pub
aws transfer import-ssh-public-key --server-id s-021345abcdef6789 --ssh-public-key-body file://id_ecdsa.pub --user-name jane-doe
Contoh
Jika Anda menjalankan perintah sebelumnya, sistem mengembalikan informasi berikut.
{ "ServerId": "s-021345abcdef6789", "SshPublicKeyId": "key-1234567890abcdef0", "UserName": "jane-doe" }
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini: