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 オブジェクトの配列を返す許可を付与する	読み取り	fleet*
BatchGetProjects	1 つまたは複数のビルドプロジェクトに関する情報を取得するアクセス許可を付与	読み取り	project*
BatchGetReportGroups	input ReportGroup パラメータで指定された reportGroupArns オブジェクトの配列を返すアクセス許可を付与します	読み取り	report-group*
BatchGetReports	input 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	ウェブフックを作成するアクセス許可を付与ソースコードが a AWS CodeBuild または Bitbucket リポジトリに保存されている既存の GitHub ビルドプロジェクトの場合、コード変更がリポジトリにプッシュされるたびに 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 Enterprise、または Bitbucket ソース認証情報のセットを削除するアクセス許可を付与します	書き込み
DeleteWebhook	ウェブフックを削除するアクセス許可を付与ソースコードが a AWS CodeBuild または Bitbucket リポジトリに保存されている既存の GitHub ビルドプロジェクトの場合、コード変更がリポジトリにプッシュされるたびに AWS CodeBuild がソースコードを再構築することを停止します。	書き込み	project*
DescribeCodeCoverages	CodeCoverage オブジェクトの配列を返すアクセス許可を付与します	読み取り	report-group*
DescribeTestCases	TestCase オブジェクトの配列を返すアクセス許可を付与します	読み取り	report-group*
GetReportGroupTrend	指定されたレポートグループのテストレポートのテストレポート値を分析し蓄積するアクセス許可を付与	読み込み	report-group*
GetResourcePolicy	指定したプロジェクトもしくはレポートグループのリソースポリシーを返すアクセス許可を付与	読み取り	project
GetResourcePolicy	指定したプロジェクトもしくはレポートグループのリソースポリシーを返すアクセス許可を付与	読み取り	report-group
ImportSourceCredentials	ソースコードが a AWS CodeBuild 、Word GitHub Enterprise、または Bitbucket リポジトリに保存されている an GitHub プロジェクトのソースリポジトリ認証情報をインポートするアクセス許可を付与します	書き込み
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	AWS CodeBuild によって管理される Docker イメージに関する情報を取得する許可を付与	リスト
ListFleets	コンピューティングフリート ARNs のリストを取得するアクセス許可を付与します。各コンピューティングフリート ARN は 1 つのフリートを表します。	リスト
ListProjects	ビルドプロジェクト名のリストを取得するアクセス許可を付与ビルドプロジェクト名はそれぞれ、1 つのビルドプロジェクトを表します	リスト
ListReportGroups	レポートグループ ARNs のリストを返すアクセス許可を付与します。各レポートグループ ARN は 1 つのレポートグループを表します	リスト
ListReports	レポート ARNs のリストを返すアクセス許可を付与します。1 つのレポートを表す各レポートARN	リスト
ListReportsForReportGroup	指定されたレポートグループに属するレポート ARNs のリストを返すアクセス許可を付与します。各レポートARNは 1 つのレポートを表します。	リスト	report-group*
ListRepositories[アクセス許可のみ]	接続されたサードパーティーの OAuth プロバイダーからのソースコードリポジトリを一覧表示するアクセス許可を付与します。 AWS CodeBuild コンソールでのみ使用されます。	リスト
ListSharedProjects	リクエスタと共有されているプロジェクト ARNs のリストを返すアクセス許可を付与します。各プロジェクトARNは 1 つのプロジェクトを表します	リスト
ListSharedReportGroups	リクエスタと共有されているレポートグループ ARNs のリストを返すアクセス許可を付与します。各レポートグループ 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	an 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