自動音声認識(ASR)アノテーションセットのプロパティ更新API



自動音声認識(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" }] }