Amazon Lex V2 を使用している場合は、代わりに Amazon Lex V2 ガイドを参照してください。
Amazon Lex V1 を使用している場合は、ボットを Amazon Lex V2 にアップグレードすることをお勧めします。V1 には新機能を追加されませんので、すべての新しいボットには V2 を使用することを強くお勧めします。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
CreateSlotTypeVersion
指定された $LATEST
バージョンのスロットタイプに基づいて新しいバージョンを作成します。このリソースの $LATEST
バージョンが最後に作成されたバージョンから変更がない場合、Amazon Lex は新しいバージョンを作成しません。最後に作成したバージョンを返します。
注記
スロットタイプの $LATEST
バージョンのみ更新できます。CreateSlotTypeVersion
オペレーションを使用して作成した番号付きのバージョンを更新することはできません。
スロットタイプのバージョンを作成すると、Amazon Lex はバージョンを 1 に設定します。それ以降のバージョンは 1 ずつ増えます。詳細については、「バージョニング」を参照してください。
このオペレーションには、lex:CreateSlotTypeVersion
アクションに対する許可が必要です。
リクエストの構文
POST /slottypes/name
/versions HTTP/1.1
Content-type: application/json
{
"checksum": "string
"
}
URI リクエストパラメータ
リクエストでは、次の URI パラメータを使用します。
- name
-
新しいバージョンを作成するスロットタイプの名前。名前は、大文字と小文字が区別されます。
長さの制限:最小長は 1 です。最大長は 100 です。
パターン:
^([A-Za-z]_?)+$
必須: はい
リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
- checksum
-
公開したいスロットタイプの
$LATEST
バージョンのチェックサム。チェックサムを指定しても、$LATEST
バージョンのスロットタイプのチェックサムが異なる場合、Amazon Lex はPreconditionFailedException
の例外を返し、新しいバージョンを公開しません。チェックサムを指定しない場合、Amazon Lex は$LATEST
バージョンを公開します。タイプ: 文字列
必須: いいえ
レスポンスの構文
HTTP/1.1 201
Content-type: application/json
{
"checksum": "string",
"createdDate": number,
"description": "string",
"enumerationValues": [
{
"synonyms": [ "string" ],
"value": "string"
}
],
"lastUpdatedDate": number,
"name": "string",
"parentSlotTypeSignature": "string",
"slotTypeConfigurations": [
{
"regexConfiguration": {
"pattern": "string"
}
}
],
"valueSelectionStrategy": "string",
"version": "string"
}
レスポンス要素
アクションが成功すると、HTTP 201 レスポンスが返されます。
サービスから以下のデータが JSON 形式で返されます。
- checksum
-
スロットタイプの
$LATEST
バージョンのチェックサム。型: 文字列
- createdDate
-
スロットタイプが作成された日付。
型: タイムスタンプ
- description
-
スロットタイプの説明。
型: 文字列
長さの制限: 最小長は 0 です。最大長は 200 です。
- enumerationValues
-
スロットタイプが取得できる値を定義する
EnumerationValue
オブジェクトのリスト。型: EnumerationValue オブジェクトの配列
配列メンバー:最小数は 0 項目です。最大数は 10000 項目です。
- lastUpdatedDate
-
スロットタイプが更新された日付。リソースを作成する場合、作成日と最終更新日は同じ日付になります。
型: タイムスタンプ
- name
-
スロットタイプの名前。
型: 文字列
長さの制限: 最小長は 1 です。最大長は 100 です。
パターン:
^([A-Za-z]_?)+$
- parentSlotTypeSignature
-
このスロットタイプの親として使用される組み込みスロットタイプです。
型: 文字列
長さの制限: 最小長は 1 です。最大長は 100 です。
パターン:
^((AMAZON\.)_?|[A-Za-z]_?)+
- slotTypeConfigurations
-
親組み込みスロットタイプを拡張する構成情報。
型: SlotTypeConfiguration オブジェクトの配列
の配列メンバー: 最小数は 0 項目です。最大数は 10 項目です。
- valueSelectionStrategy
-
Amazon Lex がスロットの価値を決定するために使用する戦略。詳細については、「PutSlotType」を参照してください。
型: 文字列
有効な値:
ORIGINAL_VALUE | TOP_RESOLUTION
- version
-
新しいスロットタイプバージョンに割り当てられたバージョン。
型: 文字列
長さの制限:最小長は 1 です。最大長は 64 文字です。
パターン:
\$LATEST|[0-9]+
エラー
- BadRequestException
-
リクエストが適切にフォーマットされていません。例えば、値が無効であったり、必須項目が設定されていない場合です。フィールドの値を確認して、再度お試しください。
HTTP ステータスコード:400
- ConflictException
-
リクエストの処理中に競合が発生しました。リクエストを再試行してください。
HTTP ステータスコード: 409
- InternalFailureException
-
Amazon Lex 内部エラーが発生しました。リクエストを再試行してください。
HTTP ステータスコード:500
- LimitExceededException
-
リクエストが制限を超えました。リクエストを再試行してください。
HTTP ステータスコード: 429
- NotFoundException
-
リクエストで指定されたリソースは見つかりませんでした。リソースを確認して、もう一度お試しください。
HTTP ステータスコード: 404
- PreconditionFailedException
-
変更しようとしているリソースのチェックサムがリクエストのチェックサムと一致しません。リソースのチェックサムを確認して、もう一度お試しください。
HTTP ステータスコード: 412
その他の参照資料
言語固有の AWS SDK でこの API を使用する方法の詳細については、以下を参照してください。