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 オブジェクトの配列を返すアクセス許可を付与	読み込み	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 Enterprise 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 Enterprise GitHub、または Bitbucket リポジトリに保存されている AWS CodeBuild プロジェクトのソースリポジトリ認証情報をインポートする許可を付与	書き込み
InvalidateProjectCache	プロジェクトのキャッシュをリセットするアクセス許可を付与	書き込み	project*
ListBuildBatches	ビルドバッチ ID のリストを取得するアクセス許可を付与ビルドバッチ ID はそれぞれ、1 つのビルドバッチを表します	リスト
ListBuildBatchesForProject	指定されたビルドプロジェクトのビルドバッチ ID のリストを取得するアクセス許可を付与ビルドバッチ ID はそれぞれ、1 つのビルドバッチを表します	リスト	project*
ListBuilds	ビルド ID のリストを取得するアクセス許可を付与ビルド ID はそれぞれ、1 つのビルドを表します	リスト
ListBuildsForProject	指定されたビルドプロジェクトのビルド ID のリストを取得するアクセス許可を付与ビルド ID はそれぞれ、1 つのビルドを表します	リスト	project*
ListConnectedOAuthAccounts [アクセス許可のみ]	接続されたサードパーティーの OAuth プロバイダーを一覧表示するアクセス許可を付与 AWS CodeBuild コンソールでのみ使用	リスト
ListCuratedEnvironmentImages	によって管理される Docker イメージに関する情報を取得する許可を付与 AWS CodeBuild	リスト
ListFleets	コンピューティングフリート ARNsのリストを取得するアクセス許可を付与します。各コンピューティングフリート ARN は 1 つのフリートを表します	リスト
ListProjects	ビルドプロジェクト名のリストを取得するアクセス許可を付与ビルドプロジェクト名はそれぞれ、1 つのビルドプロジェクトを表します	リスト
ListReportGroups	レポートグループ ARN のリストを返すアクセス許可を付与各レポートグループ ARN は 1 つのレポートグループを表します。	リスト
ListReports	レポート ARN のリストを返すアクセス許可を付与各レポート ARN は 1 つのレポートを表します。	リスト
ListReportsForReportGroup	指定したレポートグループに属するレポート ARN のリストを返すアクセス許可を付与各レポート ARN は 1 つのレポートを表します。	リスト	report-group*
ListRepositories [アクセス許可のみ]	接続されているサードパーティーの OAuth プロバイダーのソースコードリポジトリを一覧表示するアクセス許可を付与 AWS CodeBuild コンソールでのみ使用	リスト
ListSharedProjects	リクエスタと共有されているプロジェクト ARN のリストを返すアクセス許可を付与各プロジェクト ARN は 1 つのプロジェクトを表します。	リスト
ListSharedReportGroups	リクエスタと共有されているレポートグループ ARN のリストを返すアクセス許可を付与各レポートグループ ARN は 1 つのレポートグループを表します。	リスト
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