本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # CreateVocabulary 创建新的自定义词汇表。 创建新的自定义词汇表时，您可以将包含新条目、短语和术语的文本文件上传到 Amazon S3 存储桶，并在请求中加入 URI。或者，您可以使用`Phrases`标志将术语列表直接包含在请求中。 每种语言都有一个字符集，其中包含该特定语言的所有允许字符。如果您使用不支持的字符，则您的自定义词汇请求将失败。请参阅 [“自定义词汇表的字符集](https://docs.aws.amazon.com/transcribe/latest/dg/charsets.html)” 以获取适用于您的语言的字符集。 有关更多信息，请参阅[自定义词汇表](https://docs.aws.amazon.com/transcribe/latest/dg/custom-vocabulary.html)。 ## 请求语法 ``` { "LanguageCode": "string", "Phrases": [ "string" ], "Tags": [ { "Key": "string", "Value": "string" } ], "VocabularyFileUri": "string", "VocabularyName": "string" } ``` ## 请求参数 有关所有操作的通用参数的参数，请参阅[常用参数](CommonParameters.md)。 请求接受采用 JSON 格式的以下数据。 ** [LanguageCode](#API_CreateVocabulary_RequestSyntax) ** 代表自定义词汇表中条目语言的语言的语言代码。每个自定义词汇必须仅包含一种语言的术语。 自定义词汇表只能用于转录与自定义词汇表相同的语言的文件。例如，如果您使用美国英语 (`en-US`) 创建自定义词汇，则只能将此自定义词汇应用于包含英语音频的文件。 有关支持的语言及其关联语言代码的列表，请参阅[支持的语言](https://docs.aws.amazon.com/transcribe/latest/dg/supported-languages.html)表。 类型：字符串 有效值:` af-ZA | ar-AE | ar-SA | da-DK | de-CH | de-DE | en-AB | en-AU | en-GB | en-IE | en-IN | en-US | en-WL | es-ES | es-US | fa-IR | fr-CA | fr-FR | he-IL | hi-IN | id-ID | it-IT | ja-JP | ko-KR | ms-MY | nl-NL | pt-BR | pt-PT | ru-RU | ta-IN | te-IN | tr-TR | zh-CN | zh-TW | th-TH | en-ZA | en-NZ | vi-VN | sv-SE` 必需：是 ** [Phrases](#API_CreateVocabulary_RequestSyntax) ** 如果您想通过在请求中包含所有所需术语作为逗号分隔值来创建自定义词汇表，请使用此参数。创建自定义词汇表的另一种选择是将您的条目保存在文本文件中并将其上传到 Amazon S3 存储桶，然后使用`VocabularyFileUri`参数指定文件的位置。 请注意，如果您在请求`Phrases`中包含，则无法使用`VocabularyFileUri`；必须选择其中一个。 每种语言都有一个字符集，其中包含该特定语言的所有允许字符。如果您使用不支持的字符，则您的自定义词汇过滤器请求将失败。请参阅 [“自定义词汇表的字符集](https://docs.aws.amazon.com/transcribe/latest/dg/charsets.html)” 以获取适用于您的语言的字符集。 类型：字符串数组 长度约束：最小长度为 0。长度上限为 256。 模式：`.+` 必需：否 ** [Tags](#API_CreateVocabulary_RequestSyntax) ** 在创建新的自定义词汇表时，向新的自定义词汇表中添加一个或多个自定义标签，每个标签都采用 key: value 对的形式。 要了解有关在 Amazon Transcribe Transcribe Transcribe [Tran](https://docs.aws.amazon.com/transcribe/latest/dg/tagging.html) sc 类型：[Tag](API_Tag.md) 对象数组 数组成员：最少 1 项。最多 20项项项项项项项项项项 必需：否 ** [VocabularyFileUri](#API_CreateVocabulary_RequestSyntax) ** 包含自定义词汇表词汇表的文本文件的 Amazon S3 imple Simpress S URI 应位于与您调用的资源的 URI 必须位于与您调AWS 区域用的资源的 URI 的资源的 URI 必须位于URI 以下为示例 URI 路径示例 URI 路径：`s3://DOC-EXAMPLE-BUCKET/my-vocab-file.txt` 请注意，如果您在请求`VocabularyFileUri`中包含，则不能使用`Phrases`标志；必须选择其中一个。 类型：字符串 长度限制：最小长度为 1。长度上限为 2000 项 模式：`(s3://|http(s*)://).+` 必需：否 ** [VocabularyName](#API_CreateVocabulary_RequestSyntax) ** 一个由您为新的自定义词汇表选择的唯一名称。 此名称区分大小写，不能包含空格，并且在内必须是唯一的AWS 账户。如果您尝试创建新的自定义词汇表，与现有自定义词汇表词汇表，则您将收到`ConflictException`错误。 类型：字符串 长度限制：最小长度为 1。最大长度为 200。 模式：`^[0-9a-zA-Z._-]+` 必需：是 ## 响应语法 ``` { "FailureReason": "string", "LanguageCode": "string", "LastModifiedTime": number, "VocabularyName": "string", "VocabularyState": "string" } ``` ## 响应元素 如果此操作成功，则该服务将会发送回 HTTP 200 响应。 服务以 JSON 格式返回的以下数据。 ** [FailureReason](#API_CreateVocabulary_ResponseSyntax) ** 如果`VocabularyState`是`FAILED`，则`FailureReason`包含有关自定义词汇表请求失败的原因的信息。另请参阅：[常见错误](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonErrors.html)。 类型：字符串 ** [LanguageCode](#API_CreateVocabulary_ResponseSyntax) ** 您为自定义词汇表选择的语言代码。 类型：字符串 有效值:` af-ZA | ar-AE | ar-SA | da-DK | de-CH | de-DE | en-AB | en-AU | en-GB | en-IE | en-IN | en-US | en-WL | es-ES | es-US | fa-IR | fr-CA | fr-FR | he-IL | hi-IN | id-ID | it-IT | ja-JP | ko-KR | ms-MY | nl-NL | pt-BR | pt-PT | ru-RU | ta-IN | te-IN | tr-TR | zh-CN | zh-TW | th-TH | en-ZA | en-NZ | vi-VN | sv-SE` ** [LastModifiedTime](#API_CreateVocabulary_ResponseSyntax) ** 您创建自定义词汇表的日期和时间。 时间戳的格式为`YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC`。例如，`2022-05-04T12:32:58.761000-07:00`表示 2022 年 5 月 4 日 UTC-7 下午 12:32。 类型：Timestamp ** [VocabularyName](#API_CreateVocabulary_ResponseSyntax) ** 您为自定义词汇表选择的名称。 类型：字符串 长度限制：最小长度为 1。最大长度为 200。 模式：`^[0-9a-zA-Z._-]+` ** [VocabularyState](#API_CreateVocabulary_ResponseSyntax) ** 您的自定义词汇表的处理状态。如果状态为`READY`，则可以在`StartTranscriptionJob`请求中使用自定义词汇。 类型：字符串 有效值:` PENDING | READY | FAILED` ## 错误 有关所有操作常见错误的信息，请参阅[常见错误](CommonErrors.md)。 ** BadRequestException ** 您的请求未通过一项或多项验证测试。当您要删除的实体不存在或处于非终端状态（例如`IN PROGRESS`）时，可能会发生这种情况。有关更多信息，请参阅异常消息字段。 HTTP 状态代码：400 ** ConflictException ** 使用此名称的资源已经存在。资源名称在内部必须唯一，资源名称在内必须唯一AWS 账户。 HTTP 状态代码：400 ** InternalFailureException ** 出现内部错误。检查错误消息，更正问题，然后重试您的请求。 HTTP 状态代码：500 ** LimitExceededException ** 你要么发送了太多的请求，要么你的输入文件太长。请稍候，然后重试您的请求，或者使用较小的文件重试您的请求。 HTTP 状态代码：400 ## 另请参阅 有关在特定语言的 AWS 软件开发工具包中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/transcribe-2017-10-26/CreateVocabulary) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-2017-10-26/CreateVocabulary) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/CreateVocabulary) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/CreateVocabulary) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/CreateVocabulary) + [AWS适用于 JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/transcribe-2017-10-26/CreateVocabulary) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-2017-10-26/CreateVocabulary) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/transcribe-2017-10-26/CreateVocabulary) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/CreateVocabulary)