タグ付けの使用

このセクションでは、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" ]
}