AWS SQL Workbench のアクション、リソース、条件キー

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

リファレンス:

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

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

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

AWS SQL Workbench で定義されるアクション

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

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

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

注記

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

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

アクション	説明	アクセスレベル	リソースタイプ (* 必須)	条件キー	依存アクション
AssociateConnectionWithChart [アクセス許可のみ]	接続をチャートに関連付ける許可を付与	書き込み	chart*
			connection*
AssociateConnectionWithTab [アクセス許可のみ]	接続をタブに関連付ける許可を付与	書き込み	connection*
AssociateNotebookWithTab [アクセス許可のみ]	ノートブックをタブに関連付けるアクセス許可を付与	書き込み	notebook*
AssociateQueryWithTab [アクセス許可のみ]	クエリをタブに関連付ける許可を付与	書き込み	query*
BatchDeleteFolder [アクセス許可のみ]	アカウントでフォルダを削除する許可を付与	書き込み
BatchGetNotebookCell [アクセス許可のみ]	アカウントでノートブックセルの内容を取得するアクセス許可を付与	読み取り	notebook*
CreateAccount [アクセス許可のみ]	SQLWorkbench アカウントを作成する許可を付与	書き込み
CreateChart [アクセス許可のみ]	アカウントで新しい保存済みグラフを作成する許可を付与	書き込み	chart*
				aws:TagKeys aws:RequestTag/${TagKey}
CreateConnection [アクセス許可のみ]	アカウントで新しい接続を作成する許可を付与	書き込み	connection*
				aws:TagKeys aws:RequestTag/${TagKey}
CreateFolder [アクセス許可のみ]	アカウントでフォルダを作成する許可を付与	書き込み
CreateNotebook [アクセス許可のみ]	アカウントで新しいノートブックを作成するアクセス許可を付与	書き込み	notebook*
				aws:TagKeys aws:RequestTag/${TagKey}
CreateNotebookCell [アクセス許可のみ]	アカウントでノートブックセルを作成するアクセス許可を付与	書き込み	notebook*
				aws:TagKeys aws:RequestTag/${TagKey}
CreateNotebookFromVersion [アクセス許可のみ]	アカウントでノートブックバージョンから新しいノートブックを作成するアクセス許可を付与	書き込み	notebook*
				aws:TagKeys aws:RequestTag/${TagKey}
CreateNotebookVersion [アクセス許可のみ]	アカウントでノートブックバージョンを作成するアクセス許可を付与	書き込み	notebook*
				aws:TagKeys aws:RequestTag/${TagKey}
CreateSavedQuery [アクセス許可のみ]	アカウントで新しい保存済みクエリを作成する許可を付与	書き込み	query*
				aws:TagKeys aws:RequestTag/${TagKey}
DeleteChart [アクセス許可のみ]	アカウントでチャートを削除する許可を付与	書き込み	chart*
DeleteConnection [アクセス許可のみ]	アカウントの接続を削除する許可を付与	書き込み	connection*
DeleteNotebook [アクセス許可のみ]	アカウントでノートブックを削除するアクセス許可を付与	書き込み	notebook*
DeleteNotebookCell [アクセス許可のみ]	アカウントでノートブックセルを削除するアクセス許可を付与	書き込み	notebook*
DeleteNotebookVersion [アクセス許可のみ]	アカウントでノートブックセルを削除するアクセス許可を付与	書き込み	notebook*
DeleteSavedQuery [アクセス許可のみ]	アカウントで保存されたクエリを削除する許可を付与	書き込み	query*
DeleteTab [アクセス許可のみ]	アカウントのタブを削除する許可を付与	書き込み
DriverExecute [アクセス許可のみ]	Redshift クラスターでクエリを実行する許可を付与	書き込み	connection*
DuplicateNotebook [アクセス許可のみ]	アカウントで既存のノートブックを複製して新しいノートブックを作成するアクセス許可を付与	書き込み	notebook*
				aws:TagKeys aws:RequestTag/${TagKey}
