タグ付けの使用 - 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 の中止」を参照してください。

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

タグ付けの使用

このセクションでは、Kinesis Data Analytics アプリケーションに key-value メタデータタグを追加する方法について説明します。これらのタグは以下の目的に使用できます。

  • 個々の Kinesis Data Analytics アプリケーションに対する請求を決定する。詳細については、AWS「Billing and Cost Management ガイド」のコスト配分タグを使用する を参照してください。

  • タグに基づいてアプリケーションリソースへのアクセスをコントロールする。詳細については、 ユーザーガイドタグを使用したアクセス制御を参照してください。

  • ユーザー定義の目的で。ユーザータグに基づいてアプリケーションの機能を定義できます。

タグ付けに関する以下の情報に注意してください。

  • アプリケーションタグの最大数にはシステムタグが含まれます。ユーザー定義のアプリケーションタグの最大数は 50 です。

  • アクションに含まれているタグリストで Key 値が重複している場合、サービスは InvalidArgumentException をスローします。

アプリケーション作成時のタグの追加

タグの追加は、CreateApplication アクションの tags パラメータを使ってアプリケーションを作成する際に行います。

以下のリクエスト例では、CreateApplication リクエストの Tags ノードを示しています。

"Tags": [ { "Key": "Key1", "Value": "Value1" }, { "Key": "Key2", "Value": "Value2" } ]

既存のアプリケーションに対するタグの追加または更新

TagResource アクションを使用して、アプリケーションにタグを追加します。UpdateApplication アクションを使用して、アプリケーションにタグを追加することはできません。

既存のタグを更新するには、既存のタグのものと同じキーを含むタグを追加します。

TagResource アクションの以下のリクエスト例では、新しいタグを追加するか、既存のタグを更新します。

{ "ResourceARN": "string", "Tags": [ { "Key": "NewTagKey", "Value": "NewTagValue" }, { "Key": "ExistingKeyOfTagToUpdate", "Value": "NewValueForExistingTag" } ] }

アプリケーションのタグの一覧表示

既存のタグを一覧表示するには、ListTagsForResource アクションを使用します。

ListTagsForResource アクションの以下のリクエスト例では、アプリケーションのタグを一覧表示します。

{ "ResourceARN": "arn:aws:kinesisanalytics:us-west-2:012345678901:application/MyApplication" }

アプリケーションからのタグの削除

アプリケーションからタグを削除するには、UntagResource アクションを使用します。

UntagResource アクションの以下のリクエスト例では、アプリケーションからタグを削除します。

{ "ResourceARN": "arn:aws:kinesisanalytics:us-west-2:012345678901:application/MyApplication", "TagKeys": [ "KeyOfFirstTagToRemove", "KeyOfSecondTagToRemove" ] }