タグ付けを使用する

このセクションでは、アプリケーションにキーバリューメタデータタグをManaged Service for Apache Flink アプリケーションに追加する方法について説明します。これらのタグは以下の目的に使用できます。

• 個々のApache Flink アプリケーション用 Managed Serviceの課金を決定。詳細については、Billing と Cost Management ユーザーガイドの 「コスト配分タグを使用する」 を参照してください。

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

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

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

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

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

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

タグは、tagsCreateApplicationアプリケーションの作成時にアクションのパラメータを使用して追加します。

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

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

既存のアプリケーションにタグを追加するか、タグを u 個追加します。

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

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

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

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

アプリケーションのタグを一覧表示する。

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

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

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

アプリケーションからタグを削除する。

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

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

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