新規プロジェクトでは、Kinesis Data Analytics for SQL よりも 新しい Managed Service for Apache Flink Studio を使用することをお勧めします。Managed Service for Apache Flink Studio は、使いやすさと高度な分析機能を兼ね備えているため、高度なストリーム処理アプリケーションを数分で構築できます。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
StartApplication
注記
このドキュメントの対象は、SQL アプリケーションのみがサポートされる Amazon Kinesis Data Analytics API のバージョン 1 です。バージョン 2 の API では、SQL および Java アプリケーションがサポートされます。バージョン 2 の詳細については、Amazon Kinesis Data Analytics API V2 のドキュメントを参照してください。
指定された Amazon Kinesis Analytics アプリケーションを起動します。アプリケーションを作成した後、アプリケーションを起動するには、このオペレーションを排他的に呼び出す必要があります。
アプリケーションの起動後、入力データの使用を開始し、処理し、設定された宛先に出力を書き込みます。
アプリケーションを起動するには、アプリケーションのステータスが READY でなければなりません。アプリケーションのステータスは、コンソールで取得するか、DescribeApplication オペレーションを使用して取得できます。
アプリケーションを起動した後、StopApplication オペレーションを呼び出して、アプリケーションによる入力の処理を停止できます。
このオペレーションには kinesisanalytics:StartApplication アクションを実行するアクセス許可が必要です。
リクエストの構文
{
"ApplicationName": "string",
"InputConfigurations": [
{
"Id": "string",
"InputStartingPositionConfiguration": {
"InputStartingPosition": "string"
}
}
]
}リクエストパラメータ
リクエストは以下の JSON 形式のデータを受け入れます。
- ApplicationName
-
アプリケーションの名前。
型: 文字列
長さの制限: 最小長は 1 です。最大長は 128 です。
パターン:
[a-zA-Z0-9_.-]+必須: はい
- InputConfigurations
-
アプリケーションが使用を開始する特定の入力を ID で識別します。Amazon Kinesis Analytics は、入力に関連付けられたストリーミングソースの読み取りを開始します。Amazon Kinesis Analytics が読み取りを開始するストリーミングソースの場所を指定することもできます。
型: InputConfiguration オブジェクトの配列
必須: はい
レスポンス要素
アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。
エラー
- InvalidApplicationConfigurationException
-
ユーザー指定のアプリケーション設定が無効です。
HTTP ステータスコード：400
- InvalidArgumentException
-
指定された入力パラメータ値が無効です。
HTTP ステータスコード：400
- ResourceInUseException
-
このオペレーションではアプリケーションを使用できません。
HTTP ステータスコード：400
- ResourceNotFoundException
-
指定されたアプリケーションが見つかりません。
HTTP ステータスコード：400
- UnsupportedOperationException
-
指定されたパラメータがサポートされていないか、指定されたリソースがこのオペレーションに対して有効でないため、リクエストは拒否されました。
HTTP ステータスコード：400
以下の資料も参照してください。
言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