ExportNotebook [アクセス許可のみ]	アカウントでノートブックをエクスポートするアクセス許可を付与	読み取り	notebook*
GenerateSession [アクセス許可のみ]	アカウントで新しいセッションを生成する許可を付与	書き込み
GetAccountInfo [アクセス許可のみ]	アカウント情報を取得する許可を付与	読み取り
GetAccountSettings [アクセス許可のみ]	アカウント設定を取得する許可を付与	読み取り
GetAutocompletionMetadata [アクセス許可のみ]	オートコンプリート用のデータベース構造のメタデータを取得するための許可を付与します	読み取り
GetAutocompletionResource [アクセス許可のみ]	オートコンプリート用のデータベース構造に関する情報を取得するための許可を付与します	読み取り
GetChart [アクセス許可のみ]	アカウントでチャートを取得する許可を付与	読み取り	chart*
GetConnection [アクセス許可のみ]	アカウントで接続を取得する許可を付与	読み取り	connection*
GetNotebook [アクセス許可のみ]	アカウントでノートブックのメタデータを取得するアクセス許可を付与	読み取り	notebook*
GetNotebookVersion [アクセス許可のみ]	アカウントでノートブックバージョンの内容を取得するアクセス許可を付与	読み取り	notebook*
GetQSqlRecommendations [アクセス許可のみ]	SQL 推奨事項を取得する許可を付与	読み取り
GetQueryExecutionHistory [アクセス許可のみ]	アカウントでクエリ実行履歴を取得する許可を付与	読み取り
GetSavedQuery [アクセス許可のみ]	アカウントで保存されたクエリを取得する許可を付与	読み取り	query*
GetSchemaInference [アクセス許可のみ]	ファイルから推測された列とデータ型を取得するための許可を付与します	読み取り
GetUserInfo [アクセス許可のみ]	ユーザー情報を取得する許可を付与	読み取り
GetUserWorkspaceSettings [アクセス許可のみ]	アカウントでワークスペース設定を取得する許可を付与	読み取り
ImportNotebook [アクセス許可のみ]	アカウントでノートブックをインポートするアクセス許可を付与	書き込み	notebook*
				aws:TagKeys aws:RequestTag/${TagKey}
ListConnections [アクセス許可のみ]	アカウントで接続を一覧表示する許可を付与	リスト
ListDatabases [アクセス許可のみ]	Redshift クラスターのデータベースを一覧表示する許可を付与	リスト
ListFiles [アクセス許可のみ]	ファイルとフォルダを一覧表示する許可を付与	リスト
ListNotebookVersions [アクセス許可のみ]	アカウントでノートブックバージョンのメタデータを取得するアクセス許可を付与	リスト	notebook*
ListNotebooks [アクセス許可のみ]	アカウントでノートブックを一覧表示するアクセス許可を付与	リスト
ListQueryExecutionHistory [アクセス許可のみ]	アカウントでクエリ実行履歴を一覧表示する許可を付与	リスト
ListRedshiftClusters [アクセス許可のみ]	アカウントで Redshift クラスターを一覧表示する許可を付与	リスト
ListSampleDatabases [アクセス許可のみ]	サンプルデータベースを一覧表示する許可を付与	読み取り
ListSavedQueryVersions [アクセス許可のみ]	アカウントで保存されたクエリのバージョンを一覧表示する許可を付与	リスト	query*
ListTabs [アクセス許可のみ]	アカウントのタブを一覧表示する許可を付与	リスト
ListTaggedResources [アクセス許可のみ]	タグ付けされたリソースを一覧表示する許可を付与	読み取り
ListTagsForResource [アクセス許可のみ]	SQLWorkbench リソースのタグを一覧表示する許可を付与	読み取り	chart
			connection
			notebook
			query
