本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
AWS CodeDeploy 的動作、資源和條件索引鍵
AWS CodeDeploy (服務字首:codedeploy
) 提供下列服務特定的資源、動作和條件內容索引鍵,可用於 IAM 許可政策。
參考資料:
-
了解如何設定此服務。
-
檢視可供此服務使用的 API 操作清單。
-
了解如何使用 IAM 許可政策來保護此服務及其資源。
AWS CodeDeploy 定義的動作
您可在 IAM 政策陳述式的 Action
元素中指定以下動作。使用政策來授予在 AWS中執行操作的許可。在政策中使用動作時,通常會允許或拒絕存取相同名稱的 API 操作或 CLI 命令。不過,在某些情況下,單一動作可控制對多個操作的存取。或者,某些操作需要多種不同的動作。
「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值,您必須在政策陳述式的 Resource
元素中指定政策適用的所有資源 ("*")。如果資料欄包含資源類型,則您可以在具有該動作的陳述式中指定該類型的 ARN。如果動作具有一或多個必要資源,呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您使用 IAM 政策中的 Resource
元素限制資源存取,則每種必要的資源類型必須要有 ARN 或模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要),則您可以選擇使用其中一種選用資源類型。
「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition
元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊,請參閱「資源類型」資料表的條件索引鍵欄。
注意
資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄,其中包含套用至「動作」資料表中動作的資源條件索引鍵。
如需下表各欄的詳細資訊,請參閱動作資料表。
動作 | 描述 | 存取層級 | 資源類型 (*必填項目) | 條件索引鍵 | 相依動作 |
---|---|---|---|---|---|
AddTagsToOnPremisesInstances | 准許將標籤新增至一個或多個現場部署執行個體 | 標記 | |||
BatchGetApplicationRevisions | 准許取得有關一個或多個應用程式修訂的資訊 | 讀取 | |||
BatchGetApplications | 准許取得與 IAM 使用者相關聯的多個應用程式的相關資訊。 | 讀取 | |||
BatchGetDeploymentGroups | 准許取得一或多個部署群組的相關資訊 | 讀取 | |||
BatchGetDeploymentInstances | 准許取得一個或多個執行個體 (其屬於部署群組一部分) 的相關資訊 | 讀取 | |||
BatchGetDeploymentTargets | 准許傳回與部署相關聯的一或多個目標的陣列。此方法適用於所有運算類型,應該採用以取代已棄用的 BatchGetDeploymentInstances。可傳回的目標數目上限為 25 | 讀取 | |||
BatchGetDeployments | 准許取得與 IAM 使用者相關聯的多個部署的相關資訊。 | 讀取 | |||
BatchGetOnPremisesInstances | 准許取得一或多個現場部署執行個體的相關資訊。 | 讀取 | |||
ContinueDeployment | 准許立即開始將流量從原始環境中的執行個體,重新路由傳送到替代環境,而不等待一段指定的時間 | 寫入 | |||
CreateApplication | 准許建立與 IAM 使用者關聯的應用程式 | 寫入 | |||
CreateCloudFormationDeployment [僅限許可] | 准許建立 CloudFormation 部署以配合 CloudFormation 堆疊更新的作業流程 | 寫入 | |||
CreateDeployment | 准許針對與 IAM 使用者相關聯的應用程式,建立部署群組 | 寫入 | |||
CreateDeploymentConfig | 准許建立與 IAM 使用者相關聯的自訂部署組態 | 寫入 | |||
CreateDeploymentGroup | 准許針對與 IAM 使用者相關聯的應用程式,建立部署群組 | 寫入 | |||
DeleteApplication | 准許刪除與 IAM 使用者關聯的應用程式 | 寫入 | |||
DeleteDeploymentConfig | 准許刪除與 IAM 使用者相關聯的自訂部署組態 | 寫入 | |||
DeleteDeploymentGroup | 准許針對與 IAM 使用者相關聯的應用程式,刪除部署群組 | 寫入 | |||
DeleteGitHubAccountToken | 准許刪除 GitHub 帳戶連線 | 寫入 | |||
DeleteResourcesByExternalId | 准許刪除與指定外部 ID 相關聯的資源 | 寫入 | |||
DeregisterOnPremisesInstance | 准許取消註冊現場部署執行個體 | 寫入 | |||
GetApplication | 准許取得與 IAM 使用者相關聯的單一應用程式的相關資訊 | 清單 | |||
GetApplicationRevision | 准許針對與 IAM 使用者相關聯的應用程式,取得單一應用程式修訂的相關資訊 | 清單 | |||
GetDeployment | 准許針對與 IAM 使用者相關聯的應用程式,取得部署群組的單一部署的相關資訊 | 清單 | |||
GetDeploymentConfig | 准許取得與 IAM 使用者相關聯的單一部署組態的相關資訊 | 清單 | |||
GetDeploymentGroup | 准許針對與 IAM 使用者相關聯的應用程式,取得單一部署群組的相關資訊 | 清單 | |||
GetDeploymentInstance | 准許針對與 IAM 使用者相關聯的部署,取得其中單一執行個體的相關資訊 | 清單 | |||
GetDeploymentTarget | 准許傳回部署目標的相關資訊 | 讀取 | |||
GetOnPremisesInstance | 准許取得單一內部部署執行個體的相關資訊 | 清單 | |||
ListApplicationRevisions | 准許針對與 IAM 使用者相關聯的應用程式,取得所有應用程式修訂的相關資訊 | 清單 | |||
ListApplications | 准許取得與 IAM 使用者相關聯的所有應用程式的相關資訊 | 清單 | |||
ListDeploymentConfigs | 准許取得與 IAM 使用者相關聯的所有部署組態的相關資訊 | 清單 | |||
ListDeploymentGroups | 准許針對與 IAM 使用者相關聯的應用程式,取得所有部署群組的相關資訊 | 清單 | |||
ListDeploymentInstances | 准許針對與 IAM 使用者相關聯的部署,取得其中所有執行個體的相關資訊 | 清單 | |||
ListDeploymentTargets | 准許傳回與部署相關聯的目標 ID 陣列 | 清單 | |||
ListDeployments | 准許針對與 IAM 使用者相關聯的部署群組,取得所有部署的相關資訊,或取得與 IAM 使用者相關聯的所有部署 | 清單 | |||
ListGitHubAccountTokenNames | 准許列出 GitHub 帳戶預存連線的名稱 | 清單 | |||
ListOnPremisesInstances | 准許取得一或多個現場部署執行個體名稱的清單 | 清單 | |||
ListTagsForResource | 准許傳回由特定 ARN 所識別的資源的標籤清單 標籤用來組織和分類 CodeDeploy 資源 | 清單 | |||
PutLifecycleEventHookExecutionStatus | 准許針對 IAM 使用者相關聯的部署,公告生命週期事件關聯執行狀態 | 寫入 | |||
RegisterApplicationRevision | 准許針對與 IAM 使用者相關聯的應用程式,註冊應用程式修訂的相關資訊 | 寫入 | |||
RegisterOnPremisesInstance | 准許註冊內部部署執行個體 | 寫入 | |||
RemoveTagsFromOnPremisesInstances | 准許從一個或多個現場部署執行個體移除標籤 | 標記 | |||
SkipWaitTimeForInstanceTermination | 准許覆寫任何指定的等待時間,並在流量路由完成後立即開始終止執行個體 此動作僅適用於藍/綠部署 | 寫入 | |||
StopDeployment | 准許停止部署 | 寫入 | |||
TagResource | 准許將 Tags 輸入參數中的標籤清單與 ResourceArn 輸入參數所識別的資源建立關聯 | 標記 | |||
UntagResource | 准許將一組標籤與指定資源取消關聯 由 ResourceArn 輸入參數所識別的資源。標籤由 TagKeys 輸入參數中的金鑰清單所識別 | 標記 | |||
UpdateApplication | 准許更新應用程式 | 寫入 | |||
UpdateDeploymentGroup | 准許針對與 IAM 使用者相關聯的應用程式,變更單一部署群組的相關資訊 | 寫入 |
AWS CodeDeploy 定義的資源類型
此服務會定義下列資源類型,並可用在 IAM 許可政策陳述式的 Resource
元素中。動作表格中的每個動作都代表可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊,請參閱資源類型資料表。
資源類型 | ARN | 條件索引鍵 |
---|---|---|
application |
arn:${Partition}:codedeploy:${Region}:${Account}:application:${ApplicationName}
|
|
deploymentconfig |
arn:${Partition}:codedeploy:${Region}:${Account}:deploymentconfig:${DeploymentConfigurationName}
|
|
deploymentgroup |
arn:${Partition}:codedeploy:${Region}:${Account}:deploymentgroup:${ApplicationName}/${DeploymentGroupName}
|
|
instance |
arn:${Partition}:codedeploy:${Region}:${Account}:instance:${InstanceName}
|
AWS CodeDeploy 的條件索引鍵
AWS CodeDeploy 定義下列條件索引鍵,可用於 IAM 政策的 Condition
元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊,請參閱條件索引鍵表。
若要檢視所有服務都可使用的全域條件鍵,請參閱可用全域條件鍵。
條件索引鍵 | 描述 | 類型 |
---|---|---|
aws:RequestTag/${TagKey} | 根據請求中的標籤鍵值組是否存在來篩選動作 | 字串 |
aws:ResourceTag/${TagKey} | 根據連接到資源的標籤鍵值組來篩選動作 | 字串 |
aws:TagKeys | 根據請求中的標籤鍵是否存在來篩選動作 | ArrayOfString |