终止支持通知：2025年9月15日， AWS 我们将停止对Amazon Lex V1的支持。2025 年 9 月 15 日之后，您将无法再访问 Amazon Lex V1 控制台或 Amazon Lex V1 资源。如果您使用的是 Amazon Lex V2，请改为参阅 [Amazon Lex V2 指南](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html)。本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # CreateBotVersion 根据 `$LATEST` 版本创建新版本的机器人。如果自您创建上一个版本以来此资源的 `$LATEST` 版本没有更改，则 Amazon Lex 不会创建新版本。它返回上次创建的版本。 **注意** 您只能更新 `$LATEST` 版本的机器人。您无法更新通过 `CreateBotVersion` 操作创建的带编号的版本。创建机器人的第一个版本时，Amazon Lex 会将版本设置为 1。后续版本递增 1。有关更多信息，请参阅 [版本控制](versioning-aliases.md#versioning-intro)。此操作需要 `lex:CreateBotVersion` 操作权限。 ## 请求语法 ``` POST /bots/name/versions HTTP/1.1 Content-type: application/json { "checksum": "string" } ``` ## URI 请求参数请求使用以下 URI 参数。 ** [name](#API_CreateBotVersion_RequestSyntax) ** 要为其创建新版本的机器人的名称。该名称区分大小写。长度限制：最小长度为 2。最大长度为 50。模式：`^([A-Za-z]_?)+$` 必需：是 ## 请求体请求接受采用 JSON 格式的以下数据。 ** [checksum](#API_CreateBotVersion_RequestSyntax) ** 标识机器人 `$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](#API_CreateBotVersion_ResponseSyntax) ** Amazon Lex 用来取消对话的消息。有关更多信息，请参阅 [PutBot](API_PutBot.md)。类型：[Statement](API_Statement.md) 对象 ** [checksum](#API_CreateBotVersion_ResponseSyntax) ** 校验和标识创建的机器人版本。类型：字符串 ** [childDirected](#API_CreateBotVersion_ResponseSyntax) ** 对于使用 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 常见问题解答](https://aws.amazon.com/lex/faqs#data-security)。类型：布尔值 ** [clarificationPrompt](#API_CreateBotVersion_ResponseSyntax) ** Amazon Lex 在无法理解用户的请求时使用的消息。有关更多信息，请参阅 [PutBot](API_PutBot.md)。类型：[Prompt](API_Prompt.md) 对象 ** [createdDate](#API_CreateBotVersion_ResponseSyntax) ** 创建机器人版本的日期。类型：时间戳 ** [description](#API_CreateBotVersion_ResponseSyntax) ** 机器人的描述。类型：字符串长度限制：最小长度为 0。最大长度为 200。 ** [detectSentiment](#API_CreateBotVersion_ResponseSyntax) ** 表示是否应将用户输入的言语发送到 Amazon Comprehend 以进行情绪分析。类型：布尔值 ** [enableModelImprovements](#API_CreateBotVersion_ResponseSyntax) ** 表示机器人是否使用精度改进。`true` 表示机器人正在使用改进，否则为 `false`。类型：布尔值 ** [failureReason](#API_CreateBotVersion_ResponseSyntax) ** 如果 `status` 是 `FAILED`，则 Amazon Lex 会提供其未能构建机器人的原因。类型：字符串 ** [idleSessionTTLInSeconds](#API_CreateBotVersion_ResponseSyntax) ** Amazon Lex 保留对话中收集的数据的最长时间（秒）。有关更多信息，请参阅 [PutBot](API_PutBot.md)。类型：整数有效范围：最小值为 60。最大值为 86400。 ** [intents](#API_CreateBotVersion_ResponseSyntax) ** `Intent` 数据元数组。有关更多信息，请参阅 [PutBot](API_PutBot.md)。类型：[Intent](API_Intent.md) 对象数组 ** [lastUpdatedDate](#API_CreateBotVersion_ResponseSyntax) ** 此机器人 `$LATEST` 版本的更新日期。类型：时间戳 ** [locale](#API_CreateBotVersion_ResponseSyntax) ** 指定机器人的目标区域设置。类型：字符串有效值：`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](#API_CreateBotVersion_ResponseSyntax) ** 机器人的名称。类型：字符串长度限制：最小长度为 2。最大长度为 50。模式：`^([A-Za-z]_?)+$` ** [status](#API_CreateBotVersion_ResponseSyntax) ** 当您发送创建或更新机器人的请求时，Amazon Lex 会将 `status` 响应元素设置为 `BUILDING`。在 Amazon Lex 构建机器人之后，它会将 `status` 设置为 `READY`。如果 Amazon Lex 无法构建机器人，则它会将 `status` 设置为 `FAILED`。Amazon Lex 会在 `failureReason` 响应元素中返回失败的原因。类型：字符串有效值：`BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT` ** [version](#API_CreateBotVersion_ResponseSyntax) ** 自动程序的版本。类型：字符串长度限制：最小长度为 1。长度上限为 64。模式：`\$LATEST|[0-9]+` ** [voiceId](#API_CreateBotVersion_ResponseSyntax) ** 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，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/CreateBotVersion) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/CreateBotVersion) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/CreateBotVersion) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/CreateBotVersion) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/CreateBotVersion) + [AWS JavaScript V3 版 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/CreateBotVersion) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/CreateBotVersion) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/CreateBotVersion) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/CreateBotVersion) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/CreateBotVersion)