慎重に検討した結果、Amazon Kinesis Data Analytics for SQL アプリケーションを中止することにしました。
1. **2025 年 9 月 1** 日以降、Amazon Kinesis Data Analytics for SQL アプリケーションのバグ修正は提供されません。これは、今後の廃止によりサポートが制限されるためです。
2. **2025 年 10 月 15** 日以降、新しい Kinesis Data Analytics for SQL アプリケーションを作成することはできません。
3. **2026 年 1 月 27 日**以降、アプリケーションは削除されます。Amazon Kinesis Data Analytics for SQL アプリケーションを起動することも操作することもできなくなります。これ以降、Amazon Kinesis Data Analytics for SQL のサポートは終了します。詳細については、「[Amazon Kinesis Data Analytics for SQL アプリケーションのサポート終了](discontinuation.md)」を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# アクション
以下のアクションがサポートされています:
+ [AddApplicationCloudWatchLoggingOption](API_AddApplicationCloudWatchLoggingOption.md)
+ [AddApplicationInput](API_AddApplicationInput.md)
+ [AddApplicationInputProcessingConfiguration](API_AddApplicationInputProcessingConfiguration.md)
+ [AddApplicationOutput](API_AddApplicationOutput.md)
+ [AddApplicationReferenceDataSource](API_AddApplicationReferenceDataSource.md)
+ [CreateApplication](API_CreateApplication.md)
+ [DeleteApplication](API_DeleteApplication.md)
+ [DeleteApplicationCloudWatchLoggingOption](API_DeleteApplicationCloudWatchLoggingOption.md)
+ [DeleteApplicationInputProcessingConfiguration](API_DeleteApplicationInputProcessingConfiguration.md)
+ [DeleteApplicationOutput](API_DeleteApplicationOutput.md)
+ [DeleteApplicationReferenceDataSource](API_DeleteApplicationReferenceDataSource.md)
+ [DescribeApplication](API_DescribeApplication.md)
+ [DiscoverInputSchema](API_DiscoverInputSchema.md)
+ [ListApplications](API_ListApplications.md)
+ [ListTagsForResource](API_ListTagsForResource.md)
+ [StartApplication](API_StartApplication.md)
+ [StopApplication](API_StopApplication.md)
+ [TagResource](API_TagResource.md)
+ [UntagResource](API_UntagResource.md)
+ [UpdateApplication](API_UpdateApplication.md)
# AddApplicationCloudWatchLoggingOption
**注記**
このドキュメントの対象は、SQL アプリケーションのみがサポートされる Amazon Kinesis Data Analytics API のバージョン 1 です。バージョン 2 の API では、SQL および Java アプリケーションがサポートされます。バージョン 2 の詳細については、[Amazon Kinesis Data Analytics API V2 のドキュメント](/kinesisanalytics/latest/apiv2/Welcome.html)を参照してください。
アプリケーションの構成エラーをモニタリングするために CloudWatch ログストリームを追加します。Amazon Kinesis Analytics アプリケーションで CloudWatch ログストリームを使用する方法の詳細については、「[Amazon CloudWatch Logs の使用](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/cloudwatch-logs.html)」を参照してください。
## リクエストの構文
```
{
"ApplicationName": "string",
"CloudWatchLoggingOption": {
"LogStreamARN": "string",
"RoleARN": "string"
},
"CurrentApplicationVersionId": number
}
```
## リクエストパラメーター
リクエストは以下のデータを JSON 形式で受け入れます。
** [ApplicationName](#API_AddApplicationCloudWatchLoggingOption_RequestSyntax) **
Kinesis Analytics アプリケーション名。
タイプ: 文字列
長さの制限: 最小長は 1 です。最大長は 128 です。
パターン: `[a-zA-Z0-9_.-]+`
必須: はい
** [CloudWatchLoggingOption](#API_AddApplicationCloudWatchLoggingOption_RequestSyntax) **
CloudWatch ログストリームの Amazon リソースネーム (ARN) と IAM ロール ARN を提供します。注意: CloudWatch にアプリケーションメッセージを書き込むには、使用する IAM ロールで `PutLogEvents` ポリシーアクションが有効になっている必要があります。
型: [CloudWatchLoggingOption](API_CloudWatchLoggingOption.md) オブジェクト
必須: はい
** [CurrentApplicationVersionId](#API_AddApplicationCloudWatchLoggingOption_RequestSyntax) **
Kinesis Analytics アプリケーションのバージョン ID。
タイプ: Long
有効範囲: 最小値は 1 です。最大値は 999999999 です。
必須: はい
## レスポンス要素
アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。
## エラー
** ConcurrentModificationException **
アプリケーションへの同時変更の結果としてスローされる例外。例えば、2 人の個人が同じアプリケーションを同時に編集しようとしています。
** message **
HTTP ステータスコード: 400
** InvalidArgumentException **
指定された入力パラメータ値が無効です。
** message **
HTTP ステータスコード: 400
** ResourceInUseException **
このオペレーションではアプリケーションを使用できません。
** message **
HTTP ステータスコード: 400
** ResourceNotFoundException **
指定されたアプリケーションが見つかりません。
** message **
HTTP ステータスコード: 400
** UnsupportedOperationException **
指定されたパラメータがサポートされていないか、指定されたリソースがこのオペレーションに対して有効でないため、リクエストは拒否されました。
HTTP ステータスコード: 400
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/AddApplicationCloudWatchLoggingOption)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/AddApplicationCloudWatchLoggingOption)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/AddApplicationCloudWatchLoggingOption)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/AddApplicationCloudWatchLoggingOption)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/AddApplicationCloudWatchLoggingOption)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/AddApplicationCloudWatchLoggingOption)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/AddApplicationCloudWatchLoggingOption)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/AddApplicationCloudWatchLoggingOption)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/AddApplicationCloudWatchLoggingOption)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/AddApplicationCloudWatchLoggingOption)
# AddApplicationInput
**注記**
このドキュメントの対象は、SQL アプリケーションのみがサポートされる Amazon Kinesis Data Analytics API のバージョン 1 です。バージョン 2 の API では、SQL および Java アプリケーションがサポートされます。バージョン 2 の詳細については、[Amazon Kinesis Data Analytics API V2 のドキュメント](/kinesisanalytics/latest/apiv2/Welcome.html)を参照してください。
Amazon Kinesis アプリケーションにストリーミングソースを追加します。概念については、「[アプリケーション入力の設定](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-input.html)」を参照してください。
ストリーミングソースは、アプリケーションの作成時に追加することも、アプリケーションの作成後にこのオペレーションを使用して追加することもできます。詳細については、API リファレンスの「[CreateApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_CreateApplication.html)」を参照してください。
このオペレーションを使用したストリーミングソースの追加などのすべての構成の更新により、アプリケーションの新しいバージョンになります。[DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) オペレーションを使用して、現在のアプリケーションバージョンを見つけることができます。
このオペレーションには `kinesisanalytics:AddApplicationInput` アクションを実行するアクセス許可が必要です。
## リクエストの構文
```
{
"ApplicationName": "string",
"CurrentApplicationVersionId": number,
"Input": {
"InputParallelism": {
"Count": number
},
"InputProcessingConfiguration": {
"InputLambdaProcessor": {
"ResourceARN": "string",
"RoleARN": "string"
}
},
"InputSchema": {
"RecordColumns": [
{
"Mapping": "string",
"Name": "string",
"SqlType": "string"
}
],
"RecordEncoding": "string",
"RecordFormat": {
"MappingParameters": {
"CSVMappingParameters": {
"RecordColumnDelimiter": "string",
"RecordRowDelimiter": "string"
},
"JSONMappingParameters": {
"RecordRowPath": "string"
}
},
"RecordFormatType": "string"
}
},
"KinesisFirehoseInput": {
"ResourceARN": "string",
"RoleARN": "string"
},
"KinesisStreamsInput": {
"ResourceARN": "string",
"RoleARN": "string"
},
"NamePrefix": "string"
}
}
```
## リクエストパラメーター
リクエストは以下のデータを JSON 形式で受け入れます。
** [ApplicationName](#API_AddApplicationInput_RequestSyntax) **
ストリーミングソースを追加する既存 Amazon Kinesis Analytics アプリケーションの名前です。
タイプ: 文字列
長さの制限: 最小長は 1 です。最大長は 128 です。
パターン: `[a-zA-Z0-9_.-]+`
必須: はい
** [CurrentApplicationVersionId](#API_AddApplicationInput_RequestSyntax) **
Amazon Kinesis Analytics アプリケーションの現在のバージョンです。[DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) オペレーションを使用して、現在のアプリケーションバージョンを見つけることができます。
タイプ: Long
有効範囲: 最小値は 1 です。最大値は 999999999 です。
必須: はい
** [Input](#API_AddApplicationInput_RequestSyntax) **
追加する[入力](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_Input.html)。
型: [Input](API_Input.md) オブジェクト
必須: はい
## レスポンス要素
アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。
## エラー
** CodeValidationException **
ユーザー指定のアプリケーションコード (クエリ) が無効です。これは単純な構文エラーである可能性があります。
** message **
テスト
HTTP ステータスコード: 400
** ConcurrentModificationException **
アプリケーションへの同時変更の結果としてスローされる例外。例えば、2 人の個人が同じアプリケーションを同時に編集しようとしています。
** message **
HTTP ステータスコード: 400
** InvalidArgumentException **
指定された入力パラメータ値が無効です。
** message **
HTTP ステータスコード: 400
** ResourceInUseException **
このオペレーションではアプリケーションを使用できません。
** message **
HTTP ステータスコード: 400
** ResourceNotFoundException **
指定されたアプリケーションが見つかりません。
** message **
HTTP ステータスコード: 400
** UnsupportedOperationException **
指定されたパラメータがサポートされていないか、指定されたリソースがこのオペレーションに対して有効でないため、リクエストは拒否されました。
HTTP ステータスコード: 400
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/AddApplicationInput)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/AddApplicationInput)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/AddApplicationInput)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/AddApplicationInput)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/AddApplicationInput)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/AddApplicationInput)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/AddApplicationInput)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/AddApplicationInput)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/AddApplicationInput)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/AddApplicationInput)
# AddApplicationInputProcessingConfiguration
**注記**
このドキュメントの対象は、SQL アプリケーションのみがサポートされる Amazon Kinesis Data Analytics API のバージョン 1 です。バージョン 2 の API では、SQL および Java アプリケーションがサポートされます。バージョン 2 の詳細については、[Amazon Kinesis Data Analytics API V2 のドキュメント](/kinesisanalytics/latest/apiv2/Welcome.html)を参照してください。
[InputProcessingConfiguration](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_InputProcessingConfiguration.html) をアプリケーションに追加します。入力プロセッサは、アプリケーションの SQL コードが実行される前に、入力ストリーム上のレコードを処理します。現在、利用可能な唯一の入力プロセッサは [AWS Lambda](https://docs.aws.amazon.com/lambda/) です。
## リクエストの構文
```
{
"ApplicationName": "string",
"CurrentApplicationVersionId": number,
"InputId": "string",
"InputProcessingConfiguration": {
"InputLambdaProcessor": {
"ResourceARN": "string",
"RoleARN": "string"
}
}
}
```
## リクエストパラメーター
リクエストは以下のデータを JSON 形式で受け入れます。
** [ApplicationName](#API_AddApplicationInputProcessingConfiguration_RequestSyntax) **
入力処理設定を追加するアプリケーションの名前。
タイプ: 文字列
長さの制限: 最小長は 1 です。最大長は 128 です。
パターン: `[a-zA-Z0-9_.-]+`
必須: はい
** [CurrentApplicationVersionId](#API_AddApplicationInputProcessingConfiguration_RequestSyntax) **
入力処理設定を追加するアプリケーションのバージョン。[DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) オペレーションを使用して、アプリケーションの現在のバージョンを見つけることができます。指定したバージョンが現在のバージョンでない場合は、`ConcurrentModificationException` が返されます。
タイプ: Long
有効範囲: 最小値は 1 です。最大値は 999999999 です。
必須: はい
** [InputId](#API_AddApplicationInputProcessingConfiguration_RequestSyntax) **
入力処理設定を追加する入力設定の ID。[DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) オペレーションを使用して、アプリケーションの入力 ID のリストを取得できます。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 50 です。
パターン: `[a-zA-Z0-9_.-]+`
必須: はい
** [InputProcessingConfiguration](#API_AddApplicationInputProcessingConfiguration_RequestSyntax) **
[入力処理設定](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_InputProcessingConfiguration.html)をアプリケーションに追加します。
型: [InputProcessingConfiguration](API_InputProcessingConfiguration.md) オブジェクト
必須: はい
## レスポンス要素
アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。
## エラー
** ConcurrentModificationException **
アプリケーションへの同時変更の結果としてスローされる例外。例えば、2 人の個人が同じアプリケーションを同時に編集しようとしています。
** message **
HTTP ステータスコード: 400
** InvalidArgumentException **
指定された入力パラメータ値が無効です。
** message **
HTTP ステータスコード: 400
** ResourceInUseException **
このオペレーションではアプリケーションを使用できません。
** message **
HTTP ステータスコード: 400
** ResourceNotFoundException **
指定されたアプリケーションが見つかりません。
** message **
HTTP ステータスコード: 400
** UnsupportedOperationException **
指定されたパラメータがサポートされていないか、指定されたリソースがこのオペレーションに対して有効でないため、リクエストは拒否されました。
HTTP ステータスコード: 400
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/AddApplicationInputProcessingConfiguration)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/AddApplicationInputProcessingConfiguration)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/AddApplicationInputProcessingConfiguration)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/AddApplicationInputProcessingConfiguration)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/AddApplicationInputProcessingConfiguration)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/AddApplicationInputProcessingConfiguration)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/AddApplicationInputProcessingConfiguration)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/AddApplicationInputProcessingConfiguration)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/AddApplicationInputProcessingConfiguration)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/AddApplicationInputProcessingConfiguration)
# AddApplicationOutput
**注記**
このドキュメントの対象は、SQL アプリケーションのみがサポートされる Amazon Kinesis Data Analytics API のバージョン 1 です。バージョン 2 の API では、SQL および Java アプリケーションがサポートされます。バージョン 2 の詳細については、[Amazon Kinesis Data Analytics API V2 のドキュメント](/kinesisanalytics/latest/apiv2/Welcome.html)を参照してください。
外部宛先を Amazon Kinesis Analytics アプリケーションに追加します。
Amazon Kinesis Analytics でアプリケーション内のアプリケーション内ストリームから外部宛先 (Amazon Kinesis ストリーム、Amazon Kinesis Firehose 配信ストリーム、 AWS Lambda 関数など) にデータを配信する場合は、このオペレーションを使用して関連する設定をアプリケーションに追加します。アプリケーションに対して 1 つ以上の出力を設定できます。各出力構成により、アプリケーション内ストリームと外部送信先がマッピングされます。
いずれかの出力構成を使用して、データをアプリケーション内エラーストリームから外部送信先に配信できます。これにより、エラーの分析が可能になります。詳細については、「[アプリケーション出力 (宛先) について](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-output.html)」を参照してください。
このオペレーションを使用したストリーミングソースの追加などのすべての構成の更新により、アプリケーションの新しいバージョンになります。[DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) オペレーションを使用して、現在のアプリケーションバージョンを見つけることができます。
設定できるアプリケーションの入力数および出力数の制限については、「[制限](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/limits.html)」を参照してください。
このオペレーションには `kinesisanalytics:AddApplicationOutput` アクションを実行するアクセス許可が必要です。
## リクエストの構文
```
{
"ApplicationName": "string",
"CurrentApplicationVersionId": number,
"Output": {
"DestinationSchema": {
"RecordFormatType": "string"
},
"KinesisFirehoseOutput": {
"ResourceARN": "string",
"RoleARN": "string"
},
"KinesisStreamsOutput": {
"ResourceARN": "string",
"RoleARN": "string"
},
"LambdaOutput": {
"ResourceARN": "string",
"RoleARN": "string"
},
"Name": "string"
}
}
```
## リクエストパラメーター
リクエストは以下のデータを JSON 形式で受け入れます。
** [ApplicationName](#API_AddApplicationOutput_RequestSyntax) **
出力構成を追加するアプリケーションの名前。
タイプ: 文字列
長さの制限: 最小長は 1 です。最大長は 128 です。
パターン: `[a-zA-Z0-9_.-]+`
必須: はい
** [CurrentApplicationVersionId](#API_AddApplicationOutput_RequestSyntax) **
出力設定を追加するアプリケーションのバージョン。[DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) オペレーションを使用して、アプリケーションの現在のバージョンを見つけることができます。指定したバージョンが現在のバージョンでない場合は、`ConcurrentModificationException` が返されます。
タイプ: Long
有効範囲: 最小値は 1 です。最大値は 999999999 です。
必須: はい
** [Output](#API_AddApplicationOutput_RequestSyntax) **
それぞれが 1 つの出力構成を記述するオブジェクトの配列です。出力設定では、アプリケーション内ストリームの名前、送信先 (Amazon Kinesis ストリーム、Amazon Kinesis Firehose 配信ストリーム、または AWS Lambda 関数) を指定し、送信先に書き込むときに使用するフォーメーションを記録します。
型: [Output](API_Output.md) オブジェクト
必須: はい
## レスポンス要素
アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。
## エラー
** ConcurrentModificationException **
アプリケーションへの同時変更の結果としてスローされる例外。例えば、2 人の個人が同じアプリケーションを同時に編集しようとしています。
** message **
HTTP ステータスコード: 400
** InvalidArgumentException **
指定された入力パラメータ値が無効です。
** message **
HTTP ステータスコード: 400
** ResourceInUseException **
このオペレーションではアプリケーションを使用できません。
** message **
HTTP ステータスコード: 400
** ResourceNotFoundException **
指定されたアプリケーションが見つかりません。
** message **
HTTP ステータスコード: 400
** UnsupportedOperationException **
指定されたパラメータがサポートされていないか、指定されたリソースがこのオペレーションに対して有効でないため、リクエストは拒否されました。
HTTP ステータスコード: 400
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/AddApplicationOutput)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/AddApplicationOutput)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/AddApplicationOutput)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/AddApplicationOutput)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/AddApplicationOutput)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/AddApplicationOutput)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/AddApplicationOutput)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/AddApplicationOutput)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/AddApplicationOutput)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/AddApplicationOutput)
# AddApplicationReferenceDataSource
**注記**
このドキュメントの対象は、SQL アプリケーションのみがサポートされる Amazon Kinesis Data Analytics API のバージョン 1 です。バージョン 2 の API では、SQL および Java アプリケーションがサポートされます。バージョン 2 の詳細については、[Amazon Kinesis Data Analytics API V2 のドキュメント](/kinesisanalytics/latest/apiv2/Welcome.html)を参照してください。
既存のアプリケーションにリファレンスデータソースを追加します。
Amazon Kinesis Analytics は、リファレンスデータ (つまり、Amazon S3 オブジェクト) を読み取り、アプリケーション内にアプリケーション内テーブルを作成します。リクエストでは、ソース (S3 バケット名とオブジェクトのキー名)、作成するアプリケーション内テーブルの名前、および Amazon S3 オブジェクトのデータが結果のアプリケーション内テーブルの列にマッピングされる方法を説明する必要なマッピング情報を入力します。
概念については、「[アプリケーション入力の設定](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-input.html)」を参照してください。アプリケーションに追加できるデータソースの制限については、「[制限](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/limits.html)」を参照してください。
このオペレーションには `kinesisanalytics:AddApplicationOutput` アクションを実行するアクセス許可が必要です。
## リクエストの構文
```
{
"ApplicationName": "string",
"CurrentApplicationVersionId": number,
"ReferenceDataSource": {
"ReferenceSchema": {
"RecordColumns": [
{
"Mapping": "string",
"Name": "string",
"SqlType": "string"
}
],
"RecordEncoding": "string",
"RecordFormat": {
"MappingParameters": {
"CSVMappingParameters": {
"RecordColumnDelimiter": "string",
"RecordRowDelimiter": "string"
},
"JSONMappingParameters": {
"RecordRowPath": "string"
}
},
"RecordFormatType": "string"
}
},
"S3ReferenceDataSource": {
"BucketARN": "string",
"FileKey": "string",
"ReferenceRoleARN": "string"
},
"TableName": "string"
}
}
```
## リクエストパラメーター
リクエストは以下のデータを JSON 形式で受け入れます。
** [ApplicationName](#API_AddApplicationReferenceDataSource_RequestSyntax) **
既存のアプリケーションの名前。
タイプ: 文字列
長さの制限: 最小長は 1 です。最大長は 128 です。
パターン: `[a-zA-Z0-9_.-]+`
必須: はい
** [CurrentApplicationVersionId](#API_AddApplicationReferenceDataSource_RequestSyntax) **
参照データソースを追加するアプリケーションのバージョン。[DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) オペレーションを使用して、アプリケーションの現在のバージョンを見つけることができます。指定したバージョンが現在のバージョンでない場合は、`ConcurrentModificationException` が返されます。
タイプ: Long
有効範囲: 最小値は 1 です。最大値は 999999999 です。
必須: はい
** [ReferenceDataSource](#API_AddApplicationReferenceDataSource_RequestSyntax) **
リファレンスデータソースは、Amazon S3 バケット内のオブジェクトにすることができます。Amazon Kinesis Analytics は、オブジェクトを読み取り、作成されているアプリケーション内テーブルにデータをコピーします。S3 バケット、オブジェクトのキー名、および作成されているアプリケーション内テーブルを指定します。また、ユーザーに代わって Amazon Kinesis Analytics が S3 バケットからのオブジェクトの読み取りを引き受けることができる必要なアクセス許可を持つ IAM ロールも指定する必要があります。
型: [ReferenceDataSource](API_ReferenceDataSource.md) オブジェクト
必須: はい
## レスポンス要素
アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。
## エラー
** ConcurrentModificationException **
アプリケーションへの同時変更の結果としてスローされる例外。例えば、2 人の個人が同じアプリケーションを同時に編集しようとしています。
** message **
HTTP ステータスコード: 400
** InvalidArgumentException **
指定された入力パラメータ値が無効です。
** message **
HTTP ステータスコード: 400
** ResourceInUseException **
このオペレーションではアプリケーションを使用できません。
** message **
HTTP ステータスコード: 400
** ResourceNotFoundException **
指定されたアプリケーションが見つかりません。
** message **
HTTP ステータスコード: 400
** UnsupportedOperationException **
指定されたパラメータがサポートされていないか、指定されたリソースがこのオペレーションに対して有効でないため、リクエストは拒否されました。
HTTP ステータスコード: 400
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource)
# CreateApplication
**注記**
このドキュメントの対象は、SQL アプリケーションのみがサポートされる Amazon Kinesis Data Analytics API のバージョン 1 です。バージョン 2 の API では、SQL および Java アプリケーションがサポートされます。バージョン 2 の詳細については、[Amazon Kinesis Data Analytics API V2 のドキュメント](/kinesisanalytics/latest/apiv2/Welcome.html)を参照してください。
Amazon Kinesis Analytics アプリケーションを作成します。各アプリケーションには、入力として 1 つのストリーミングソース、入力を処理するアプリケーションコード、Amazon Kinesis Analytics がアプリケーションからの出力データを書き込む宛先を 3 つまで設定できます。概要については、「[仕組み](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works.html)」を参照してください。
入力の設定では、ストリーミングソースをアプリケーション内ストリームにマッピングします。アプリケーション内ストリームは常に更新されるテーブルとみなすことができます。マッピングでは、アプリケーション内ストリーム用のスキーマを提供し、アプリケーション内ストリーム内の各データ列をストリーミングソース内のデータ要素にマッピングする必要があります。
アプリケーションコードとは、入力データを読み取って変換し、出力を生成する 1 つ以上の SQL ステートメントです。アプリケーションコードでは、SQL ストリームやポンプなど、複数の SQL アーティファクトを作成できます。
出力設定では、アプリケーションで作成されたアプリケーション内ストリームから最大 3 つの宛先にデータを書き込むようにアプリケーションを設定できます。
ソースストリームからデータを読み取ったり、送信先ストリームにデータを書き込んだりするには、Amazon Kinesis Analytics にアクセス許可が必要です。このアクセス権限は、IAM ロールを作成することによって付与します。このオペレーションには `kinesisanalytics:CreateApplication` アクションを実行するアクセス許可が必要です。
Amazon Kinesis Analytics アプリケーションを作成するための入門演習については、「[開始方法](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/getting-started.html)」を参照してください。
## リクエストの構文
```
{
"ApplicationCode": "string",
"ApplicationDescription": "string",
"ApplicationName": "string",
"CloudWatchLoggingOptions": [
{
"LogStreamARN": "string",
"RoleARN": "string"
}
],
"Inputs": [
{
"InputParallelism": {
"Count": number
},
"InputProcessingConfiguration": {
"InputLambdaProcessor": {
"ResourceARN": "string",
"RoleARN": "string"
}
},
"InputSchema": {
"RecordColumns": [
{
"Mapping": "string",
"Name": "string",
"SqlType": "string"
}
],
"RecordEncoding": "string",
"RecordFormat": {
"MappingParameters": {
"CSVMappingParameters": {
"RecordColumnDelimiter": "string",
"RecordRowDelimiter": "string"
},
"JSONMappingParameters": {
"RecordRowPath": "string"
}
},
"RecordFormatType": "string"
}
},
"KinesisFirehoseInput": {
"ResourceARN": "string",
"RoleARN": "string"
},
"KinesisStreamsInput": {
"ResourceARN": "string",
"RoleARN": "string"
},
"NamePrefix": "string"
}
],
"Outputs": [
{
"DestinationSchema": {
"RecordFormatType": "string"
},
"KinesisFirehoseOutput": {
"ResourceARN": "string",
"RoleARN": "string"
},
"KinesisStreamsOutput": {
"ResourceARN": "string",
"RoleARN": "string"
},
"LambdaOutput": {
"ResourceARN": "string",
"RoleARN": "string"
},
"Name": "string"
}
],
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## リクエストパラメーター
リクエストは以下のデータを JSON 形式で受け入れます。
** [ApplicationCode](#API_CreateApplication_RequestSyntax) **
入力データを読み取って変換し、出力を生成する 1 つ以上の SQL ステートメント。たとえば、1 つのアプリケーション内ストリームからデータを読み取り、ベンダー別の広告クリック数の移動平均を生成する SQL ステートメントを記述し、ポンプを使用して、表示された行を別のアプリケーション内ストリームに挿入することができます。一般的なパターンの詳細については、「[アプリケーションコード](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-app-code.html)」を参照してください。
このような一連の SQL ステートメントを入力できます。ここでは、1 つのステートメントの出力は次のステートメントの入力として使用できます。アプリケーション内ストリームとポンプを作成して、中間結果を保存します。
アプリケーションコードは、`Outputs` で指定された名前でストリームを作成する必要があります。たとえば、`Outputs` で `ExampleOutputStream1` および `ExampleOutputStream2` という名前の出力ストリームを定義した場合、アプリケーションコードはこれらのストリームを作成する必要があります。
タイプ: 文字列
長さの制約: 最小長は 0 です。最大長は 102400 です。
必須: いいえ
** [ApplicationDescription](#API_CreateApplication_RequestSyntax) **
アプリケーションの簡単な説明。
タイプ: 文字列
長さの制約: 最小長は 0 です。最大長は 1,024 です。
必須: いいえ
** [ApplicationName](#API_CreateApplication_RequestSyntax) **
Amazon Kinesis Analytics アプリケーションの名前 (例 : `sample-app`)。
タイプ: 文字列
長さの制限: 最小長は 1 です。最大長は 128 です。
パターン: `[a-zA-Z0-9_.-]+`
必須: はい
** [CloudWatchLoggingOptions](#API_CreateApplication_RequestSyntax) **
このパラメータでは、CloudWatch ログストリームを設定してアプリケーションの設定エラーをモニタリングします。詳細については、「[Amazon CloudWatch Logs の使用](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/cloudwatch-logs.html)」を参照してください。
タイプ: [CloudWatchLoggingOption](API_CloudWatchLoggingOption.md) オブジェクトの配列
必須: いいえ
** [Inputs](#API_CreateApplication_RequestSyntax) **
このパラメータを使用して、アプリケーション入力を設定します。
単一のストリーミングソースから入力を受信するようにアプリケーションを設定できます。この構成では、このストリーミングソースを作成済みのアプリケーション内ストリームにマッピングします。その後、アプリケーションコードは、テーブルのようにアプリケーション内ストリームのクエリを実行できるようになります (このコードは常に更新されるテーブルと考えることができます)。
ストリーミングソースの場合、その Amazon リソースネーム (ARN) とストリームのデータの形式 (JSON、CSV など) を指定します。ユーザーに代わって Amazon Kinesis Analytics がこのストリームの読み取りを引き受けられるよう IAM ロールを指定する必要もあります。
アプリケーション内ストリームを作成するには、SQL で使用するスキーマ化されたデータに変換するスキーマを指定する必要があります。スキーマでは、アプリケーション内ストリームの列を記録するために、ストリーミングソース内のデータ要素の必要なマッピングを指定します。
タイプ: [Input](API_Input.md) オブジェクトの配列
必須: いいえ
** [Outputs](#API_CreateApplication_RequestSyntax) **
アプリケーション内ストリームのいずれかから最大 3 つの宛先にデータを書き込むように、アプリケーション出力を設定できます。
これらの宛先には、Amazon Kinesis ストリーム、Amazon Kinesis Firehose 配信ストリーム、 AWS Lambda 送信先、またはこれらの 3 つの任意の組み合わせを使用できます。
設定では、アプリケーション内ストリーム名、送信先ストリームまたは Lambda 関数の Amazon リソースネーム (ARN)、データを書き込むときに使用する形式を指定します。また、Amazon Kinesis Analytics がユーザーに代わって送信先ストリームまたは Lambda 関数に書き込むために引き受けることができる IAM ロールを指定する必要があります。
出力設定では、出力ストリームまたは Lambda 関数 ARN も指定します。ストリームの送信先には、ストリーム内のデータの形式 (JSON、CSV など) を指定します。また、Amazon Kinesis Analytics がユーザーに代わってストリームまたは Lambda 関数に書き込むために引き受けることができる IAM ロールを指定する必要があります。
タイプ: [Output](API_Output.md) オブジェクトの配列
必須: いいえ
** [Tags](#API_CreateApplication_RequestSyntax) **
アプリケーションに割り当てる 1 つ以上のタグのリスト。タグは、アプリケーションを識別するキーと値のペアです。アプリケーションタグの最大数にはシステムタグが含まれることに注意してください。ユーザー定義のアプリケーションタグの最大数は 50 です。詳細については、「[タグ付けの使用](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-tagging.html)」を参照してください。
型: [Tag](API_Tag.md) オブジェクトの配列
配列メンバー: 最小数は 1 項目です。最大数は 200 項目です。
必須: いいえ
## レスポンスの構文
```
{
"ApplicationSummary": {
"ApplicationARN": "string",
"ApplicationName": "string",
"ApplicationStatus": "string"
}
}
```
## レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
** [ApplicationSummary](#API_CreateApplication_ResponseSyntax) **
Amazon Kinesis Analytics は、`CreateApplication` リクエストへのレスポンスとしてアプリケーションの Amazon リソースネーム (ARN)、名前、ステータスなど、作成したアプリケーションの概要を記載したレスポンスを返します。
型: [ApplicationSummary](API_ApplicationSummary.md) オブジェクト
## エラー
** CodeValidationException **
ユーザー指定のアプリケーションコード (クエリ) が無効です。これは単純な構文エラーである可能性があります。
** message **
テスト
HTTP ステータスコード: 400
** ConcurrentModificationException **
アプリケーションへの同時変更の結果としてスローされる例外。例えば、2 人の個人が同じアプリケーションを同時に編集しようとしています。
** message **
HTTP ステータスコード: 400
** InvalidArgumentException **
指定された入力パラメータ値が無効です。
** message **
HTTP ステータスコード: 400
** LimitExceededException **
許可されているアプリケーションの数を超えました。
** message **
HTTP ステータスコード: 400
** ResourceInUseException **
このオペレーションではアプリケーションを使用できません。
** message **
HTTP ステータスコード: 400
** TooManyTagsException **
多すぎるタグを使用してアプリケーションが作成されたか、またはアプリケーションに追加されたタグが多すぎます。アプリケーションタグの最大数にはシステムタグが含まれることに注意してください。ユーザー定義のアプリケーションタグの最大数は 50 です。
HTTP ステータスコード: 400
** UnsupportedOperationException **
指定されたパラメータがサポートされていないか、指定されたリソースがこのオペレーションに対して有効でないため、リクエストは拒否されました。
HTTP ステータスコード: 400
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/CreateApplication)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/CreateApplication)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/CreateApplication)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/CreateApplication)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/CreateApplication)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/CreateApplication)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/CreateApplication)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/CreateApplication)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/CreateApplication)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/CreateApplication)
# DeleteApplication
**注記**
このドキュメントの対象は、SQL アプリケーションのみがサポートされる Amazon Kinesis Data Analytics API のバージョン 1 です。バージョン 2 の API では、SQL および Java アプリケーションがサポートされます。バージョン 2 の詳細については、[Amazon Kinesis Data Analytics API V2 のドキュメント](/kinesisanalytics/latest/apiv2/Welcome.html)を参照してください。
指定されたアプリケーションを削除します。Amazon Kinesis Analytics はアプリケーションの実行を停止し、あらゆるアプリケーションアーティファクト (アプリケーション内ストリーム、参照テーブル、アプリケーションコードなど) を含むアプリケーションを削除します。
このオペレーションには `kinesisanalytics:DeleteApplication` アクションを実行するアクセス許可が必要です。
## リクエストの構文
```
{
"ApplicationName": "string",
"CreateTimestamp": number
}
```
## リクエストパラメーター
リクエストは以下のデータを JSON 形式で受け入れます。
** [ApplicationName](#API_DeleteApplication_RequestSyntax) **
削除する Amazon Kinesis Analytics アプリケーションの名前。
タイプ: 文字列
長さの制限: 最小長は 1 です。最大長は 128 です。
パターン: `[a-zA-Z0-9_.-]+`
必須: はい
** [CreateTimestamp](#API_DeleteApplication_RequestSyntax) **
`DescribeApplication` オペレーションを使用して、この値を取得できます。
タイプ: タイムスタンプ
必須: はい
## レスポンス要素
アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。
## エラー
** ConcurrentModificationException **
アプリケーションへの同時変更の結果としてスローされる例外。例えば、2 人の個人が同じアプリケーションを同時に編集しようとしています。
** message **
HTTP ステータスコード: 400
** ResourceInUseException **
このオペレーションではアプリケーションを使用できません。
** message **
HTTP ステータスコード: 400
** ResourceNotFoundException **
指定されたアプリケーションが見つかりません。
** message **
HTTP ステータスコード: 400
** UnsupportedOperationException **
指定されたパラメータがサポートされていないか、指定されたリソースがこのオペレーションに対して有効でないため、リクエストは拒否されました。
HTTP ステータスコード: 400
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/DeleteApplication)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/DeleteApplication)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/DeleteApplication)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/DeleteApplication)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/DeleteApplication)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/DeleteApplication)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/DeleteApplication)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/DeleteApplication)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/DeleteApplication)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/DeleteApplication)
# DeleteApplicationCloudWatchLoggingOption
**注記**
このドキュメントの対象は、SQL アプリケーションのみがサポートされる Amazon Kinesis Data Analytics API のバージョン 1 です。バージョン 2 の API では、SQL および Java アプリケーションがサポートされます。バージョン 2 の詳細については、[Amazon Kinesis Data Analytics API V2 のドキュメント](/kinesisanalytics/latest/apiv2/Welcome.html)を参照してください。
アプリケーションから CloudWatch ログストリームを削除します。Amazon Kinesis Analytics アプリケーションで CloudWatch ログストリームを使用する方法の詳細については、「[Amazon CloudWatch Logs の使用](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/cloudwatch-logs.html)」を参照してください。
## リクエストの構文
```
{
"ApplicationName": "string",
"CloudWatchLoggingOptionId": "string",
"CurrentApplicationVersionId": number
}
```
## リクエストパラメーター
リクエストは以下のデータを JSON 形式で受け入れます。
** [ApplicationName](#API_DeleteApplicationCloudWatchLoggingOption_RequestSyntax) **
Kinesis Analytics アプリケーション名。
タイプ: 文字列
長さの制限: 最小長は 1 です。最大長は 128 です。
パターン: `[a-zA-Z0-9_.-]+`
必須: はい
** [CloudWatchLoggingOptionId](#API_DeleteApplicationCloudWatchLoggingOption_RequestSyntax) **
削除する CloudWatch ログ記録オプションの `CloudWatchLoggingOptionId`。`CloudWatchLoggingOptionId` は [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) オペレーションを呼び出すことで取得できます。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 50 です。
パターン: `[a-zA-Z0-9_.-]+`
必須: はい
** [CurrentApplicationVersionId](#API_DeleteApplicationCloudWatchLoggingOption_RequestSyntax) **
Kinesis Analytics アプリケーションのバージョン ID。
タイプ: Long
有効範囲: 最小値は 1 です。最大値は 999999999 です。
必須: はい
## レスポンス要素
アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。
## エラー
** ConcurrentModificationException **
アプリケーションへの同時変更の結果としてスローされる例外。例えば、2 人の個人が同じアプリケーションを同時に編集しようとしています。
** message **
HTTP ステータスコード: 400
** InvalidArgumentException **
指定された入力パラメータ値が無効です。
** message **
HTTP ステータスコード: 400
** ResourceInUseException **
このオペレーションではアプリケーションを使用できません。
** message **
HTTP ステータスコード: 400
** ResourceNotFoundException **
指定されたアプリケーションが見つかりません。
** message **
HTTP ステータスコード: 400
** UnsupportedOperationException **
指定されたパラメータがサポートされていないか、指定されたリソースがこのオペレーションに対して有効でないため、リクエストは拒否されました。
HTTP ステータスコード: 400
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/DeleteApplicationCloudWatchLoggingOption)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/DeleteApplicationCloudWatchLoggingOption)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/DeleteApplicationCloudWatchLoggingOption)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/DeleteApplicationCloudWatchLoggingOption)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/DeleteApplicationCloudWatchLoggingOption)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/DeleteApplicationCloudWatchLoggingOption)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/DeleteApplicationCloudWatchLoggingOption)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/DeleteApplicationCloudWatchLoggingOption)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/DeleteApplicationCloudWatchLoggingOption)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/DeleteApplicationCloudWatchLoggingOption)
# DeleteApplicationInputProcessingConfiguration
**注記**
このドキュメントの対象は、SQL アプリケーションのみがサポートされる Amazon Kinesis Data Analytics API のバージョン 1 です。バージョン 2 の API では、SQL および Java アプリケーションがサポートされます。バージョン 2 の詳細については、[Amazon Kinesis Data Analytics API V2 のドキュメント](/kinesisanalytics/latest/apiv2/Welcome.html)を参照してください。
入力から [InputProcessingConfiguration](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_InputProcessingConfiguration.html) を削除します。
## リクエストの構文
```
{
"ApplicationName": "string",
"CurrentApplicationVersionId": number,
"InputId": "string"
}
```
## リクエストパラメーター
リクエストは以下のデータを JSON 形式で受け入れます。
** [ApplicationName](#API_DeleteApplicationInputProcessingConfiguration_RequestSyntax) **
Kinesis Analytics アプリケーション名。
タイプ: 文字列
長さの制限: 最小長は 1 です。最大長は 128 です。
パターン: `[a-zA-Z0-9_.-]+`
必須: はい
** [CurrentApplicationVersionId](#API_DeleteApplicationInputProcessingConfiguration_RequestSyntax) **
Kinesis Analytics アプリケーションのバージョン ID。
タイプ: Long
有効範囲: 最小値は 1 です。最大値は 999999999 です。
必須: はい
** [InputId](#API_DeleteApplicationInputProcessingConfiguration_RequestSyntax) **
入力処理設定から削除する入力設定の ID。[DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) オペレーションを使用して、アプリケーションの入力 ID のリストを取得できます。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 50 です。
パターン: `[a-zA-Z0-9_.-]+`
必須: はい
## レスポンス要素
アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。
## エラー
** ConcurrentModificationException **
アプリケーションへの同時変更の結果としてスローされる例外。例えば、2 人の個人が同じアプリケーションを同時に編集しようとしています。
** message **
HTTP ステータスコード: 400
** InvalidArgumentException **
指定された入力パラメータ値が無効です。
** message **
HTTP ステータスコード: 400
** ResourceInUseException **
このオペレーションではアプリケーションを使用できません。
** message **
HTTP ステータスコード: 400
** ResourceNotFoundException **
指定されたアプリケーションが見つかりません。
** message **
HTTP ステータスコード: 400
** UnsupportedOperationException **
指定されたパラメータがサポートされていないか、指定されたリソースがこのオペレーションに対して有効でないため、リクエストは拒否されました。
HTTP ステータスコード: 400
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/DeleteApplicationInputProcessingConfiguration)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/DeleteApplicationInputProcessingConfiguration)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/DeleteApplicationInputProcessingConfiguration)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/DeleteApplicationInputProcessingConfiguration)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/DeleteApplicationInputProcessingConfiguration)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/DeleteApplicationInputProcessingConfiguration)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/DeleteApplicationInputProcessingConfiguration)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/DeleteApplicationInputProcessingConfiguration)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/DeleteApplicationInputProcessingConfiguration)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/DeleteApplicationInputProcessingConfiguration)
# DeleteApplicationOutput
**注記**
このドキュメントの対象は、SQL アプリケーションのみがサポートされる Amazon Kinesis Data Analytics API のバージョン 1 です。バージョン 2 の API では、SQL および Java アプリケーションがサポートされます。バージョン 2 の詳細については、[Amazon Kinesis Data Analytics API V2 のドキュメント](/kinesisanalytics/latest/apiv2/Welcome.html)を参照してください。
出力先の設定をアプリケーション設定から削除します。Amazon Kinesis Analytics は、対応するアプリケーション内ストリームから外部出力先にデータを書き込まなくなります。
このオペレーションには `kinesisanalytics:DeleteApplicationOutput` アクションを実行するアクセス許可が必要です。
## リクエストの構文
```
{
"ApplicationName": "string",
"CurrentApplicationVersionId": number,
"OutputId": "string"
}
```
## リクエストパラメーター
リクエストは以下のデータを JSON 形式で受け入れます。
** [ApplicationName](#API_DeleteApplicationOutput_RequestSyntax) **
Amazon Kinesis Analytics アプリケーション名。
タイプ: 文字列
長さの制限: 最小長は 1 です。最大長は 128 です。
パターン: `[a-zA-Z0-9_.-]+`
必須: はい
** [CurrentApplicationVersionId](#API_DeleteApplicationOutput_RequestSyntax) **
Amazon Kinesis Analytics アプリケーションバージョン。[DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) オペレーションを使用して、アプリケーションの現在のバージョンを見つけることができます。指定したバージョンが現在のバージョンでない場合は、`ConcurrentModificationException` が返されます。
タイプ: Long
有効範囲: 最小値は 1 です。最大値は 999999999 です。
必須: はい
** [OutputId](#API_DeleteApplicationOutput_RequestSyntax) **
削除する設定の ID。アプリケーションの作成時、または後から [AddApplicationOutput](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_AddApplicationOutput.html) オペレーションを使用してアプリケーションに追加される各出力設定には、一意の ID があります。アプリケーション設定から削除する出力構成を一意に識別するために、ID を指定する必要があります。[DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) オペレーションを使用して特定の `OutputId` を取得できます。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 50 です。
パターン: `[a-zA-Z0-9_.-]+`
必須: はい
## レスポンス要素
アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。
## エラー
** ConcurrentModificationException **
アプリケーションへの同時変更の結果としてスローされる例外。例えば、2 人の個人が同じアプリケーションを同時に編集しようとしています。
** message **
HTTP ステータスコード: 400
** InvalidArgumentException **
指定された入力パラメータ値が無効です。
** message **
HTTP ステータスコード: 400
** ResourceInUseException **
このオペレーションではアプリケーションを使用できません。
** message **
HTTP ステータスコード: 400
** ResourceNotFoundException **
指定されたアプリケーションが見つかりません。
** message **
HTTP ステータスコード: 400
** UnsupportedOperationException **
指定されたパラメータがサポートされていないか、指定されたリソースがこのオペレーションに対して有効でないため、リクエストは拒否されました。
HTTP ステータスコード: 400
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/DeleteApplicationOutput)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/DeleteApplicationOutput)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/DeleteApplicationOutput)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/DeleteApplicationOutput)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/DeleteApplicationOutput)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/DeleteApplicationOutput)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/DeleteApplicationOutput)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/DeleteApplicationOutput)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/DeleteApplicationOutput)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/DeleteApplicationOutput)
# DeleteApplicationReferenceDataSource
**注記**
このドキュメントの対象は、SQL アプリケーションのみがサポートされる Amazon Kinesis Data Analytics API のバージョン 1 です。バージョン 2 の API では、SQL および Java アプリケーションがサポートされます。バージョン 2 の詳細については、[Amazon Kinesis Data Analytics API V2 のドキュメント](/kinesisanalytics/latest/apiv2/Welcome.html)を参照してください。
指定したアプリケーションの設定からリファレンスデータソース設定を削除します。
アプリケーションが実行中の場合、Amazon Kinesis Analytics は [AddApplicationReferenceDataSource](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_AddApplicationReferenceDataSource.html) オペレーションを使用して作成したアプリケーション内テーブルをすぐに削除します。
このオペレーションには `kinesisanalytics.DeleteApplicationReferenceDataSource` アクションを実行するアクセス許可が必要です。
## リクエストの構文
```
{
"ApplicationName": "string",
"CurrentApplicationVersionId": number,
"ReferenceId": "string"
}
```
## リクエストパラメーター
リクエストは以下のデータを JSON 形式で受け入れます。
** [ApplicationName](#API_DeleteApplicationReferenceDataSource_RequestSyntax) **
既存のアプリケーションの名前。
タイプ: 文字列
長さの制限: 最小長は 1 です。最大長は 128 です。
パターン: `[a-zA-Z0-9_.-]+`
必須: はい
** [CurrentApplicationVersionId](#API_DeleteApplicationReferenceDataSource_RequestSyntax) **
アプリケーションのバージョン。[DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) オペレーションを使用して、アプリケーションの現在のバージョンを見つけることができます。指定したバージョンが現在のバージョンでない場合は、`ConcurrentModificationException` が返されます。
タイプ: Long
有効範囲: 最小値は 1 です。最大値は 999999999 です。
必須: はい
** [ReferenceId](#API_DeleteApplicationReferenceDataSource_RequestSyntax) **
リファレンスデータソースの ID。[AddApplicationReferenceDataSource](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_AddApplicationReferenceDataSource.html) オペレーションを使用してリファレンスデータソースをアプリケーションに追加するときに、Amazon Kinesis Analytics が ID を割り当てます。リファレンス ID を取得するには、[DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) オペレーションを使用します。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 50 です。
パターン: `[a-zA-Z0-9_.-]+`
必須: はい
## レスポンス要素
アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。
## エラー
** ConcurrentModificationException **
アプリケーションへの同時変更の結果としてスローされる例外。例えば、2 人の個人が同じアプリケーションを同時に編集しようとしています。
** message **
HTTP ステータスコード: 400
** InvalidArgumentException **
指定された入力パラメータ値が無効です。
** message **
HTTP ステータスコード: 400
** ResourceInUseException **
このオペレーションではアプリケーションを使用できません。
** message **
HTTP ステータスコード: 400
** ResourceNotFoundException **
指定されたアプリケーションが見つかりません。
** message **
HTTP ステータスコード: 400
** UnsupportedOperationException **
指定されたパラメータがサポートされていないか、指定されたリソースがこのオペレーションに対して有効でないため、リクエストは拒否されました。
HTTP ステータスコード: 400
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/DeleteApplicationReferenceDataSource)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/DeleteApplicationReferenceDataSource)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/DeleteApplicationReferenceDataSource)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/DeleteApplicationReferenceDataSource)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/DeleteApplicationReferenceDataSource)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/DeleteApplicationReferenceDataSource)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/DeleteApplicationReferenceDataSource)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/DeleteApplicationReferenceDataSource)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/DeleteApplicationReferenceDataSource)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/DeleteApplicationReferenceDataSource)
# DescribeApplication
**注記**
このドキュメントの対象は、SQL アプリケーションのみがサポートされる Amazon Kinesis Data Analytics API のバージョン 1 です。バージョン 2 の API では、SQL および Java アプリケーションがサポートされます。バージョン 2 の詳細については、[Amazon Kinesis Data Analytics API V2 のドキュメント](/kinesisanalytics/latest/apiv2/Welcome.html)を参照してください。
特定の Amazon Kinesis Analytics アプリケーションに関する情報を返します。
アカウント内のすべてのアプリケーションのリストを取得するには、 [ListApplications](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_ListApplications.html) オペレーションを使用します。
このオペレーションには `kinesisanalytics:DescribeApplication` アクションを実行するアクセス許可が必要です。`DescribeApplication` を使用して現在のアプリケーションバージョン Id を取得できます。この情報は、`Update` などの他のオペレーションを呼び出すときに必要です。
## リクエストの構文
```
{
"ApplicationName": "string"
}
```
## リクエストパラメーター
リクエストは以下のデータを JSON 形式で受け入れます。
** [ApplicationName](#API_DescribeApplication_RequestSyntax) **
アプリケーションの名前。
タイプ: 文字列
長さの制限: 最小長は 1 です。最大長は 128 です。
パターン: `[a-zA-Z0-9_.-]+`
必須: はい
## レスポンスの構文
```
{
"ApplicationDetail": {
"ApplicationARN": "string",
"ApplicationCode": "string",
"ApplicationDescription": "string",
"ApplicationName": "string",
"ApplicationStatus": "string",
"ApplicationVersionId": number,
"CloudWatchLoggingOptionDescriptions": [
{
"CloudWatchLoggingOptionId": "string",
"LogStreamARN": "string",
"RoleARN": "string"
}
],
"CreateTimestamp": number,
"InputDescriptions": [
{
"InAppStreamNames": [ "string" ],
"InputId": "string",
"InputParallelism": {
"Count": number
},
"InputProcessingConfigurationDescription": {
"InputLambdaProcessorDescription": {
"ResourceARN": "string",
"RoleARN": "string"
}
},
"InputSchema": {
"RecordColumns": [
{
"Mapping": "string",
"Name": "string",
"SqlType": "string"
}
],
"RecordEncoding": "string",
"RecordFormat": {
"MappingParameters": {
"CSVMappingParameters": {
"RecordColumnDelimiter": "string",
"RecordRowDelimiter": "string"
},
"JSONMappingParameters": {
"RecordRowPath": "string"
}
},
"RecordFormatType": "string"
}
},
"InputStartingPositionConfiguration": {
"InputStartingPosition": "string"
},
"KinesisFirehoseInputDescription": {
"ResourceARN": "string",
"RoleARN": "string"
},
"KinesisStreamsInputDescription": {
"ResourceARN": "string",
"RoleARN": "string"
},
"NamePrefix": "string"
}
],
"LastUpdateTimestamp": number,
"OutputDescriptions": [
{
"DestinationSchema": {
"RecordFormatType": "string"
},
"KinesisFirehoseOutputDescription": {
"ResourceARN": "string",
"RoleARN": "string"
},
"KinesisStreamsOutputDescription": {
"ResourceARN": "string",
"RoleARN": "string"
},
"LambdaOutputDescription": {
"ResourceARN": "string",
"RoleARN": "string"
},
"Name": "string",
"OutputId": "string"
}
],
"ReferenceDataSourceDescriptions": [
{
"ReferenceId": "string",
"ReferenceSchema": {
"RecordColumns": [
{
"Mapping": "string",
"Name": "string",
"SqlType": "string"
}
],
"RecordEncoding": "string",
"RecordFormat": {
"MappingParameters": {
"CSVMappingParameters": {
"RecordColumnDelimiter": "string",
"RecordRowDelimiter": "string"
},
"JSONMappingParameters": {
"RecordRowPath": "string"
}
},
"RecordFormatType": "string"
}
},
"S3ReferenceDataSourceDescription": {
"BucketARN": "string",
"FileKey": "string",
"ReferenceRoleARN": "string"
},
"TableName": "string"
}
]
}
}
```
## レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
** [ApplicationDetail](#API_DescribeApplication_ResponseSyntax) **
アプリケーションの Amazon リソースネーム (ARN)、ステータス、最新バージョン、入出力の設定に関する詳細など、アプリケーションの説明を提供します。
型: [ApplicationDetail](API_ApplicationDetail.md) オブジェクト
## エラー
** ResourceNotFoundException **
指定されたアプリケーションが見つかりません。
** message **
HTTP ステータスコード: 400
** UnsupportedOperationException **
指定されたパラメータがサポートされていないか、指定されたリソースがこのオペレーションに対して有効でないため、リクエストは拒否されました。
HTTP ステータスコード: 400
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/DescribeApplication)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/DescribeApplication)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/DescribeApplication)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/DescribeApplication)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/DescribeApplication)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/DescribeApplication)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/DescribeApplication)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/DescribeApplication)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/DescribeApplication)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/DescribeApplication)
# DiscoverInputSchema
**注記**
このドキュメントの対象は、SQL アプリケーションのみがサポートされる Amazon Kinesis Data Analytics API のバージョン 1 です。バージョン 2 の API では、SQL および Java アプリケーションがサポートされます。バージョン 2 の詳細については、[Amazon Kinesis Data Analytics API V2 のドキュメント](/kinesisanalytics/latest/apiv2/Welcome.html)を参照してください。
指定したストリーミングソース (Amazon Kinesis ストリームまたは Amazon Kinesis Firehose 配信ストリーム) または S3 オブジェクトのサンプルレコードを評価することによって、スキーマを推測します。レスポンスでは、推測されたスキーマと、オペレーションでスキーマを推測するために使用されたサンプルレコードも返されます。
推測されたスキーマは、アプリケーションのストリーミングソースを設定するときに使用できます。概念については、「[アプリケーション入力の設定](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-input.html)」を参照してください。Amazon Kinesis Analytics コンソールを使用してアプリケーションを作成する場合、コンソールはこのオペレーションを使用してスキーマを推測し、コンソールのユーザーインターフェイスに表示します。
このオペレーションには `kinesisanalytics:DiscoverInputSchema` アクションを実行するアクセス許可が必要です。
## リクエストの構文
```
{
"InputProcessingConfiguration": {
"InputLambdaProcessor": {
"ResourceARN": "string",
"RoleARN": "string"
}
},
"InputStartingPositionConfiguration": {
"InputStartingPosition": "string"
},
"ResourceARN": "string",
"RoleARN": "string",
"S3Configuration": {
"BucketARN": "string",
"FileKey": "string",
"RoleARN": "string"
}
}
```
## リクエストパラメーター
リクエストは以下のデータを JSON 形式で受け入れます。
** [InputProcessingConfiguration](#API_DiscoverInputSchema_RequestSyntax) **
レコードのスキーマを検出する前に、[InputProcessingConfiguration](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_InputProcessingConfiguration.html) を使用してレコードを前処理します。
型: [InputProcessingConfiguration](API_InputProcessingConfiguration.md) オブジェクト
必須: いいえ
** [InputStartingPositionConfiguration](#API_DiscoverInputSchema_RequestSyntax) **
Amazon Kinesis Analytics で、指定したストリーミングソースから検出の目的でレコードの読み取りを開始するポイント。
型: [InputStartingPositionConfiguration](API_InputStartingPositionConfiguration.md) オブジェクト
必須: いいえ
** [ResourceARN](#API_DiscoverInputSchema_RequestSyntax) **
ストリーミングソースの Amazon リソースネーム (ARN)。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 2,048 です。
パターン: `arn:.*`
必須: いいえ
** [RoleARN](#API_DiscoverInputSchema_RequestSyntax) **
Amazon Kinesis Analytics がユーザーに代わってストリームにアクセスするために引き受けることができる IAM ロールの ARN。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 2,048 です。
パターン: `arn:.*`
必須: いいえ
** [S3Configuration](#API_DiscoverInputSchema_RequestSyntax) **
Amazon S3 オブジェクトのデータからスキーマを検出するには、このパラメータを指定します。
型: [S3Configuration](API_S3Configuration.md) オブジェクト
必須: いいえ
## レスポンスの構文
```
{
"InputSchema": {
"RecordColumns": [
{
"Mapping": "string",
"Name": "string",
"SqlType": "string"
}
],
"RecordEncoding": "string",
"RecordFormat": {
"MappingParameters": {
"CSVMappingParameters": {
"RecordColumnDelimiter": "string",
"RecordRowDelimiter": "string"
},
"JSONMappingParameters": {
"RecordRowPath": "string"
}
},
"RecordFormatType": "string"
}
},
"ParsedInputRecords": [
[ "string" ]
],
"ProcessedInputRecords": [ "string" ],
"RawInputRecords": [ "string" ]
}
```
## レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
** [InputSchema](#API_DiscoverInputSchema_ResponseSyntax) **
ストリーミングソースから推測されたスキーマ。ストリーミングソース内のデータ形式、アプリケーション内ストリームで作成可能な対応カラムに対して各データ要素をマッピングする方法を定義します。
型: [SourceSchema](API_SourceSchema.md) オブジェクト
** [ParsedInputRecords](#API_DiscoverInputSchema_ResponseSyntax) **
要素の配列。各要素はストリームレコード内の行に対応します (ストリームレコードは複数の行を持つことができます)。
型: 文字列の配列の配列
** [ProcessedInputRecords](#API_DiscoverInputSchema_ResponseSyntax) **
`InputProcessingConfiguration` パラメータで指定されたプロセッサによって変更されたストリームデータ。
型: 文字列の配列
** [RawInputRecords](#API_DiscoverInputSchema_ResponseSyntax) **
スキーマを推測するためにサンプリングされた生のストリームデータ。
型: 文字列の配列
## エラー
** InvalidArgumentException **
指定された入力パラメータ値が無効です。
** message **
HTTP ステータスコード: 400
** ResourceProvisionedThroughputExceededException **
Amazon Kinesis Streams ProvisionedThroughputExceededException が原因で、検出においてストリーミングソースからレコードを取得できませんでした。詳細については、Amazon Kinesis Streams API リファレンスの [GetRecords](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_GetRecords.html) を参照してください。
HTTP ステータスコード: 400
** ServiceUnavailableException **
サービスは利用できません。戻ってオペレーションを再試行してください。
HTTP ステータスコード: 500
** UnableToDetectSchemaException **
日付形式が有効ではありません。Amazon Kinesis Analytics は、指定されたストリーミングソースのスキーマを検出できません。
HTTP ステータスコード: 400
** UnsupportedOperationException **
指定されたパラメータがサポートされていないか、指定されたリソースがこのオペレーションに対して有効でないため、リクエストは拒否されました。
HTTP ステータスコード: 400
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/DiscoverInputSchema)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/DiscoverInputSchema)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/DiscoverInputSchema)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/DiscoverInputSchema)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/DiscoverInputSchema)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/DiscoverInputSchema)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/DiscoverInputSchema)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/DiscoverInputSchema)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/DiscoverInputSchema)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/DiscoverInputSchema)
# ListApplications
**注記**
このドキュメントの対象は、SQL アプリケーションのみがサポートされる Amazon Kinesis Data Analytics API のバージョン 1 です。バージョン 2 の API では、SQL および Java アプリケーションがサポートされます。バージョン 2 の詳細については、[Amazon Kinesis Data Analytics API V2 のドキュメント](/kinesisanalytics/latest/apiv2/Welcome.html)を参照してください。
アカウントの Amazon Kinesis Analytics アプリケーションのリストを返します。レスポンスには、アプリケーションごとにアプリケーション名、Amazon リソースネーム (ARN)、ステータスが含まれます。レスポンスで `HasMoreApplications` 値が true として返された場合は、リクエスト本文に `ExclusiveStartApplicationName` を追加し、この値を前のレスポンスからの最後のアプリケーション名に設定すると、別のリクエストを送信できます。
特定のアプリケーションの詳細情報が必要な場合は、[DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) を使用します。
このオペレーションには `kinesisanalytics:ListApplications` アクションを実行するアクセス許可が必要です。
## リクエストの構文
```
{
"ExclusiveStartApplicationName": "string",
"Limit": number
}
```
## リクエストパラメーター
リクエストは以下のデータを JSON 形式で受け入れます。
** [ExclusiveStartApplicationName](#API_ListApplications_RequestSyntax) **
リストを開始するアプリケーションの名前。ページ割りを使用してリストを取得する場合、最初のリクエストでこのパラメータを指定する必要はありません。ただし、後続のリクエストでは、前のレスポンスの最後のアプリケーション名を追加して、アプリケーションの次のページを取得します。
タイプ: 文字列
長さの制限: 最小長は 1 です。最大長は 128 です。
パターン: `[a-zA-Z0-9_.-]+`
必須: いいえ
** [Limit](#API_ListApplications_RequestSyntax) **
リストするアプリケーションの最大数。
タイプ: 整数
有効範囲: 最小値 は 1 です。最大値は 50 です。
必須: いいえ
## レスポンスの構文
```
{
"ApplicationSummaries": [
{
"ApplicationARN": "string",
"ApplicationName": "string",
"ApplicationStatus": "string"
}
],
"HasMoreApplications": boolean
}
```
## レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
** [ApplicationSummaries](#API_ListApplications_ResponseSyntax) **
`ApplicationSummary` オブジェクトのリスト
型: [ApplicationSummary](API_ApplicationSummary.md) オブジェクトの配列
** [HasMoreApplications](#API_ListApplications_ResponseSyntax) **
取得するアプリケーションがさらに存在する場合は true を返します。
タイプ: ブール値
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/ListApplications)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/ListApplications)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/ListApplications)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/ListApplications)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/ListApplications)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/ListApplications)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/ListApplications)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/ListApplications)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/ListApplications)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/ListApplications)
# ListTagsForResource
アプリケーションに割り当てられたキーと値のタグのリストを取得します。詳細については、「[タグ付けの使用](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-tagging.html)」を参照してください。
## リクエストの構文
```
{
"ResourceARN": "string"
}
```
## リクエストパラメーター
リクエストは以下のデータを JSON 形式で受け入れます。
** [ResourceARN](#API_ListTagsForResource_RequestSyntax) **
タグを取得するアプリケーションの ARN。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 2,048 です。
パターン: `arn:.*`
必須: はい
## レスポンスの構文
```
{
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
** [Tags](#API_ListTagsForResource_ResponseSyntax) **
アプリケーションに割り当てられたキーと値のタグ。
型: [Tag](API_Tag.md) オブジェクトの配列
配列メンバー: 最小数は 1 項目です。最大数は 200 項目です。
## エラー
** ConcurrentModificationException **
アプリケーションへの同時変更の結果としてスローされる例外。例えば、2 人の個人が同じアプリケーションを同時に編集しようとしています。
** message **
HTTP ステータスコード: 400
** InvalidArgumentException **
指定された入力パラメータ値が無効です。
** message **
HTTP ステータスコード: 400
** ResourceNotFoundException **
指定されたアプリケーションが見つかりません。
** message **
HTTP ステータスコード: 400
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/ListTagsForResource)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/ListTagsForResource)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/ListTagsForResource)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/ListTagsForResource)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/ListTagsForResource)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/ListTagsForResource)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/ListTagsForResource)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/ListTagsForResource)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/ListTagsForResource)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/ListTagsForResource)
# StartApplication
**注記**
このドキュメントの対象は、SQL アプリケーションのみがサポートされる Amazon Kinesis Data Analytics API のバージョン 1 です。バージョン 2 の API では、SQL および Java アプリケーションがサポートされます。バージョン 2 の詳細については、[Amazon Kinesis Data Analytics API V2 のドキュメント](/kinesisanalytics/latest/apiv2/Welcome.html)を参照してください。
指定された Amazon Kinesis Analytics アプリケーションを起動します。アプリケーションを作成した後、アプリケーションを起動するには、このオペレーションを排他的に呼び出す必要があります。
アプリケーションの起動後、入力データの使用を開始し、処理し、設定された宛先に出力を書き込みます。
アプリケーションを起動するには、アプリケーションのステータスが `READY` でなければなりません。アプリケーションのステータスは、コンソールで取得するか、[DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) オペレーションを使用して取得できます。
アプリケーションを起動した後、[StopApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_StopApplication.html) オペレーションを呼び出して、アプリケーションによる入力の処理を停止できます。
このオペレーションには `kinesisanalytics:StartApplication` アクションを実行するアクセス許可が必要です。
## リクエストの構文
```
{
"ApplicationName": "string",
"InputConfigurations": [
{
"Id": "string",
"InputStartingPositionConfiguration": {
"InputStartingPosition": "string"
}
}
]
}
```
## リクエストパラメーター
リクエストは以下のデータを JSON 形式で受け入れます。
** [ApplicationName](#API_StartApplication_RequestSyntax) **
アプリケーションの名前。
タイプ: 文字列
長さの制限: 最小長は 1 です。最大長は 128 です。
パターン: `[a-zA-Z0-9_.-]+`
必須: はい
** [InputConfigurations](#API_StartApplication_RequestSyntax) **
アプリケーションが使用を開始する特定の入力を ID で識別します。Amazon Kinesis Analytics は、入力に関連付けられたストリーミングソースの読み取りを開始します。Amazon Kinesis Analytics が読み取りを開始するストリーミングソースの場所を指定することもできます。
型: [InputConfiguration](API_InputConfiguration.md) オブジェクトの配列
必須: はい
## レスポンス要素
アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。
## エラー
** InvalidApplicationConfigurationException **
ユーザー指定のアプリケーション設定が無効です。
** message **
test
HTTP ステータスコード: 400
** InvalidArgumentException **
指定された入力パラメータ値が無効です。
** message **
HTTP ステータスコード: 400
** ResourceInUseException **
このオペレーションではアプリケーションを使用できません。
** message **
HTTP ステータスコード: 400
** ResourceNotFoundException **
指定されたアプリケーションが見つかりません。
** message **
HTTP ステータスコード: 400
** UnsupportedOperationException **
指定されたパラメータがサポートされていないか、指定されたリソースがこのオペレーションに対して有効でないため、リクエストは拒否されました。
HTTP ステータスコード: 400
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/StartApplication)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/StartApplication)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/StartApplication)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/StartApplication)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/StartApplication)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/StartApplication)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/StartApplication)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/StartApplication)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/StartApplication)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/StartApplication)
# StopApplication
**注記**
このドキュメントの対象は、SQL アプリケーションのみがサポートされる Amazon Kinesis Data Analytics API のバージョン 1 です。バージョン 2 の API では、SQL および Java アプリケーションがサポートされます。バージョン 2 の詳細については、[Amazon Kinesis Data Analytics API V2 のドキュメント](/kinesisanalytics/latest/apiv2/Welcome.html)を参照してください。
アプリケーションによる入力データの処理を停止します。実行中の状態にある場合にのみ、アプリケーションを停止できます。[DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) オペレーションを使用して、アプリケーション状態を見つけることができます。アプリケーションが停止すると、Amazon Kinesis Analytics は入力からのデータの読み取りを停止し、アプリケーションはデータの処理を停止するため、宛先へ書きこまれる出力はありません。
このオペレーションには `kinesisanalytics:StopApplication` アクションを実行するアクセス許可が必要です。
## リクエストの構文
```
{
"ApplicationName": "string"
}
```
## リクエストパラメーター
リクエストは以下のデータを JSON 形式で受け入れます。
** [ApplicationName](#API_StopApplication_RequestSyntax) **
停止する実行中のアプリケーションの名前。
タイプ: 文字列
長さの制限: 最小長は 1 です。最大長は 128 です。
パターン: `[a-zA-Z0-9_.-]+`
必須: はい
## レスポンス要素
アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。
## エラー
** ResourceInUseException **
このオペレーションではアプリケーションを使用できません。
** message **
HTTP ステータスコード: 400
** ResourceNotFoundException **
指定されたアプリケーションが見つかりません。
** message **
HTTP ステータスコード: 400
** UnsupportedOperationException **
指定されたパラメータがサポートされていないか、指定されたリソースがこのオペレーションに対して有効でないため、リクエストは拒否されました。
HTTP ステータスコード: 400
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/StopApplication)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/StopApplication)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/StopApplication)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/StopApplication)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/StopApplication)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/StopApplication)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/StopApplication)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/StopApplication)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/StopApplication)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/StopApplication)
# TagResource
Kinesis Analytics アプリケーションに 1 つ以上のキーと値のタグを追加します。アプリケーションタグの最大数にはシステムタグが含まれることに注意してください。ユーザー定義のアプリケーションタグの最大数は 50 です。詳細については、「[タグ付けの使用](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-tagging.html)」を参照してください。
## リクエストの構文
```
{
"ResourceARN": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## リクエストパラメーター
リクエストは以下のデータを JSON 形式で受け入れます。
** [ResourceARN](#API_TagResource_RequestSyntax) **
タグを割り当てるアプリケーションの ARN。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 2,048 です。
パターン: `arn:.*`
必須: はい
** [Tags](#API_TagResource_RequestSyntax) **
アプリケーションに割り当てるキー値のタグ。
型: [Tag](API_Tag.md) オブジェクトの配列
配列メンバー: 最小数は 1 項目です。最大数は 200 項目です。
必須: はい
## レスポンス要素
アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。
## エラー
** ConcurrentModificationException **
アプリケーションへの同時変更の結果としてスローされる例外。例えば、2 人の個人が同じアプリケーションを同時に編集しようとしています。
** message **
HTTP ステータスコード: 400
** InvalidArgumentException **
指定された入力パラメータ値が無効です。
** message **
HTTP ステータスコード: 400
** ResourceInUseException **
このオペレーションではアプリケーションを使用できません。
** message **
HTTP ステータスコード: 400
** ResourceNotFoundException **
指定されたアプリケーションが見つかりません。
** message **
HTTP ステータスコード: 400
** TooManyTagsException **
多すぎるタグを使用してアプリケーションが作成されたか、またはアプリケーションに追加されたタグが多すぎます。アプリケーションタグの最大数にはシステムタグが含まれることに注意してください。ユーザー定義のアプリケーションタグの最大数は 50 です。
HTTP ステータスコード: 400
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/TagResource)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/TagResource)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/TagResource)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/TagResource)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/TagResource)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/TagResource)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/TagResource)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/TagResource)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/TagResource)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/TagResource)
# UntagResource
Kinesis Analytics アプリケーションから 1 つ以上のタグを削除します。詳細については、「[タグ付けの使用](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-tagging.html)」を参照してください。
## リクエストの構文
```
{
"ResourceARN": "string",
"TagKeys": [ "string" ]
}
```
## リクエストパラメーター
リクエストは以下のデータを JSON 形式で受け入れます。
** [ResourceARN](#API_UntagResource_RequestSyntax) **
タグを削除する Kinesis Analytics アプリケーションの ARN。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 2,048 です。
パターン: `arn:.*`
必須: はい
** [TagKeys](#API_UntagResource_RequestSyntax) **
指定されたアプリケーションから削除するタグのキーのリスト。
型: 文字列の配列
配列メンバー: 最小数は 1 項目です。最大数は 200 項目です。
長さの制限：最小長 1、最大長は 128 です。
必須: はい
## レスポンス要素
アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。
## エラー
** ConcurrentModificationException **
アプリケーションへの同時変更の結果としてスローされる例外。例えば、2 人の個人が同じアプリケーションを同時に編集しようとしています。
** message **
HTTP ステータスコード: 400
** InvalidArgumentException **
指定された入力パラメータ値が無効です。
** message **
HTTP ステータスコード: 400
** ResourceInUseException **
このオペレーションではアプリケーションを使用できません。
** message **
HTTP ステータスコード: 400
** ResourceNotFoundException **
指定されたアプリケーションが見つかりません。
** message **
HTTP ステータスコード: 400
** TooManyTagsException **
多すぎるタグを使用してアプリケーションが作成されたか、またはアプリケーションに追加されたタグが多すぎます。アプリケーションタグの最大数にはシステムタグが含まれることに注意してください。ユーザー定義のアプリケーションタグの最大数は 50 です。
HTTP ステータスコード: 400
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/UntagResource)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/UntagResource)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/UntagResource)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/UntagResource)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/UntagResource)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/UntagResource)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/UntagResource)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/UntagResource)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/UntagResource)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/UntagResource)
# UpdateApplication
**注記**
このドキュメントの対象は、SQL アプリケーションのみがサポートされる Amazon Kinesis Data Analytics API のバージョン 1 です。バージョン 2 の API では、SQL および Java アプリケーションがサポートされます。バージョン 2 の詳細については、[Amazon Kinesis Data Analytics API V2 のドキュメント](/kinesisanalytics/latest/apiv2/Welcome.html)を参照してください。
既存の Amazon Kinesis Analytics アプリケーションを更新します。この API を使用して、アプリケーションコード、入力設定、および出力設定を更新できます。
Amazon Kinesis Analytics は、アプリケーションが更新されるたびに、`CurrentApplicationVersionId` を更新します。
このオペレーションには `kinesisanalytics:UpdateApplication` アクションに対するアクセス許可が必要です。
## リクエストの構文
```
{
"ApplicationName": "string",
"ApplicationUpdate": {
"ApplicationCodeUpdate": "string",
"CloudWatchLoggingOptionUpdates": [
{
"CloudWatchLoggingOptionId": "string",
"LogStreamARNUpdate": "string",
"RoleARNUpdate": "string"
}
],
"InputUpdates": [
{
"InputId": "string",
"InputParallelismUpdate": {
"CountUpdate": number
},
"InputProcessingConfigurationUpdate": {
"InputLambdaProcessorUpdate": {
"ResourceARNUpdate": "string",
"RoleARNUpdate": "string"
}
},
"InputSchemaUpdate": {
"RecordColumnUpdates": [
{
"Mapping": "string",
"Name": "string",
"SqlType": "string"
}
],
"RecordEncodingUpdate": "string",
"RecordFormatUpdate": {
"MappingParameters": {
"CSVMappingParameters": {
"RecordColumnDelimiter": "string",
"RecordRowDelimiter": "string"
},
"JSONMappingParameters": {
"RecordRowPath": "string"
}
},
"RecordFormatType": "string"
}
},
"KinesisFirehoseInputUpdate": {
"ResourceARNUpdate": "string",
"RoleARNUpdate": "string"
},
"KinesisStreamsInputUpdate": {
"ResourceARNUpdate": "string",
"RoleARNUpdate": "string"
},
"NamePrefixUpdate": "string"
}
],
"OutputUpdates": [
{
"DestinationSchemaUpdate": {
"RecordFormatType": "string"
},
"KinesisFirehoseOutputUpdate": {
"ResourceARNUpdate": "string",
"RoleARNUpdate": "string"
},
"KinesisStreamsOutputUpdate": {
"ResourceARNUpdate": "string",
"RoleARNUpdate": "string"
},
"LambdaOutputUpdate": {
"ResourceARNUpdate": "string",
"RoleARNUpdate": "string"
},
"NameUpdate": "string",
"OutputId": "string"
}
],
"ReferenceDataSourceUpdates": [
{
"ReferenceId": "string",
"ReferenceSchemaUpdate": {
"RecordColumns": [
{
"Mapping": "string",
"Name": "string",
"SqlType": "string"
}
],
"RecordEncoding": "string",
"RecordFormat": {
"MappingParameters": {
"CSVMappingParameters": {
"RecordColumnDelimiter": "string",
"RecordRowDelimiter": "string"
},
"JSONMappingParameters": {
"RecordRowPath": "string"
}
},
"RecordFormatType": "string"
}
},
"S3ReferenceDataSourceUpdate": {
"BucketARNUpdate": "string",
"FileKeyUpdate": "string",
"ReferenceRoleARNUpdate": "string"
},
"TableNameUpdate": "string"
}
]
},
"CurrentApplicationVersionId": number
}
```
## リクエストパラメーター
リクエストは以下のデータを JSON 形式で受け入れます。
** [ApplicationName](#API_UpdateApplication_RequestSyntax) **
更新する Amazon Kinesis Analytics アプリケーションの名前。
タイプ: 文字列
長さの制限: 最小長は 1 です。最大長は 128 です。
パターン: `[a-zA-Z0-9_.-]+`
必須: はい
** [ApplicationUpdate](#API_UpdateApplication_RequestSyntax) **
アプリケーションの更新を記述します。
型: [ApplicationUpdate](API_ApplicationUpdate.md) オブジェクト
必須: はい
** [CurrentApplicationVersionId](#API_UpdateApplication_RequestSyntax) **
現在のアプリケーションバージョン ID。[DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) オペレーションを使用してこの値を取得できます。
タイプ: Long
有効範囲: 最小値は 1 です。最大値は 999999999 です。
必須: はい
## レスポンス要素
アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。
## エラー
** CodeValidationException **
ユーザー指定のアプリケーションコード (クエリ) が無効です。これは単純な構文エラーである可能性があります。
** message **
テスト
HTTP ステータスコード: 400
** ConcurrentModificationException **
アプリケーションへの同時変更の結果としてスローされる例外。例えば、2 人の個人が同じアプリケーションを同時に編集しようとしています。
** message **
HTTP ステータスコード: 400
** InvalidArgumentException **
指定された入力パラメータ値が無効です。
** message **
HTTP ステータスコード: 400
** ResourceInUseException **
このオペレーションではアプリケーションを使用できません。
** message **
HTTP ステータスコード: 400
** ResourceNotFoundException **
指定されたアプリケーションが見つかりません。
** message **
HTTP ステータスコード: 400
** UnsupportedOperationException **
指定されたパラメータがサポートされていないか、指定されたリソースがこのオペレーションに対して有効でないため、リクエストは拒否されました。
HTTP ステータスコード: 400
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/UpdateApplication)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/UpdateApplication)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/UpdateApplication)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/UpdateApplication)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/UpdateApplication)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/UpdateApplication)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/UpdateApplication)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/UpdateApplication)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/UpdateApplication)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/UpdateApplication)