Amazon DynamoDB のアクション、リソース、および条件キー
Amazon DynamoDB (サービスプレフィックス: dynamodb) では、IAM アクセス許可ポリシーで使用できるように、以下のサービス固有のオペレーション、リソース、アクション、および条件キーが用意されています。
リファレンス:
-
このサービスを設定する方法について説明します。
-
このサービスで使用可能な API オペレーションのリストを表示します。
-
IAM アクセス許可ポリシーを使用して、このサービスとそのリソースを保護する方法を学びます。
-
このサービスのプログラムによるサービス認可リファレンス
を表示します。
トピック
Amazon DynamoDB で定義される API オペレーション
次の表は、API オペレーションを認可する IAM アクションにマッピングします。指定された API とアクションの静的値を持つ条件キーのみが一覧表示されます。各アクションでサポートされている条件キーの完全なセットについては、「アクション」表を参照してください。
| 運用 | SDK クライアント | IAM アクション | 条件キー | 指定できる値 (複数可) | アクセスレベル |
|---|---|---|---|---|---|
|
BatchExecuteStatement |
dynamodb |
書き込み |
|||
書き込み |
|||||
読み取り |
|||||
書き込み |
|||||
|
BatchGetItem |
dynamodb |
読み取り |
|||
|
BatchWriteItem |
dynamodb |
書き込み |
|||
|
CreateBackup |
dynamodb |
書き込み |
|||
|
CreateGlobalTable |
dynamodb |
書き込み |
|||
|
CreateTable |
dynamodb |
書き込み |
|||
書き込み |
|||||
書き込み |
|||||
書き込み |
|||||
書き込み |
|||||
読み取り |
|||||
書き込み |
|||||
アクセス許可管理、書き込み |
|||||
読み取り |
|||||
読み取り |
|||||
タグ付け、書き込み |
|||||
書き込み |
|||||
|
DeleteBackup |
dynamodb |
書き込み |
|||
|
DeleteItem |
dynamodb |
書き込み |
|||
書き込み |
|||||
|
DeleteResourcePolicy |
dynamodb |
アクセス許可管理、書き込み |
|||
|
DeleteTable |
dynamodb |
書き込み |
|||
|
DescribeBackup |
dynamodb |
読み取り |
|||
|
DescribeContinuousBackups |
dynamodb |
読み取り |
|||
|
DescribeContributorInsights |
dynamodb |
読み取り |
|||
|
DescribeEndpoints |
dynamodb |
読み取り |
|||
|
DescribeExport |
dynamodb |
読み取り |
|||
|
DescribeGlobalTable |
dynamodb |
読み取り |
|||
|
DescribeGlobalTableSettings |
dynamodb |
読み取り |
|||
|
DescribeImport |
dynamodb |
読み取り |
|||
|
DescribeKinesisStreamingDestination |
dynamodb |
読み取り |
|||
|
DescribeLimits |
dynamodb |
読み取り |
|||
|
DescribeTable |
dynamodb |
読み取り |
|||
読み取り |
|||||
書き込み |
|||||
|
DescribeTableReplicaAutoScaling |
dynamodb |
読み取り |
|||
|
DescribeTimeToLive |
dynamodb |
読み取り |
|||
読み取り |
|||||
|
DisableKinesisStreamingDestination |
dynamodb |
書き込み |
|||
|
EnableKinesisStreamingDestination |
dynamodb |
書き込み |
|||
|
ExecuteStatement |
dynamodb |
書き込み |
|||
書き込み |
|||||
読み取り |
|||||
書き込み |
|||||
|
ExecuteTransaction |
dynamodb |
書き込み |
|||
書き込み |
|||||
読み取り |
|||||
書き込み |
|||||
|
ExportTableToPointInTime |
dynamodb |
書き込み |
|||
|
GetItem |
dynamodb |
読み取り |
|||
読み取り |
|||||
|
GetResourcePolicy |
dynamodb |
読み取り |
|||
|
ImportTable |
dynamodb |
書き込み |
|||
|
ListBackups |
dynamodb |
リスト |
|||
|
ListContributorInsights |
dynamodb |
リスト |
|||
|
ListExports |
dynamodb |
リスト |
|||
|
ListGlobalTables |
dynamodb |
リスト |
|||
|
ListImports |
dynamodb |
リスト |
|||
|
ListTables |
dynamodb |
リスト |
|||
|
ListTagsOfResource |
dynamodb |
読み取り |
|||
|
PutItem |
dynamodb |
書き込み |
|||
書き込み |
|||||
|
PutResourcePolicy |
dynamodb |
アクセス許可管理、書き込み |
|||
|
クエリ |
dynamodb |
読み取り |
|||
|
RestoreTableFromBackup |
dynamodb |
書き込み |
|||
書き込み |
|||||
読み取り |
|||||
書き込み |
|||||
読み取り |
|||||
書き込み |
|||||
読み取り |
|||||
書き込み |
|||||
|
RestoreTableToPointInTime |
dynamodb |
書き込み |
|||
書き込み |
|||||
書き込み |
|||||
書き込み |
|||||
読み取り |
|||||
書き込み |
|||||
読み取り |
|||||
読み取り |
|||||
書き込み |
|||||
|
スキャン |
dynamodb |
読み取り |
|||
|
TagResource |
dynamodb |
タグ付け、書き込み |
|||
|
TransactGetItems |
dynamodb |
読み取り |
|||
|
TransactWriteItems |
dynamodb |
読み取り |
|||
書き込み |
|||||
書き込み |
|||||
書き込み |
|||||
|
UntagResource |
dynamodb |
タグ付け、書き込み |
|||
|
UpdateContinuousBackups |
dynamodb |
書き込み |
|||
|
UpdateContributorInsights |
dynamodb |
書き込み |
|||
|
UpdateGlobalTable |
dynamodb |
書き込み |
|||
|
UpdateGlobalTableSettings |
dynamodb |
書き込み |
|||
|
UpdateItem |
dynamodb |
書き込み |
|||
|
UpdateKinesisStreamingDestination |
dynamodb |
書き込み |
|||
|
UpdateTable |
dynamodb |
書き込み |
|||
書き込み |
|||||
書き込み |
|||||
書き込み |
|||||
書き込み |
|||||
書き込み |
|||||
読み取り |
|||||
書き込み |
|||||
読み取り |
|||||
書き込み |
|||||
読み取り |
|||||
タグ付け、書き込み |
|||||
書き込み |
|||||
書き込み |
|||||
書き込み |
|||||
|
UpdateTableReplicaAutoScaling |
dynamodb |
書き込み |
|||
|
UpdateTimeToLive |
dynamodb |
書き込み |
|||
書き込み |
|||||
書き込み |
|||||
|
DescribeStream |
dynamodbstreams |
読み取り |
|||
読み取り |
|||||
|
GetRecords |
dynamodbstreams |
読み取り |
|||
読み取り |
|||||
|
GetShardIterator |
dynamodbstreams |
読み取り |
|||
読み取り |
|||||
|
ListStreams |
dynamodbstreams |
読み取り |
Amazon DynamoDB で定義されるアクション
IAM ポリシーステートメントの Action エレメントでは、以下のアクションを指定できます。ポリシーを使用して、 AWSでオペレーションを実行するアクセス許可を付与します。ポリシーでアクションを使用する場合は、通常、同じ名前の API オペレーションまたは CLI コマンドへのアクセスを許可または拒否します。ただし、場合によっては、1 つのアクションによって複数のオペレーションへのアクセスが制御されます。あるいは、いくつかのオペレーションはいくつかの異なるアクションを必要とします。
| アクション | 説明 | リソースタイプ (* 必須) | 条件キー | アクセスレベル |
|---|---|---|---|---|
1 つ以上の表から 1 つ以上の項目の属性を返す許可を付与します。 |
読み取り |
|||
1 つ以上の表を配置もしくは削除する許可を付与します。 |
書き込み |
|||
ConditionCheckItem オペレーションにより、指定されたプライマリキーを持つ項目で一連の属性が存在するかどうかがチェックする許可を付与します。 |
読み取り |
|||
既存の表のバックアップを作成するためのアクセス許可を付与します。 |
書き込み |
|||
既存の表からグローバル表を作成するアクセス許可を付与します。 |
書き込み |
|||
CreateTable オペレーションで新しい表をアカウントに追加しする許可を付与します。 |
書き込み |
|||
表の既存のバックアップを削除するアクセス許可を付与します。 |
書き込み |
|||
プライマリキーを使用して表から 1 つの項目を削除する権限を付与します。 |
書き込み |
|||
リソースに添付されたリソースベースのポリシーを削除する許可を付与する |
アクセス許可管理、書き込み |
|||
DeleteTable オペレーションで表およびその項目をすべて削除する許可を付与します。 |
書き込み |
|||
表の既存のバックアップを記述するアクセス許可を付与します。 |
読み取り |
|||
指定された表のバックアップの復元設定のステータスを確認する許可を付与します。 |
読み取り |
|||
特定の表およびグローバルセカンダリインデックスの寄稿者インサイトステータスを記述する許可を付与します。 |
読み取り |
|||
リージョンレベルのエンドポイントに関する情報を返すための許可を付与します |
読み取り |
|||
表の既存のエクスポートを記述するアクセス許可を付与します。 |
読み取り |
|||
指定したグローバル表に関する情報を返すアクセス許可を付与します。 |
読み取り |
|||
指定されたグローバル表に関する設定情報を返すアクセス許可を付与します。 |
読み取り |
|||
既存のインポートを記述する許可を付与 |
読み取り |
|||
所与の表の Kinesis ストリーミングのステータスおよび関連する詳細を記述する権限を付与します。 |
読み取り |
|||
リージョン全体とそこで作成した任意の DynamoDB テーブルの両方について、リージョン AWS アカウント 内の の現在のプロビジョニングされた容量制限を返すアクセス許可を付与します |
読み取り |
|||
ストリームに関する情報 (例: ストリームの最新ステータス、Amazon リソースネーム (ARN)、シャードの構成、対応する DynamoDB テーブル) を返す許可を付与します。 |
読み取り |
|||
表に関する情報を返すアクセス許可を付与します。 |
読み取り |
|||
グローバル表のすべてのレプリカにおける Auto Scaling 設定を記述する許可を付与します。 |
読み取り |
|||
指定された表の 有効期限 (TTL) ステータスの説明をする許可を付与します。 |
読み取り |
|||
DynamoDB テーブルから Kinesis データストリームへのレプリケーションを停止する権限を付与します。 |
書き込み |
|||
イネーブルワークフローで選択されたタイムスタンプに従い、指定された Kinesis データストリームへの表データレプリケーションを開始する権限を付与します。 |
書き込み |
|||
DynamoDB 表の S3 へのエクスポートを開始するアクセス許可を付与します。 |
書き込み |
|||
指定されたプライマリキーを持つ項目の属性のセットを返しますGetlemオペレーションへのアクセス許可を付与します。 |
読み取り |
|||
特定のシャード内からストリームレコードを取得する許可を付与します。 |
読み取り |
|||
リソースのリソースベースのポリシーを表示する許可を付与する |
読み取り |
|||
シャードイテレータを返すアクセス許可を付与します。 |
読み取り |
|||
S3 から DynamoDB 表へのインポートを開始する許可を付与 |
書き込み |
|||
アカウントおよびエンドポイントに関連付けられているバックアップを一覧表示するアクセス許可を付与します。 |
リスト |
|||
現在のアカウントとエンドポイントに関連付けられているすべての表およびグローバルセカンダリインデックスの ContributorInsightsSummary を一覧表示する許可を付与します。 |
リスト |
|||
アカウントおよびエンドポイントに関連付けられているエクスポートを一覧表示するアクセス許可を付与します。 |
リスト |
|||
指定されたリージョンにレプリカを持つすべてのグローバル表を一覧表示する許可を付与します。 |
リスト |
|||
アカウントおよびエンドポイントに関連付けられているインポートを一覧表示する許可を付与 |
リスト |
|||
現在のアカウントおよびエンドポイントに関連付けられたストリーム ARN の配列を返す許可を付与します。 |
読み取り |
|||
現在のアカウントおよびエンドポイントに関連付けられた表の名前の配列を返す許可を付与します。 |
リスト |
|||
Amazon DynamoDB リソースのすべてのタグを一覧表示する許可を付与します。 |
読み取り |
|||
プライマリキーを使用してテーブルから 1 つの項目を削除する権限を付与します。 |
書き込み |
|||
同じプライマリキーを持つ項目がテーブルに存在しない場合に新しい項目を作成する権限を付与します。 |
書き込み |
|||
テーブルまたはインデックスから項目の属性セットを読み取る権限を付与します |
読み取り |
|||
既存の項目の属性を編集する権限を付与します。 |
書き込み |
|||
新しい項目を作成するか、古い項目を新しい項目に置き換える許可を付与します。 |
書き込み |
|||
リソースにリソースベースのポリシーをアタッチする許可を付与する |
アクセス許可管理、書き込み |
|||
表のプライマリキーもしくはセカンダリインデックスを使用してその表もしくはインデックスの項目に直接アクセスする許可を付与します。 |
読み取り |
|||
既存のバックアップから新しい 表を作成するアクセス権限を付与します。 |
書き込み |
|||
表を任意の時点に復元する許可を付与します。 |
書き込み |
|||
表もしくはセカンダリインデックスの各項目にアクセスして、1 つ以上の項目または項目属性を返す許可を付与します。 |
読み取り |
|||
Amazon DynamoDB テーブルに関連付けられたベクトルインデックスに対してベクトル類似度検索を実行するアクセス許可を付与します |
読み取り |
|||
タグのセットを Amazon DynamoDB リソースに関連付ける許可を付与します。 |
タグ付け、書き込み |
|||
Amazon DynamoDB リソースからタグの関連付けを削除する許可を付与します。 |
タグ付け、書き込み |
|||
連続バックアップを有効または無効にするアクセス許可を付与します。 |
書き込み |
|||
特定のテーブルもしくはグローバルセカンダリインデックスの寄稿者インサイトのステータスを更新します。 |
書き込み |
|||
指定したグローバル表にユーザーがレプリカを追加または削除するアクセス許可を付与します。 |
書き込み |
|||
指定されたグローバル表内の設定を更新する権限を付与します。 |
書き込み |
|||
既存項目の属性を編集、もしくは存在しない場合は新しい項目を表に追加する許可を付与します。 |
書き込み |
|||
指定された Kinesis データストリームのデータレプリケーション設定を更新する許可を付与する |
書き込み |
|||
特定の表のプロビジョンドスループット設定、グローバルセカンダリインデックス、もしくは DynamoDB Streams 設定を変更する許可を付与します。 |
書き込み |
|||
レプリカ表の Auto Scaling 設定を更新する許可を付与します。 |
書き込み |
|||
指定された表の TTL を有効または無効にするアクセス許可を付与します |
書き込み |
Amazon DynamoDB のアクセス許可のみのアクション
以下のアクションは Amazon DynamoDB によって定義されますが、API オペレーションを通じて直接呼び出すことはできません。アクセス許可を付与または拒否するには、IAM ポリシーステートメントでのみ使用できます。
| アクション | 説明 | リソースタイプ (* 必須) | 条件キー | アクセスレベル |
|---|---|---|---|---|
マルチアカウントグローバルテーブルレプリカを作成する許可を付与 |
書き込み |
|||
グローバルテーブルに証人を追加するアクセス許可を付与 |
書き込み |
|||
新しいレプリカ表を追加するアクセス許可を付与します。 |
書き込み |
|||
グローバルテーブルから証人を削除するアクセス許可を付与 |
書き込み |
|||
レプリカ表およびその項目をすべて削除するアクセス許可を付与します。 |
書き込み |
|||
1 つ以上の購入されたリザーブドキャパシティーを記述する許可を付与します。 |
読み取り |
|||
購入可能なリザーブドキャパシティーの提供内容を記述する許可を付与します。 |
読み取り |
|||
アカウントの属性ベースのアクセスコントロールのステータスを表示するアクセス許可を付与 |
読み取り |
|||
グローバルテーブルで実験を開始する許可を付与 |
書き込み |
|||
アカウントで使用するリザーブドキャパシティーを購入する許可を付与します。 |
書き込み |
|||
マルチアカウントグローバルテーブルレプリカからデータを読み取る許可を付与 |
読み取り |
|||
マルチアカウントグローバルテーブルレプリカの設定を構成するアクセス許可を付与します |
書き込み |
|||
AWS Backup の復旧ポイントから新しいテーブルを作成するアクセス許可を付与します |
書き込み |
|||
高度な機能を有効にしたバックアップで AWS バックアップを作成するアクセス許可を付与します |
書き込み |
|||
アカウントの属性ベースのアクセスコントロールのステータスを更新するアクセス許可を付与 |
アクセス許可管理、書き込み |
|||
指定されたグローバルテーブル内のバージョンを更新するための許可を付与します |
書き込み |
|||
マルチアカウントグローバルテーブルレプリカにデータを書き込む許可を付与 |
書き込み |
Amazon DynamoDB で定義されるリソースタイプ
以下のリソースタイプは、このサービスによって定義され、IAM アクセス許可ポリシーステートメントの Resource エレメントで使用できます。
| リソースタイプ: | ARN | 条件キー |
|---|---|---|
arn:${Partition}:dynamodb:${Region}:${Account}:table/${TableName}/backup/${BackupName} |
||
arn:${Partition}:dynamodb:${Region}:${Account}:table/${TableName}/export/${ExportName} |
||
arn:${Partition}:dynamodb::${Account}:global-table/${GlobalTableName} |
||
arn:${Partition}:dynamodb:${Region}:${Account}:table/${TableName}/import/${ImportName} |
||
arn:${Partition}:dynamodb:${Region}:${Account}:table/${TableName}/index/${IndexName} |
||
arn:${Partition}:dynamodb:${Region}:${Account}:table/${TableName}/stream/${StreamLabel} |
||
arn:${Partition}:dynamodb:${Region}:${Account}:table/${TableName} |
Amazon DynamoDB の条件キー
Amazon DynamoDB では、IAM ポリシーの Condition 要素で使用できる以下の条件キーを定義します。
| 条件キー | 説明 | タイプ |
|---|---|---|
リクエストで渡されたタグでアクセスをフィルタリングします |
String |
|
リソースに関連付けられたタグでアクセスをフィルタリングします |
String |
|
リクエストで渡されたタグキーでアクセスをフィルタリングします |
ArrayOfString |
|
テーブルの属性 (フィールドまたは列) の名前でフィルタリングします |
ArrayOfString |
|
トランザクション API の呼び出しをブロックしてアクセスをフィルタリングし、非トランザクション API の呼び出しを許可します。その逆も可能です |
String |
|
テーブルの最初のパーティションキーでアクセスをフィルタリングします |
ArrayOfString |
|
FIS アクションの ID AWS でアクセスをフィルタリングします |
String |
|
FIS ターゲットの ARN AWS でアクセスをフィルタリングします |
ArrayOfARN |
|
テーブルの 4 番目のパーティションキーでアクセスをフィルタリングします |
ArrayOfString |
|
テーブルのフルスキャンをブロックしてアクセスをフィルタリングします |
Bool |
|
テーブルの最初のパーティションキーでアクセスをフィルタリングします |
ArrayOfString |
|
リクエストの ReturnConsumedCapacity パラメータでアクセスをフィルタリングします。「TOTAL」もしくは「NONE」を含みます。 |
String |
|
リクエストの ReturnValues パラメータでアクセスをフィルタリングします。次のいずれかを含みます: 「ALL_OLD」、「UPDATED_OLD」、「ALL_NEW」、「UPDATED_NEW」もしくは「NONE」 |
String |
|
テーブルの 2 番目のパーティションキーでアクセスをフィルタリングします |
ArrayOfString |
|
クエリまたはスキャンリクエストの Select パラメータでアクセスをフィルタリングします |
String |
|
テーブルの 3 番目のパーティションキーでアクセスをフィルタリングします |
ArrayOfString |