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

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

リファレンス:

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

トピック

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

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

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

Actions テーブルのアクセスレベル列は、アクションの分類方法 (List、Read、Permissions Management、Tagging) を示しています。このように分類することで、ポリシーで使用する際にアクションで付与するアクセスレベルを理解しやすくなります。アクセスレベルの詳細については、ポリシー概要の「アクセスレベル」を参照してください。

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

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

Actions テーブルの Dependent actions 列には、アクションを正常に呼び出すために必要な追加のアクセス許可が表示されます。これらのアクセス許可は、アクション自体のアクセス許可に加えて必要になる場合があります。アクションが依存アクションを指定すると、それらの依存関係は、テーブルにリストされている最初のリソースだけでなく、そのアクションに定義された追加のリソースに適用される場合があります。

注記

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

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

アクション	説明	アクセスレベル	リソースタイプ (* 必須)	条件キー
AssociateApprovalRuleTemplateWithRepository	承認ルールテンプレートをリポジトリに関連付けるアクセス許可を付与	Write	repository*
BatchAssociateApprovalRuleTemplateWithRepositories	1 回のオペレーションで複数のリポジトリに承認ルールテンプレートを関連付けるアクセス許可を付与	Write	repository*
BatchDescribeMergeConflicts	3 方向マージオプションまたはスカッシュマージオプションを使用して 2 つのコミットをマージしようとしたときに、複数のマージ競合に関する情報を取得する許可を付与。	Read	repository*
BatchDisassociateApprovalRuleTemplateFromRepositories	1 回のオペレーションで承認ルールテンプレートと複数のリポジトリ間の関連付けを削除する許可を付与	書き込み	repository*
BatchGetCommits	AWS CodeCommit リポジトリ内の 1 つ以上のコミットに関する情報を返すアクセス許可を付与します	読み取り	repository*
BatchGetPullRequests [許可のみ]	AWS CodeCommit リポジトリ内の 1 つ以上のプルリクエストに関する情報を返すアクセス許可を付与します	読み取り	repository*
BatchGetRepositories	複数のリポジトリに関する情報を取得する許可を付与。	Read	repository*
CancelUploadArchive [許可のみ]	AWS CodePipeline のパイプラインへのアーカイブのアップロードをキャンセルするアクセス許可を付与します	読み取り	repository*
CreateApprovalRuleTemplate	承認ルールテンプレートを作成する許可を付与。このテンプレートで定義された条件と一致するプル要求で承認ルールを自動的に作成します。個々のプルリクエストの承認ルールを作成するアクセス許可は付与されません	書き込み
CreateBranch	この API を使用して AWS CodeCommit リポジトリにブランチを作成するアクセス許可を付与します。Git ブランチ作成アクションは制御しません。	書き込み	repository*
CreateBranch		書き込み		codecommit:References
CreateCommit	AWS CodeCommit リポジトリのブランチ内の単一または複数のファイルを追加、コピー、移動、または更新し、指定されたブランチの変更のコミットを生成するアクセス許可を付与します	書き込み	repository*
CreateCommit		書き込み		codecommit:References
CreatePullRequest	指定されたリポジトリにプルリクエストを作成する許可を付与。	Write	repository*
CreatePullRequestApprovalRule	個々のプルリクエストに固有の承認ルールを作成する許可を付与。承認ルールテンプレートを作成するアクセス許可は付与しません。	書き込み	repository*
CreateRepository	AWS CodeCommit リポジトリを作成するアクセス許可を付与します	書き込み	repository*
CreateRepository	AWS CodeCommit リポジトリを作成するアクセス許可を付与します	書き込み		aws:RequestTag/${TagKey} aws:TagKeys
CreateUnreferencedMergeCommit	3 方向またはスカッシュマージオプションを使用して 2 つのコミットをマージした結果を含む、参照されていないコミットを作成する (ただし Git マージアクションは管理しない) アクセス許可を付与	Write	repository*
CreateUnreferencedMergeCommit		Write		codecommit:References
DeleteApprovalRuleTemplate	承認ルールテンプレートを削除する許可を付与	書き込み
DeleteBranch	この API を使用して AWS CodeCommit リポジトリ内のブランチを削除するアクセス許可を付与します。Git ブランチ削除アクションは制御しません。	書き込み	repository*
DeleteBranch		書き込み		codecommit:References
DeleteCommentContent	リポジトリ内の変更、ファイル、またはコミットに対するコメントの内容を削除する許可を付与。	Write	repository*
DeleteFile	指定されたブランチから指定されたファイルを削除する許可を付与。	Write	repository*
DeleteFile	指定されたブランチから指定されたファイルを削除する許可を付与。	Write		codecommit:References
DeletePullRequestApprovalRule	ルールが承認ルールテンプレートによって作成されなかった場合に、プルリクエストに対して作成された承認ルールを削除する許可を付与	書き込み	repository*
DeleteRepository	AWS CodeCommit リポジトリを削除するアクセス許可を付与します	書き込み	repository*
DescribeMergeConflicts	3 方向またはスカッシュマージオプションを使用して 2 つのコミットをマージしようとしたときに、特定のマージ競合に関する情報を取得する許可を付与。	Read	repository*
DescribePullRequestEvents	1 つ以上のプルリクエストイベントに関する情報を返すアクセス許可を付与	Read	repository*
DisassociateApprovalRuleTemplateFromRepository	承認規則テンプレートとリポジトリ間の関連付けを削除する許可を付与	Write	repository*
EvaluatePullRequestApprovalRules	現在の承認状態と承認ルールの要件に基づいて、プルリクエストがマージ可能かどうかを評価する許可を付与	Read	repository*
GetApprovalRuleTemplate	承認ルールテンプレートに関する情報を返すアクセス許可を付与	読み取り
GetBlob	AWS CodeCommit AWS CodeCommit コンソールから CodeCommit リポジトリ内の個々のファイルのエンコードされたコンテンツを表示するアクセス許可を付与します	読み取り	repository*
GetBranch	この API を使用して AWS CodeCommit リポジトリ内のブランチに関する詳細を取得するアクセス許可を付与します。Git ブランチアクションは制御しません。	読み取り	repository*
GetComment	リポジトリ内の変更、ファイル、またはコミットに対するコメントの内容を取得する許可を付与。	Read	repository*
GetCommentReactions	コメントに対する反応を取得する許可を付与	Read	repository*
GetCommentsForComparedCommit	2 つのコミットの比較についてのコメントに関する情報を取得する許可を付与。	Read	repository*
GetCommentsForPullRequest	プルリクエストについてのコメントを取得する許可を付与。	Read	repository*
GetCommit	この API を使用して、コミットメッセージやコミット情報など、コミットに関する情報を返す (ただし Git のログアクションは管理しない) アクセス許可を付与	Read	repository*
GetCommitHistory [許可のみ]	リポジトリでのコミットの履歴に関する情報を取得する許可を付与。	Read	repository*
GetCommitsFromMergeBase [許可のみ]	潜在的なマージのコンテキストにおけるコミット間の違いに関する情報を取得する許可を付与。	Read	repository*
GetDifferences	有効なコミット指定子 (ブランチ、タグ、HEAD、コミット ID、または他の完全修飾参照) 間の違いに関する情報を表示する許可を付与。	Read	repository*
GetFile	指定されたファイルとそのメタデータの base-64 エンコードコンテンツを返すアクセス許可を付与	Read	repository*
GetFolder	リポジトリ内の指定されたフォルダの内容を返すアクセス許可を付与	Read	repository*
GetMergeCommit	マージコミットを作成するプルリクエストのいずれかのマージオプションによって作成されたマージコミットに関する情報を取得する許可を付与。すべてのマージオプションがマージコミットを作成するわけではありません。このアクセス許可では、Git マージアクションを管理できません。	Read	repository*
GetMergeCommit		Read		codecommit:References
GetMergeConflicts	リポジトリ内のプルリクエストについて、前後のコミット ID 間のマージ競合に関する情報を返すアクセス許可を付与	Read	repository*
GetMergeOptions	2 つのコミットをマージするために使用できるプルリクエストのマージオプションに関する情報を取得する (ただし Git マージアクションは管理しない) アクセス許可を付与	Read	repository*
GetObjectIdentifier [許可のみ]	BLOB、ツリー、コミットをそれらの識別子に解決する許可を付与。	Read	repository*
GetPullRequest	指定されたリポジトリ内のプルリクエストに関する情報を取得する許可を付与。	Read	repository*
GetPullRequestApprovalStates	入力されたプルリクエストに対する現在の承認を取得する許可を付与	Read	repository*
GetPullRequestOverrideState	指定されたプルリクエストの現在のオーバーライド状態を取得する許可を付与	Read	repository*
GetReferences [許可のみ]	AWS CodeCommit リポジトリ内のリファレンスに関する詳細を取得するアクセス許可を付与します。Git リファレンスアクションは制御しません。	読み取り	repository*
GetRepository	AWS CodeCommit リポジトリに関する情報を取得するアクセス許可を付与します	読み取り	repository*
GetRepositoryTriggers	リポジトリのために設定されたトリガーに関する情報を取得する許可を付与。	Read	repository*
GetTree [許可のみ]	AWS CodeCommit コンソールから、CodeCommit AWS CodeCommit リポジトリ内の指定されたツリーの内容を表示するアクセス許可を付与します	読み取り	repository*
GetUploadArchiveStatus [許可のみ]	AWS CodePipeline のパイプラインへのアーカイブアップロードに関するステータス情報を取得する許可を付与	読み取り	repository*
GitPull [許可のみ]	AWS CodeCommit リポジトリからローカルリポジトリに情報をプルするアクセス許可を付与します	読み取り	repository*
GitPush [許可のみ]	ローカルリポジトリから AWS CodeCommit リポジトリに情報をプッシュするアクセス許可を付与します	書き込み	repository*
GitPush [許可のみ]	ローカルリポジトリから AWS CodeCommit リポジトリに情報をプッシュするアクセス許可を付与します	書き込み		codecommit:References
ListApprovalRuleTemplates	AWS リージョンの内のすべての承認ルールテンプレートを一覧表示するアクセス許可を付与します AWS アカウント	リスト
ListAssociatedApprovalRuleTemplatesForRepository	リポジトリに関連付けられた承認規則テンプレートを一覧表示する許可を付与	リスト	repository*
ListBranches	この API を使用して、 AWS CodeCommit リポジトリのブランチを一覧表示するアクセス許可を付与します。Git ブランチアクションは制御しません。	リスト	repository*
ListFileCommitHistory	指定されたファイルへのコミットと変更を一覧表示するアクセス許可を付与します	リスト	repository*
ListPullRequests	指定されたリポジトリのプルリクエストを一覧表示する許可を付与。	リスト	repository*
ListRepositories	の現在のリージョンの AWS CodeCommit リポジトリに関する情報を一覧表示するアクセス許可を付与します AWS アカウント	リスト
ListRepositoriesForApprovalRuleTemplate	承認ルールテンプレートに関連付けられているリポジトリを一覧表示する許可を付与	リスト
ListTagsForResource	CodeCommit リソースの ARN にアタッチされているリソースを一覧表示する許可を付与。	リスト	repository
MergeBranchesByFastForward	早送りマージオプションを使用して 2 つのコミットを指定された送信先ブランチにマージする許可を付与。	Write	repository*
MergeBranchesByFastForward	早送りマージオプションを使用して 2 つのコミットを指定された送信先ブランチにマージする許可を付与。	Write		codecommit:References
MergeBranchesBySquash	スカッシュマージオプションを使用して 2 つのコミットを指定された送信先ブランチにマージする許可を付与。	Write	repository*
MergeBranchesBySquash	スカッシュマージオプションを使用して 2 つのコミットを指定された送信先ブランチにマージする許可を付与。	Write		codecommit:References
MergeBranchesByThreeWay	3 方向マージオプションを使用して 2 つのコミットを指定された送信先ブランチにマージする許可を付与。	Write	repository*
MergeBranchesByThreeWay	3 方向マージオプションを使用して 2 つのコミットを指定された送信先ブランチにマージする許可を付与。	Write		codecommit:References
MergePullRequestByFastForward	プルリクエストを閉じ、早送りマージオプションを使用して、指定されたコミットでそのプルリクエスト用に指定された送信先ブランチにマージするよう試みるアクセス許可を付与	Write	repository*
MergePullRequestByFastForward		Write		codecommit:References
MergePullRequestBySquash	プルリクエストを閉じ、スカッシュマージオプションを使用して、指定されたコミットでそのプルリクエスト用に指定された送信先ブランチにマージするよう試みるアクセス許可を付与	Write	repository*
MergePullRequestBySquash		Write		codecommit:References
MergePullRequestByThreeWay	プルリクエストを閉じ、3 方向マージオプションを使用して、指定されたコミットでそのプルリクエスト用に指定された送信先ブランチにマージするよう試みるアクセス許可を付与	Write	repository*
MergePullRequestByThreeWay		Write		codecommit:References
OverridePullRequestApprovalRules	テンプレートによって作成された承認ルールを含む、プル要求のすべての承認ルールを上書きする許可を付与	Write	repository*
PostCommentForComparedCommit	2 つのコミットの比較に対するコメントを投稿する許可を付与。	Write	repository*
PostCommentForPullRequest	プルリクエストについてのコメントを投稿する許可を付与。	Write	repository*
PostCommentReply	コミット間の比較またはプルリクエストに対するコメントに返答する形でコメントを投稿する許可を付与。	Write	repository*
PutCommentReaction	コメントに反応を投稿する許可を付与	書き込み	repository*
PutFile	AWS CodeCommit リポジトリのブランチでファイルを追加または更新し、指定されたブランチに追加するためのコミットを生成するアクセス許可を付与します	書き込み	repository*
PutFile		書き込み		codecommit:References
PutRepositoryTriggers	リポジトリのトリガーを作成、更新、または削除する許可を付与。	Write	repository*
TagResource	CodeCommit リソースの ARN にリソースタグをアタッチする許可を付与。	Tagging	repository
TagResource	CodeCommit リソースの ARN にリソースタグをアタッチする許可を付与。	Tagging		aws:ResourceTag/${TagKey} aws:RequestTag/${TagKey} aws:TagKeys
TestRepositoryTriggers	トリガーターゲットに情報を送信することで、リポジトリトリガーの機能をテストする許可を付与。	Write	repository*
UntagResource	CodeCommit リソースの ARN からリソースタグの関連付けを解除する許可を付与。	Tagging	repository
UntagResource	CodeCommit リソースの ARN からリソースタグの関連付けを解除する許可を付与。	Tagging		aws:TagKeys aws:ResourceTag/${TagKey}
UpdateApprovalRuleTemplateContent	承認ルールテンプレートのコンテンツを更新する許可を付与。プル要求用に特別に作成された承認ルールのコンテンツを更新するアクセス許可は付与しません	Write
UpdateApprovalRuleTemplateDescription	承認ルールテンプレートの説明を更新する許可を付与	Write
UpdateApprovalRuleTemplateName	承認ルールテンプレートの名前を更新する許可を付与	Write
UpdateComment	ID がコメントの作成に使用された ID と一致する場合にコメントの内容を更新する許可を付与。	書き込み	repository*
UpdateDefaultBranch	AWS CodeCommit リポジトリのデフォルトブランチを変更するアクセス許可を付与します	書き込み	repository*
UpdatePullRequestApprovalRuleContent	特定のプルリクエストに対して作成された承認ルールのコンテンツを更新する許可を付与。承認ルールテンプレートを使用して作成されたルールの承認ルールコンテンツを更新するアクセス許可は付与しません	Write	repository*
UpdatePullRequestApprovalState	プルリクエストの承認状態を更新する許可を付与	Write	repository*
UpdatePullRequestDescription	プルリクエストの説明を更新する許可を付与。	Write	repository*
UpdatePullRequestStatus	プルリクエストのステータスを更新する許可を付与。	Write	repository*
UpdatePullRequestTitle	プルリクエストのタイトルを更新する許可を付与。	書き込み	repository*
UpdateRepositoryDescription	AWS CodeCommit リポジトリの説明を変更するアクセス許可を付与します	書き込み	repository*
UpdateRepositoryEncryptionKey	AWS CodeCommit リポジトリの暗号化と復号に使用される AWS KMS 暗号化キーを変更するアクセス許可を付与します	書き込み	repository*
UpdateRepositoryName	AWS CodeCommit リポジトリの名前を変更するアクセス許可を付与します	書き込み	repository*
UploadArchive [アクセス許可のみ]	AWS CodePipeline のサービスロールに、リポジトリの変更をパイプラインにアップロードするアクセス許可を付与します	書き込み	repository*

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

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

リソースタイプ	ARN	条件キー
repository	`arn:${Partition}:codecommit:${Region}:${Account}:${RepositoryName}`	aws:ResourceTag/${TagKey}

AWS CodeCommit の条件キー

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

すべてのサービスで使用できるグローバル条件キーを表示するには、AWS 「グローバル条件コンテキストキー」を参照してください。

条件キー	説明	[Type] (タイプ)
aws:RequestTag/${TagKey}	リクエスト内のタグキーと値のペアが存在するかどうかでアクションをフィルタリングします	文字列
aws:ResourceTag/${TagKey}	リソースにアタッチされているタグキーおよび値のペアでアクセスをフィルタリングします	文字列
aws:TagKeys	リクエスト内のタグキーが存在するかどうかでアクセスをフィルタリングします	ArrayOfString
codecommit:References	指定された AWS CodeCommit アクションへのアクセスを Git リファレンスでフィルタリングします	文字列

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

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

ドキュメントの表記規則

Amazon CodeCatalyst

AWS CodeConnections