PutTab [アクセス許可のみ]	アカウントでタブを作成または更新する許可を付与	書き込み
PutUserWorkspaceSettings [アクセス許可のみ]	アカウントでワークスペース設定を更新する許可を付与	書き込み
RestoreNotebookVersion [アクセス許可のみ]	アカウントでノートブックをあるバージョンに復元するアクセス許可を付与	書き込み	notebook*
				aws:TagKeys aws:RequestTag/${TagKey}
TagResource [アクセス許可のみ]	SQLWorkbench リソースにタグ付けする許可を付与	タグ付け	chart
			connection
			notebook
			query
				aws:TagKeys aws:RequestTag/${TagKey}
UntagResource [アクセス許可のみ]	SQLWorkbench リソースのタグ付けを解除する許可を付与	タグ付け	chart
			connection
			notebook
			query
				aws:TagKeys
UpdateAccountConnectionSettings [アクセス許可のみ]	アカウント全体での接続設定を更新する許可を付与	書き込み
UpdateAccountExportSettings [アクセス許可のみ]	アカウント全体でのエクスポート設定を更新する許可を付与	書き込み
UpdateAccountGeneralSettings [アクセス許可のみ]	アカウント全体の全般設定を更新する許可を付与	書き込み
UpdateAccountQSqlSettings [アクセス許可のみ]	アカウント全体のテキストを SQL 設定に更新する許可を付与	書き込み
UpdateChart [アクセス許可のみ]	アカウントでチャートを更新する許可を付与	書き込み	chart*
				aws:TagKeys aws:RequestTag/${TagKey}
UpdateConnection [アクセス許可のみ]	アカウントで接続を更新する許可を付与	書き込み	connection*
				aws:TagKeys aws:RequestTag/${TagKey}
UpdateFileFolder [アクセス許可のみ]	アカウントでファイルを移動する許可を付与	書き込み	chart
			query
UpdateFolder [アクセス許可のみ]	アカウントでフォルダの名前と詳細を更新する許可を付与	書き込み
UpdateNotebook [アクセス許可のみ]	アカウントでノートブックのメタデータを更新するアクセス許可を付与	書き込み	notebook*
				aws:TagKeys aws:RequestTag/${TagKey}
UpdateNotebookCellContent [アクセス許可のみ]	アカウントでノートブックセルの内容を更新するアクセス許可を付与	書き込み	notebook*
				aws:TagKeys aws:RequestTag/${TagKey}
UpdateNotebookCellLayout [アクセス許可のみ]	アカウントでノートブックセルのレイアウトを更新するアクセス許可を付与	書き込み	notebook*
				aws:TagKeys aws:RequestTag/${TagKey}
UpdateSavedQuery [アクセス許可のみ]	アカウントで保存されたクエリを更新する許可を付与	書き込み	query*
				aws:TagKeys aws:RequestTag/${TagKey}

AWS SQL Workbench で定義されるリソースタイプ

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

リソースタイプ	ARN	条件キー
connection	arn:${Partition}:sqlworkbench:${Region}:${Account}:connection/${ResourceId}	aws:ResourceTag/${TagKey}
query	arn:${Partition}:sqlworkbench:${Region}:${Account}:query/${ResourceId}	aws:ResourceTag/${TagKey}
chart	arn:${Partition}:sqlworkbench:${Region}:${Account}:chart/${ResourceId}	aws:ResourceTag/${TagKey}
notebook	arn:${Partition}:sqlworkbench:${Region}:${Account}:notebook/${ResourceId}	aws:ResourceTag/${TagKey}

AWS SQL Workbench の条件キー

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

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

条件キー	説明	タイプ
aws:RequestTag/${TagKey}	リクエストで渡されたタグでアクセスをフィルタリングします	文字列
aws:ResourceTag/${TagKey}	リソースに関連付けられたタグでアクセスをフィルタリングします	文字列
aws:TagKeys	リクエストで渡されたタグキーでアクセスをフィルタリングします	ArrayOfString