JSON メソッドの IAM 権限

次の表に、特定のリソースに Cloud Storage の各 JSON メソッドを実行する場合に必要な Identity and Access Management（IAM）権限を示します。IAM 権限は、ロールを作成するためにバンドルされています。ユーザーとグループにロールを付与します。

均一なバケットレベルのアクセスが無効になっているバケットにのみ適用される追加のメソッドについては、ACL メソッドのテーブルをご覧ください。

リソース	メソッド	必要な IAM 権限 ¹
`Buckets`	`delete`	`storage.buckets.delete`
`Buckets`	`get`	`storage.buckets.get` `storage.buckets.getIamPolicy`²
`Buckets`	`getIamPolicy`	`storage.buckets.getIamPolicy`
`Buckets`	`insert`	`storage.buckets.create` `storage.buckets.enableObjectRetention`³
`Buckets`	`list`	`storage.buckets.list` `storage.buckets.getIamPolicy`²
`Buckets`	`listChannels`	`storage.buckets.get`
`Buckets`	`lockRetentionPolicy`	`storage.buckets.update`
`Buckets`	`patch`	`storage.buckets.update` `storage.buckets.getIamPolicy`⁴ `storage.buckets.setIamPolicy`⁵
`Buckets`	`setIamPolicy`	`storage.buckets.setIamPolicy`
`Buckets`	`testIamPermissions`	なし
`Buckets`	`update`	`storage.buckets.update` `storage.buckets.getIamPolicy`⁴ `storage.buckets.setIamPolicy`⁵
`Channels`	`stop`	なし
`Folders`	`get`	`storage.folders.get`
`Folders`	`insert`	`storage.folders.create`
`Folders`	`list`	`storage.folders.list`
`Folders`	`rename`	`storage.folders.rename`（ソースフォルダの場合） `storage.folders.create`（宛先フォルダの場合）
`Folders`	`delete`	`storage.folders.delete`
`ManagedFolders`	`delete`	`storage.managedfolders.delete` `storage.managedfolders.setIamPolicy`¹⁰
`ManagedFolders`	`get`	`storage.managedfolders.get`
`ManagedFolders`	`getIamPolicy`	`storage.managedfolders.getIamPolicy`
`ManagedFolders`	`insert`	`storage.managedfolders.create`
`ManagedFolders`	`list`	`storage.managedfolders.list`
`ManagedFolders`	`update`	`storage.managedfolders.update`
`ManagedFolders`	`setIamPolicy`	`storage.managedfolders.setIamPolicy`
`Notifications`	`delete`	`storage.buckets.update`
`Notifications`	`get`	`storage.buckets.get`
`Notifications`	`insert`	`storage.buckets.update`
`Notifications`	`list`	`storage.buckets.get`
`Objects`	`bulkRestore`	`storage.buckets.restore` `storage.objects.create` `storage.objects.delete`¹¹ `storage.objects.restore` `storage.objects.setIamPolicy`⁶^、12
`Objects`	`compose`	`storage.objects.get` `storage.objects.create` `storage.objects.delete`⁷ `storage.objects.getIamPolicy`²^、6 `storage.objects.setRetention`⁸
`Objects`	`copy`	`storage.objects.get`（転送元バケットの場合） `storage.objects.create`（転送先バケットの場合） `storage.objects.delete`（転送先バケットの場合）⁷ `storage.objects.setRetention`（転送先バケットの場合）⁸
`Objects`	`delete`	`storage.objects.delete`
`Objects`	`get`	`storage.objects.get` `storage.objects.getIamPolicy`²^、6
`Objects`	`insert`	`storage.objects.create` `storage.objects.delete`⁷ `storage.objects.setRetention`⁸
`Objects`	`list`	`storage.objects.list` `storage.objects.getIamPolicy`²^、6
`Objects`	`patch`	`storage.objects.update` `storage.objects.setRetention`⁸ `storage.objects.overrideUnlockedRetention`⁹ `storage.objects.getIamPolicy`⁴^、6 `storage.objects.setIamPolicy`⁵^、6
`Objects`	`restore`	`storage.objects.create` `storage.objects.delete`⁷ `storage.objects.restore` `storage.objects.getIamPolicy`²^、6 `storage.objects.setIamPolicy`⁶^、12
`Objects`	`rewrite`	`storage.objects.get`（転送元バケットの場合） `storage.objects.create`（転送先バケットの場合） `storage.objects.delete`（転送先バケットの場合）⁷ `storage.objects.setRetention`（転送先バケットの場合）⁸
`Objects`	`update`	`storage.objects.update` `storage.objects.setRetention`⁸ `storage.objects.overrideUnlockedRetention`⁹ `storage.objects.getIamPolicy`⁴^、6 `storage.objects.setIamPolicy`⁵^、6
`Objects`	`watchAll`	`storage.buckets.update`
`Projects.hmacKeys`	`create`	`storage.hmacKeys.create`
`Projects.hmacKeys`	`delete`	`storage.hmacKeys.delete`
`Projects.hmacKeys`	`get`	`storage.hmacKeys.get`
`Projects.hmacKeys`	`list`	`storage.hmacKeys.list`
`Projects.hmacKeys`	`update`	`storage.hmacKeys.update`
`Projects.serviceAccount`	`get`	`resourceManager.projects.get`
`ReportConfigs`	`delete`	`storageinsights.reportConfigs.delete`
`ReportConfigs`	`get`	`storageinsights.reportConfigs.get`
`ReportConfigs`	`list`	`storageinsights.reportConfigs.list`
`ReportConfigs`	`insert`	`storageinsights.reportConfigs.create`
`ReportConfigs`	`update`	`storageinsights.reportConfigs.update`
`ReportDetails`	`get`	`storageinsights.reportDetails.get`
`ReportDetails`	`list`	`storageinsights.reportDetails.list`

¹ リクエストで userProject パラメータまたは x-goog-user-project ヘッダーを使用する場合、リクエストに必要な通常の IAM 権限に加えて、指定したプロジェクト ID の serviceusage.services.use 権限が必要です。

² この権限は、full プロジェクションの一部として ACL または IAM ポリシーを含める場合にのみ必要です。この権限がないときに full プロジェクションをリクエストすると、部分プロジェクションのみが表示されます。

³ この権限は、リクエストに enableObjectRetention クエリパラメータが含まれている場合にのみ必要です。

⁴ この権限は、レスポンスの一部として ACL を含める場合にのみ必要です。

⁵ この権限は、ACL または公開アクセスの防止設定の変更をリクエストに含める場合に必要です。

⁶ この権限は、均一なバケットレベルのアクセスが有効になっているバケットには適用されません。

⁷ この権限は、リクエストによって同じ名前のオブジェクトが上書きされる場合にのみ必要です。

⁸ この権限は、リクエスト本文に retention プロパティを含める場合、または既存の保持構成を持つオブジェクトに対して UPDATE リクエストを作成する場合に必要です。

⁹ この権限は、リクエストに overrideUnlockedRetention=true クエリパラメータが含まれている場合にのみ必要です。

¹⁰ この権限は、リクエストに allowNonEmpty=true クエリパラメータが含まれている場合にのみ必要です。

¹¹ この権限は、リクエストに allowOverwrite=true クエリパラメータが含まれ、リクエストによって同じ名前のオブジェクトが上書きされる場合にのみ必要です。

¹² この権限は、リクエストに copySourceAcl=true クエリパラメータが含まれている場合にのみ必要です。

ACL 関連メソッド

次の表に、ACL の管理にのみ適用される JSON メソッドの実行に必要な IAM 権限を示します。これらのメソッドは、均一なバケットレベルのアクセスが無効になっているバケットにのみ適用されます。

リソース	メソッド	必要な IAM 権限 ¹
`BucketAccessControls`	`delete`	`storage.buckets.get` `storage.buckets.getIamPolicy` `storage.buckets.setIamPolicy` `storage.buckets.update`
`BucketAccessControls`	`get`	`storage.buckets.get` `storage.buckets.getIamPolicy`
`BucketAccessControls`	`insert`	`storage.buckets.get` `storage.buckets.getIamPolicy` `storage.buckets.setIamPolicy` `storage.buckets.update`
`BucketAccessControls`	`list`	`storage.buckets.get` `storage.buckets.getIamPolicy`
`BucketAccessControls`	`patch`	`storage.buckets.get` `storage.buckets.getIamPolicy` `storage.buckets.setIamPolicy` `storage.buckets.update`
`BucketAccessControls`	`update`	`storage.buckets.get` `storage.buckets.getIamPolicy` `storage.buckets.setIamPolicy` `storage.buckets.update`
`DefaultObjectAccessControls`	`delete`	`storage.buckets.get` `storage.buckets.getIamPolicy` `storage.buckets.setIamPolicy` `storage.buckets.update`
`DefaultObjectAccessControls`	`get`	`storage.buckets.get` `storage.buckets.getIamPolicy`
`DefaultObjectAccessControls`	`insert`	`storage.buckets.get` `storage.buckets.getIamPolicy` `storage.buckets.setIamPolicy` `storage.buckets.update`
`DefaultObjectAccessControls`	`list`	`storage.buckets.get` `storage.buckets.getIamPolicy`
`DefaultObjectAccessControls`	`patch`	`storage.buckets.get` `storage.buckets.getIamPolicy` `storage.buckets.setIamPolicy` `storage.buckets.update`
`DefaultObjectAccessControls`	`update`	`storage.buckets.get` `storage.buckets.getIamPolicy` `storage.buckets.setIamPolicy` `storage.buckets.update`
`ObjectAccessControls`	`delete`	`storage.objects.get` `storage.objects.getIamPolicy` `storage.objects.setIamPolicy` `storage.objects.update`
`ObjectAccessControls`	`get`	`storage.objects.get` `storage.objects.getIamPolicy`
`ObjectAccessControls`	`insert`	`storage.objects.get` `storage.objects.getIamPolicy` `storage.objects.setIamPolicy` `storage.objects.update`
`ObjectAccessControls`	`list`	`storage.objects.get` `storage.objects.getIamPolicy`
`ObjectAccessControls`	`patch`	`storage.objects.get` `storage.objects.getIamPolicy` `storage.objects.setIamPolicy` `storage.objects.update`
`ObjectAccessControls`	`update`	`storage.objects.get` `storage.objects.getIamPolicy` `storage.objects.setIamPolicy` `storage.objects.update`

次のステップ

Cloud Storage のロールと権限の一覧について、Cloud Storage に適用される IAM ロールを確認する。
プロジェクトレベルとバケットレベルで IAM ロールを割り当てる。