本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
Amazon EC2 Image Builder 的動作、資源和條件索引鍵
Amazon EC2 Image Builder (服務字首：imagebuilder) 提供以下可在 IAM 許可政策中使用的服務特定資源、動作和條件內容金鑰。
參考資料：
-
了解如何設定此服務。
-
檢視可供此服務使用的 API 操作清單。
-
了解如何使用 IAM 許可政策來保護此服務及其資源。
Amazon EC2 Image Builder 定義的動作
您可在 IAM 政策陳述式的 Action 元素中指定以下動作。使用政策來授予在 AWS中執行操作的許可。在政策中使用動作時，通常會允許或拒絕存取相同名稱的 API 操作或 CLI 命令。不過，在某些情況下，單一動作可控制對多個操作的存取。或者，某些操作需要多種不同的動作。
動作資料表的存取層級欄說明動作的分類方式 （列出、讀取、許可管理或標記）。此分類可協助您了解在政策中使用某動作時，該動作授予您的存取層級。如需存取層級的詳細資訊，請參閱政策摘要中的存取層級。
「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值，您必須在政策陳述式的 Resource 元素中指定政策適用的所有資源 ("*")。如果資料欄包含資源類型，則您可以在具有該動作的陳述式中指定該類型的 ARN。如果動作具有一或多個必要資源，呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您使用 IAM 政策中的 Resource 元素限制資源存取，則每種必要的資源類型必須要有 ARN 或模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要)，則您可以選擇使用其中一種選用資源類型。
「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition 元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊，請參閱「資源類型」資料表的條件索引鍵欄。
動作資料表的相依動作欄會顯示成功呼叫動作所需的其他許可。除了 動作本身的許可之外，還可能需要這些許可。當動作指定相依動作時，這些相依性可能適用於針對該動作定義的其他資源，而不只是資料表中列出的第一個資源。
注意
資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄，其中包含套用至「動作」資料表中動作的資源條件索引鍵。
如需下表各欄的詳細資訊，請參閱動作資料表。
| 動作 | 描述 | 存取層級 | 資源類型 (*必填項目) | 條件索引鍵 | 相依動作 |
|---|---|---|---|---|---|
| CancelImageCreation | 准許取消建立映像 | 寫入 | |||
| CancelLifecycleExecution | 准許取消執行生命週期執行 | 寫入 | |||
| CreateComponent | 准許建立新的元件 | 寫入 |
imagebuilder:TagResource kms:Encrypt kms:GenerateDataKey kms:GenerateDataKeyWithoutPlaintext s3:GetObject s3:ListBucket |
||
| CreateContainerRecipe | 准許建立新的容器配方 | 寫入 |
ec2:DescribeImages ecr:DescribeImages ecr:DescribeRepositories imagebuilder:GetComponent imagebuilder:GetImage imagebuilder:TagResource kms:Encrypt kms:GenerateDataKey kms:GenerateDataKeyWithoutPlaintext s3:GetObject s3:ListBucket ssm:GetParameter |
||
| CreateDistributionConfiguration | 准許建立新的分佈組態 | 寫入 |
ec2:CreateLaunchTemplateVersion ec2:DescribeLaunchTemplates ec2:ModifyLaunchTemplate imagebuilder:TagResource s3:ListBucket ssm:GetParameter |
||
| CreateImage | 准許建立新映像 | 寫入 |
ecr:BatchGetRepositoryScanningConfiguration ecr:DescribeRepositories iam:CreateServiceLinkedRole iam:PassRole imagebuilder:GetContainerRecipe imagebuilder:GetDistributionConfiguration imagebuilder:GetImageRecipe imagebuilder:GetInfrastructureConfiguration imagebuilder:GetWorkflow imagebuilder:TagResource inspector2:BatchGetAccountStatus |
||
| CreateImagePipeline | 准許建立新的映像管道 | 寫入 |
ecr:BatchGetRepositoryScanningConfiguration ecr:DescribeRepositories iam:CreateServiceLinkedRole iam:PassRole imagebuilder:GetContainerRecipe imagebuilder:GetDistributionConfiguration imagebuilder:GetImageRecipe imagebuilder:GetInfrastructureConfiguration imagebuilder:GetWorkflow imagebuilder:TagResource inspector2:BatchGetAccountStatus |
||
| CreateImageRecipe | 准許建立新的映像配方 | 寫入 |
ec2:DescribeImages imagebuilder:GetComponent imagebuilder:GetImage imagebuilder:TagResource ssm:GetParameter |
||
| CreateInfrastructureConfiguration | 准許建立新的基礎架構組態 | 寫入 |
ec2:DescribeAvailabilityZones ec2:DescribeHosts iam:PassRole imagebuilder:TagResource resource-groups:GetGroup sns:Publish |
||
|
imagebuilder:CreatedResourceTagKeys imagebuilder:CreatedResourceTag/${TagKey} |
|||||
| CreateLifecyclePolicy | 准許建立新的生命週期政策 | 寫入 |
iam:PassRole imagebuilder:TagResource |
||
| CreateWorkflow | 授予許可來建立工作流程 | 寫入 |
imagebuilder:TagResource kms:Encrypt kms:GenerateDataKey kms:GenerateDataKeyWithoutPlaintext s3:GetObject s3:ListBucket |
||
| DeleteComponent | 准許刪除元件 | 寫入 | |||
| DeleteContainerRecipe | 准許刪除容器配方 | 寫入 | |||
| DeleteDistributionConfiguration | 准許刪除分佈組態 | 寫入 | |||
| DeleteImage | 准許刪除映像 | 寫入 | |||
| DeleteImagePipeline | 准許刪除映像管道 | 寫入 | |||
| DeleteImageRecipe | 准許刪除映像配方 | 寫入 | |||
| DeleteInfrastructureConfiguration | 准許刪除基礎架構組態 | 寫入 | |||
| DeleteLifecyclePolicy | 准許刪除生命週期政策 | 寫入 | |||
| DeleteWorkflow | 授予許可來刪除工作流程 | 寫入 | |||
| GetComponent | 准許檢視元件的詳細資訊 | 讀取 |
kms:Decrypt |
||
| GetComponentPolicy | 准許檢視與元件相關聯的資源政策 | 讀取 | |||
| GetContainerRecipe | 准許檢視容器配方的詳細資訊 | 讀取 | |||
| GetContainerRecipePolicy | 准許檢視與容器配方相關聯的資源政策 | 讀取 | |||
| GetDistributionConfiguration | 准許檢視分佈組態的詳細資訊 | 讀取 | |||
| GetImage | 准許檢視映像的詳細資訊 | 讀取 | |||
| GetImagePipeline | 准許檢視映像管道的詳細資訊 | 讀取 | |||
| GetImagePolicy | 准許檢視與映像相關聯的資源政策 | 讀取 | |||
| GetImageRecipe | 准許檢視映像配方的詳細資訊 | 讀取 | |||
| GetImageRecipePolicy | 准許檢視與映像配方相關聯的資源政策 | 讀取 | |||
| GetInfrastructureConfiguration | 准許檢視基礎架構組態的詳細資訊 | 閱讀 | |||
| GetLifecycleExecution | 准許檢視生命週期執行的相關詳細資訊 | 閱讀 | |||
| GetLifecyclePolicy | 准許檢視生命週期政策的相關詳細資訊 | 閱讀 | |||
| GetMarketplaceResource | 准許擷取 Marketplace 提供的資源 | 閱讀 | |||
| GetWorkflow | 授予許可檢視工作流程執行的詳細資訊 | 閱讀 |
kms:Decrypt |
||
| GetWorkflowExecution | 准許檢視工作流程執行的詳細資訊 | 閱讀 | |||
| GetWorkflowStepExecution | 准許檢視工作流程步驟執行的詳細資訊 | 閱讀 |
kms:Decrypt |
||
| ImportComponent | 准許匯入新元件 | 寫入 |
imagebuilder:TagResource kms:Encrypt kms:GenerateDataKey kms:GenerateDataKeyWithoutPlaintext s3:GetObject s3:ListBucket |
||
| ImportDiskImage | 准許匯入磁碟映像 | 寫入 |
iam:CreateServiceLinkedRole iam:PassRole imagebuilder:GetInfrastructureConfiguration imagebuilder:GetWorkflow imagebuilder:TagResource s3:GetObject s3:ListBucket |
||
| ImportVmImage | 准許匯入映像 | 寫入 |
ec2:DescribeImages ec2:DescribeImportImageTasks iam:CreateServiceLinkedRole imagebuilder:TagResource |
||
| ListComponentBuildVersions | 准許列出帳戶中的元件組建版本 | 列出 | |||
| ListComponents | 准許列出帳戶所擁有或共用的元件版本 | 列出 | |||
| ListContainerRecipes | 准許列出帳戶所擁有或共用的容器配方 | 列出 | |||
| ListDistributionConfigurations | 准許列出帳戶中的分佈組態 | 列出 | |||
| ListImageBuildVersions | 准許列出帳戶中映像建置版本 | 清單 | |||
| ListImagePackages | 准許傳回指定映像上安裝的套件清單 | 清單 | |||
| ListImagePipelineImages | 准許傳回特定管道建立的映像清單 | 清單 | |||
| ListImagePipelines | 准許列出帳戶中的映像管道 | 列出 | |||
| ListImageRecipes | 准許列出帳戶所擁有或共用的映像配方 | 清單 | |||
| ListImageScanFindingAggregations | 准許列出帳戶中映像掃描調查結果上的彙總 | 清單 | |||
| ListImageScanFindings | 准許列出帳戶中映像的映像掃描調查結果 | 清單 |
inspector2:ListFindings |
||
| ListImages | 准許列出帳戶所擁有或共用的映像版本 | 列出 | |||
| ListInfrastructureConfigurations | 准許列出帳戶中的基礎架構組態 | 清單 | |||
| ListLifecycleExecutionResources | 准許列出指定生命週期執行的資源 | 清單 | |||
| ListLifecycleExecutions | 准許列出指定資源的生命週期執行 | 清單 | |||
| ListLifecyclePolicies | 准許列出您帳戶中的生命週期政策 | 清單 | |||
| ListTagsForResource | 准許列出 Image Builder 資源的標籤 | 閱讀 | |||
| ListWaitingWorkflowSteps | 授予許可列出來電者帳戶等待工作流程步驟 | 清單 | |||
| ListWorkflowBuildVersions | 授予許可列出帳戶中工作流程建置版本 | 清單 | |||
| ListWorkflowExecutions | 准許列出指定映像的工作流程執行 | 清單 | |||
| ListWorkflowStepExecutions | 准許列出指定工作流程的工作流程步驟執行 | 清單 |
kms:Decrypt |
||
| ListWorkflows | 授予許可列出帳戶所擁有或共用的工作流程版本 | 清單 | |||
| PutComponentPolicy | 准許設定與元件相關聯的資源政策 | 許可管理 | |||
| PutContainerRecipePolicy | 准許設定與某個容器配方相關聯的資源政策 | 許可管理 | |||
| PutImagePolicy | 准許設定與映像相關聯的資源政策 | 許可管理 | |||
| PutImageRecipePolicy | 准許設定與映像配方相關聯的資源政策 | 許可管理 | |||
| SendWorkflowStepAction | 授予許可來將動作傳送至工作流程步驟 | 寫入 | |||
| StartImagePipelineExecution | 准許從管道建立新映像 | 寫入 |
iam:CreateServiceLinkedRole imagebuilder:GetImagePipeline imagebuilder:TagResource |
||
| StartResourceStateUpdate | 准許啟動指定資源的狀態更新 | 寫入 | |||
| TagResource | 准許標記 Image Builder 資源 | 標記 | |||
| UntagResource | 准許取消標記 Image Builder 資源 | 標記 | |||
| UpdateDistributionConfiguration | 准許更新現有的分佈組態 | 寫入 |
ec2:CreateLaunchTemplateVersion ec2:DescribeLaunchTemplates ec2:ModifyLaunchTemplate s3:ListBucket ssm:GetParameter |
||
| UpdateImagePipeline | 准許更新現有的映像管道 | 寫入 |
ecr:BatchGetRepositoryScanningConfiguration ecr:DescribeRepositories iam:CreateServiceLinkedRole iam:PassRole imagebuilder:GetContainerRecipe imagebuilder:GetDistributionConfiguration imagebuilder:GetImageRecipe imagebuilder:GetInfrastructureConfiguration imagebuilder:GetWorkflow inspector2:BatchGetAccountStatus |
||
| UpdateInfrastructureConfiguration | 准許更新現有的基礎架構組態 | 寫入 |
ec2:DescribeAvailabilityZones ec2:DescribeHosts iam:PassRole resource-groups:GetGroup sns:Publish |
||
|
imagebuilder:CreatedResourceTagKeys imagebuilder:CreatedResourceTag/${TagKey} |
|||||
| UpdateLifecyclePolicy | 准許更新現有的生命週期政策 | 寫入 |
iam:PassRole |
||
Amazon EC2 Image Builder 定義的資源類型
此服務會定義下列資源類型，並可用在 IAM 許可政策陳述式的 Resource 元素中。動作表格中的每個動作都代表可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊，請參閱資源類型資料表。
| 資源類型 | ARN | 條件索引鍵 |
|---|---|---|
| component |
arn:${Partition}:imagebuilder:${Region}:${Account}:component/${ComponentName}/${ComponentVersion}/${ComponentBuildVersion}
|
|
| distributionConfiguration |
arn:${Partition}:imagebuilder:${Region}:${Account}:distribution-configuration/${DistributionConfigurationName}
|
|
| image |
arn:${Partition}:imagebuilder:${Region}:${Account}:image/${ImageName}/${ImageVersion}/${ImageBuildVersion}
|
|
| imageVersion |
arn:${Partition}:imagebuilder:${Region}:${Account}:image/${ImageName}/${ImageVersion}
|
|
| imageRecipe |
arn:${Partition}:imagebuilder:${Region}:${Account}:image-recipe/${ImageRecipeName}/${ImageRecipeVersion}
|
|
| containerRecipe |
arn:${Partition}:imagebuilder:${Region}:${Account}:container-recipe/${ContainerRecipeName}/${ContainerRecipeVersion}
|
|
| imagePipeline |
arn:${Partition}:imagebuilder:${Region}:${Account}:image-pipeline/${ImagePipelineName}
|
|
| infrastructureConfiguration |
arn:${Partition}:imagebuilder:${Region}:${Account}:infrastructure-configuration/${ResourceId}
|
|
| lifecycleExecution |
arn:${Partition}:imagebuilder:${Region}:${Account}:lifecycle-execution/${LifecycleExecutionId}
|
|
| lifecyclePolicy |
arn:${Partition}:imagebuilder:${Region}:${Account}:lifecycle-policy/${LifecyclePolicyName}
|
|
| workflow |
arn:${Partition}:imagebuilder:${Region}:${Account}:workflow/${WorkflowType}/${WorkflowName}/${WorkflowVersion}/${WorkflowBuildVersion}
|
|
| workflowExecution |
arn:${Partition}:imagebuilder:${Region}:${Account}:workflow-execution/${WorkflowExecutionId}
|
|
| workflowStepExecution |
arn:${Partition}:imagebuilder:${Region}:${Account}:workflow-step-execution/${WorkflowStepExecutionId}
|
|
| allComponentBuildVersions |
arn:${Partition}:imagebuilder:${Region}:${Account}:component/${ComponentName}/${ComponentVersion}/*
|
|
| allImageBuildVersions |
arn:${Partition}:imagebuilder:${Region}:${Account}:image/${ImageName}/${ImageVersion}/*
|
|
| allWorkflowBuildVersions |
arn:${Partition}:imagebuilder:${Region}:${Account}:workflow/${WorkflowType}/${WorkflowName}/${WorkflowVersion}/*
|
Amazon EC2 Image Builder 的條件索引鍵
Amazon EC2 Image Builder 定義下列條件金鑰，可用於 IAM 政策的 Condition 元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊，請參閱條件索引鍵表。
若要檢視所有 服務可用的全域條件索引鍵，請參閱AWS 全域條件內容索引鍵。
| 條件索引鍵 | 描述 | 類型 |
|---|---|---|
| aws:RequestTag/${TagKey} | 依請求中的標籤鍵值對是否存在篩選存取權 | 字串 |
| aws:ResourceTag/${TagKey} | 依連接到資源的標籤鍵值對篩選存取權 | 字串 |
| aws:TagKeys | 依請求中是否存在標籤索引鍵來篩選存取 | ArrayOfString |
| imagebuilder:CreatedResourceTag/${TagKey} | 根據連接至由 Image Builder 建立之資源的標籤鍵/值對來篩選存取 | 字串 |
| imagebuilder:CreatedResourceTagKeys | 依請求中是否存在標籤索引鍵來篩選存取 | ArrayOfString |
| imagebuilder:Ec2MetadataHttpTokens | 依請求中指定的 EC2 執行個體中繼資料 HTTP 字符要求篩選存取權 | String |
| imagebuilder:LifecyclePolicyResourceType | 依請求中指定的生命週期政策資源類型來篩選存取權 | String |
| imagebuilder:StatusTopicArn | 依請求中將發佈終端狀態通知的 SNS 主題 ARN 篩選存取權 | ARN |
