ImportCertificate - AWS Transfer Family

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

ImportCertificate

Mengimpor sertifikat penandatanganan dan enkripsi yang Anda perlukan untuk membuat profil lokal (AS2) dan profil mitra.

Sintaksis Permintaan

{ "ActiveDate": number, "Certificate": "string", "CertificateChain": "string", "Description": "string", "InactiveDate": number, "PrivateKey": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "Usage": "string" }

Parameter Permintaan

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat Parameter Umum.

Permintaan menerima data berikut dalam format JSON.

ActiveDate

Tanggal opsional yang menentukan kapan sertifikat menjadi aktif.

Tipe: Timestamp

Wajib: Tidak

Certificate
  • Untuk CLI, berikan jalur file untuk sertifikat dalam format URI. Misalnya, --certificate file://encryption-cert.pem. Atau, Anda dapat memberikan konten mentah.

  • Untuk SDK, tentukan konten mentah dari file sertifikat. Sebagai contoh, --certificate "`cat encryption-cert.pem`".

Jenis: String

Panjang Batasan: Panjang minimum 1. Panjang maksimum 16384.

Pola: [\u0009\u000A\u000D\u0020-\u00FF]*

Wajib: Ya

CertificateChain

Daftar opsional sertifikat yang membentuk rantai untuk sertifikat yang sedang diimpor.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 2097152.

Pola: [\u0009\u000A\u000D\u0020-\u00FF]*

Wajib: Tidak

Description

Deskripsi singkat yang membantu mengidentifikasi sertifikat.

Jenis: String

Panjang Batasan: Panjang minimum 1. Panjang maksimum 200.

Pola: [\p{Graph}]+

Wajib: Tidak

InactiveDate

Tanggal opsional yang menentukan kapan sertifikat menjadi tidak aktif.

Tipe: Timestamp

Wajib: Tidak

PrivateKey
  • Untuk CLI, berikan jalur file untuk kunci pribadi dalam format URI. Misalnya,. --private-key file://encryption-key.pem Atau, Anda dapat memberikan konten mentah dari file kunci pribadi.

  • Untuk SDK, tentukan konten mentah dari file kunci pribadi. Misalnya, --private-key "`cat encryption-key.pem`"

Jenis: String

Panjang Batasan: Panjang minimum 1. Panjang maksimum 16384.

Pola: [\u0009\u000A\u000D\u0020-\u00FF]*

Wajib: Tidak

Tags

Pasangan nilai kunci yang dapat digunakan untuk mengelompokkan dan mencari sertifikat.

Tipe: Array objek Tag

Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 50 item.

Wajib: Tidak

Usage

Menentukan bagaimana sertifikat ini digunakan. Ini dapat digunakan dengan cara-cara berikut:

  • SIGNING: Untuk menandatangani pesan AS2

  • ENCRYPTION: Untuk mengenkripsi pesan AS2

  • TLS: Untuk mengamankan komunikasi AS2 yang dikirim melalui HTTPS

Jenis: String

Nilai yang Valid: SIGNING | ENCRYPTION

Wajib: Ya

Sintaksis Respons

{ "CertificateId": "string" }

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

CertificateId

Array pengidentifikasi untuk sertifikat yang diimpor. Anda menggunakan pengenal ini untuk bekerja dengan profil dan profil mitra.

Jenis: String

Kendala Panjang: Panjang tetap 22.

Pola: cert-([0-9a-f]{17})

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

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

Contoh

Contoh

Contoh berikut mengimpor sertifikat yang akan digunakan untuk enkripsi. Pada perintah pertama, kami menyediakan konten file sertifikat dan rantai sertifikat. Gunakan format ini untuk perintah SDK.

aws transfer import-certificate --usage ENCRYPTION --certificate "`cat encryption-cert.pem`" \ --private-key "`cat encryption-key.pem`" --certificate-chain "`cat root-ca.pem`"

Contoh

Contoh berikut identik dengan perintah sebelumnya, kecuali bahwa kami menyediakan lokasi file untuk kunci pribadi, sertifikat, dan file rantai sertifikat. Versi perintah ini tidak berfungsi jika Anda menggunakan SDK.

aws transfer import-certificate --usage ENCRYPTION --certificate file://encryption-cert.pem \ --private-key file://encryption-key.pem --certificate-chain file://root-ca.pem

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini: