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

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

リファレンス:

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

トピック

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

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

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

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

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

注記

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

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

アクション	説明	アクセスレベル	リソースタイプ (* 必須)	条件キー
BatchDeleteBuilds	1 つまたは複数のテーブルを削除するアクセス許可を付与	書き込み	project*
BatchGetBuildBatches	1 つまたは複数のビルドバッチに関する情報を取得するアクセス許可を付与	読み込み	project*
BatchGetBuilds	1 つまたは複数のビルドの情報を取得するアクセス許可を付与	読み取り	project*
BatchGetFleets	入力パラメータで指定されたフリートオブジェクトの配列を返すアクセス許可を付与します	読み取り	fleet*
BatchGetProjects	1 つまたは複数のビルドプロジェクトに関する情報を取得するアクセス許可を付与	読み取り	project*
BatchGetReportGroups	入力 reportGroupArns パラメータで指定された ReportGroup オブジェクトの配列を返すアクセス許可を付与します	読み取り	report-group*
BatchGetReports	入力 reportArns パラメータで指定されたレポートオブジェクトの配列を返すアクセス許可を付与します	読み取り	report-group*
BatchPutCodeCoverages[アクセス許可のみ]	レポートに関する情報を追加または更新するアクセス許可を付与	書き込み	report-group*
BatchPutTestCases[アクセス許可のみ]	レポートに関する情報を追加または更新するアクセス許可を付与	書き込み	report-group*
CreateFleet	コンピューティングフリートを作成するアクセス許可を付与	書き込み	fleet*
CreateFleet	コンピューティングフリートを作成するアクセス許可を付与	書き込み		aws:RequestTag/${TagKey} aws:TagKeys
CreateProject	ビルドプロジェクトを作成するアクセス許可を付与	書き込み	project*
CreateProject	ビルドプロジェクトを作成するアクセス許可を付与	書き込み		aws:RequestTag/${TagKey} aws:TagKeys
CreateReport[アクセス許可のみ]	レポートを作成するアクセス許可を付与レポートは、レポートグループの buildspec ファイルで指定されたテストがプロジェクトのビルド中に実行されるときに作成されます。	書き込み	report-group*
CreateReportGroup	レポートグループを作成するアクセス許可を付与	書き込み	report-group*
CreateReportGroup	レポートグループを作成するアクセス許可を付与	書き込み		aws:RequestTag/${TagKey} aws:TagKeys
CreateWebhook	ウェブフックを作成するアクセス許可を付与ソースコードが GitHub または Bitbucket リポジトリに保存されている既存の AWS CodeBuild ビルドプロジェクトの場合、 AWS CodeBuild はコード変更がリポジトリにプッシュされるたびにソースコードの再構築を開始します。	書き込み	project*
DeleteBuildBatch	ビルドバッチを削除するアクセス許可を付与	書き込み	project*
DeleteFleet	コンピューティングフリートを削除するアクセス許可を付与	書き込み	fleet*
DeleteOAuthToken[アクセス許可のみ]	接続されたサードパーティーOAuthプロバイダーからOAuthトークンを削除するアクセス許可を付与します。 AWS CodeBuild コンソールでのみ使用	書き込み
DeleteProject	ビルドプロジェクトを削除するアクセス許可を付与	書き込み	project*
DeleteReport	レポートを削除するアクセス許可を付与	書き込み	report-group*
DeleteReportGroup	レポートグループを削除するアクセス許可を付与	書き込み	report-group*
DeleteResourcePolicy	関連付けられたプロジェクトまたはレポートグループのリソースポリシーを削除するアクセス許可を付与	権限の管理	project
DeleteResourcePolicy	関連付けられたプロジェクトまたはレポートグループのリソースポリシーを削除するアクセス許可を付与	権限の管理	report-group
DeleteSourceCredentials	GitHub、 GitHub エンタープライズ、または Bitbucket ソース認証情報のセットを削除するアクセス許可を付与	書き込み
DeleteWebhook	ウェブフックを削除するアクセス許可を付与ソースコードが GitHub または Bitbucket リポジトリに保存されている既存の AWS CodeBuild ビルドプロジェクトの場合、コード変更がリポジトリにプッシュされるたびに、はソースコード AWS CodeBuild の再構築を停止します。	書き込み	project*
DescribeCodeCoverages	CodeCoverage オブジェクトの配列を返すアクセス許可を付与	読み取り	report-group*
DescribeTestCases	TestCase オブジェクトの配列を返すアクセス許可を付与	読み取り	report-group*
GetReportGroupTrend	指定されたレポートグループのテストレポートのテストレポート値を分析し蓄積するアクセス許可を付与	読み込み	report-group*
GetResourcePolicy	指定したプロジェクトもしくはレポートグループのリソースポリシーを返すアクセス許可を付与	読み取り	project
GetResourcePolicy	指定したプロジェクトもしくはレポートグループのリソースポリシーを返すアクセス許可を付与	読み取り	report-group
ImportSourceCredentials	ソースコードが GitHub、 GitHub エンタープライズ、または Bitbucket リポジトリに保存されている AWS CodeBuild プロジェクトのソースリポジトリ認証情報をインポートするアクセス許可を付与	書き込み
InvalidateProjectCache	プロジェクトのキャッシュをリセットするアクセス許可を付与	書き込み	project*
ListBuildBatches	ビルドバッチのリストを取得するアクセス許可を付与IDsします。各ビルドバッチ ID は 1 つのビルドバッチを表します。	リスト
ListBuildBatchesForProject	IDs 指定されたビルドプロジェクトのビルドバッチのリストを取得するアクセス許可を付与します。各ビルドバッチ ID は 1 つのビルドバッチを表します。	リスト	project*
ListBuilds	ビルドのリストを取得するアクセス許可を付与IDsします。各ビルド ID は 1 つのビルドを表します。	リスト
ListBuildsForProject	指定されたビルドプロジェクトのビルドのリストを取得するアクセス許可を付与しますIDs。各ビルド ID は 1 つのビルドを表します。	リスト	project*
ListConnectedOAuthAccounts[アクセス許可のみ]	接続されたサードパーティーOAuthプロバイダーを一覧表示するアクセス許可を付与します。 AWS CodeBuild コンソールでのみ使用	リスト
ListCuratedEnvironmentImages	によって管理される Docker イメージに関する情報を取得するアクセス許可を付与します AWS CodeBuild	リスト
ListFleets	コンピューティングフリートのリストを取得するアクセス許可を付与しARNs、各コンピューティングフリートは単一のフリートARNを表します。	リスト
ListProjects	ビルドプロジェクト名のリストを取得するアクセス許可を付与ビルドプロジェクト名はそれぞれ、1 つのビルドプロジェクトを表します	リスト
ListReportGroups	レポートグループのリストを返すアクセス許可を付与しますARNs。各レポートグループは 1 つのレポートグループARNを表します	リスト
ListReports	レポートのリストを返すアクセス許可を付与しますARNs。1 つのレポートARNを表す各レポート	リスト
ListReportsForReportGroup	指定されたレポートグループに属するレポートのリストを返ARNsすアクセス許可を付与します。各レポートは 1 つのレポートARNを表します。	リスト	report-group*
ListRepositories[アクセス許可のみ]	接続されたサードパーティーOAuthプロバイダーからのソースコードリポジトリを一覧表示するアクセス許可を付与します。 AWS CodeBuild コンソールでのみ使用	リスト
ListSharedProjects	リクエスタと共有されているプロジェクトのリストを返ARNsすアクセス許可を付与します。各プロジェクトは 1 つのプロジェクトARNを表します	リスト
ListSharedReportGroups	リクエスタと共有されているレポートグループのリストを返ARNsすアクセス許可を付与します。各レポートグループは 1 つのレポートグループARNを表します	リスト
ListSourceCredentials	SourceCredentialsInfo オブジェクトのリストを返すアクセス許可を付与	リスト
PersistOAuthToken[アクセス許可のみ]	接続されたサードパーティーOAuthプロバイダーからOAuthトークンを保存するアクセス許可を付与します。 AWS CodeBuild コンソールでのみ使用	書き込み
PutResourcePolicy	関連付けられたプロジェクトまたはレポートグループのリソースポリシーを作成するアクセス許可を付与	権限の管理	project
PutResourcePolicy	関連付けられたプロジェクトまたはレポートグループのリソースポリシーを作成するアクセス許可を付与	権限の管理	report-group
RetryBuild	ビルドを再試行するアクセス許可を付与	書き込み	project*
RetryBuildBatch	ビルドバッチを再試行するアクセス許可を付与	書き込み	project*
StartBuild	ビルドの実行を開始するアクセス許可を付与	書き込み	project*
StartBuildBatch	ビルドバッチの実行を開始するアクセス許可を付与	書き込み	project*
StopBuild	ビルドの実行停止を試みるアクセス許可を付与	書き込み	project*
StopBuildBatch	ビルドバッチの実行停止を試みるアクセス許可を付与	書き込み	project*
UpdateFleet	既存のコンピューティングフリートの設定を変更するアクセス許可を付与します	書き込み	fleet*
UpdateFleet	既存のコンピューティングフリートの設定を変更するアクセス許可を付与します	書き込み		aws:RequestTag/${TagKey} aws:TagKeys
UpdateProject	既存のビルドプロジェクトの設定を変更するアクセス許可を付与	書き込み	project*
UpdateProject	既存のビルドプロジェクトの設定を変更するアクセス許可を付与	書き込み		aws:RequestTag/${TagKey} aws:TagKeys
UpdateProjectVisibility	プロジェクトおよびそのビルドの公開可視性を変更するアクセス許可を付与	書き込み	project*
UpdateProjectVisibility	プロジェクトおよびそのビルドの公開可視性を変更するアクセス許可を付与	書き込み		aws:RequestTag/${TagKey} aws:TagKeys
UpdateReport[アクセス許可のみ]	レポートに関する情報を更新するアクセス許可を付与	書き込み	report-group*
UpdateReportGroup	既存のレポートグループの設定を変更するアクセス許可を付与	書き込み	report-group*
UpdateReportGroup	既存のレポートグループの設定を変更するアクセス許可を付与	書き込み		aws:RequestTag/${TagKey} aws:TagKeys
UpdateWebhook	AWS CodeBuild ビルドプロジェクトに関連付けられたウェブフックを更新するアクセス許可を付与	書き込み	project*

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

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

リソースタイプ	ARN	条件キー
build	`arn:${Partition}:codebuild:${Region}:${Account}:build/${BuildId}`
build-batch	`arn:${Partition}:codebuild:${Region}:${Account}:build-batch/${BuildBatchId}`
project	`arn:${Partition}:codebuild:${Region}:${Account}:project/${ProjectName}`	aws:ResourceTag/${TagKey}
report-group	`arn:${Partition}:codebuild:${Region}:${Account}:report-group/${ReportGroupName}`	aws:ResourceTag/${TagKey}
report	`arn:${Partition}:codebuild:${Region}:${Account}:report/${ReportGroupName}:${ReportId}`
fleet	`arn:${Partition}:codebuild:${Region}:${Account}:fleet/${FleetName}:${FleetId}`

AWS CodeBuild の条件キー

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

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

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

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

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

ドキュメントの表記規則

AWS CodeArtifact

Amazon CodeCatalyst