PutBotAlias - Amazon Lex V1
Minta SintaksParameter Permintaan URIIsi PermintaanSintaksis ResponsElemen ResponsKesalahanLihat Juga

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.

botName

Nama bot.

Kendala Panjang: Panjang minimum 2. Panjang maksimum 50.

Pola: ^([A-Za-z]_?)+$

Diperlukan: Ya

name

Nama alias. Namanya tidak peka huruf besar/kecil.

Batasan Panjang: Panjang minimum 1. Panjang maksimum 100.

Pola: ^([A-Za-z]_?)+$

Wajib: Ya

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 mendapatkan BadRequestException pengecualian.

Saat Anda ingin memperbarui alias bot, atur checksum bidang ke checksum dari revisi versi terbaru. $LATEST Jika Anda tidak menentukan checksum bidang, atau jika checksum tidak cocok dengan $LATEST versi, Anda mendapatkan PreconditionFailedException 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

tags

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, gunakan TagResource 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]_?)+$

tags

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: