Actions, resources, and condition keys for Amazon EC2 Image Builder
Amazon EC2 Image Builder (service prefix: imagebuilder) provides the following
service-specific operations, resources, actions, and condition keys for use in IAM permission
policies.
References:
-
Learn how to configure this service.
-
View a list of the API operations available for this service.
-
Learn how to secure this service and its resources by using IAM permission policies.
-
View the programmatic service authorization reference
for this service.
Topics
API operations defined by Amazon EC2 Image Builder
The following table maps API operations to the IAM actions they authorize. Only condition keys that have static values for the given API and action are listed; for the full set of condition keys supported by each action, see the Actions table.
| Operation | IAM action | Condition key | Possible value(s) | Access level |
|---|---|---|---|---|
|
CancelImageCreation |
Write |
|||
|
CancelLifecycleExecution |
Write |
|||
|
CreateComponent |
Write |
|||
Tagging, Write |
||||
|
CreateContainerRecipe |
Write |
|||
Read |
||||
Read |
||||
Tagging, Write |
||||
|
CreateDistributionConfiguration |
Write |
|||
Tagging, Write |
||||
|
CreateImage |
Write |
|||
Read |
||||
Read |
||||
Read |
||||
Read |
||||
Read |
||||
Tagging, Write |
||||
iam:PassedToService |
imagebuilder.amazonaws.com |
Write |
||
|
CreateImagePipeline |
Write |
|||
Read |
||||
Read |
||||
Read |
||||
Read |
||||
Read |
||||
Tagging, Write |
||||
iam:PassedToService |
imagebuilder.amazonaws.com |
Write |
||
|
CreateImageRecipe |
Write |
|||
Read |
||||
Read |
||||
Tagging, Write |
||||
|
CreateInfrastructureConfiguration |
Write |
|||
Tagging, Write |
||||
Read |
||||
iam:PassedToService |
ec2.amazonaws.com |
Write |
||
|
CreateLifecyclePolicy |
Write |
|||
Tagging, Write |
||||
iam:PassedToService |
imagebuilder.amazonaws.com |
Write |
||
|
CreateWorkflow |
Write |
|||
Tagging, Write |
||||
|
DeleteComponent |
Write |
|||
|
DeleteContainerRecipe |
Write |
|||
|
DeleteDistributionConfiguration |
Write |
|||
|
DeleteImage |
Write |
|||
|
DeleteImagePipeline |
Write |
|||
|
DeleteImageRecipe |
Write |
|||
|
DeleteInfrastructureConfiguration |
Write |
|||
|
DeleteLifecyclePolicy |
Write |
|||
|
DeleteWorkflow |
Write |
|||
|
DistributeImage |
Write |
|||
Read |
||||
Read |
||||
iam:PassedToService |
imagebuilder.amazonaws.com |
Write |
||
|
GetComponent |
Read |
|||
|
GetComponentPolicy |
Read |
|||
|
GetContainerRecipe |
Read |
|||
|
GetContainerRecipePolicy |
Read |
|||
|
GetDistributionConfiguration |
Read |
|||
|
GetImage |
Read |
|||
|
GetImagePipeline |
Read |
|||
|
GetImagePolicy |
Read |
|||
|
GetImageRecipe |
Read |
|||
|
GetImageRecipePolicy |
Read |
|||
|
GetInfrastructureConfiguration |
Read |
|||
|
GetLifecycleExecution |
Read |
|||
|
GetLifecyclePolicy |
Read |
|||
|
GetMarketplaceResource |
Read |
|||
|
GetWorkflow |
Read |
|||
|
GetWorkflowExecution |
Read |
|||
|
GetWorkflowStepExecution |
Read |
|||
|
ImportDiskImage |
Read |
|||
Write |
||||
Tagging, Write |
||||
iam:PassedToService |
imagebuilder.amazonaws.com |
Write |
||
|
ImportVmImage |
Write |
|||
Tagging, Write |
||||
|
ListComponentBuildVersions |
List |
|||
|
ListComponents |
List |
|||
|
ListContainerRecipes |
List |
|||
|
ListDistributionConfigurations |
List |
|||
|
ListImageBuildVersions |
List |
|||
|
ListImagePackages |
List |
|||
|
ListImagePipelineImages |
List |
|||
|
ListImagePipelines |
List |
|||
|
ListImageRecipes |
List |
|||
|
ListImageScanFindingAggregations |
List |
|||
|
ListImageScanFindings |
List |
|||
|
ListImages |
List |
|||
|
ListInfrastructureConfigurations |
List |
|||
|
ListLifecycleExecutionResources |
List |
|||
|
ListLifecycleExecutions |
List |
|||
|
ListLifecyclePolicies |
List |
|||
|
ListTagsForResource |
Read |
|||
|
ListWaitingWorkflowSteps |
List |
|||
|
ListWorkflowBuildVersions |
List |
|||
|
ListWorkflowExecutions |
List |
|||
|
ListWorkflowStepExecutions |
List |
|||
|
ListWorkflows |
List |
|||
|
PutComponentPolicy |
Permissions management, Write |
|||
|
PutContainerRecipePolicy |
Permissions management, Write |
|||
|
PutImagePolicy |
Permissions management, Write |
|||
|
PutImageRecipePolicy |
Permissions management, Write |
|||
|
RetryImage |
Write |
|||
|
SendWorkflowStepAction |
Write |
|||
|
StartImagePipelineExecution |
Write |
|||
Tagging, Write |
||||
|
StartResourceStateUpdate |
Write |
|||
iam:PassedToService |
imagebuilder.amazonaws.com |
Write |
||
|
TagResource |
Tagging, Write |
|||
|
UntagResource |
Tagging, Write |
|||
|
UpdateDistributionConfiguration |
Write |
|||
iam:PassedToService |
vmie.amazonaws.com |
Write |
||
|
UpdateImagePipeline |
Read |
|||
Read |
||||
Read |
||||
Read |
||||
Read |
||||
Tagging, Write |
||||
Write |
||||
iam:PassedToService |
imagebuilder.amazonaws.com |
Write |
||
|
UpdateInfrastructureConfiguration |
Write |
|||
Read |
||||
iam:PassedToService |
ec2.amazonaws.com |
Write |
||
|
UpdateLifecyclePolicy |
Write |
|||
iam:PassedToService |
imagebuilder.amazonaws.com |
Write |
Actions defined by Amazon EC2 Image Builder
You can specify the following actions in the Action element of an IAM
policy statement. Use policies to grant permissions to perform an operation in Amazon. When
you use an action in a policy, you usually allow or deny access to the API operation or CLI
command with the same name. However, in some cases, a single action controls access to more
than one operation. Alternatively, some operations require several different actions.
| Actions | Description | Resource types (*required) | Condition keys | Access level |
|---|---|---|---|---|
Grants permission to cancel an image creation |
Write |
|||
Grants permission to cancel a lifecycle execution |
Write |
|||
Grants permission to create a new component |
Write |
|||
Grants permission to create a new Container Recipe |
Write |
|||
Grants permission to create a new distribution configuration |
Write |
|||
Grants permission to create a new image |
Write |
|||
Grants permission to create a new image pipeline |
Write |
|||
Grants permission to create a new Image Recipe |
Write |
|||
Grants permission to create a new infrastructure configuration |
imagebuilder:CreatedResourceTag/${TagKey} imagebuilder:CreatedResourceTagKeys |
Write |
||
Grants permission to create a new lifecycle policy |
Write |
|||
Grants permission to create a new workflow |
Write |
|||
Grants permission to delete a component |
Write |
|||
Grants permission to delete a container recipe |
Write |
|||
Grants permission to delete a distribution configuration |
Write |
|||
Grants permission to delete an image |
Write |
|||
Grants permission to delete an image pipeline |
Write |
|||
Grants permission to delete an image recipe |
Write |
|||
Grants permission to delete an infrastructure configuration |
Write |
|||
Grants permission to delete a lifecycle policy |
Write |
|||
Grants permission to delete a workflow |
Write |
|||
Grants permission to distribute an image |
Write |
|||
Grants permission to view details about a component |
Read |
|||
Grants permission to view the resource policy associated with a component |
Read |
|||
Grants permission to view details about a container recipe |
Read |
|||
Grants permission to view the resource policy associated with a container recipe |
Read |
|||
Grants permission to view details about a distribution configuration |
Read |
|||
Grants permission to view details about an image |
Read |
|||
Grants permission to view details about an image pipeline |
Read |
|||
Grants permission to view the resource policy associated with an image |
Read |
|||
Grants permission to view details about an image recipe |
Read |
|||
Grants permission to view the resource policy associated with an image recipe |
Read |
|||
Grants permission to view details about an infrastructure configuration |
Read |
|||
Grants permission to view details about a lifecycle execution |
Read |
|||
Grants permission to view details about a lifecycle policy |
Read |
|||
Grants permission to retrieve Marketplace provided resource |
Read |
|||
Grants permission to view details about a workflow |
Read |
|||
Grants permission to view details about a workflow execution |
Read |
|||
Grants permission to view details about a workflow step execution |
Read |
|||
Grants permission to import a new component |
Write |
|||
Grants permission to import a disk image |
Write |
|||
Grants permission to import an image |
Write |
|||
Grants permission to list the component build versions in your account |
List |
|||
Grants permission to list the component versions owned by or shared with your account |
List |
|||
Grants permission to list the container recipes owned by or shared with your account |
List |
|||
Grants permission to list the distribution configurations in your account |
List |
|||
Grants permission to list the image build versions in your account |
List |
|||
Grants permission to return a list of packages installed on the specified image |
List |
|||
Grants permission to return a list of images created by the specified pipeline |
List |
|||
Grants permission to list the image pipelines in your account |
List |
|||
Grants permission to list the image recipes owned by or shared with your account |
List |
|||
Grants permission to list aggregations on the image scan findings in your account |
List |
|||
Grants permission to list the image scan findings for the images in your account |
List |
|||
Grants permission to list the image versions owned by or shared with your account |
List |
|||
Grants permission to list the infrastructure configurations in your account |
List |
|||
Grants permission to list resources for the specified lifecycle execution |
List |
|||
Grants permission to list lifecycle executions for the specified resource |
List |
|||
Grants permission to list the lifecycle policies in your account |
List |
|||
Grants permission to list tags for an Image Builder resource |
Read |
|||
Grants permission to list waiting workflow steps for the caller account |
List |
|||
Grants permission to list the workflow build versions in your account |
List |
|||
Grants permission to list workflow executions for the specified image |
List |
|||
Grants permission to list workflow step executions for the specified workflow |
List |
|||
Grants permission to list the workflow versions owned by or shared with your account |
List |
|||
Grants permission to set the resource policy associated with a component |
Permissions management, Write |
|||
Grants permission to set the resource policy associated with a container recipe |
Permissions management, Write |
|||
Grants permission to set the resource policy associated with an image |
Permissions management, Write |
|||
Grants permission to set the resource policy associated with an image recipe |
Permissions management, Write |
|||
Grants permission to retry an image creation |
Write |
|||
Grants permission to send an action to a workflow step |
Write |
|||
Grants permission to create a new image from a pipeline |
Write |
|||
Grants permission to start a state update for the specified resource |
Write |
|||
Grants permission to tag an Image Builder resource |
Tagging, Write |
|||
Grants permission to untag an Image Builder resource |
Tagging, Write |
|||
Grants permission to update an existing distribution configuration |
Write |
|||
Grants permission to update an existing image pipeline |
Write |
|||
Grants permission to update an existing infrastructure configuration |
imagebuilder:CreatedResourceTag/${TagKey} imagebuilder:CreatedResourceTagKeys |
Write |
||
Grants permission to update an existing lifecycle policy |
Write |
Resource types defined by Amazon EC2 Image Builder
The following resource types are defined by this service and can be used in the
Resource element of IAM permission policy statements.
| Resource types | ARN | Condition keys |
|---|---|---|
arn:${Partition}:imagebuilder:${Region}:${Account}:component/${ComponentName}/${ComponentVersion}/* |
||
arn:${Partition}:imagebuilder:${Region}:${Account}:image/${ImageName}/${ImageVersion}/* |
||
arn:${Partition}:imagebuilder:${Region}:${Account}:workflow/${WorkflowType}/${WorkflowName}/${WorkflowVersion}/* |
||
arn:${Partition}:imagebuilder:${Region}:${Account}:component/${ComponentName}/${ComponentVersion}/${ComponentBuildVersion} |
||
arn:${Partition}:imagebuilder:${Region}:${Account}:container-recipe/${ContainerRecipeName}/${ContainerRecipeVersion} |
||
arn:${Partition}:imagebuilder:${Region}:${Account}:distribution-configuration/${DistributionConfigurationName} |
||
arn:${Partition}:imagebuilder:${Region}:${Account}:image/${ImageName}/${ImageVersion}/${ImageBuildVersion} |
||
arn:${Partition}:imagebuilder:${Region}:${Account}:image-pipeline/${ImagePipelineName} |
||
arn:${Partition}:imagebuilder:${Region}:${Account}:image-recipe/${ImageRecipeName}/${ImageRecipeVersion} |
||
arn:${Partition}:imagebuilder:${Region}:${Account}:image/${ImageName}/${ImageVersion} |
||
arn:${Partition}:imagebuilder:${Region}:${Account}:infrastructure-configuration/${ResourceId} |
||
arn:${Partition}:imagebuilder:${Region}:${Account}:lifecycle-execution/${LifecycleExecutionId} |
||
arn:${Partition}:imagebuilder:${Region}:${Account}:lifecycle-policy/${LifecyclePolicyName} |
||
arn:${Partition}:imagebuilder:${Region}:${Account}:workflow/${WorkflowType}/${WorkflowName}/${WorkflowVersion}/${WorkflowBuildVersion} |
||
arn:${Partition}:imagebuilder:${Region}:${Account}:workflow-execution/${WorkflowExecutionId} |
||
arn:${Partition}:imagebuilder:${Region}:${Account}:workflow-step-execution/${WorkflowStepExecutionId} |
Condition keys for Amazon EC2 Image Builder
Amazon EC2 Image Builder defines the following condition keys that can be used in the
Condition element of an IAM policy.
| Condition keys | Description | Type |
|---|---|---|
Filters access by the presence of tag key-value pairs in the request |
String |
|
Filters access by tag key-value pairs attached to the resource |
String |
|
Filters access by the presence of tag keys in the request |
ArrayOfString |
|
Filters access by the tag key-value pairs attached to the resource created by Image Builder |
String |
|
Filters access by the presence of tag keys in the request |
ArrayOfString |
|
Filters access by the EC2 Instance Metadata HTTP Token Requirement specified in the request |
String |
|
Filters access by the Lifecycle Policy Resource Type specified in the request |
String |
|
Filters access by the SNS Topic Arn in the request to which terminal state notifications will be published |
ARN |