Pemberitahuan akhir dukungan: Pada 15 September 2025, AWS akan menghentikan dukungan untuk Amazon Lex V1. Setelah 15 September 2025, Anda tidak lagi dapat mengakses konsol Amazon Lex V1 atau sumber daya Amazon Lex V1. Jika Anda menggunakan Amazon Lex V2, lihat panduan Amazon Lex V2 sebagai gantinya.
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
GetBots
Mengembalikan informasi bot sebagai berikut:
-
Jika Anda memberikan
nameContainsbidang, respons menyertakan informasi untuk$LATESTversi semua bot yang namanya berisi string yang ditentukan. -
Jika Anda tidak menentukan
nameContainsbidang, operasi akan mengembalikan informasi tentang$LATESTversi semua bot Anda.
Operasi ini memerlukan izin untuk tindakan lex:GetBots.
Minta Sintaks
GET /bots/?maxResults=maxResults&nameContains=nameContains&nextToken=nextToken HTTP/1.1
Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
- maxResults
-
Jumlah maksimum bot yang akan dikembalikan dalam respons bahwa permintaan akan dikembalikan. Default-nya adalah 10.
Rentang yang Valid: Nilai minimum 1. Nilai maksimum 50.
- nameContains
-
Substring agar sesuai dengan nama bot. Bot akan dikembalikan jika ada bagian dari namanya yang cocok dengan substring. Misalnya, “xyz” cocok dengan “xyzabc” dan “abcxyz.”
Kendala Panjang: Panjang minimum 2. Panjang maksimum 50.
Pola:
^([A-Za-z]_?)+$ - nextToken
-
Token pagination yang mengambil halaman bot berikutnya. Jika respons terhadap panggilan ini terpotong, Amazon Lex mengembalikan token pagination dalam respons. Untuk mengambil halaman bot berikutnya, tentukan token pagination di permintaan berikutnya.
Isi Permintaan
Permintaan tidak memiliki isi permintaan.
Sintaks Respons
HTTP/1.1 200
Content-type: application/json
{
"bots": [
{
"createdDate": number,
"description": "string",
"lastUpdatedDate": number,
"name": "string",
"status": "string",
"version": "string"
}
],
"nextToken": "string"
}Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
- bots
-
Sebuah array
botMetadataobjek, dengan satu entri untuk setiap bot.Tipe: Array objek BotMetadata
- nextToken
-
Jika respons terpotong, itu termasuk token pagination yang dapat Anda tentukan dalam permintaan berikutnya untuk mengambil halaman bot berikutnya.
Tipe: String
Kesalahan
- BadRequestException
-
Permintaan tidak terbentuk dengan baik. Misalnya, nilai tidak valid atau bidang wajib hilang. Periksa nilai bidang, dan coba lagi.
Kode Status HTTP: 400
- InternalFailureException
-
Terjadi kesalahan internal Amazon Lex. Coba permintaan Anda lagi.
Kode Status HTTP: 500
- LimitExceededException
-
Permintaan melebihi batas. Coba permintaan Anda lagi.
Kode Status HTTP: 429
- NotFoundException
-
Sumber daya yang ditentukan dalam permintaan tidak ditemukan. Periksa sumber daya dan coba lagi.
Kode Status HTTP: 404
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
