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

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

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 の停止」を参照してください。

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

AddApplicationCloudWatchLoggingOption

注記

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

アプリケーションの構成エラーをモニタリングするために CloudWatch ログストリームを追加します。Amazon Kinesis Analytics アプリケーションで CloudWatch ログストリームを使用する方法の詳細については、「Amazon CloudWatch Logs の使用」を参照してください。

リクエストの構文

{ "ApplicationName": "string", "CloudWatchLoggingOption": { "LogStreamARN": "string", "RoleARN": "string" }, "CurrentApplicationVersionId": number }

リクエストパラメータ

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

ApplicationName

Kinesis Analytics アプリケーション名。

型: 文字列

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

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

必須: はい

CloudWatchLoggingOption

CloudWatch ログストリームの Amazon リソースネーム (ARN) と IAM ロール ARN を提供します。注意: CloudWatch にアプリケーションメッセージを書き込むには、使用する IAM ロールで PutLogEvents ポリシーアクションが有効になっている必要があります。

型: CloudWatchLoggingOption オブジェクト

必須: はい

CurrentApplicationVersionId

Kinesis Analytics アプリケーションのバージョン ID。

型: 長整数

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

必須: はい

レスポンス要素

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

エラー

ConcurrentModificationException

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

HTTP ステータスコード: 400

InvalidArgumentException

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

HTTP ステータスコード: 400

ResourceInUseException

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

HTTP ステータスコード: 400

ResourceNotFoundException

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

HTTP ステータスコード: 400

UnsupportedOperationException

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

HTTP ステータスコード: 400

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

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