Amazon Kinesis Data Streams のアクション、リソース、および条件キー

Amazon Kinesis Data Streams (サービスプレフィックス: kinesis) では、IAM アクセス許可ポリシーで使用できるように、以下のサービス固有のリソースやアクション、条件コンテキストキーが用意されています。

リファレンス:

• このサービスを設定する方法について説明します。

• このサービスで使用できる API オペレーションのリストを表示します。

• IAM アクセス許可ポリシーを使用して、このサービスとそのリソースを保護する方法について説明します。

Amazon Kinesis Data Streams で定義されるアクション

IAM ポリシーステートメントの Action要素で次のアクションを指定できます。ポリシーを使用して、 AWSでオペレーションを実行するアクセス許可を付与します。ポリシーでアクションを使用する場合、通常、同じ名前の API オペレーションまたは CLI コマンドへのアクセスを許可または拒否します。ただし、場合によっては、1 つのアクションによって複数のオペレーションへのアクセスが制御されます。あるいは、いくつかのオペレーションはいくつかの異なるアクションを必要とします。

[アクション] テーブルの [リソースタイプ] 列は、各アクションがリソースレベルの許可をサポートしているかどうかを示します。この列に値がない場合は、ポリシーステートメントの Resource 要素で、ポリシーが適用されるすべてのリソース (「*」) を指定する必要があります。列にリソースタイプが含まれている場合は、そのアクションを含むステートメントでそのタイプの ARN を指定できます。アクションで 1 つ以上のリソースが必須となっている場合、呼び出し元には、それらのリソースを伴うアクションを使用するための許可が付与されている必要があります。必須リソースは、アスタリスク (*) でテーブルに示されています。IAM ポリシーの Resource要素でリソースアクセスを制限する場合は、必要なリソースタイプごとに ARN またはパターンを含める必要があります。一部のアクションでは、複数のリソースタイプがサポートされています。リソースタイプがオプション (必須として示されていない) の場合、オプションのリソースタイプのいずれかを使用することを選択できます。

[アクション] テーブルの [条件キー] 列には、ポリシーステートメントの Condition 要素で指定できるキーが含まれます。サービスのリソースに関連付けられている条件キーの詳細については、[リソースタイプ] テーブルの [条件キー] 列を参照してください。

注記

リソース条件キーは、リソースタイプテーブルに一覧表示されています。アクションに適用されるリソースタイプへのリンクは、[アクション] テーブルの [リソースタイプ (* 必須)] 列にあります。[リソースタイプ] テーブルのリソースタイプには、[アクション] テーブルのアクションに適用されるリソース条件キーである、[条件キー] 列が含まれています。

以下の表の列の詳細については、「アクションテーブル」を参照してください。

アクション	説明	アクセスレベル	リソースタイプ (* 必須)	条件キー	依存アクション
AddTagsToStream	指定した Amazon Kinesis ストリームのタグを追加または更新する許可を付与します 各ストリームには、最大 10 個のタグを追加できます	タグ付け	stream*	aws:TagKeys aws:RequestTag/${TagKey} aws:ResourceTag/${TagKey}
CreateStream	Amazon Kinesis ストリームを作成する許可を付与します	書き込み	stream*	aws:TagKeys aws:RequestTag/${TagKey} aws:ResourceTag/${TagKey}
DecreaseStreamRetentionPeriod	ストリームの保持期間 (データレコードがストリームに追加されてからアクセス可能な期間) を短縮する許可を付与します	書き込み	stream*	aws:ResourceTag/${TagKey}
DeleteResourcePolicy	指定されたストリームまたはコンシューマーに関連付けられたリソースポリシーを削除するためのアクセス許可を付与	書き込み	consumer*
			stream*	aws:ResourceTag/${TagKey}
DeleteStream	ストリーム、シャード、データを削除する許可を付与します	書き込み	stream*	aws:ResourceTag/${TagKey}
DeregisterStreamConsumer	Kinesis データストリームでストリームコンシューマーの登録解除する許可を付与します	書き込み	consumer*
DescribeLimits	アカウントのシャード制限と使用状況を説明する許可を付与します	読み取り
DescribeStream	指定されたストリームを説明する許可を付与します	読み取り	stream*	aws:ResourceTag/${TagKey}
DescribeStreamConsumer	登録済みストリームコンシューマーの説明を取得する許可を付与します	読み取り	consumer*
DescribeStreamSummary	指定された Kinesis データストリームの概要説明 (シャードリストなし) を提供する許可を付与します	読み取り	stream*	aws:ResourceTag/${TagKey}
DisableEnhancedMonitoring	拡張モニタリングを無効にする許可を付与します	書き込み
EnableEnhancedMonitoring	シャードレベルメトリクスの拡張 Kinesis データストリームモニタリングを有効にする許可を付与します	書き込み
GetRecords	シャードからデータレコードを取得するための許可を付与します	読み取り	stream*	aws:ResourceTag/${TagKey}
GetResourcePolicy	指定されたストリームまたはコンシューマーに関連付けられたリソースポリシーを取得するためのアクセス許可を付与	読み取り	consumer*
			stream*	aws:ResourceTag/${TagKey}
