AWS CodeBuild のアクション、リソース、および条件キー - サービス認証リファレンス

「翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。」

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

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

参照:

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

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

[リソースタイプ] 列は、各アクションがリソースレベルのアクセス許可をサポートしているかどうかを示します。この列に値がない場合は、ポリシーステートメントの Resource 要素ですべてのリソース (「*」) を指定する必要があります。列にリソースタイプが含まれる場合、そのアクションを含むステートメントでそのタイプの ARN を指定できます。必須リソースは、アスタリスク (*) でテーブルに示されています。このアクションを使用してステートメントでリソースレベルのアクセス許可 ARN を指定する場合、このタイプである必要があります。一部のアクションでは、複数のリソースタイプがサポートされています。リソースタイプがオプション (必須として示されていない) の場合、一方を使用することはできますが、他方を使用することはできません。

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

アクション 説明 アクセスレベル リソースタイプ (* 必須) 条件キー 依存アクション
BatchDeleteBuilds 1 つ以上のビルドを削除します。 書き込み

project*

BatchGetBuildBatches 1 つ以上のビルドバッチに関する情報を取得します。 Read

project*

BatchGetBuilds 1 つ以上のビルドに関する情報を取得します。 Read

project*

BatchGetProjects 1 つ以上のビルドプロジェクトに関する情報を取得します。 Read

project*

BatchGetReportGroups 入力 reportGroupArns パラメータによって指定されている ReportGroup オブジェクトの配列を返します。 Read

report-group*

BatchGetReports 入力 reportArns パラメータによって指定されている Report オブジェクトの配列を返します。 Read

report-group*

BatchPutCodeCoverages [アクセス許可のみ] レポートに関する情報を追加または更新します。 書き込み

report-group*

BatchPutTestCases [アクセス許可のみ] レポートに関する情報を追加または更新します。 書き込み

report-group*

CreateProject ビルドプロジェクトを作成します。 書き込み

project*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateReport [アクセス許可のみ] レポートを作成します。レポートは、レポートグループの buildspec ファイルで指定されたテストがプロジェクトのビルド中に実行されるときに作成されます。 書き込み

report-group*

CreateReportGroup レポートグループを作成します。 書き込み

report-group*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateWebhook ソースコードが GitHub または Bitbucket リポジトリに保存されている既存の AWS CodeBuild ビルドプロジェクトに対して、コード変更がリポジトリにプッシュされるたびに AWS CodeBuild がソースコードの再構築を開始できるようにします。 書き込み

project*

DeleteBuildBatch ビルドバッチを削除します。 書き込み

project*

DeleteOAuthToken [アクセス許可のみ] 接続されたサードパーティーの OAuth プロバイダーから OAuth トークンを削除します。AWS CodeBuild コンソールでのみ使用されます。 書き込み
DeleteProject ビルドプロジェクトを削除します。 書き込み

project*

DeleteReport レポートを削除します。 書き込み

report-group*

DeleteReportGroup レポートグループを削除します。 書き込み

report-group*

DeleteResourcePolicy 関連付けられたプロジェクトまたはレポートグループのリソースポリシーを削除します。 アクセス権限の管理

project

report-group

DeleteSourceCredentials GitHub、GitHub Enterprise、または Bitbucket のソース認証情報のセットを削除します。 書き込み
DeleteWebhook ソースコードが GitHub または Bitbucket リポジトリに保存されている既存の AWS CodeBuild ビルドプロジェクトに対して、コード変更がリポジトリにプッシュされるたびに AWS CodeBuild がソースコードを再構築するのを停止します。 書き込み

project*

DescribeCodeCoverages CodeCoverage オブジェクトの配列を返します。 Read

report-group*

DescribeTestCases TestCase オブジェクトの配列を返します。 Read

report-group*

GetResourcePolicy 指定したプロジェクトまたはレポートグループのリソースポリシーを返します。 Read

project

report-group

ImportSourceCredentials ソースコードが GitHub、GitHub Enterprise、または 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 AWS CodeBuild によって管理される Docker イメージに関する情報を取得します。 リスト
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

report-group

RetryBuild ビルドを再試行します。 書き込み

project*

RetryBuildBatch ビルドバッチを再試行します。 書き込み

project*

StartBuild ビルドの実行を開始します。 書き込み

project*

StartBuildBatch ビルドバッチの実行を開始します。 書き込み

project*

StopBuild ビルドの実行停止を試みます。 書き込み

project*

StopBuildBatch ビルドバッチの実行停止を試みます。 書き込み

project*

UpdateProject 既存のビルドプロジェクトの設定を変更します。 書き込み

project*

aws:RequestTag/${TagKey}

aws:TagKeys

UpdateReport [アクセス許可のみ] レポートに関する情報を更新します。 書き込み

report-group*

UpdateReportGroup 既存のレポートグループの設定を変更します。 書き込み

report-group*

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}

AWS CodeBuild の条件キー

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

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

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