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.
Mengembalikan daftar alias untuk bot Amazon Lex tertentu.
Operasi ini memerlukan izin utuk tindakan lex:GetBotAliases
.
Minta Sintaks
GET /bots/botName
/aliases/?maxResults=maxResults
&nameContains=nameContains
&nextToken=nextToken
HTTP/1.1
Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
- botName
-
Nama bot.
Kendala Panjang: Panjang minimum 2. Panjang maksimum 50.
Pola:
^([A-Za-z]_?)+$
Wajib: Ya
- maxResults
-
Jumlah maksimum alias untuk kembali dalam respons. Defaultnya adalah 50.
Rentang yang Valid: Nilai minimum 1. Nilai maksimum 50.
- nameContains
-
Substring untuk mencocokkan nama alias bot. Alias akan dikembalikan jika ada bagian dari namanya yang cocok dengan substring. Misalnya, “xyz” cocok dengan “xyzabc” dan “abcxyz.”
Batasan Panjang: Panjang minimum 1. Panjang maksimum 100.
Pola:
^([A-Za-z]_?)+$
- nextToken
-
Token pagination untuk mengambil halaman berikutnya dari alias. Jika respons terhadap panggilan ini terpotong, Amazon Lex mengembalikan token pagination dalam respons. Untuk mengambil halaman alias berikutnya, tentukan token pagination di permintaan berikutnya.
Isi Permintaan
Permintaan tidak memiliki isi permintaan.
Sintaks Respons
HTTP/1.1 200
Content-type: application/json
{
"BotAliases": [
{
"botName": "string",
"botVersion": "string",
"checksum": "string",
"conversationLogs": {
"iamRoleArn": "string",
"logSettings": [
{
"destination": "string",
"kmsKeyArn": "string",
"logType": "string",
"resourceArn": "string",
"resourcePrefix": "string"
}
]
},
"createdDate": number,
"description": "string",
"lastUpdatedDate": number,
"name": "string"
}
],
"nextToken": "string"
}
Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
- BotAliases
-
Sebuah array
BotAliasMetadata
objek, masing-masing menggambarkan alias bot.Tipe: Array objek BotAliasMetadata
- nextToken
-
Token pagination untuk mengambil halaman berikutnya dari alias. Jika respons terhadap panggilan ini terpotong, Amazon Lex mengembalikan token pagination dalam respons. Untuk mengambil halaman alias berikutnya, tentukan token pagination di permintaan 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
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini: