AWS Storage Gateway のアクション、リソースおよび条件キー

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

リファレンス:

このサービスを設定する方法について説明します。
このサービスで使用できる API オペレーションのリストを表示します。
IAM アクセス許可ポリシーを使用して、このサービスとそのリソースを保護する方法について説明します。

トピック

AWS Storage Gateway で定義されるアクション
AWS Storage Gateway で定義されるリソースタイプ
AWS Storage Gateway の条件キー

AWS Storage Gateway で定義されるアクション

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

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

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

注記

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

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

アクション	説明	アクセスレベル	リソースタイプ (* 必須)	条件キー	依存アクション
ActivateGateway	以前ホストにデプロイしたゲートウェイをアクティブ化する許可を付与	書き込み		aws:RequestTag/${TagKey} aws:TagKeys
AddCache	キャッシュされたボリュームゲートウェイのキャッシュとして 1 つまたは複数のゲートウェイローカルディスクを設定する許可を付与	書き込み	gateway*
AddTagsToResource	指定されたリソースに 1 つ以上のタグを追加する権限を付与します	タグ付け	gateway
			share
			tape
			volume
				aws:RequestTag/${TagKey} aws:TagKeys
AddUploadBuffer	指定したゲートウェイのアップロードバッファとして 1 つまたは複数のゲートウェイローカルディスクを設定する許可を付与	書き込み	gateway*
AddWorkingStorage	ゲートウェイの作業ストレージとして 1 つまたは複数のゲートウェイローカルディスクを設定する許可を付与	書き込み	gateway*
AssignTapePool	指定されたターゲットプールにテープを移動する許可を付与	書き込み	tape*
AssignTapePool	指定されたターゲットプールにテープを移動する許可を付与	書き込み	tapepool*
AssociateFileSystem	Amazon FSx ファイルシステムを Amazon FSx ファイルゲートウェイに関連付けるアクセス許可を付与します	書き込み	gateway*		ds:DescribeDirectories ec2:DescribeNetworkInterfaces fsx:DescribeFileSystems iam:CreateServiceLinkedRole logs:CreateLogDelivery logs:GetLogDelivery logs:ListLogDeliveries logs:UpdateLogDelivery
AssociateFileSystem		書き込み		aws:RequestTag/${TagKey} aws:TagKeys
AttachVolume	ボリュームを iSCSI 接続に接続し、指定されたゲートウェイにボリュームをアタッチするアクセス許可を付与します	書き込み	gateway*
AttachVolume	ボリュームを iSCSI 接続に接続し、指定されたゲートウェイにボリュームをアタッチするアクセス許可を付与します	書き込み	volume*
BypassGovernanceRetention	プールのガバナンス保持ロックをバイパスできるようにする許可を付与	書き込み	tapepool*
CancelArchival	アーカイブプロセスの開始後、仮想テープシェルフ (VTS) への仮想テープのアーカイブをキャンセルするアクセス許可を付与します	書き込み	gateway*
CancelArchival		書き込み	tape*
CancelRetrieval	取得プロセスが開始された後、仮想テープシェルフ (VTS) からゲートウェイへの仮想テープの取得をキャンセルするアクセス許可を付与します	書き込み	gateway*
CancelRetrieval		書き込み	tape*
CreateCachediSCSIVolume	指定されたキャッシュゲートウェイでキャッシュボリュームを作成する許可を付与。このオペレーションは、ゲートウェイキャッシュ型ボリュームアーキテクチャでのみサポートされています	書き込み	gateway*
			volume*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateNFSFileShare	既存のファイルゲートウェイで NFS ファイル共有を作成するアクセス許可を付与します	書き込み	gateway*
CreateNFSFileShare	既存のファイルゲートウェイで NFS ファイル共有を作成するアクセス許可を付与します	書き込み		aws:RequestTag/${TagKey} aws:TagKeys
CreateSMBFileShare	既存のファイルゲートウェイで SMB ファイル共有を作成するアクセス許可を付与します	書き込み	gateway*
CreateSMBFileShare	既存のファイルゲートウェイで SMB ファイル共有を作成するアクセス許可を付与します	書き込み		aws:RequestTag/${TagKey} aws:TagKeys
CreateSnapshot	ボリュームのスナップショットを開始する許可を付与	書き込み	volume*
CreateSnapshot	ボリュームのスナップショットを開始する許可を付与	書き込み		aws:RequestTag/${TagKey} aws:TagKeys
CreateSnapshotFromVolumeRecoveryPoint	ボリュームリカバリポイントからゲートウェイのスナップショットを開始する許可を付与	書き込み	volume*
CreateSnapshotFromVolumeRecoveryPoint	ボリュームリカバリポイントからゲートウェイのスナップショットを開始する許可を付与	書き込み		aws:RequestTag/${TagKey} aws:TagKeys
CreateStorediSCSIVolume	指定されたゲートウェイでボリュームを作成する許可を付与	書き込み	gateway*
CreateStorediSCSIVolume	指定されたゲートウェイでボリュームを作成する許可を付与	書き込み		aws:RequestTag/${TagKey} aws:TagKeys
CreateTapePool	テーププールを作成する許可を付与	書き込み		aws:RequestTag/${TagKey} aws:TagKeys
CreateTapeWithBarcode	独自のバーコードを使用して仮想テープを作成する許可を付与	書き込み	gateway*
			tapepool*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateTapes	1 つまたは複数の仮想テープを作成する許可を付与。仮想テープにデータを書き込み、テープをアーカイブします	書き込み	gateway*
			tapepool*
				aws:RequestTag/${TagKey} aws:TagKeys
DeleteAutomaticTapeCreationPolicy	Gateway-VTL に設定された自動テープ作成ポリシーを削除するアクセス許可を付与します	書き込み	gateway*
DeleteBandwidthRateLimit	ゲートウェイの帯域幅レート制限を削除する許可を付与	書き込み	gateway*
DeleteChapCredentials	指定された iCHAP ターゲットとイニシエータペアのチャレンジハンドシェイク認証プロトコル (SCSI) 認証情報を削除するアクセス許可を付与します	書き込み	target*
DeleteFileShare	ファイルゲートウェイからファイル共有を削除する許可を付与	書き込み	share*
DeleteGateway	ゲートウェイを削除する許可を付与	書き込み	gateway*
DeleteSnapshotSchedule	ボリュームのスナップショットを削除する許可を付与	書き込み	volume*
DeleteTape	指定された仮想テープを削除する許可を付与	書き込み	gateway*
DeleteTape	指定された仮想テープを削除する許可を付与	書き込み	tape*
DeleteTapeArchive	仮想テープシェルフ (VTS) から指定された仮想テープを削除するアクセス許可を付与します	書き込み
DeleteTapePool	指定されたテーププールを削除する許可を付与	書き込み	tapepool*
DeleteVolume	CreateCachediまたは Word SCSIVolume CreateStorediSCSIVolume を使用して以前に作成した指定されたゲートウェイボリュームを削除するアクセス許可を付与します API	書き込み	volume*
DescribeAvailabilityMonitorTest	ゲートウェイで実行された最新の高可用性モニタリングテストに関する情報を取得する許可を付与	読み込み	gateway*
DescribeBandwidthRateLimit	ゲートウェイの帯域幅レート制限を取得する許可を付与	読み込み	gateway*
DescribeBandwidthRateLimitSchedule	ゲートウェイの帯域幅レート制限スケジュールを取得する許可を付与	読み込み	gateway*
DescribeCache	ゲートウェイのキャッシュに関する情報を取得する許可を付与。このオペレーションは、ゲートウェイキャッシュ型ボリュームアーキテクチャでのみサポートされています	読み込み	gateway*
DescribeCachediSCSIVolumes	リクエストで指定されたゲートウェイボリュームの説明を取得する許可を付与。このオペレーションは、ゲートウェイキャッシュ型ボリュームアーキテクチャでのみサポートされています	読み取り	volume*
DescribeChapCredentials	指定された iSCSI ターゲットのチャレンジハンドシェイク認証プロトコル (CHAP) 認証情報の配列を、ターゲットとイニシエーターのペアごとに 1 つずつ取得するアクセス許可を付与します	読み取り	target*
DescribeFileSystemAssociations	1 つまたは複数のファイルシステムの関連付けの説明を取得するためのアクセス許可を付与します。	読み込み	fs-association*
DescribeGatewayInformation	名前、ネットワークインターフェイス、設定したタイムゾーン、および状態 (ゲートウェイが実行中かどうか) など、ゲートウェイに関するメタデータを取得する許可を付与	読み込み	gateway*
DescribeMaintenanceStartTime	曜日と時刻を含むゲートウェイの週次メンテナンス開始時刻を確定する許可を付与	読み込み	gateway*
DescribeNFSFileShares	ファイルゲートウェイから 1 つまたは複数のファイル共有の説明を取得するためのアクセス許可を付与する	読み込み	share*
DescribeSMBFileShares	ファイルゲートウェイから 1 つまたは複数のファイル共有の説明を取得するためのアクセス許可を付与する	読み取り	share*
DescribeSMBSettings	ファイルゲートウェイからサーバーメッセージブロック (SMB) ファイル共有設定の説明を取得する許可を付与	読み取り	gateway*
DescribeSnapshotSchedule	指定されたゲートウェイボリュームのスナップショットスケジュールを説明する許可を付与	読み込み	volume*
DescribeStorediSCSIVolumes	リクエストで指定されたゲートウェイボリュームの説明を取得する許可を付与	読み取り	volume*
DescribeTapeArchives	仮想テープシェルフ (VTS) 内の指定された仮想テープの説明を取得するアクセス許可を付与します	読み取り
DescribeTapeRecoveryPoints	指定された Gateway-VTL で使用可能な仮想テープ復旧ポイントのリストを取得するアクセス許可を付与します	読み取り	gateway*
DescribeTapes	仮想テープの指定された Amazon リソースネーム (ARN) の説明を取得する許可を付与	読み取り	gateway*
DescribeUploadBuffer	ゲートウェイのアップロードバッファに関する情報を取得する許可を付与	読み取り	gateway*
DescribeVTLDevices	指定されたゲートウェイの仮想テープライブラリ (VTL) デバイスの説明を取得するアクセス許可を付与します	読み取り	gateway*
DescribeWorkingStorage	ゲートウェイの作業ストレージに関する情報を取得する許可を付与	読み取り	gateway*
DetachVolume	iSCSI 接続からボリュームを切断し、指定したゲートウェイからボリュームをデタッチするアクセス許可を付与します	書き込み	volume*
DisableGateway	ゲートウェイが機能しなくなったときにゲートウェイを無効にする許可を付与	書き込み	gateway*
DisassociateFileSystem	Amazon FSx ファイルゲートウェイから Amazon FSx ファイルシステムの関連付けを解除するアクセス許可を付与します	書き込み	fs-association*
JoinDomain	Active Directory ドメインに参加できるようにする許可を付与	書き込み	gateway*
ListAutomaticTapeCreationPolicies	指定された Gateway-VTL またはが所有するすべての Gateway-VTLs に設定されている自動テープ作成ポリシーを一覧表示するアクセス許可を付与します AWS アカウント	リスト
ListFileShares	特定のファイルゲートウェイのファイル共有のリスト、またはが所有するファイル共有のリストを取得する許可を付与 AWS アカウント	リスト
ListFileSystemAssociations	指定されたゲートウェイのファイルシステムの関連付け一覧を取得するためのアクセス許可を付与します。	リスト
ListGateways	リクエストで指定されたリージョン AWS アカウントのが所有するゲートウェイを一覧表示するアクセス許可を付与します。返されるリストは、ゲートウェイ Amazon リソースネーム (ARN) によって順序付けられます。	リスト
ListLocalDisks	ゲートウェイのローカルディスクのリストを取得する許可を付与	リスト	gateway*
ListTagsForResource	指定されたリソースに追加されたタグを取得する許可を付与	リスト	gateway
			share
			tape
			volume
ListTapePools	が所有するテーププールを一覧表示する許可を付与 AWS アカウント	リスト
ListTapes	仮想テープライブラリ (VTL) と仮想テープシェルフ (VTS) 内の仮想テープを一覧表示するアクセス許可を付与します	リスト
ListVolumeInitiators	ボリュームに接続されている iSCSI イニシエータを一覧表示する許可を付与	リスト	volume*
ListVolumeRecoveryPoints	指定したゲートウェイのリカバリポイントを一覧表示する許可を付与	リスト	gateway*
ListVolumes	ゲートウェイの iSCSI ストアドボリュームを一覧表示する許可を付与	リスト
NotifyWhenUploaded	CloudWatch ファイル共有に書き込まれたすべてのファイルが Amazon S3 にアップロードされたときに、NFS Events を通じて通知を送信するアクセス許可を付与します	書き込み	share*
RefreshCache	指定したファイル共有のキャッシュを更新する許可を付与	書き込み	share*
RemoveTagsFromResource	指定されたリソースから 1 つ以上のタグを削除する権限を付与します	タグ付け	gateway
			share
			tape
			volume
				aws:TagKeys
ResetCache	エラーが発生したすべてのキャッシュディスクをリセットするアクセス許可を付与し、ディスクをキャッシュストレージとして再設定できるようにする	書き込み	gateway*
RetrieveTapeArchive	アーカイブされた仮想テープを仮想テープシェルフ (VTS) から Gateway-VTL に取得するアクセス許可を付与します	書き込み	gateway*
RetrieveTapeArchive		書き込み	tape*
RetrieveTapeRecoveryPoint	指定した仮想テープのリカバリポイントを取得する許可を付与	書き込み	gateway*
RetrieveTapeRecoveryPoint	指定した仮想テープのリカバリポイントを取得する許可を付与	書き込み	tape*
SetLocalConsolePassword	VM ローカルコンソールのパスワードを設定する許可を付与	書き込み	gateway*
SetSMBGuestPassword	SMB ゲストユーザーのパスワードを設定するアクセス許可を付与します	書き込み	gateway*
ShutdownGateway	ゲートウェイをシャットダウンする許可を付与	書き込み	gateway*
StartAvailabilityMonitorTest	指定されたゲートウェイがホスト環境で高可用性モニタリング用に構成されていることを確認するテストを開始する許可を付与	書き込み	gateway*
StartGateway	以前にシャットダウンしたゲートウェイを起動する許可を付与	書き込み	gateway*
UpdateAutomaticTapeCreationPolicy	Gateway-VTL に設定されている自動テープ作成ポリシーを更新するアクセス許可を付与します	書き込み	gateway*
UpdateAutomaticTapeCreationPolicy	Gateway-VTL に設定されている自動テープ作成ポリシーを更新するアクセス許可を付与します	書き込み	tapepool*
UpdateBandwidthRateLimit	ゲートウェイの帯域幅レート制限を更新する許可を付与	書き込み	gateway*
UpdateBandwidthRateLimitSchedule	ゲートウェイの帯域幅レート制限スケジュールを更新する許可を付与	書き込み	gateway*
UpdateChapCredentials	指定された iSCSI ターゲットのチャレンジハンドシェイク認証プロトコル (CHAP) 認証情報を更新するアクセス許可を付与します	書き込み	target*
UpdateFileSystemAssociation	ファイルシステムの関連付けを更新する許可を付与。	書き込み	fs-association*		logs:CreateLogDelivery logs:DeleteLogDelivery logs:GetLogDelivery logs:ListLogDeliveries logs:UpdateLogDelivery
UpdateGatewayInformation	ゲートウェイの名前とタイムゾーンを含む、ゲートウェイのメタデータを更新する許可を付与	書き込み	gateway*
UpdateGatewaySoftwareNow	ゲートウェイ仮想マシン (VM) ソフトウェアを更新する許可を付与	書き込み	gateway*
UpdateMaintenanceStartTime	曜日と時刻を含むゲートウェイの週次メンテナンス開始時刻情報を更新する許可を付与。メンテナンス時間は、ゲートウェイのタイムゾーンの時間です	書き込み	gateway*
UpdateNFSFileShare	NFS ファイル共有を更新する許可を付与	書き込み	share*
UpdateSMBFileShare	SMB ファイル共有を更新する許可を付与	書き込み	share*
UpdateSMBFileShareVisibility	ゲートウェイ上の共有がネットビューまたは参照リストに表示されるかどうかを更新する許可を付与	書き込み	gateway*
UpdateSMBLocalGroups	ゲートウェイ上の SMB ファイル共有に対する特別なアクセス許可を持つ Active Directory ユーザーおよびグループのリストを更新するアクセス許可を付与します	書き込み	gateway*
UpdateSMBSecurityStrategy	ファイルゲートウェイで SMB セキュリティ戦略を更新する許可を付与	書き込み	gateway*
UpdateSnapshotSchedule	ゲートウェイボリューム用に構成されたスナップショットスケジュールを更新する許可を付与	書き込み	volume*
UpdateSnapshotSchedule	ゲートウェイボリューム用に構成されたスナップショットスケジュールを更新する許可を付与	書き込み		aws:RequestTag/${TagKey} aws:TagKeys
UpdateVTLDeviceType	Gateway-VTL でメディアチェンジャーのタイプを更新するアクセス許可を付与します	書き込み	device*

