AddApplicationInputProcessingConfiguration - Amazon Kinesis Data Analytics for SQL Applications デベロッパーガイド

慎重に検討した結果、アプリケーションの Amazon Kinesis Data Analytics は 2 つのステップSQLで中止することにしました。

1. 2025 年 10 月 15 日以降、SQLアプリケーションの新しい Kinesis Data Analytics を作成することはできません。

2. 2026 年 1 月 27 日以降、アプリケーションを削除します。SQL アプリケーションの Amazon Kinesis Data Analytics を開始または操作することはできません。SQL それ以降、Amazon Kinesis Data Analytics のサポートは終了します。詳細については、「Amazon Kinesis Data Analytics for SQL Applications の中止」を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AddApplicationInputProcessingConfiguration

注記

このドキュメントの対象は、SQL アプリケーションのみがサポートされる Amazon Kinesis Data Analytics API のバージョン 1 です。バージョン 2 の API では、SQL および Java アプリケーションがサポートされます。バージョン 2 の詳細については、Amazon Kinesis Data Analytics API V2 のドキュメントを参照してください。

をアプリケーションInputProcessingConfigurationに追加します。入力プロセッサは、アプリケーションの SQL コードが実行される前に、入力ストリーム上のレコードを処理します。現在、利用可能な唯一の入力プロセッサは AWS Lambda です。

リクエストの構文

{ "ApplicationName": "string", "CurrentApplicationVersionId": number, "InputId": "string", "InputProcessingConfiguration": { "InputLambdaProcessor": { "ResourceARN": "string", "RoleARN": "string" } } }

リクエストパラメータ

リクエストは以下の JSON 形式のデータを受け入れます。

ApplicationName

入力処理設定を追加するアプリケーションの名前。

型: 文字列

長さの制限: 最小長は 1 です。最大長は 128 です。

パターン: [a-zA-Z0-9_.-]+

必須:はい

CurrentApplicationVersionId

入力処理設定を追加するアプリケーションのバージョン。DescribeApplication オペレーションを使用して、現在のアプリケーションバージョンを取得できます。指定したバージョンが現在のバージョンでない場合は、ConcurrentModificationException が返されます。

型: 長整数

有効範囲: 最小値は 1 です。最大値は 999999999 です。

必須: はい

InputId

入力処理設定を追加する入力設定の ID。DescribeApplication オペレーションを使用して、アプリケーションの入力 IDsのリストを取得できます。

型: 文字列

長さの制限:最小長は 1 です。最大長は 50 です。

Pattern: [a-zA-Z0-9_.-]+

必須:はい

InputProcessingConfiguration

アプリケーションInputProcessingConfigurationに追加する 。

型: InputProcessingConfiguration オブジェクト

必須: はい

レスポンス要素

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。

エラー

ConcurrentModificationException

アプリケーションへの同時変更の結果としてスローされる例外。例えば、2 人の個人が同じアプリケーションを同時に編集しようとしています。

HTTP ステータスコード:400

InvalidArgumentException

指定された入力パラメータ値が無効です。

HTTP ステータスコード:400

ResourceInUseException

このオペレーションではアプリケーションを使用できません。

HTTP ステータスコード:400

ResourceNotFoundException

指定されたアプリケーションが見つかりません。

HTTP ステータスコード:400

UnsupportedOperationException

指定されたパラメータがサポートされていないか、指定されたリソースがこのオペレーションに対して有効でないため、リクエストは拒否されました。

HTTP ステータスコード:400

その他の参照資料

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。