Jika Anda menggunakan Amazon Lex V2, lihat panduan Amazon Lex V2 sebagai gantinya.
Jika Anda menggunakan Amazon Lex V1, kami sarankan untuk meningkatkan bot Anda ke Amazon Lex V2. Kami tidak lagi menambahkan fitur baru ke V1 dan sangat menyarankan menggunakan V2 untuk semua bot baru.
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
PutBotAlias
Membuat alias untuk versi bot yang ditentukan atau menggantikan alias untuk bot yang ditentukan. Untuk mengubah versi bot yang ditunjuk alias, ganti alias. Untuk informasi selengkapnya tentang alias, lihatPembuatan Versi dan Alias.
Operasi ini memerlukan izin utuk tindakan lex:PutBotAlias
.
Minta Sintaks
PUT /bots/botName
/aliases/name
HTTP/1.1
Content-type: application/json
{
"botVersion": "string
",
"checksum": "string
",
"conversationLogs": {
"iamRoleArn": "string
",
"logSettings": [
{
"destination": "string
",
"kmsKeyArn": "string
",
"logType": "string
",
"resourceArn": "string
"
}
]
},
"description": "string
",
"tags": [
{
"key": "string
",
"value": "string
"
}
]
}
Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
Isi Permintaan
Permintaan menerima data berikut dalam format JSON.
- botVersion
-
Versi bot.
Jenis: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.
Pola:
\$LATEST|[0-9]+
Diperlukan: Ya
- checksum
-
Mengidentifikasi revisi spesifik dari versi.
$LATEST
Saat Anda membuat alias bot baru, biarkan
checksum
bidang kosong. Jika Anda menentukan checksum, Anda mendapatkanBadRequestException
pengecualian.Saat Anda ingin memperbarui alias bot, atur
checksum
bidang ke checksum dari revisi versi terbaru.$LATEST
Jika Anda tidak menentukanchecksum
bidang, atau jika checksum tidak cocok dengan$LATEST
versi, Anda mendapatkanPreconditionFailedException
pengecualian.Tipe: String
Wajib: Tidak
- conversationLogs
-
Pengaturan untuk log percakapan untuk alias.
Tipe: Objek ConversationLogsRequest
Diperlukan: Tidak
- description
-
Deskripsi alias.
Tipe: String
Batasan Panjang: Panjang minimum 0. Panjang maksimum 200.
Diperlukan: Tidak
-
Daftar tag untuk ditambahkan ke alias bot. Anda hanya dapat menambahkan tag ketika Anda membuat alias, Anda tidak dapat menggunakan
PutBotAlias
operasi untuk memperbarui tag pada alias bot. Untuk memperbarui tag, gunakanTagResource
operasi.Tipe: Array objek Tag
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 200 item.
Diperlukan: Tidak
Sintaksis Respons
HTTP/1.1 200
Content-type: application/json
{
"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",
"tags": [
{
"key": "string",
"value": "string"
}
]
}
Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
- botName
-
Nama bot yang ditunjuk alias.
Jenis: String
Kendala Panjang: Panjang minimum 2. Panjang maksimum 50.
Pola:
^([A-Za-z]_?)+$
- botVersion
-
Versi bot yang ditunjuk alias.
Jenis: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.
Pola:
\$LATEST|[0-9]+
- checksum
-
Checksum untuk versi alias saat ini.
Jenis: String
- conversationLogs
-
Pengaturan yang menentukan bagaimana Amazon Lex menggunakan log percakapan untuk alias.
Tipe: Objek ConversationLogsResponse
- createdDate
-
Tanggal alias bot dibuat.
Tipe: Timestamp
- description
-
Deskripsi alias.
Tipe: String
Batasan Panjang: Panjang minimum 0. Panjang maksimum 200.
- lastUpdatedDate
-
Tanggal alias bot diperbarui. Saat Anda membuat sumber daya, tanggal pembuatan dan tanggal pembaruan terakhir adalah sama.
Tipe: Timestamp
- name
-
Nama alias.
Tipe: String
Panjang Batasan: Panjang minimum 1. Panjang maksimum 100.
Pola:
^([A-Za-z]_?)+$
-
Daftar tag yang terkait dengan bot.
Tipe: Array objek Tag
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 200 item.
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
- ConflictException
-
Ada konflik yang memproses permintaan tersebut. Coba permintaan Anda lagi.
Kode Status HTTP: 409
- 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
- PreconditionFailedException
-
Checksum sumber daya yang Anda coba ubah tidak cocok dengan checksum dalam permintaan. Periksa checksum sumber daya dan coba lagi.
Kode Status HTTP: 412
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini: