终止支持通知：2025年9月15日， AWS 我们将停止对Amazon Lex V1的支持。2025 年 9 月 15 日之后，您将无法再访问亚马逊 Lex V1 主机或 Amazon Lex V1 资源。如果您使用的是 Amazon Lex V2，请改为参阅 Amazon Lex V2 指南。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
CreateBotVersion
根据 $LATEST 版本创建新版本的机器人。如果自您创建上一个版本以来此资源的 $LATEST 版本没有更改，则 Amazon Lex 不会创建新版本。它返回上次创建的版本。
注意
您只能更新 $LATEST 版本的机器人。您无法更新通过 CreateBotVersion 操作创建的带编号的版本。
创建机器人的第一个版本时，Amazon Lex 会将版本设置为 1。后续版本递增 1。有关更多信息，请参阅 版本控制。
此操作需要 lex:CreateBotVersion 操作权限。
请求语法
POST /bots/name/versions HTTP/1.1
Content-type: application/json
{
"checksum": "string"
}URI 请求参数
请求使用以下 URI 参数。
- name
-
要为其创建新版本的机器人的名称。该名称区分大小写。
长度限制：最小长度为 2。最大长度为 50。
模式：
^([A-Za-z]_?)+$必需：是
请求体
请求接受采用 JSON 格式的以下数据。
- checksum
-
标识机器人
$LATEST版本的特定修订版。如果您指定了校验和，而机器人的$LATEST版本具有不同的校验和，则会返回PreconditionFailedException异常，并且 Amazon Lex 不会发布新版本。如果不指定校验和，Amazon Lex 会发布$LATEST版本。类型：字符串
必需：否
响应语法
HTTP/1.1 201
Content-type: application/json
{
"abortStatement": {
"messages": [
{
"content": "string",
"contentType": "string",
"groupNumber": number
}
],
"responseCard": "string"
},
"checksum": "string",
"childDirected": boolean,
"clarificationPrompt": {
"maxAttempts": number,
"messages": [
{
"content": "string",
"contentType": "string",
"groupNumber": number
}
],
"responseCard": "string"
},
"createdDate": number,
"description": "string",
"detectSentiment": boolean,
"enableModelImprovements": boolean,
"failureReason": "string",
"idleSessionTTLInSeconds": number,
"intents": [
{
"intentName": "string",
"intentVersion": "string"
}
],
"lastUpdatedDate": number,
"locale": "string",
"name": "string",
"status": "string",
"version": "string",
"voiceId": "string"
}响应元素
如果此操作成功，则该服务将会发送回 HTTP 201 响应。
服务以 JSON 格式返回的以下数据。
- abortStatement
-
Amazon Lex 用来取消对话的消息。有关更多信息，请参阅 PutBot。
类型：Statement 对象
- checksum
-
校验和标识创建的机器人版本。
类型：字符串
- childDirected
-
对于使用 Amazon Lex 模型构建服务创建的每个 Amazon Lex 机器人，您都必须通过在
childDirected字段中指定true或false，指定您对 Amazon Lex 的使用是否与全部或部分针对 13 岁以下儿童且受《儿童在线隐私保护法》(COPPA) 约束的网站、程序或其他应用程序有关。在childDirected字段中指定true，即表示您确认您对 Amazon Lex 的使用确实与全部或部分针对 13 岁以下儿童且受 COPPA 约束的网站、计划或其他应用程序有关。在childDirected字段中指定false，即表示您确认您对 Amazon Lex 的使用不与全部或部分针对 13 岁以下儿童且受 COPPA 约束的网站、计划或其他应用程序有关。如果在childDirected字段中指定默认值不能正确反映您确认您对 Amazon Lex 的使用不与全部或部分针对 13 岁以下儿童且受 COPPA 约束的网站、计划或其他应用程序有关，则您可以不指定。如果您对 Amazon Lex 的使用涉及全部或部分针对 13 岁以下儿童的网站、程序或其他应用程序，则必须获得 COPPA 规定的任何必需的可核实的家长同意。有关将 Amazon Lex 用于全部或部分针对 13 岁以下儿童的网站、程序或其他应用程序的信息，请参阅 Amazon Lex 常见问题解答
。 类型：布尔值
- clarificationPrompt
-
Amazon Lex 在无法理解用户的请求时使用的消息。有关更多信息，请参阅 PutBot。
类型：Prompt 对象
- createdDate
-
创建机器人版本的日期。
类型：时间戳
- description
-
机器人的描述。
类型：字符串
长度约束：最小长度为 0。最大长度为 200。
- detectSentiment
-
表示是否应将用户输入的言语发送到 Amazon Comprehend 以进行情绪分析。
类型：布尔值
- enableModelImprovements
-
表示机器人是否使用精度改进。
true表示机器人正在使用改进，否则为false。类型：布尔值
- failureReason
-
如果
status是FAILED，则 Amazon Lex 会提供其未能构建机器人的原因。类型：字符串
- idleSessionTTLInSeconds
-
Amazon Lex 保留对话中收集的数据的最长时间（秒）。有关更多信息，请参阅 PutBot。
类型：整数
有效范围：最小值为 60。最大值为 86400。
- intents
-
Intent数据元数组。有关更多信息，请参阅 PutBot。类型：Intent 对象数组
- lastUpdatedDate
-
此机器人
$LATEST版本的更新日期。类型：时间戳
- locale
-
指定机器人的目标区域设置。
类型：字符串
有效值：
de-DE | en-AU | en-GB | en-IN | en-US | es-419 | es-ES | es-US | fr-FR | fr-CA | it-IT | ja-JP | ko-KR - name
-
机器人的名称。
类型：字符串
长度限制：最小长度为 2。最大长度为 50。
模式：
^([A-Za-z]_?)+$ - status
-
当您发送创建或更新机器人的请求时，Amazon Lex 会将
status响应元素设置为BUILDING。在 Amazon Lex 构建机器人之后，它会将status设置为READY。如果 Amazon Lex 无法构建机器人，则它会将status设置为FAILED。Amazon Lex 会在failureReason响应元素中返回失败的原因。类型：字符串
有效值：
BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT - version
-
自动程序的版本。
类型：字符串
长度限制：长度下限为 1。长度上限为 64。
模式：
\$LATEST|[0-9]+ - voiceId
-
Amazon Lex 用于和用户进行语音交互的 Amazon Polly 语音 ID。
类型：字符串
错误
- BadRequestException
-
请求格式不正确。例如，值无效或必填字段未填充。检查字段值，然后重试。
HTTP 状态代码：400
- ConflictException
-
处理请求时出现冲突。请再次尝试您的请求。
HTTP 状态代码：409
- InternalFailureException
-
出现内部 Amazon Lex 错误。请再次尝试您的请求。
HTTP 状态代码：500
- LimitExceededException
-
请求超出了限制。请再次尝试您的请求。
HTTP 状态代码：429
- NotFoundException
-
找不到在请求中指定的资源。检查资源并重试。
HTTP 状态代码：404
- PreconditionFailedException
-
您尝试更改的资源的校验和与请求中的校验和不匹配。检查资源的校验和并重试。
HTTP 状态代码：412
另请参阅
有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容：
