自動音声認識(ASR)アノテーションセットのプロパティ更新API
Note: Submit your skill and see it come to life.
自動音声認識(ASR)アノテーションセットのプロパティ更新API
このAPIを呼び出すと、既存のASRアノテーションセットの名前を更新できます。
HTTPメソッドとパス
PUT v1/skills/{skillId}/asrAnnotationSets/{annotationSetId} HTTP/1.1
フィールド | 型 | 説明 | 必須 |
---|---|---|---|
skillId |
文字列 | URIパスに含むスキルIDです。 | ◯ |
annotationSetId |
文字列 | URIパスに含むアノテーションIDです。 | ◯ |
リクエスト
リクエストヘッダー
Content-Type: application/json
Accept: application/json
リクエスト本文
{
"name": string
}
アトリビュート | 型 | 説明 | 必須 |
---|---|---|---|
name | 文字列 | アノテーションセットの名前です。上限は170文字です。 | ◯ |
応答
HTTPステータス
HTTP 204 No Content
応答ヘッダー
なし
応答本文
なし
エラー応答
このセクションでは、リクエスト固有のエラーについて説明します。すべてのASR APIに適用されるエラーのリファレンスについては、自動音声認識(ASR)APIエラーリファレンスを参照してください。
HTTPステータスコード | エラーコード | シナリオ |
---|---|---|
400 Bad Request |
MISSING_REQUIRED_PROPERTY |
リクエスト本文に必須フィールドがありません。 |
CONTENT_PARSE_FAILURE |
リクエスト本文の形式が正しくありません。 |
|
INVALID_STRING_LENGTH |
nameフィールドの長さが許容範囲外です。 |
|
INVALID_REQUEST_PARAMETER |
nameフィールドに無効な文字が含まれています。 |
|
404 Not Found |
RESOURCE_NOT_FOUND |
指定されたスキルが存在しません。 |
500 Internal Server Error |
INTERNAL_SERVER_ERROR |
内部サーバエラーのため、リクエストが失敗しました。 |
例
サンプルリクエスト | 応答の例 |
---|---|
PUT v1/skills/amzn.skill.id.1234/asrAnnotationSets/123456-1234123-123123 HTTP/1.1 Content-Type: application/json Accept: application/json { "name": "my new annotation set name" }
|
HTTP 204 No Content |
PUT v1/skills/amzn.skill.id.1234/asrAnnotationSets/123456-1234123-123123/properties HTTP/1.1 { "name": "" } |
HTTP 400 BadRequest Content-Type: application/json { "message": "Payload validations failed", "violations": [{ "message": "The \"name\" property at property path \"$.name\" is outside the allowed range.Actual length: 0, Minimum length: 1", "code": "INVALID_STRING_LENGTH" }] } |