AddApplicationInputProcessingConfiguration - Amazon Kinesis Data Analytics for SQL Applications 開発者ガイド

新規プロジェクトでは、Kinesis Data Analytics for SQL よりも 新しい Managed Service for Apache Flink Studio を使用することをお勧めします。Managed Service for Apache Flink Studio は、使いやすさと高度な分析機能を兼ね備えているため、高度なストリーム処理アプリケーションを数分で構築できます。

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

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 オペレーションを使用して、アプリケーションの入力 ID のリストを取得できます。

型: 文字列

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

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

必須: はい

InputProcessingConfiguration

入力処理設定をアプリケーションに追加します。

型: InputProcessingConfiguration オブジェクト

必須: はい

レスポンス要素

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

エラー

ConcurrentModificationException

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

HTTP ステータスコード:400

InvalidArgumentException

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

HTTP ステータスコード:400

ResourceInUseException

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

HTTP ステータスコード:400

ResourceNotFoundException

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

HTTP ステータスコード:400

UnsupportedOperationException

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

HTTP ステータスコード:400

以下の資料も参照してください。

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