GetShardIterator	シャードイテレーターを取得する許可を付与します シャードイテレーターはリクエスタに返されてから 5 分後に有効期限が切れます	読み取り	stream*	aws:ResourceTag/${TagKey}
IncreaseStreamRetentionPeriod	ストリームの保持期間 (データレコードがストリームに追加されてからアクセス可能な期間) を延長する許可を付与します	書き込み	stream*	aws:ResourceTag/${TagKey}
ListShards	ストリーム内のシャードを一覧表示する許可を付与し、各シャードに関する情報を提供します	リスト	stream*	aws:ResourceTag/${TagKey}
ListStreamConsumers	拡張ファンアウトを使用して Kinesis ストリームからデータを受け取るために登録されたストリームコンシューマーを一覧表示する許可を付与し、各コンシューマーに関する情報を提供します	リスト	stream*	aws:ResourceTag/${TagKey}
ListStreams	ストリームを一覧表示する許可を付与します	リスト
ListTagsForStream	指定済み Amazon Kinesis ストリームのタグを一覧表示する許可を付与します	読み取り	stream*	aws:ResourceTag/${TagKey}
MergeShards	ストリーム内で隣接する 2 つのシャードをマージし、それらを 1 つのシャードに結合して、データの取り込みと転送する場合のストリーム容量を減らす許可を付与します	書き込み	stream*	aws:ResourceTag/${TagKey}
PutRecord	プロデューサーから Amazon Kinesis ストリームに単一のデータレコードを書き込む許可を付与します	書き込み	stream*	aws:ResourceTag/${TagKey}
PutRecords	1 回の呼び出しでプロデューサーから Amazon Kinesis ストリームに複数のデータレコードを書き込むアクセス許可を付与します ( PutRecords リクエストとも呼ばれます）	書き込み	stream*	aws:ResourceTag/${TagKey}
PutResourcePolicy	指定されたストリームまたはコンシューマーにリソースポリシーをアタッチするためのアクセス許可を付与	書き込み	consumer*
			stream*	aws:ResourceTag/${TagKey}
RegisterStreamConsumer	Kinesis データストリームでストリームコンシューマーを登録する許可を付与します	書き込み	stream*	aws:ResourceTag/${TagKey}
RemoveTagsFromStream	指定済み Kinesis データストリームからタグを削除する許可を付与します 削除済みタグは削除され、このオペレーションが正常に完了した後は復元できません	タグ付け	stream*	aws:TagKeys aws:ResourceTag/${TagKey}
SplitShard	データの取り込みと転送する場合のストリーム容量を増やすために、Kinesis データストリームでシャードを 2 つの新しいシャードに分割する許可を付与します	書き込み	stream*	aws:ResourceTag/${TagKey}
StartStreamEncryption	指定されたストリームの an AWS KMS キーを使用してサーバー側の暗号化を有効化または更新するアクセス許可を付与します	書き込み	kmsKey*
			stream*	aws:ResourceTag/${TagKey}
StopStreamEncryption	指定済ストリームに対するサーバー側の暗号化を無効にする許可を付与します	書き込み	kmsKey*
			stream*	aws:ResourceTag/${TagKey}
SubscribeToShard	ファンアウトを拡張した特定のシャードのリスニング許可を付与します	読み取り	consumer*
UpdateShardCount	指定済みストリームのシャード数を指定済みシャード数に更新する許可を付与します	書き込み
UpdateStreamMode	データストリームのキャパシティーモードを更新する許可を付与します	書き込み

Amazon Kinesis Data Streams で定義されるリソースタイプ

次のリソースタイプは、このサービスによって定義され、IAM アクセス許可ポリシーステートメントの Resource要素で使用できます。アクションテーブルの各アクションは、そのアクションで指定できるリソースタイプを示しています。リソースタイプは、ポリシーに含めることができる条件キーを定義することもできます。これらのキーは、[リソースタイプ] テーブルの最後の列に表示されます。以下の表の列の詳細については、「リソースタイプテーブル」を参照してください。

リソースタイプ	ARN	条件キー
stream	arn:${Partition}:kinesis:${Region}:${Account}:stream/${StreamName}	aws:ResourceTag/${TagKey}
consumer	arn:${Partition}:kinesis:${Region}:${Account}:${StreamType}/${StreamName}/consumer/${ConsumerName}:${ConsumerCreationTimpstamp}
kmsKey	arn:${Partition}:kms:${Region}:${Account}:key/${KeyId}

Amazon Kinesis Data Streams の条件キー

Amazon Kinesis Data Streams では、IAM ポリシーの Condition要素で使用できる以下の条件キーを定義します。これらのキーを使用して、ポリシーステートメントが適用される条件をさらに絞り込むことができます。以下の表の列の詳細については、「条件キーテーブル」を参照してください。

すべてのサービスで使用できるグローバル条件キーを確認するには、「使用できるグローバル条件キー」を参照してください。

条件キー	説明	[Type] (タイプ)
aws:RequestTag/${TagKey}	リクエスト内のタグキーと値のペアが存在するかどうかでアクションをフィルタリングします	文字列
aws:ResourceTag/${TagKey}	リソースにアタッチされているタグキーおよび値のペアでアクセスをフィルタリングします	文字列
aws:TagKeys	リクエスト内のタグキーが存在するかどうかでアクセスをフィルタリングします	ArrayOfString