本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
下列項目的動作、資源和條件索引鍵 AWS CodePipeline
AWS CodePipeline (服務前置詞:codepipeline
) 提供下列服務特定資源、動作和條件內容金鑰,以供 IAM 權限政策使用。
參考資料:
-
了解如何設定此服務。
-
檢視可供此服務使用的 API 操作清單。
-
了解如何使用 IAM 許可政策來保護此服務及其資源。
AWS CodePipeline 定義的動作
您可在 IAM 政策陳述式的 Action
元素中指定以下動作。使用政策來授予在 AWS中執行操作的許可。在政策中使用動作時,通常會允許或拒絕存取相同名稱的 API 操作或 CLI 命令。不過,在某些情況下,單一動作可控制對多個操作的存取。或者,某些操作需要多種不同的動作。
「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值,您必須在政策陳述式的 Resource
元素中指定政策適用的所有資源 ("*")。如果資料欄包含資源類型,則您可以在具有該動作的陳述式中指定該類型的 ARN。如果動作具有一或多個必要資源,呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您使用 IAM 政策中的 Resource
元素限制資源存取,則每種必要的資源類型必須要有 ARN 或模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要),則您可以選擇使用其中一種選用資源類型。
「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition
元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊,請參閱「資源類型」資料表的條件索引鍵欄。
注意
資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄,其中包含套用至「動作」資料表中動作的資源條件索引鍵。
如需下表各欄的詳細資訊,請參閱動作資料表。
動作 | 描述 | 存取層級 | 資源類型 (*必填項目) | 條件索引鍵 | 相依動作 |
---|---|---|---|---|---|
AcknowledgeJob | 授予權限以檢視指定任務資訊,以及了解該任務是否已由任務工作者接收。 | 寫入 | |||
AcknowledgeThirdPartyJob | 授予權限以確認任務工作者已經收到指定的任務 (僅限合作夥伴動作) | 寫入 | |||
CreateCustomActionType | 授予建立自訂動作的權限,您可以在與您的相關聯的管道中使用 AWS 帳戶 | 寫入 | |||
CreatePipeline | 授予權限以建立唯一命名的管道 | 寫入 | |||
DeleteCustomActionType | 准許刪除自訂動作 | 寫入 | |||
DeletePipeline | 准許刪除指定的管道 | 寫入 | |||
DeleteWebhook | 准許刪除指定的 Webhook | 寫入 | |||
DeregisterWebhookWithThirdParty | 准許從組態指定的第三方移除 Webhook 的註冊 | 寫入 | |||
DisableStageTransition | 准許防止修訂轉移到管道中到下一個階段 | 寫入 | |||
EnableStageTransition | 授予權限以允許修訂轉移到管道中的下一個階段 | 寫入 | |||
GetActionType | 准許檢閱動作類型的資訊 | 讀取 | |||
GetJobDetails | 准許檢視關於任務的資訊 (僅限自訂動作) | 讀取 | |||
GetPipeline | 准許擷取管道結構的相關資訊 | 讀取 | |||
GetPipelineExecution | ㄓ准許檢視管道執行相關資訊,包含成品詳細資訊、管道執行 ID、管道名稱、版本及狀態。 | 讀取 | |||
GetPipelineState | 准許針對管道的階段和動作,檢視其目前狀態的相關資訊。 | 讀取 | |||
GetThirdPartyJobDetails | 准許檢視第三方動作之任務的詳細資料 (僅限合作夥伴動作) | 讀取 | |||
ListActionExecutions | 准許列出管道中發生的動作執行 | 讀取 | |||
ListActionTypes | 准許針對您帳戶中的管道,列出可用的所有動作類型的摘要 | 讀取 | |||
ListPipelineExecutions | 准許列出管道之最近執行的摘要 | 清單 | |||
ListPipelines | 授予列出與您相關聯之所有管線摘要的權限 AWS 帳戶 | 清單 | |||
ListTagsForResource | 授予列出 CodePipeline 資源標籤的權限 | 讀取 | |||
ListWebhooks | 授予列出與您相關聯的所有網絡掛鉤的權限 AWS 帳戶 | 清單 | |||
PollForJobs | 授予檢視任何工作相關資訊的權限, CodePipeline 以便執行動作 | 寫入 | |||
PollForThirdPartyJobs | 准許判斷是否有任何需要任務工作者處理的第三方任務 (僅限合作夥伴動作) | 寫入 | |||
PutActionRevision | 准許編輯管道中的動作 | 寫入 | |||
PutApprovalResult | 授與對手動核准請求提供回應 (已核准或已拒絕) 的權限 CodePipeline | 寫入 | |||
PutJobFailureResult | 准許表示由任務工作者傳回管道的任務失敗 (僅限自訂動作) | 寫入 | |||
PutJobSuccessResult | 准許表示由任務工作者傳回管道的任務成功 (僅限自訂動作) | 寫入 | |||
PutThirdPartyJobFailureResult | 准許表示由任務工作者傳回管道的第三方任務失敗 (僅限合作夥伴動作) | 寫入 | |||
PutThirdPartyJobSuccessResult | 准許表示由任務工作者傳回管道的第三方任務成功 (僅限合作夥伴動作) | 寫入 | |||
PutWebhook | 准許建立或更新 Webhook | 寫入 | |||
RegisterWebhookWithThirdParty | 准許向組態中指定的第三方註冊 Webhook | 寫入 | |||
RetryStageExecution | 准許透過重試階段中最後一次失敗動作,以繼續執行管道 | 寫入 | |||
RollbackStage | 授與將階段復原至先前成功執行的權限 | 寫入 | |||
StartPipelineExecution | 准許透過管道執行最近的修訂 | 寫入 | |||
StopPipelineExecution | 准許停止進行中的管道執行 | 寫入 | |||
TagResource | 授予標記資 CodePipeline 源的權限 | 標記 | |||
UntagResource | 授予從 CodePipeline 資源中移除標籤的權限 | 標記 | |||
UpdateActionType | 准許更新動作類型 | 寫入 | |||
UpdatePipeline | 准許以管道結構的變更來更新管道 | 寫入 |
AWS CodePipeline 定義的資源類型
此服務會定義下列資源類型,並可用在 IAM 許可政策陳述式的 Resource
元素中。動作資料表中的每個動作都會指明可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊,請參閱資源類型資料表。
資源類型 | ARN | 條件索引鍵 |
---|---|---|
action |
arn:${Partition}:codepipeline:${Region}:${Account}:${PipelineName}/${StageName}/${ActionName}
|
|
actiontype |
arn:${Partition}:codepipeline:${Region}:${Account}:actiontype:${Owner}/${Category}/${Provider}/${Version}
|
|
pipeline |
arn:${Partition}:codepipeline:${Region}:${Account}:${PipelineName}
|
|
stage |
arn:${Partition}:codepipeline:${Region}:${Account}:${PipelineName}/${StageName}
|
|
webhook |
arn:${Partition}:codepipeline:${Region}:${Account}:webhook:${WebhookName}
|
AWS CodePipeline 的條件索引鍵
AWS CodePipeline 定義下列可用於 IAM 政策Condition
元素的條件金鑰。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊,請參閱條件索引鍵資料表。
若要檢視所有服務都可使用的全域條件索引鍵,請參閱可用全域條件索引鍵。
條件索引鍵 | 描述 | 類型 |
---|---|---|
aws:RequestTag/${TagKey} | 根據請求中的標籤鍵值組是否存在來篩選動作 | 字串 |
aws:ResourceTag/${TagKey} | 根據連接到資源的標籤鍵值組來篩選動作 | 字串 |
aws:TagKeys | 根據請求中的標籤鍵是否存在來篩選動作 | ArrayOfString |