本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
CreateVocabulary
创建新的自定义词汇表，可用于更改 Amazon Transcribe 处理音频文件转录的方式。
请求语法
{
"LanguageCode": "string",
"Phrases": [ "string" ],
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"VocabularyFileUri": "string",
"VocabularyName": "string"
}请求参数
有关所有操作通用的参数的信息，请参阅常见参数.
请求接受采用 JSON 格式的以下数据。
- LanguageCode
-
词汇表条目的语言代码。有关语言及其相应语言代码的列表，请参阅什么是 Amazon Transcribe？.
类型: 字符串
有效值:
af-ZA | ar-AE | ar-SA | cy-GB | 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 | ga-IE | gd-GB | 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：必需 是
- Phrases
-
包含词汇条目的字符串数组。
类型: 字符串数组
约束：最小长度为 0。长度上限为 256。
模式：
.+：必需 否
- Tags
-
在创建新词汇表时，将一个或多个标签（每个标签以键:值对的形式）添加到新的 Amazon Transcribe 词汇中。
类型: 数组Tag对象
数组成员：最少 1 项。最多 200 项。
：必需 否
- VocabularyFileUri
-
包含自定义词汇定义的文本文件的 S3 位置。URI 必须与您要调用的 API 终端节点位于同一区域。一般格式为：
https://s3.<Amazon-region>.amazonaws.com/<AWSDOC-EXAMPLE-BUCKET>/<keyprefix>/<objectkey>例如：
https://s3.us-east-1.amazonaws.com/AWSDOC-EXAMPLE-BUCKET/vocab.txt有关 S3 对象名称的更多信息，请参阅。对象键中的Amazon S3 开发人员指南中).
有关自定义词汇表的更多信息，请参阅自定义词汇表.
类型: 字符串
约束：最小长度为 1。长度上限为 2000。
模式：
(s3://|http(s*)://).+：必需 否
- VocabularyName
-
词汇的名称。名称在Amazon Web Services 账户. 该名称区分大小写。如果你尝试创建一个与之前的词汇表名称相同的词汇，你将收到
ConflictException错误消息。类型: 字符串
约束：最小长度为 1。最大长度为 200。
模式：
^[0-9a-zA-Z._-]+：必需 是
响应语法
{
"FailureReason": "string",
"LanguageCode": "string",
"LastModifiedTime": number,
"VocabularyName": "string",
"VocabularyState": "string"
}响应元素
如果此操作成功，则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回的以下数据。
- FailureReason
-
如果
VocabularyState字段是FAILED，此字段包含有关任务失败的信息。类型: 字符串
- LanguageCode
-
词汇表条目的语言代码。
类型: 字符串
有效值:
af-ZA | ar-AE | ar-SA | cy-GB | 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 | ga-IE | gd-GB | 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 - LastModifiedTime
-
词汇表的创建日期和时间。
类型: 时间戳
- VocabularyName
-
词汇的名称。
类型: 字符串
约束：最小长度为 1。最大长度为 200。
模式：
^[0-9a-zA-Z._-]+ - VocabularyState
-
词汇的处理状态。当您时
VocabularyState字段包含READY词汇已准备好用于StartTranscriptionJob请求.类型: 字符串
有效值:
PENDING | READY | FAILED
Errors
有关所有操作中常见的错误的信息，请参阅常见错误.
- BadRequestException
-
您的请求没有通过一个或多个验证测试。例如，如果您尝试删除的实体不存在，或者它处于非终端状态（例如，它 “正在进行中”）。查看异常
Message字段以获取更多信息。HTTP 状态代码：400
- ConflictException
-
已经有一个具有该名称的资源。
HTTP 状态代码：400
- InternalFailureException
-
发生内部服务器错误。检查错误消息并再次尝试请求。
HTTP 状态代码：500
- LimitExceededException
-
您已经发送过多的请求或您的输入文件中包含过长。等待，然后再重新发送您的请求，或使用较小的文件，然后重新发送请求。
HTTP 状态代码：400
另请参阅
有关在特定语言的Amazon软件开发工具包中使用此 API 的更多信息，请参阅以下内容：