Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
CreateProfile
Membuat profil lokal atau mitra untuk digunakan untuk AS2 transfer.
Sintaksis Permintaan
{
"As2Id": "string",
"CertificateIds": [ "string" ],
"ProfileType": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat Parameter Umum.
Permintaan menerima data berikut dalam JSON format.
- As2Id
-
As2IdItu adalah AS2-nama, seperti yang didefinisikan dalam RFC4130. Untuk transfer masuk, ini adalah AS2-Fromheader untuk AS2 pesan yang dikirim dari mitra. Untuk konektor keluar, ini adalahAS2-Toheader untuk AS2 pesan yang dikirim ke mitra menggunakanStartFileTransferAPI operasi. ID ini tidak dapat menyertakan spasi.Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.
Pola:
[\p{Print}\s]*Wajib: Ya
- CertificateIds
-
Array pengidentifikasi untuk sertifikat yang diimpor. Anda menggunakan pengenal ini untuk bekerja dengan profil dan profil mitra.
Tipe: Array string
Kendala Panjang: Panjang tetap 22.
Pola:
cert-([0-9a-f]{17})Wajib: Tidak
- ProfileType
-
Menentukan jenis profil yang akan dibuat:
-
Tentukan
LOCALuntuk membuat profil lokal. Profil lokal mewakili organisasi atau pihak server Transfer Family yang AS2 diaktifkan. -
Tentukan
PARTNERuntuk membuat profil mitra. Profil mitra mewakili organisasi jarak jauh, di luar Transfer Family.
Tipe: String
Nilai yang Valid:
LOCAL | PARTNERWajib: Ya
-
- Tags
-
Pasangan nilai kunci yang dapat digunakan untuk mengelompokkan dan mencari AS2 profil.
Tipe: Array objek Tag
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 50 item.
Diperlukan: Tidak
Sintaksis Respons
{
"ProfileId": "string"
}Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Data berikut dikembalikan dalam JSON format oleh layanan.
- ProfileId
-
Pengidentifikasi unik untuk AS2 profil, dikembalikan setelah API panggilan berhasil.
Tipe: String
Kendala Panjang: Panjang tetap 19.
Pola:
p-([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.
HTTPKode Status: 500
- InvalidRequestException
-
Pengecualian ini dilontarkan ketika klien mengirimkan permintaan yang salah format.
HTTPKode Status: 400
- ResourceNotFoundException
-
Pengecualian ini dilemparkan ketika sumber daya tidak ditemukan oleh layanan AWS Transfer Family.
HTTPKode Status: 400
- ServiceUnavailableException
-
Permintaan gagal karena layanan AWS Transfer Family tidak tersedia.
HTTPKode Status: 500
- ThrottlingException
-
Permintaan ditolak karena throttling permintaan.
HTTPKode Status: 400
Contoh
Contoh
Contoh berikut membuat profil, dan mengembalikan ID profil.
Sertifikat IDs dibuat saat Anda menjalankanimport-certificate, satu untuk sertifikat penandatanganan, dan satu untuk sertifikat enkripsi.
aws transfer create-profile --as2-id MYCORP --certificate-ids c-abcdefg123456hijk c-987654aaaa321bbbb
Contoh Respons
APIPanggilan mengembalikan ID profil untuk profil baru.
{ "ProfileId": "p-11112222333344444" }
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan ini API di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
