ListCertificates - AWS Transfer Family
Sintaksis PermintaanParameter PermintaanSintaksis ResponsElemen ResponsKesalahanLihat Juga

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

ListCertificates

Mengembalikan daftar sertifikat saat ini yang telah diimpor ke AWS Transfer Family. Jika Anda ingin membatasi hasil ke angka tertentu, berikan nilai untuk MaxResults parameter tersebut. Jika Anda menjalankan perintah sebelumnya dan menerima nilai untuk NextToken parameter, Anda dapat memberikan nilai tersebut untuk melanjutkan daftar sertifikat dari tempat Anda tinggalkan.

Sintaksis Permintaan

{
   "MaxResults": number,
   "NextToken": "string"
}

Parameter Permintaan

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

Permintaan menerima data berikut dalam JSON format.

MaxResults

Jumlah maksimum sertifikat untuk dikembalikan.

Jenis: Integer

Rentang yang Valid: Nilai minimum 1. Nilai maksimum 1000.

Wajib: Tidak

NextToken

Ketika Anda bisa mendapatkan hasil tambahan dari ListCertificates panggilan, NextToken parameter dikembalikan dalam output. Anda kemudian dapat meneruskan perintah berikutnya ke NextToken parameter untuk melanjutkan daftar sertifikat tambahan.

Tipe: String

Panjang Batasan: Panjang minimum 1. Panjang maksimum 6144.

Wajib: Tidak

Sintaksis Respons

{
   "Certificates": [ 
      { 
         "ActiveDate": number,
         "Arn": "string",
         "CertificateId": "string",
         "Description": "string",
         "InactiveDate": number,
         "Status": "string",
         "Type": "string",
         "Usage": "string"
      }
   ],
   "NextToken": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Data berikut dikembalikan dalam JSON format oleh layanan.

Certificates

Mengembalikan array sertifikat yang ditentukan dalam ListCertificates panggilan.

Tipe: Array objek ListedCertificate

NextToken

Mengembalikan token berikutnya, yang dapat Anda gunakan untuk daftar sertifikat berikutnya.

Tipe: String

Panjang Batasan: Panjang minimum 1. Panjang maksimum 6144.

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

InvalidNextTokenException

NextTokenParameter yang dilewatkan tidak valid.

HTTPKode Status: 400

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

Lihat Juga

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