Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
DescribeSecurityPolicy
Menjelaskan kebijakan keamanan yang dilampirkan ke server atau konektor SFTP Anda. Respons berisi deskripsi properti kebijakan keamanan. Untuk informasi selengkapnya tentang kebijakan keamanan, lihat Bekerja dengan kebijakan keamanan untuk server atau Bekerja dengan kebijakan keamanan untuk konektor SFTP.
Sintaksis Permintaan
{
"SecurityPolicyName": "string
"
}
Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat Parameter Umum.
Permintaan menerima data berikut dalam format JSON.
- SecurityPolicyName
-
Tentukan nama teks kebijakan keamanan yang Anda inginkan detailnya.
Jenis: String
Batasan Panjang: Panjang minimum 0. Panjang maksimum 100.
Pola:
Transfer[A-Za-z0-9]*SecurityPolicy-[A-Za-z0-9-]+
Diperlukan: Ya
Sintaksis Respons
{
"SecurityPolicy": {
"Fips": boolean,
"Protocols": [ "string" ],
"SecurityPolicyName": "string",
"SshCiphers": [ "string" ],
"SshHostKeyAlgorithms": [ "string" ],
"SshKexs": [ "string" ],
"SshMacs": [ "string" ],
"TlsCiphers": [ "string" ],
"Type": "string"
}
}
Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
- SecurityPolicy
-
Array yang berisi properti kebijakan keamanan.
Tipe: Objek DescribedSecurityPolicy
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
Perintah contoh berikut mengambil nama kebijakan keamanan sebagai argumen, dan mengembalikan algoritme untuk kebijakan keamanan yang ditentukan.
Permintaan Sampel
aws transfer describe-security-policy --security-policy-name "TransferSecurityPolicy-FIPS-2023-05"
Contoh Respons
{
"SecurityPolicy": {
"Fips": true,
"SecurityPolicyName": "TransferSecurityPolicy-FIPS-2023-05",
"SshCiphers": [
"aes256-gcm@openssh.com",
"aes128-gcm@openssh.com",
"aes256-ctr",
"aes192-ctr"
],
"SshKexs": [
"diffie-hellman-group16-sha512",
"diffie-hellman-group18-sha512",
"diffie-hellman-group-exchange-sha256"
],
"SshMacs": [
"hmac-sha2-256-etm@openssh.com",
"hmac-sha2-512-etm@openssh.com"
],
"TlsCiphers": [
"TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256",
"TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256",
"TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256",
"TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256",
"TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384",
"TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384",
"TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384",
"TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384"
]
}
}
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini: