本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
UpdateVocabulary
將現有的自訂詞彙更新為新值。此作業會以新值覆寫所有現有資訊；您無法將新字詞附加至現有的自訂字彙。
請求語法
{
"LanguageCode": "string",
"Phrases": [ "string" ],
"VocabularyFileUri": "string",
"VocabularyName": "string"
}請求參數
如需有關所有動作共用之參數的資訊，請參閱一般參數。
請求接受採用 JSON 格式的下列資料。
- LanguageCode
-
代表您要更新之自訂字彙中項目語言的語言的語言代碼。每個自訂字彙只能包含一種語言的術語。
自訂字彙只能用來轉錄與自訂字彙相同語言的檔案。例如，如果您使用美式英文 (
en-US) 建立自訂字彙，則只能將此自訂字彙套用至包含英文音訊的檔案。如需支援的語言及其相關語言代碼的清單，請參閱支援的語言表格。
類型：String
有效值：
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
-
如果您想要在請求中加入所有想要的字詞 (以逗號分隔值) 來更新自訂字彙，請使用此參數。更新自訂詞彙的另一個選項是將項目儲存在文字檔中，並將其上傳到 Amazon S3 儲存貯體，然後使用
VocabularyFileUri參數指定檔案的位置。請注意，如果您
Phrases在請求中包含，則無法使用VocabularyFileUri；您必須選擇其中一個。每種語言都有一個字元集，其中包含該特定語言允許的所有字元。如果您使用不支援的字元，您的自訂字彙篩選要求會失敗。請參閱自訂字彙的字元集，以取得您所用語言的字元集。
類型：字串陣列
長度限制：長度下限為 0。長度上限為 256。
模式：
.+必要：否
- VocabularyFileUri
-
包含您自訂詞彙的文字檔案的 Amazon S3 位置。URI 必須位於與您呼叫AWS 區域的資源相同。
範例如下 URI 路徑：
s3://DOC-EXAMPLE-BUCKET/my-vocab-file.txt請注意，如果您
VocabularyFileUri在請求中包含，則無法使用該Phrases標誌；您必須選擇其中一個。類型：String
長度限制：長度下限為 1。長度上限為 2000。
模式：
(s3://|http(s*)://).+必要：否
- VocabularyName
-
您要更新的自訂詞彙。自訂詞彙名稱會區分大小寫。
類型：String
長度限制：長度下限為 1。長度上限為 200。
模式：
^[0-9a-zA-Z._-]+必要：是
回應語法
{
"LanguageCode": "string",
"LastModifiedTime": number,
"VocabularyName": "string",
"VocabularyState": "string"
}回應元素
如果動作成功，則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- LanguageCode
-
您為自訂字彙選取的語言代碼。
類型：String
有效值：
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
-
上次更新指定自訂詞彙的日期和時間。
時間戳記的格式為
YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC。例如，2022-05-04T12:32:58.761000-07:00代表二零二二年五月四日下午十二時三十二分。UTC-7類型：Timestamp
- VocabularyName
-
更新自訂詞彙的名稱。
類型：String
長度限制：長度下限為 1。長度上限為 200。
模式：
^[0-9a-zA-Z._-]+ - VocabularyState
-
自訂字彙的處理狀態。如果狀態為
READY，您可以在StartTranscriptionJob請求中使用自訂字彙。類型：String
有效值：
PENDING | READY | FAILED
錯誤
如需所有動作常見的錯誤相關資訊，請參閱常見錯誤。
- BadRequestException
-
您的要求未通過一或多個驗證測試。當您嘗試刪除的實體不存在或處於非終端狀態（例如
IN PROGRESS）時，可能會發生這種情況。如需詳細資訊，請參閱例外訊息欄位。HTTP 狀態碼：400
- ConflictException
-
具有此名稱的資源已存在。資源名稱在AWS 帳戶.
HTTP 狀態碼：400
- InternalFailureException
-
發生內部錯誤。檢查錯誤訊息，修正問題，然後再試一次您的要求。
HTTP 狀態碼：500
- LimitExceededException
-
您可能傳送太多要求，或輸入檔案太長。請先等候再重試您的要求，或使用較小的檔案再試一次。
HTTP 狀態碼：400
- NotFoundException
-
我們找不到要求的資源。請檢查指定的名稱是否正確，然後再試一次。
HTTP 狀態碼：400
另請參閱
如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