AWS Storage Gateway で定義されるリソースタイプ

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

リソースタイプ	ARN	条件キー
device	`arn:${Partition}:storagegateway:${Region}:${Account}:gateway/${GatewayId}/device/${Vtldevice}`
fs-association	`arn:${Partition}:storagegateway:${Region}:${Account}:fs-association/${FsaId}`	aws:ResourceTag/${TagKey}
gateway	`arn:${Partition}:storagegateway:${Region}:${Account}:gateway/${GatewayId}`	aws:ResourceTag/${TagKey}
share	`arn:${Partition}:storagegateway:${Region}:${Account}:share/${ShareId}`	aws:ResourceTag/${TagKey}
tape	`arn:${Partition}:storagegateway:${Region}:${Account}:tape/${TapeBarcode}`	aws:ResourceTag/${TagKey}
tapepool	`arn:${Partition}:storagegateway:${Region}:${Account}:tapepool/${PoolId}`	aws:ResourceTag/${TagKey}
target	`arn:${Partition}:storagegateway:${Region}:${Account}:gateway/${GatewayId}/target/${IscsiTarget}`
volume	`arn:${Partition}:storagegateway:${Region}:${Account}:gateway/${GatewayId}/volume/${VolumeId}`	aws:ResourceTag/${TagKey}

AWS Storage Gateway の条件キー

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

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

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

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

AWS Step Functions

AWS サプライチェーン