的動作、資源和條件索引鍵 AWS CodeCommit

AWS CodeCommit (服務前置詞:codecommit) 提供下列服務特定資源、動作和條件內容金鑰，以供 IAM 權限政策使用。

參考資料：

• 了解如何設定此服務。

• 檢視可供此服務使用的 API 操作清單。

• 了解如何使用 IAM 許可政策來保護此服務及其資源。

AWS CodeCommit 定義的動作

您可在 IAM 政策陳述式的 Action 元素中指定以下動作。使用政策來授予在 AWS中執行操作的許可。在政策中使用動作時，通常會允許或拒絕存取相同名稱的 API 操作或 CLI 命令。不過，在某些情況下，單一動作可控制對多個操作的存取。或者，某些操作需要多種不同的動作。

「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值，您必須在政策陳述式的 Resource 元素中指定政策適用的所有資源 ("*")。如果資料欄包含資源類型，則您可以在具有該動作的陳述式中指定該類型的 ARN。如果動作具有一或多個必要資源，呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您使用 IAM 政策中的 Resource 元素限制資源存取，則每種必要的資源類型必須要有 ARN 或模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要)，則您可以選擇使用其中一種選用資源類型。

「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition 元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊，請參閱「資源類型」資料表的條件索引鍵欄。

注意

資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄，其中包含套用至「動作」資料表中動作的資源條件索引鍵。

如需下表各欄的詳細資訊，請參閱動作資料表。

動作	描述	存取層級	資源類型 (*必填項目)	條件索引鍵	相依動作
AssociateApprovalRuleTemplateWithRepository	准許建立核准規則範本與儲存器的關聯	寫入	repository*
BatchAssociateApprovalRuleTemplateWithRepositories	准許使用單一操作建立核准規則範本與多個儲存器的關聯	寫入	repository*
BatchDescribeMergeConflicts	在嘗試使用三向合併或壓縮合併選項來合併兩個遞交時，准許取得多次合併衝突的相關資訊	讀取	repository*
BatchDisassociateApprovalRuleTemplateFromRepositories	准許使用單一操作移除核准規則範本與多個儲存器的關聯	寫入	repository*
BatchGetCommits	授予返回有關 AWS CodeCommit 存儲庫中一個或多個提交信息的權限	讀取	repository*
BatchGetPullRequests [僅限許可]	授予傳回 AWS CodeCommit 儲存庫中一或多個提取要求相關資訊的權限	讀取	repository*
BatchGetRepositories	准許取得多個儲存庫的相關資訊	讀取	repository*
CancelUploadArchive [僅限許可]	授予取消上傳歸檔至中管線的權限 AWS CodePipeline	讀取	repository*
CreateApprovalRuleTemplate	准許建立符合後列條件的核准規則範本：此範本會在符合範本定義條件的提取請求中自動建立核准規則；但不准許建立個別提取請求的核准規則	寫入
CreateBranch	授予使用此 API 在 AWS CodeCommit 存儲庫中創建分支的權限; 不控制 Git 創建分支操作	寫入	repository*
				codecommit:References
CreateCommit	授予在 AWS CodeCommit 存儲庫中添加，複製，移動或更新單個或多個文件的權限，並為指定分支中的更改生成提交	寫入	repository*
				codecommit:References
CreatePullRequest	准許在指定的儲存庫建立提取請求	寫入	repository*
CreatePullRequestApprovalRule	准許建立個別提取請求專屬的核准規則；但不准許建立核准規則範本	寫入	repository*
CreateRepository	授予建立存 AWS CodeCommit 放庫的權限	寫入	repository*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateUnreferencedMergeCommit	准許建立未參考的遞交，其中包含使用三向或壓縮合併選項來合併兩個遞交的結果；不控制 Git 合併動作	寫入	repository*
				codecommit:References
DeleteApprovalRuleTemplate	准許刪除核准規則範本	寫入
DeleteBranch	授予使用此 API 刪除 AWS CodeCommit 存儲庫中分支的權限; 不控制 Git 刪除分支操作	寫入	repository*
				codecommit:References
DeleteCommentContent	針對儲存庫中的變更、檔案或遞交所做的註解，准許刪除註解的內容	寫入	repository*
DeleteFile	准許從指定的分支刪除指定的檔案	寫入	repository*
				codecommit:References
DeletePullRequestApprovalRule	准許刪除針對提取請求建立的核准規則 (如果該規則不是由核准規則範本所建立)	寫入	repository*
DeleteRepository	授予刪除存 AWS CodeCommit 放庫的權限	寫入	repository*
DescribeMergeConflicts	在嘗試使用三向或壓縮合併選項來合併兩個遞交時，准許取得特定合併衝突的相關資訊	讀取	repository*
DescribePullRequestEvents	准許傳回一或多個提取請求事件的相關資訊	讀取	repository*
DisassociateApprovalRuleTemplateFromRepository	准許移除核准規則範本與儲存器的關聯性	寫入	repository*
EvaluatePullRequestApprovalRules	准許評估提取請求是否可合併，評判基礎為其目前的核准狀態與核准規則需求	讀取	repository*
GetApprovalRuleTemplate	准許傳回核准規則範本的資訊	讀取
GetBlob	授予從 AWS CodeCommit 主控台檢視 AWS CodeCommit 儲存庫中個別檔案編碼內容的權限	讀取	repository*
GetBranch	授予使用此 API 獲取 AWS CodeCommit 存儲庫中分支詳細信息的權限; 不控制 Git 分支操作	讀取	repository*
GetComment	針對儲存庫中的變更、檔案或遞交所做的註解，准許取得註解的內容	讀取	repository*
GetCommentReactions	准許取得註解的反應	讀取	repository*
GetCommentsForComparedCommit	針對比較兩個遞交而做的註解，准許取得註解的相關資訊	讀取	repository*
GetCommentsForPullRequest	准許取得對提取請求所做的註解	讀取	repository*
GetCommit	准許使用此 API 傳回遞交的相關資訊，包括遞交訊息和遞交者資訊；不控制 Git 日誌動作	讀取	repository*
GetCommitHistory [僅限許可]	准許取得儲存庫中的遞交歷史記錄的相關資訊	讀取	repository*
GetCommitsFromMergeBase [僅限許可]	准許在潛在合併情況下取得遞交之間差異的相關資訊	讀取	repository*
GetDifferences	准許檢視有效遞交指標 (例如，分支、標籤、HEAD、遞交 ID，或其他完整參考) 之間差異的相關資訊	讀取	repository*
GetFile	准許傳回特定檔案及其中繼資料的 base-64 編碼內容	讀取	repository*
GetFolder	准許傳回儲存庫中特定資料夾的內容	讀取	repository*
GetMergeCommit	針對建立合併遞交的提取請求，准許取得以其中一個合併選項建立的合併遞交的相關資訊。並不是所有合併選項都會建立合併遞交。此許可不會控制 Git 合併動作	讀取	repository*
				codecommit:References
GetMergeConflicts	針對儲存庫中的提取請求，准許取得遞交 ID 前後之間的合併衝突的相關資訊	讀取	repository*
GetMergeOptions	針對可用來合併兩個遞交的提取請求，准許取得合併選項的相關資訊；不控制 Git 合併動作	讀取	repository*
GetObjectIdentifier [僅限許可]	准許將 Blob、樹狀目錄和遞交解析為其識別符	讀取	repository*
GetPullRequest	准許取得特定儲存庫中的提取請求的相關資訊	讀取	repository*
GetPullRequestApprovalStates	准許擷取已輸入提取請求目前的核准	讀取	repository*
GetPullRequestOverrideState	准許擷取指定提取請求目前的覆寫狀態	讀取	repository*
GetReferences [僅限許可]	授予獲取 AWS CodeCommit 存儲庫中引用詳細信息的權限; 不控制 Git 引用操作	讀取	repository*
GetRepository	授予取得 AWS CodeCommit 儲存庫相關資訊的權限	讀取	repository*
GetRepositoryTriggers	准許取得儲存庫已設定的觸發的相關資訊	讀取	repository*
GetTree [僅限許可]	授予從 AWS CodeCommit 控制台查看 AWS CodeCommit 存儲庫中指定樹狀結構內容的權限	讀取	repository*
GetUploadArchiveStatus [僅限許可]	授予取得有關檔案上傳至中管線之狀態資訊的權限 AWS CodePipeline	讀取	repository*
GitPull [僅限許可]	授予將信息從 AWS CodeCommit 存儲庫提取到本地回購的權限	讀取	repository*
GitPush [僅限許可]	授予將信息從本地回購推送到 AWS CodeCommit 存儲庫的權限	寫入	repository*
				codecommit:References
ListApprovalRuleTemplates	授與在中列出所有核准規則範本 AWS 區域 的權限 AWS 帳戶	清單
ListAssociatedApprovalRuleTemplatesForRepository	准許列出與儲存器相關聯的核准規則範本	清單	repository*
ListBranches	授予使用此 API 列出 AWS CodeCommit 存儲庫分支的權限; 不控制 Git 分支操作	清單	repository*
ListFileCommitHistory	准許列出指定文件的遞交和變更	清單	repository*
ListPullRequests	准許列出特定儲存庫的提取請求	清單	repository*
ListRepositories	授予列出目前區域中 AWS CodeCommit 儲存庫相關資訊的權限 AWS 帳戶	清單
ListRepositoriesForApprovalRuleTemplate	准許列出與核准規則範本相關聯的儲存器	清單
ListTagsForResource	授予列出附加至資源 ARN 之 CodeCommit 資源的權限	清單	repository
MergeBranchesByFastForward	准許使用向前快轉合併選項，將兩個遞交合併到指定的目的地分支	寫入	repository*
				codecommit:References
MergeBranchesBySquash	准許使用壓縮合併選項，將兩個遞交合併到指定的目的地分支	寫入	repository*
				codecommit:References
MergeBranchesByThreeWay	准許使用三向合併選項，將兩個遞交合併到指定的目的地分支	寫入	repository*
				codecommit:References
MergePullRequestByFastForward	准許關閉提取請求，並在指定的遞交上嘗試使用向前快轉合併選項，合併到該提取請求指定的目的地分支	寫入	repository*
				codecommit:References
MergePullRequestBySquash	准許關閉提取請求，並在指定的遞交上嘗試使用壓縮合併選項，合併到該提取請求指定的目的地分支	寫入	repository*
				codecommit:References
MergePullRequestByThreeWay	准許關閉提取請求，並在指定的遞交上嘗試使用三向合併選項，合併到該提取請求指定的目的地分支	寫入	repository*
				codecommit:References
OverridePullRequestApprovalRules	准許覆寫提取請求的所有核准規則，包括由範本建立的核准規則	寫入	repository*
PostCommentForComparedCommit	針對兩個遞交之間的比較，准許張貼註解	寫入	repository*
PostCommentForPullRequest	准許對提取請求張貼註解	寫入	repository*
PostCommentReply	針對遞交之間的比較或提取請求而做的註解，准許張貼註解以回覆	寫入	repository*
PutCommentReaction	准許張貼註解的反應	寫入	repository*
PutFile	授予在 AWS CodeCommit 存儲庫中添加或更新分支中的文件的權限，並為指定分支中的添加生成提交	寫入	repository*
				codecommit:References
PutRepositoryTriggers	准許建立、更新或刪除儲存庫的觸發	寫入	repository*
TagResource	授予將資源標籤附加至資 CodeCommit 源 ARN 的權限	標記	repository
				aws:ResourceTag/${TagKey} aws:RequestTag/${TagKey} aws:TagKeys
TestRepositoryTriggers	准許將資訊傳送到觸發目標，以測試儲存庫觸發的功能	寫入	repository*
UntagResource	授與取消資源標籤與資源 ARN 關聯的權限 CodeCommit	標記	repository
				aws:TagKeys aws:ResourceTag/${TagKey}
UpdateApprovalRuleTemplateContent	准許更新核准規則範本的內容；但不准許更新專為提取請求建立之核准規則的內容	寫入
UpdateApprovalRuleTemplateDescription	准許更新核准規則範本的描述	寫入
UpdateApprovalRuleTemplateName	准許更新核准規則範本的名稱	寫入
UpdateComment	如果身分符合用來建立註解的身分，則准許更新註解的內容	寫入	repository*
UpdateDefaultBranch	授予更改 AWS CodeCommit 存儲庫中默認分支的權限	寫入	repository*
UpdatePullRequestApprovalRuleContent	准許更新針對特定提取請求建立之核准規則的內容；但不准許更新使用核准規則範本建立之規則的核准規則內容	寫入	repository*
UpdatePullRequestApprovalState	准許更新提取請求的核准狀態	寫入	repository*
UpdatePullRequestDescription	准許更新提取請求的描述	寫入	repository*
UpdatePullRequestStatus	准許更新提取請求的狀態	寫入	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元素的條件金鑰。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊，請參閱條件索引鍵資料表。

若要檢視所有服務都可使用的全域條件索引鍵，請參閱可用全域條件索引鍵。

條件索引鍵	描述	Type
aws:RequestTag/${TagKey}	依請求中的標籤鍵值對是否存在篩選存取權	字串
aws:ResourceTag/${TagKey}	依連接到資源的標籤鍵值對篩選存取權	字串
aws:TagKeys	依請求中是否存在標籤索引鍵來篩選存取	ArrayOfString
codecommit:References	通過 Git 引用過濾對指定 AWS CodeCommit 操作的訪問	字串