{"files":{"SKILL.md":"---\nname: ec2-image-builder\ndescription: \"EC2 Image Builder API skill. Use when working with EC2 Image Builder for CancelImageCreation, CancelLifecycleExecution, CreateComponent. Covers 73 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# EC2 Image Builder\nAPI version: 2019-12-02\n\n## Auth\nAWS SigV4\n\n## Base URL\nNot specified.\n\n## Setup\n1. Configure auth: AWS SigV4\n2. GET /GetComponent -- gets a component object.\n3. POST /ListComponentBuildVersions -- create first ListComponentBuildVersion\n\n## Endpoints\n73 endpoints across 71 groups. See references/api-spec.lap for full details.\n\n### CancelImageCreation\n| Method | Path | Description |\n|--------|------|-------------|\n| PUT | /CancelImageCreation | CancelImageCreation cancels the creation of Image. This operation can only be used on images in a non-terminal state. |\n\n### CancelLifecycleExecution\n| Method | Path | Description |\n|--------|------|-------------|\n| PUT | /CancelLifecycleExecution | Cancel a specific image lifecycle policy runtime instance. |\n\n### CreateComponent\n| Method | Path | Description |\n|--------|------|-------------|\n| PUT | /CreateComponent | Creates a new component that can be used to build, validate, test, and assess your image. The component is based on a YAML document that you specify using exactly one of the following methods:   Inline, using the data property in the request body.   A URL that points to a YAML document file stored in Amazon S3, using the uri property in the request body. |\n\n### CreateContainerRecipe\n| Method | Path | Description |\n|--------|------|-------------|\n| PUT | /CreateContainerRecipe | Creates a new container recipe. Container recipes define how images are configured, tested, and assessed. |\n\n### CreateDistributionConfiguration\n| Method | Path | Description |\n|--------|------|-------------|\n| PUT | /CreateDistributionConfiguration | Creates a new distribution configuration. Distribution configurations define and configure the outputs of your pipeline. |\n\n### CreateImage\n| Method | Path | Description |\n|--------|------|-------------|\n| PUT | /CreateImage | Creates a new image. This request will create a new image along with all of the configured output resources defined in the distribution configuration. You must specify exactly one recipe for your image, using either a ContainerRecipeArn or an ImageRecipeArn. |\n\n### CreateImagePipeline\n| Method | Path | Description |\n|--------|------|-------------|\n| PUT | /CreateImagePipeline | Creates a new image pipeline. Image pipelines enable you to automate the creation and distribution of images. |\n\n### CreateImageRecipe\n| Method | Path | Description |\n|--------|------|-------------|\n| PUT | /CreateImageRecipe | Creates a new image recipe. Image recipes define how images are configured, tested, and assessed. |\n\n### CreateInfrastructureConfiguration\n| Method | Path | Description |\n|--------|------|-------------|\n| PUT | /CreateInfrastructureConfiguration | Creates a new infrastructure configuration. An infrastructure configuration defines the environment in which your image will be built and tested. |\n\n### CreateLifecyclePolicy\n| Method | Path | Description |\n|--------|------|-------------|\n| PUT | /CreateLifecyclePolicy | Create a lifecycle policy resource. |\n\n### CreateWorkflow\n| Method | Path | Description |\n|--------|------|-------------|\n| PUT | /CreateWorkflow | Create a new workflow or a new version of an existing workflow. |\n\n### DeleteComponent\n| Method | Path | Description |\n|--------|------|-------------|\n| DELETE | /DeleteComponent | Deletes a component build version. |\n\n### DeleteContainerRecipe\n| Method | Path | Description |\n|--------|------|-------------|\n| DELETE | /DeleteContainerRecipe | Deletes a container recipe. |\n\n### DeleteDistributionConfiguration\n| Method | Path | Description |\n|--------|------|-------------|\n| DELETE | /DeleteDistributionConfiguration | Deletes a distribution configuration. |\n\n### DeleteImage\n| Method | Path | Description |\n|--------|------|-------------|\n| DELETE | /DeleteImage | Deletes an Image Builder image resource. This does not delete any EC2 AMIs or ECR container images that are created during the image build process. You must clean those up separately, using the appropriate Amazon EC2 or Amazon ECR console actions, or API or CLI commands.   To deregister an EC2 Linux AMI, see Deregister your Linux AMI in the  Amazon EC2 User Guide .   To deregister an EC2 Windows AMI, see Deregister your Windows AMI in the  Amazon EC2 Windows Guide .   To delete a container image from Amazon ECR, see Deleting an image in the Amazon ECR User Guide. |\n\n### DeleteImagePipeline\n| Method | Path | Description |\n|--------|------|-------------|\n| DELETE | /DeleteImagePipeline | Deletes an image pipeline. |\n\n### DeleteImageRecipe\n| Method | Path | Description |\n|--------|------|-------------|\n| DELETE | /DeleteImageRecipe | Deletes an image recipe. |\n\n### DeleteInfrastructureConfiguration\n| Method | Path | Description |\n|--------|------|-------------|\n| DELETE | /DeleteInfrastructureConfiguration | Deletes an infrastructure configuration. |\n\n### DeleteLifecyclePolicy\n| Method | Path | Description |\n|--------|------|-------------|\n| DELETE | /DeleteLifecyclePolicy | Delete the specified lifecycle policy resource. |\n\n### DeleteWorkflow\n| Method | Path | Description |\n|--------|------|-------------|\n| DELETE | /DeleteWorkflow | Deletes a specific workflow resource. |\n\n### GetComponent\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /GetComponent | Gets a component object. |\n\n### GetComponentPolicy\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /GetComponentPolicy | Gets a component policy. |\n\n### GetContainerRecipe\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /GetContainerRecipe | Retrieves a container recipe. |\n\n### GetContainerRecipePolicy\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /GetContainerRecipePolicy | Retrieves the policy for a container recipe. |\n\n### GetDistributionConfiguration\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /GetDistributionConfiguration | Gets a distribution configuration. |\n\n### GetImage\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /GetImage | Gets an image. |\n\n### GetImagePipeline\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /GetImagePipeline | Gets an image pipeline. |\n\n### GetImagePolicy\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /GetImagePolicy | Gets an image policy. |\n\n### GetImageRecipe\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /GetImageRecipe | Gets an image recipe. |\n\n### GetImageRecipePolicy\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /GetImageRecipePolicy | Gets an image recipe policy. |\n\n### GetInfrastructureConfiguration\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /GetInfrastructureConfiguration | Gets an infrastructure configuration. |\n\n### GetLifecycleExecution\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /GetLifecycleExecution | Get the runtime information that was logged for a specific runtime instance of the lifecycle policy. |\n\n### GetLifecyclePolicy\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /GetLifecyclePolicy | Get details for the specified image lifecycle policy. |\n\n### GetWorkflow\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /GetWorkflow | Get a workflow resource object. |\n\n### GetWorkflowExecution\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /GetWorkflowExecution | Get the runtime information that was logged for a specific runtime instance of the workflow. |\n\n### GetWorkflowStepExecution\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /GetWorkflowStepExecution | Get the runtime information that was logged for a specific runtime instance of the workflow step. |\n\n### ImportComponent\n| Method | Path | Description |\n|--------|------|-------------|\n| PUT | /ImportComponent | Imports a component and transforms its data into a component document. |\n\n### ImportVmImage\n| Method | Path | Description |\n|--------|------|-------------|\n| PUT | /ImportVmImage | When you export your virtual machine (VM) from its virtualization environment, that process creates a set of one or more disk container files that act as snapshots of your VM’s environment, settings, and data. The Amazon EC2 API ImportImage action uses those files to import your VM and create an AMI. To import using the CLI command, see import-image  You can reference the task ID from the VM import to pull in the AMI that the import created as the base image for your Image Builder recipe. |\n\n### ListComponentBuildVersions\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /ListComponentBuildVersions | Returns the list of component build versions for the specified semantic version.  The semantic version has four nodes: ../. You can assign values for the first three, and can filter on all of them.  Filtering: With semantic versioning, you have the flexibility to use wildcards (x) to specify the most recent versions or nodes when selecting the base image or components for your recipe. When you use a wildcard in any node, all nodes to the right of the first wildcard must also be wildcards. |\n\n### ListComponents\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /ListComponents | Returns the list of components that can be filtered by name, or by using the listed filters to streamline results. Newly created components can take up to two minutes to appear in the ListComponents API Results.  The semantic version has four nodes: ../. You can assign values for the first three, and can filter on all of them.  Filtering: With semantic versioning, you have the flexibility to use wildcards (x) to specify the most recent versions or nodes when selecting the base image or components for your recipe. When you use a wildcard in any node, all nodes to the right of the first wildcard must also be wildcards. |\n\n### ListContainerRecipes\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /ListContainerRecipes | Returns a list of container recipes. |\n\n### ListDistributionConfigurations\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /ListDistributionConfigurations | Returns a list of distribution configurations. |\n\n### ListImageBuildVersions\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /ListImageBuildVersions | Returns a list of image build versions. |\n\n### ListImagePackages\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /ListImagePackages | List the Packages that are associated with an Image Build Version, as determined by Amazon Web Services Systems Manager Inventory at build time. |\n\n### ListImagePipelineImages\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /ListImagePipelineImages | Returns a list of images created by the specified pipeline. |\n\n### ListImagePipelines\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /ListImagePipelines | Returns a list of image pipelines. |\n\n### ListImageRecipes\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /ListImageRecipes | Returns a list of image recipes. |\n\n### ListImageScanFindingAggregations\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /ListImageScanFindingAggregations | Returns a list of image scan aggregations for your account. You can filter by the type of key that Image Builder uses to group results. For example, if you want to get a list of findings by severity level for one of your pipelines, you might specify your pipeline with the imagePipelineArn filter. If you don't specify a filter, Image Builder returns an aggregation for your account. To streamline results, you can use the following filters in your request:    accountId     imageBuildVersionArn     imagePipelineArn     vulnerabilityId |\n\n### ListImageScanFindings\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /ListImageScanFindings | Returns a list of image scan findings for your account. |\n\n### ListImages\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /ListImages | Returns the list of images that you have access to. Newly created images can take up to two minutes to appear in the ListImages API Results. |\n\n### ListInfrastructureConfigurations\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /ListInfrastructureConfigurations | Returns a list of infrastructure configurations. |\n\n### ListLifecycleExecutionResources\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /ListLifecycleExecutionResources | List resources that the runtime instance of the image lifecycle identified for lifecycle actions. |\n\n### ListLifecycleExecutions\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /ListLifecycleExecutions | Get the lifecycle runtime history for the specified resource. |\n\n### ListLifecyclePolicies\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /ListLifecyclePolicies | Get a list of lifecycle policies in your Amazon Web Services account. |\n\n### Tags\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /tags/{resourceArn} | Returns the list of tags for the specified resource. |\n| POST | /tags/{resourceArn} | Adds a tag to a resource. |\n| DELETE | /tags/{resourceArn} | Removes a tag from a resource. |\n\n### ListWaitingWorkflowSteps\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /ListWaitingWorkflowSteps | Get a list of workflow steps that are waiting for action for workflows in your Amazon Web Services account. |\n\n### ListWorkflowBuildVersions\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /ListWorkflowBuildVersions | Returns a list of build versions for a specific workflow resource. |\n\n### ListWorkflowExecutions\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /ListWorkflowExecutions | Returns a list of workflow runtime instance metadata objects for a specific image build version. |\n\n### ListWorkflowStepExecutions\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /ListWorkflowStepExecutions | Returns runtime data for each step in a runtime instance of the workflow that you specify in the request. |\n\n### ListWorkflows\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /ListWorkflows | Lists workflow build versions based on filtering parameters. |\n\n### PutComponentPolicy\n| Method | Path | Description |\n|--------|------|-------------|\n| PUT | /PutComponentPolicy | Applies a policy to a component. We recommend that you call the RAM API CreateResourceShare to share resources. If you call the Image Builder API PutComponentPolicy, you must also call the RAM API PromoteResourceShareCreatedFromPolicy in order for the resource to be visible to all principals with whom the resource is shared. |\n\n### PutContainerRecipePolicy\n| Method | Path | Description |\n|--------|------|-------------|\n| PUT | /PutContainerRecipePolicy | Applies a policy to a container image. We recommend that you call the RAM API CreateResourceShare (https://docs.aws.amazon.com//ram/latest/APIReference/API_CreateResourceShare.html) to share resources. If you call the Image Builder API PutContainerImagePolicy, you must also call the RAM API PromoteResourceShareCreatedFromPolicy (https://docs.aws.amazon.com//ram/latest/APIReference/API_PromoteResourceShareCreatedFromPolicy.html) in order for the resource to be visible to all principals with whom the resource is shared. |\n\n### PutImagePolicy\n| Method | Path | Description |\n|--------|------|-------------|\n| PUT | /PutImagePolicy | Applies a policy to an image. We recommend that you call the RAM API CreateResourceShare to share resources. If you call the Image Builder API PutImagePolicy, you must also call the RAM API PromoteResourceShareCreatedFromPolicy in order for the resource to be visible to all principals with whom the resource is shared. |\n\n### PutImageRecipePolicy\n| Method | Path | Description |\n|--------|------|-------------|\n| PUT | /PutImageRecipePolicy | Applies a policy to an image recipe. We recommend that you call the RAM API CreateResourceShare to share resources. If you call the Image Builder API PutImageRecipePolicy, you must also call the RAM API PromoteResourceShareCreatedFromPolicy in order for the resource to be visible to all principals with whom the resource is shared. |\n\n### SendWorkflowStepAction\n| Method | Path | Description |\n|--------|------|-------------|\n| PUT | /SendWorkflowStepAction | Pauses or resumes image creation when the associated workflow runs a WaitForAction step. |\n\n### StartImagePipelineExecution\n| Method | Path | Description |\n|--------|------|-------------|\n| PUT | /StartImagePipelineExecution | Manually triggers a pipeline to create an image. |\n\n### StartResourceStateUpdate\n| Method | Path | Description |\n|--------|------|-------------|\n| PUT | /StartResourceStateUpdate | Begin asynchronous resource state update for lifecycle changes to the specified image resources. |\n\n### UpdateDistributionConfiguration\n| Method | Path | Description |\n|--------|------|-------------|\n| PUT | /UpdateDistributionConfiguration | Updates a new distribution configuration. Distribution configurations define and configure the outputs of your pipeline. |\n\n### UpdateImagePipeline\n| Method | Path | Description |\n|--------|------|-------------|\n| PUT | /UpdateImagePipeline | Updates an image pipeline. Image pipelines enable you to automate the creation and distribution of images. You must specify exactly one recipe for your image, using either a containerRecipeArn or an imageRecipeArn.  UpdateImagePipeline does not support selective updates for the pipeline. You must specify all of the required properties in the update request, not just the properties that have changed. |\n\n### UpdateInfrastructureConfiguration\n| Method | Path | Description |\n|--------|------|-------------|\n| PUT | /UpdateInfrastructureConfiguration | Updates a new infrastructure configuration. An infrastructure configuration defines the environment in which your image will be built and tested. |\n\n### UpdateLifecyclePolicy\n| Method | Path | Description |\n|--------|------|-------------|\n| PUT | /UpdateLifecyclePolicy | Update the specified lifecycle policy. |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all GetComponent?\" -> GET /GetComponent\n- \"List all GetComponentPolicy?\" -> GET /GetComponentPolicy\n- \"List all GetContainerRecipe?\" -> GET /GetContainerRecipe\n- \"List all GetContainerRecipePolicy?\" -> GET /GetContainerRecipePolicy\n- \"List all GetDistributionConfiguration?\" -> GET /GetDistributionConfiguration\n- \"List all GetImage?\" -> GET /GetImage\n- \"List all GetImagePipeline?\" -> GET /GetImagePipeline\n- \"List all GetImagePolicy?\" -> GET /GetImagePolicy\n- \"List all GetImageRecipe?\" -> GET /GetImageRecipe\n- \"List all GetImageRecipePolicy?\" -> GET /GetImageRecipePolicy\n- \"List all GetInfrastructureConfiguration?\" -> GET /GetInfrastructureConfiguration\n- \"List all GetLifecycleExecution?\" -> GET /GetLifecycleExecution\n- \"List all GetLifecyclePolicy?\" -> GET /GetLifecyclePolicy\n- \"List all GetWorkflow?\" -> GET /GetWorkflow\n- \"List all GetWorkflowExecution?\" -> GET /GetWorkflowExecution\n- \"List all GetWorkflowStepExecution?\" -> GET /GetWorkflowStepExecution\n- \"Create a ListComponentBuildVersion?\" -> POST /ListComponentBuildVersions\n- \"Create a ListComponent?\" -> POST /ListComponents\n- \"Create a ListContainerRecipe?\" -> POST /ListContainerRecipes\n- \"Create a ListDistributionConfiguration?\" -> POST /ListDistributionConfigurations\n- \"Create a ListImageBuildVersion?\" -> POST /ListImageBuildVersions\n- \"Create a ListImagePackage?\" -> POST /ListImagePackages\n- \"Create a ListImagePipelineImage?\" -> POST /ListImagePipelineImages\n- \"Create a ListImagePipeline?\" -> POST /ListImagePipelines\n- \"Create a ListImageRecipe?\" -> POST /ListImageRecipes\n- \"Create a ListImageScanFindingAggregation?\" -> POST /ListImageScanFindingAggregations\n- \"Create a ListImageScanFinding?\" -> POST /ListImageScanFindings\n- \"Create a ListImage?\" -> POST /ListImages\n- \"Create a ListInfrastructureConfiguration?\" -> POST /ListInfrastructureConfigurations\n- \"Create a ListLifecycleExecutionResource?\" -> POST /ListLifecycleExecutionResources\n- \"Create a ListLifecycleExecution?\" -> POST /ListLifecycleExecutions\n- \"Create a ListLifecyclePolicy?\" -> POST /ListLifecyclePolicies\n- \"Get tag details?\" -> GET /tags/{resourceArn}\n- \"Create a ListWaitingWorkflowStep?\" -> POST /ListWaitingWorkflowSteps\n- \"Create a ListWorkflowBuildVersion?\" -> POST /ListWorkflowBuildVersions\n- \"Create a ListWorkflowExecution?\" -> POST /ListWorkflowExecutions\n- \"Create a ListWorkflowStepExecution?\" -> POST /ListWorkflowStepExecutions\n- \"Create a ListWorkflow?\" -> POST /ListWorkflows\n- \"Delete a tag?\" -> DELETE /tags/{resourceArn}\n- \"How to authenticate?\" -> See Auth section above\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Create/update endpoints return the modified resource on success\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api EC2 Image Builder\n@version 2019-12-02\n@auth AWS SigV4\n@endpoints 73\n@hint download_for_search\n@toc CancelImageCreation(1), CancelLifecycleExecution(1), CreateComponent(1), CreateContainerRecipe(1), CreateDistributionConfiguration(1), CreateImage(1), CreateImagePipeline(1), CreateImageRecipe(1), CreateInfrastructureConfiguration(1), CreateLifecyclePolicy(1), CreateWorkflow(1), DeleteComponent(1), DeleteContainerRecipe(1), DeleteDistributionConfiguration(1), DeleteImage(1), DeleteImagePipeline(1), DeleteImageRecipe(1), DeleteInfrastructureConfiguration(1), DeleteLifecyclePolicy(1), DeleteWorkflow(1), GetComponent(1), GetComponentPolicy(1), GetContainerRecipe(1), GetContainerRecipePolicy(1), GetDistributionConfiguration(1), GetImage(1), GetImagePipeline(1), GetImagePolicy(1), GetImageRecipe(1), GetImageRecipePolicy(1), GetInfrastructureConfiguration(1), GetLifecycleExecution(1), GetLifecyclePolicy(1), GetWorkflow(1), GetWorkflowExecution(1), GetWorkflowStepExecution(1), ImportComponent(1), ImportVmImage(1), ListComponentBuildVersions(1), ListComponents(1), ListContainerRecipes(1), ListDistributionConfigurations(1), ListImageBuildVersions(1), ListImagePackages(1), ListImagePipelineImages(1), ListImagePipelines(1), ListImageRecipes(1), ListImageScanFindingAggregations(1), ListImageScanFindings(1), ListImages(1), ListInfrastructureConfigurations(1), ListLifecycleExecutionResources(1), ListLifecycleExecutions(1), ListLifecyclePolicies(1), tags(3), ListWaitingWorkflowSteps(1), ListWorkflowBuildVersions(1), ListWorkflowExecutions(1), ListWorkflowStepExecutions(1), ListWorkflows(1), PutComponentPolicy(1), PutContainerRecipePolicy(1), PutImagePolicy(1), PutImageRecipePolicy(1), SendWorkflowStepAction(1), StartImagePipelineExecution(1), StartResourceStateUpdate(1), UpdateDistributionConfiguration(1), UpdateImagePipeline(1), UpdateInfrastructureConfiguration(1), UpdateLifecyclePolicy(1)\n\n@group CancelImageCreation\n@endpoint PUT /CancelImageCreation\n@desc CancelImageCreation cancels the creation of Image. This operation can only be used on images in a non-terminal state.\n@required {imageBuildVersionArn: str, clientToken: str}\n@returns(200) {requestId: str?, clientToken: str?, imageBuildVersionArn: str?}\n\n@endgroup\n\n@group CancelLifecycleExecution\n@endpoint PUT /CancelLifecycleExecution\n@desc Cancel a specific image lifecycle policy runtime instance.\n@required {lifecycleExecutionId: str, clientToken: str}\n@returns(200) {lifecycleExecutionId: str?}\n\n@endgroup\n\n@group CreateComponent\n@endpoint PUT /CreateComponent\n@desc Creates a new component that can be used to build, validate, test, and assess your image. The component is based on a YAML document that you specify using exactly one of the following methods:   Inline, using the data property in the request body.   A URL that points to a YAML document file stored in Amazon S3, using the uri property in the request body.\n@required {name: str, semanticVersion: str, platform: str, clientToken: str}\n@optional {description: str, changeDescription: str, supportedOsVersions: [str], data: str, uri: str, kmsKeyId: str, tags: map<str,str>}\n@returns(200) {requestId: str?, clientToken: str?, componentBuildVersionArn: str?}\n\n@endgroup\n\n@group CreateContainerRecipe\n@endpoint PUT /CreateContainerRecipe\n@desc Creates a new container recipe. Container recipes define how images are configured, tested, and assessed.\n@required {containerType: str, name: str, semanticVersion: str, components: [ComponentConfiguration], parentImage: str, targetRepository: TargetContainerRepository, clientToken: str}\n@optional {description: str, instanceConfiguration: InstanceConfiguration, dockerfileTemplateData: str, dockerfileTemplateUri: str, platformOverride: str, imageOsVersionOverride: str, tags: map<str,str>, workingDirectory: str, kmsKeyId: str}\n@returns(200) {requestId: str?, clientToken: str?, containerRecipeArn: str?}\n\n@endgroup\n\n@group CreateDistributionConfiguration\n@endpoint PUT /CreateDistributionConfiguration\n@desc Creates a new distribution configuration. Distribution configurations define and configure the outputs of your pipeline.\n@required {name: str, distributions: [Distribution], clientToken: str}\n@optional {description: str, tags: map<str,str>}\n@returns(200) {requestId: str?, clientToken: str?, distributionConfigurationArn: str?}\n\n@endgroup\n\n@group CreateImage\n@endpoint PUT /CreateImage\n@desc Creates a new image. This request will create a new image along with all of the configured output resources defined in the distribution configuration. You must specify exactly one recipe for your image, using either a ContainerRecipeArn or an ImageRecipeArn.\n@required {infrastructureConfigurationArn: str, clientToken: str}\n@optional {imageRecipeArn: str, containerRecipeArn: str, distributionConfigurationArn: str, imageTestsConfiguration: ImageTestsConfiguration, enhancedImageMetadataEnabled: bool, tags: map<str,str>, imageScanningConfiguration: ImageScanningConfiguration, workflows: [WorkflowConfiguration], executionRole: str}\n@returns(200) {requestId: str?, clientToken: str?, imageBuildVersionArn: str?}\n\n@endgroup\n\n@group CreateImagePipeline\n@endpoint PUT /CreateImagePipeline\n@desc Creates a new image pipeline. Image pipelines enable you to automate the creation and distribution of images.\n@required {name: str, infrastructureConfigurationArn: str, clientToken: str}\n@optional {description: str, imageRecipeArn: str, containerRecipeArn: str, distributionConfigurationArn: str, imageTestsConfiguration: ImageTestsConfiguration, enhancedImageMetadataEnabled: bool, schedule: Schedule, status: str, tags: map<str,str>, imageScanningConfiguration: ImageScanningConfiguration, workflows: [WorkflowConfiguration], executionRole: str}\n@returns(200) {requestId: str?, clientToken: str?, imagePipelineArn: str?}\n\n@endgroup\n\n@group CreateImageRecipe\n@endpoint PUT /CreateImageRecipe\n@desc Creates a new image recipe. Image recipes define how images are configured, tested, and assessed.\n@required {name: str, semanticVersion: str, components: [ComponentConfiguration], parentImage: str, clientToken: str}\n@optional {description: str, blockDeviceMappings: [InstanceBlockDeviceMapping], tags: map<str,str>, workingDirectory: str, additionalInstanceConfiguration: AdditionalInstanceConfiguration}\n@returns(200) {requestId: str?, clientToken: str?, imageRecipeArn: str?}\n\n@endgroup\n\n@group CreateInfrastructureConfiguration\n@endpoint PUT /CreateInfrastructureConfiguration\n@desc Creates a new infrastructure configuration. An infrastructure configuration defines the environment in which your image will be built and tested.\n@required {name: str, instanceProfileName: str, clientToken: str}\n@optional {description: str, instanceTypes: [str], securityGroupIds: [str], subnetId: str, logging: Logging, keyPair: str, terminateInstanceOnFailure: bool, snsTopicArn: str, resourceTags: map<str,str>, instanceMetadataOptions: InstanceMetadataOptions, tags: map<str,str>}\n@returns(200) {requestId: str?, clientToken: str?, infrastructureConfigurationArn: str?}\n\n@endgroup\n\n@group CreateLifecyclePolicy\n@endpoint PUT /CreateLifecyclePolicy\n@desc Create a lifecycle policy resource.\n@required {name: str, executionRole: str, resourceType: str, policyDetails: [LifecyclePolicyDetail], resourceSelection: LifecyclePolicyResourceSelection, clientToken: str}\n@optional {description: str, status: str, tags: map<str,str>}\n@returns(200) {clientToken: str?, lifecyclePolicyArn: str?}\n\n@endgroup\n\n@group CreateWorkflow\n@endpoint PUT /CreateWorkflow\n@desc Create a new workflow or a new version of an existing workflow.\n@required {name: str, semanticVersion: str, clientToken: str, type: str}\n@optional {description: str, changeDescription: str, data: str, uri: str, kmsKeyId: str, tags: map<str,str>}\n@returns(200) {clientToken: str?, workflowBuildVersionArn: str?}\n\n@endgroup\n\n@group DeleteComponent\n@endpoint DELETE /DeleteComponent\n@desc Deletes a component build version.\n@required {componentBuildVersionArn: str}\n@returns(200) {requestId: str?, componentBuildVersionArn: str?}\n\n@endgroup\n\n@group DeleteContainerRecipe\n@endpoint DELETE /DeleteContainerRecipe\n@desc Deletes a container recipe.\n@required {containerRecipeArn: str}\n@returns(200) {requestId: str?, containerRecipeArn: str?}\n\n@endgroup\n\n@group DeleteDistributionConfiguration\n@endpoint DELETE /DeleteDistributionConfiguration\n@desc Deletes a distribution configuration.\n@required {distributionConfigurationArn: str}\n@returns(200) {requestId: str?, distributionConfigurationArn: str?}\n\n@endgroup\n\n@group DeleteImage\n@endpoint DELETE /DeleteImage\n@desc Deletes an Image Builder image resource. This does not delete any EC2 AMIs or ECR container images that are created during the image build process. You must clean those up separately, using the appropriate Amazon EC2 or Amazon ECR console actions, or API or CLI commands.   To deregister an EC2 Linux AMI, see Deregister your Linux AMI in the  Amazon EC2 User Guide .   To deregister an EC2 Windows AMI, see Deregister your Windows AMI in the  Amazon EC2 Windows Guide .   To delete a container image from Amazon ECR, see Deleting an image in the Amazon ECR User Guide.\n@required {imageBuildVersionArn: str}\n@returns(200) {requestId: str?, imageBuildVersionArn: str?}\n\n@endgroup\n\n@group DeleteImagePipeline\n@endpoint DELETE /DeleteImagePipeline\n@desc Deletes an image pipeline.\n@required {imagePipelineArn: str}\n@returns(200) {requestId: str?, imagePipelineArn: str?}\n\n@endgroup\n\n@group DeleteImageRecipe\n@endpoint DELETE /DeleteImageRecipe\n@desc Deletes an image recipe.\n@required {imageRecipeArn: str}\n@returns(200) {requestId: str?, imageRecipeArn: str?}\n\n@endgroup\n\n@group DeleteInfrastructureConfiguration\n@endpoint DELETE /DeleteInfrastructureConfiguration\n@desc Deletes an infrastructure configuration.\n@required {infrastructureConfigurationArn: str}\n@returns(200) {requestId: str?, infrastructureConfigurationArn: str?}\n\n@endgroup\n\n@group DeleteLifecyclePolicy\n@endpoint DELETE /DeleteLifecyclePolicy\n@desc Delete the specified lifecycle policy resource.\n@required {lifecyclePolicyArn: str}\n@returns(200) {lifecyclePolicyArn: str?}\n\n@endgroup\n\n@group DeleteWorkflow\n@endpoint DELETE /DeleteWorkflow\n@desc Deletes a specific workflow resource.\n@required {workflowBuildVersionArn: str}\n@returns(200) {workflowBuildVersionArn: str?}\n\n@endgroup\n\n@group GetComponent\n@endpoint GET /GetComponent\n@desc Gets a component object.\n@required {componentBuildVersionArn: str}\n@returns(200) {requestId: str?, component: Component?{arn: str?, name: str?, version: str?, description: str?, changeDescription: str?, type: str?, platform: str?, supportedOsVersions: [str]?, state: ComponentState?{status: str?, reason: str?}, parameters: [ComponentParameterDetail]?, owner: str?, data: str?, kmsKeyId: str?, encrypted: bool?, dateCreated: str?, tags: map<str, str>?: any, publisher: str?, obfuscate: bool?}}\n\n@endgroup\n\n@group GetComponentPolicy\n@endpoint GET /GetComponentPolicy\n@desc Gets a component policy.\n@required {componentArn: str}\n@returns(200) {requestId: str?, policy: str?}\n\n@endgroup\n\n@group GetContainerRecipe\n@endpoint GET /GetContainerRecipe\n@desc Retrieves a container recipe.\n@required {containerRecipeArn: str}\n@returns(200) {requestId: str?, containerRecipe: ContainerRecipe?{arn: str?, containerType: str?, name: str?, description: str?, platform: str?, owner: str?, version: str?, components: [ComponentConfiguration]?, instanceConfiguration: InstanceConfiguration?{image: str?, blockDeviceMappings: [InstanceBlockDeviceMapping]?}, dockerfileTemplateData: str?, kmsKeyId: str?, encrypted: bool?, parentImage: str?, dateCreated: str?, tags: map<str, str>?: any, workingDirectory: str?, targetRepository: TargetContainerRepository?{service: str, repositoryName: str}}}\n\n@endgroup\n\n@group GetContainerRecipePolicy\n@endpoint GET /GetContainerRecipePolicy\n@desc Retrieves the policy for a container recipe.\n@required {containerRecipeArn: str}\n@returns(200) {requestId: str?, policy: str?}\n\n@endgroup\n\n@group GetDistributionConfiguration\n@endpoint GET /GetDistributionConfiguration\n@desc Gets a distribution configuration.\n@required {distributionConfigurationArn: str}\n@returns(200) {requestId: str?, distributionConfiguration: DistributionConfiguration?{arn: str?, name: str?, description: str?, distributions: [Distribution]?, timeoutMinutes: int, dateCreated: str?, dateUpdated: str?, tags: map<str, str>?: any}}\n\n@endgroup\n\n@group GetImage\n@endpoint GET /GetImage\n@desc Gets an image.\n@required {imageBuildVersionArn: str}\n@returns(200) {requestId: str?, image: Image?{arn: str?, type: str?, name: str?, version: str?, platform: str?, enhancedImageMetadataEnabled: bool?, osVersion: str?, state: ImageState?{status: str?, reason: str?}, imageRecipe: ImageRecipe?{arn: str?, type: str?, name: str?, description: str?, platform: str?, owner: str?, version: str?, components: [ComponentConfiguration]?, parentImage: str?, blockDeviceMappings: [InstanceBlockDeviceMapping]?, dateCreated: str?, tags: map<str, str>?: any, workingDirectory: str?, additionalInstanceConfiguration: AdditionalInstanceConfiguration?{systemsManagerAgent: SystemsManagerAgent?, userDataOverride: str?}}, containerRecipe: ContainerRecipe?{arn: str?, containerType: str?, name: str?, description: str?, platform: str?, owner: str?, version: str?, components: [ComponentConfiguration]?, instanceConfiguration: InstanceConfiguration?{image: str?, blockDeviceMappings: [InstanceBlockDeviceMapping]?}, dockerfileTemplateData: str?, kmsKeyId: str?, encrypted: bool?, parentImage: str?, dateCreated: str?, tags: map<str, str>?: any, workingDirectory: str?, targetRepository: TargetContainerRepository?{service: str, repositoryName: str}}, sourcePipelineName: str?, sourcePipelineArn: str?, infrastructureConfiguration: InfrastructureConfiguration?{arn: str?, name: str?, description: str?, instanceTypes: [str]?, instanceProfileName: str?, securityGroupIds: [str]?, subnetId: str?, logging: Logging?{s3Logs: S3Logs?}, keyPair: str?, terminateInstanceOnFailure: bool?, snsTopicArn: str?, dateCreated: str?, dateUpdated: str?, resourceTags: map<str, str>?: any, instanceMetadataOptions: InstanceMetadataOptions?{httpTokens: str?, httpPutResponseHopLimit: int?}, tags: map<str, str>?: any}, distributionConfiguration: DistributionConfiguration?{arn: str?, name: str?, description: str?, distributions: [Distribution]?, timeoutMinutes: int, dateCreated: str?, dateUpdated: str?, tags: map<str, str>?: any}, imageTestsConfiguration: ImageTestsConfiguration?{imageTestsEnabled: bool?, timeoutMinutes: int?}, dateCreated: str?, outputResources: OutputResources?{amis: [Ami]?, containers: [Container]?}, tags: map<str, str>?: any, buildType: str?, imageSource: str?, scanState: ImageScanState?{status: str?, reason: str?}, imageScanningConfiguration: ImageScanningConfiguration?{imageScanningEnabled: bool?, ecrConfiguration: EcrConfiguration?{repositoryName: str?, containerTags: [str]?}}, deprecationTime: str(timestamp)?, lifecycleExecutionId: str?, executionRole: str?, workflows: [WorkflowConfiguration]?}}\n\n@endgroup\n\n@group GetImagePipeline\n@endpoint GET /GetImagePipeline\n@desc Gets an image pipeline.\n@required {imagePipelineArn: str}\n@returns(200) {requestId: str?, imagePipeline: ImagePipeline?{arn: str?, name: str?, description: str?, platform: str?, enhancedImageMetadataEnabled: bool?, imageRecipeArn: str?, containerRecipeArn: str?, infrastructureConfigurationArn: str?, distributionConfigurationArn: str?, imageTestsConfiguration: ImageTestsConfiguration?{imageTestsEnabled: bool?, timeoutMinutes: int?}, schedule: Schedule?{scheduleExpression: str?, timezone: str?, pipelineExecutionStartCondition: str?}, status: str?, dateCreated: str?, dateUpdated: str?, dateLastRun: str?, dateNextRun: str?, tags: map<str, str>?: any, imageScanningConfiguration: ImageScanningConfiguration?{imageScanningEnabled: bool?, ecrConfiguration: EcrConfiguration?{repositoryName: str?, containerTags: [str]?}}, executionRole: str?, workflows: [WorkflowConfiguration]?}}\n\n@endgroup\n\n@group GetImagePolicy\n@endpoint GET /GetImagePolicy\n@desc Gets an image policy.\n@required {imageArn: str}\n@returns(200) {requestId: str?, policy: str?}\n\n@endgroup\n\n@group GetImageRecipe\n@endpoint GET /GetImageRecipe\n@desc Gets an image recipe.\n@required {imageRecipeArn: str}\n@returns(200) {requestId: str?, imageRecipe: ImageRecipe?{arn: str?, type: str?, name: str?, description: str?, platform: str?, owner: str?, version: str?, components: [ComponentConfiguration]?, parentImage: str?, blockDeviceMappings: [InstanceBlockDeviceMapping]?, dateCreated: str?, tags: map<str, str>?: any, workingDirectory: str?, additionalInstanceConfiguration: AdditionalInstanceConfiguration?{systemsManagerAgent: SystemsManagerAgent?{uninstallAfterBuild: bool?}, userDataOverride: str?}}}\n\n@endgroup\n\n@group GetImageRecipePolicy\n@endpoint GET /GetImageRecipePolicy\n@desc Gets an image recipe policy.\n@required {imageRecipeArn: str}\n@returns(200) {requestId: str?, policy: str?}\n\n@endgroup\n\n@group GetInfrastructureConfiguration\n@endpoint GET /GetInfrastructureConfiguration\n@desc Gets an infrastructure configuration.\n@required {infrastructureConfigurationArn: str}\n@returns(200) {requestId: str?, infrastructureConfiguration: InfrastructureConfiguration?{arn: str?, name: str?, description: str?, instanceTypes: [str]?, instanceProfileName: str?, securityGroupIds: [str]?, subnetId: str?, logging: Logging?{s3Logs: S3Logs?{s3BucketName: str?, s3KeyPrefix: str?}}, keyPair: str?, terminateInstanceOnFailure: bool?, snsTopicArn: str?, dateCreated: str?, dateUpdated: str?, resourceTags: map<str, str>?: any, instanceMetadataOptions: InstanceMetadataOptions?{httpTokens: str?, httpPutResponseHopLimit: int?}, tags: map<str, str>?: any}}\n\n@endgroup\n\n@group GetLifecycleExecution\n@endpoint GET /GetLifecycleExecution\n@desc Get the runtime information that was logged for a specific runtime instance of the lifecycle policy.\n@required {lifecycleExecutionId: str}\n@returns(200) {lifecycleExecution: LifecycleExecution?{lifecycleExecutionId: str?, lifecyclePolicyArn: str?, resourcesImpactedSummary: LifecycleExecutionResourcesImpactedSummary?{hasImpactedResources: bool?}, state: LifecycleExecutionState?{status: str?, reason: str?}, startTime: str(timestamp)?, endTime: str(timestamp)?}}\n\n@endgroup\n\n@group GetLifecyclePolicy\n@endpoint GET /GetLifecyclePolicy\n@desc Get details for the specified image lifecycle policy.\n@required {lifecyclePolicyArn: str}\n@returns(200) {lifecyclePolicy: LifecyclePolicy?{arn: str?, name: str?, description: str?, status: str?, executionRole: str?, resourceType: str?, policyDetails: [LifecyclePolicyDetail]?, resourceSelection: LifecyclePolicyResourceSelection?{recipes: [LifecyclePolicyResourceSelectionRecipe]?, tagMap: map<str, str>?: any}, dateCreated: str(timestamp)?, dateUpdated: str(timestamp)?, dateLastRun: str(timestamp)?, tags: map<str, str>?: any}}\n\n@endgroup\n\n@group GetWorkflow\n@endpoint GET /GetWorkflow\n@desc Get a workflow resource object.\n@required {workflowBuildVersionArn: str}\n@returns(200) {workflow: Workflow?{arn: str?, name: str?, version: str?, description: str?, changeDescription: str?, type: str?, state: WorkflowState?{status: str?, reason: str?}, owner: str?, data: str?, kmsKeyId: str?, dateCreated: str?, tags: map<str, str>?: any, parameters: [WorkflowParameterDetail]?}}\n\n@endgroup\n\n@group GetWorkflowExecution\n@endpoint GET /GetWorkflowExecution\n@desc Get the runtime information that was logged for a specific runtime instance of the workflow.\n@required {workflowExecutionId: str}\n@returns(200) {requestId: str?, workflowBuildVersionArn: str?, workflowExecutionId: str?, imageBuildVersionArn: str?, type: str?, status: str?, message: str?, totalStepCount: int?, totalStepsSucceeded: int?, totalStepsFailed: int?, totalStepsSkipped: int?, startTime: str?, endTime: str?, parallelGroup: str?}\n\n@endgroup\n\n@group GetWorkflowStepExecution\n@endpoint GET /GetWorkflowStepExecution\n@desc Get the runtime information that was logged for a specific runtime instance of the workflow step.\n@required {stepExecutionId: str}\n@returns(200) {requestId: str?, stepExecutionId: str?, workflowBuildVersionArn: str?, workflowExecutionId: str?, imageBuildVersionArn: str?, name: str?, description: str?, action: str?, status: str?, rollbackStatus: str?, message: str?, inputs: str?, outputs: str?, startTime: str?, endTime: str?, onFailure: str?, timeoutSeconds: int?}\n\n@endgroup\n\n@group ImportComponent\n@endpoint PUT /ImportComponent\n@desc Imports a component and transforms its data into a component document.\n@required {name: str, semanticVersion: str, type: str, format: str, platform: str, clientToken: str}\n@optional {description: str, changeDescription: str, data: str, uri: str, kmsKeyId: str, tags: map<str,str>}\n@returns(200) {requestId: str?, clientToken: str?, componentBuildVersionArn: str?}\n\n@endgroup\n\n@group ImportVmImage\n@endpoint PUT /ImportVmImage\n@desc When you export your virtual machine (VM) from its virtualization environment, that process creates a set of one or more disk container files that act as snapshots of your VM’s environment, settings, and data. The Amazon EC2 API ImportImage action uses those files to import your VM and create an AMI. To import using the CLI command, see import-image  You can reference the task ID from the VM import to pull in the AMI that the import created as the base image for your Image Builder recipe.\n@required {name: str, semanticVersion: str, platform: str, vmImportTaskId: str, clientToken: str}\n@optional {description: str, osVersion: str, tags: map<str,str>}\n@returns(200) {requestId: str?, imageArn: str?, clientToken: str?}\n\n@endgroup\n\n@group ListComponentBuildVersions\n@endpoint POST /ListComponentBuildVersions\n@desc Returns the list of component build versions for the specified semantic version.  The semantic version has four nodes: ../. You can assign values for the first three, and can filter on all of them.  Filtering: With semantic versioning, you have the flexibility to use wildcards (x) to specify the most recent versions or nodes when selecting the base image or components for your recipe. When you use a wildcard in any node, all nodes to the right of the first wildcard must also be wildcards.\n@required {componentVersionArn: str}\n@optional {maxResults: int, nextToken: str}\n@returns(200) {requestId: str?, componentSummaryList: [ComponentSummary]?, nextToken: str?}\n\n@endgroup\n\n@group ListComponents\n@endpoint POST /ListComponents\n@desc Returns the list of components that can be filtered by name, or by using the listed filters to streamline results. Newly created components can take up to two minutes to appear in the ListComponents API Results.  The semantic version has four nodes: ../. You can assign values for the first three, and can filter on all of them.  Filtering: With semantic versioning, you have the flexibility to use wildcards (x) to specify the most recent versions or nodes when selecting the base image or components for your recipe. When you use a wildcard in any node, all nodes to the right of the first wildcard must also be wildcards.\n@optional {owner: str, filters: [Filter], byName: bool, maxResults: int, nextToken: str}\n@returns(200) {requestId: str?, componentVersionList: [ComponentVersion]?, nextToken: str?}\n\n@endgroup\n\n@group ListContainerRecipes\n@endpoint POST /ListContainerRecipes\n@desc Returns a list of container recipes.\n@optional {owner: str, filters: [Filter], maxResults: int, nextToken: str}\n@returns(200) {requestId: str?, containerRecipeSummaryList: [ContainerRecipeSummary]?, nextToken: str?}\n\n@endgroup\n\n@group ListDistributionConfigurations\n@endpoint POST /ListDistributionConfigurations\n@desc Returns a list of distribution configurations.\n@optional {filters: [Filter], maxResults: int, nextToken: str}\n@returns(200) {requestId: str?, distributionConfigurationSummaryList: [DistributionConfigurationSummary]?, nextToken: str?}\n\n@endgroup\n\n@group ListImageBuildVersions\n@endpoint POST /ListImageBuildVersions\n@desc Returns a list of image build versions.\n@required {imageVersionArn: str}\n@optional {filters: [Filter], maxResults: int, nextToken: str}\n@returns(200) {requestId: str?, imageSummaryList: [ImageSummary]?, nextToken: str?}\n\n@endgroup\n\n@group ListImagePackages\n@endpoint POST /ListImagePackages\n@desc List the Packages that are associated with an Image Build Version, as determined by Amazon Web Services Systems Manager Inventory at build time.\n@required {imageBuildVersionArn: str}\n@optional {maxResults: int, nextToken: str}\n@returns(200) {requestId: str?, imagePackageList: [ImagePackage]?, nextToken: str?}\n\n@endgroup\n\n@group ListImagePipelineImages\n@endpoint POST /ListImagePipelineImages\n@desc Returns a list of images created by the specified pipeline.\n@required {imagePipelineArn: str}\n@optional {filters: [Filter], maxResults: int, nextToken: str}\n@returns(200) {requestId: str?, imageSummaryList: [ImageSummary]?, nextToken: str?}\n\n@endgroup\n\n@group ListImagePipelines\n@endpoint POST /ListImagePipelines\n@desc Returns a list of image pipelines.\n@optional {filters: [Filter], maxResults: int, nextToken: str}\n@returns(200) {requestId: str?, imagePipelineList: [ImagePipeline]?, nextToken: str?}\n\n@endgroup\n\n@group ListImageRecipes\n@endpoint POST /ListImageRecipes\n@desc Returns a list of image recipes.\n@optional {owner: str, filters: [Filter], maxResults: int, nextToken: str}\n@returns(200) {requestId: str?, imageRecipeSummaryList: [ImageRecipeSummary]?, nextToken: str?}\n\n@endgroup\n\n@group ListImageScanFindingAggregations\n@endpoint POST /ListImageScanFindingAggregations\n@desc Returns a list of image scan aggregations for your account. You can filter by the type of key that Image Builder uses to group results. For example, if you want to get a list of findings by severity level for one of your pipelines, you might specify your pipeline with the imagePipelineArn filter. If you don't specify a filter, Image Builder returns an aggregation for your account. To streamline results, you can use the following filters in your request:    accountId     imageBuildVersionArn     imagePipelineArn     vulnerabilityId\n@optional {filter: Filter, nextToken: str}\n@returns(200) {requestId: str?, aggregationType: str?, responses: [ImageScanFindingAggregation]?, nextToken: str?}\n\n@endgroup\n\n@group ListImageScanFindings\n@endpoint POST /ListImageScanFindings\n@desc Returns a list of image scan findings for your account.\n@optional {filters: [ImageScanFindingsFilter], maxResults: int, nextToken: str}\n@returns(200) {requestId: str?, findings: [ImageScanFinding]?, nextToken: str?}\n\n@endgroup\n\n@group ListImages\n@endpoint POST /ListImages\n@desc Returns the list of images that you have access to. Newly created images can take up to two minutes to appear in the ListImages API Results.\n@optional {owner: str, filters: [Filter], byName: bool, maxResults: int, nextToken: str, includeDeprecated: bool}\n@returns(200) {requestId: str?, imageVersionList: [ImageVersion]?, nextToken: str?}\n\n@endgroup\n\n@group ListInfrastructureConfigurations\n@endpoint POST /ListInfrastructureConfigurations\n@desc Returns a list of infrastructure configurations.\n@optional {filters: [Filter], maxResults: int, nextToken: str}\n@returns(200) {requestId: str?, infrastructureConfigurationSummaryList: [InfrastructureConfigurationSummary]?, nextToken: str?}\n\n@endgroup\n\n@group ListLifecycleExecutionResources\n@endpoint POST /ListLifecycleExecutionResources\n@desc List resources that the runtime instance of the image lifecycle identified for lifecycle actions.\n@required {lifecycleExecutionId: str}\n@optional {parentResourceId: str, maxResults: int, nextToken: str}\n@returns(200) {lifecycleExecutionId: str?, lifecycleExecutionState: LifecycleExecutionState?{status: str?, reason: str?}, resources: [LifecycleExecutionResource]?, nextToken: str?}\n\n@endgroup\n\n@group ListLifecycleExecutions\n@endpoint POST /ListLifecycleExecutions\n@desc Get the lifecycle runtime history for the specified resource.\n@required {resourceArn: str}\n@optional {maxResults: int, nextToken: str}\n@returns(200) {lifecycleExecutions: [LifecycleExecution]?, nextToken: str?}\n\n@endgroup\n\n@group ListLifecyclePolicies\n@endpoint POST /ListLifecyclePolicies\n@desc Get a list of lifecycle policies in your Amazon Web Services account.\n@optional {filters: [Filter], maxResults: int, nextToken: str}\n@returns(200) {lifecyclePolicySummaryList: [LifecyclePolicySummary]?, nextToken: str?}\n\n@endgroup\n\n@group tags\n@endpoint GET /tags/{resourceArn}\n@desc Returns the list of tags for the specified resource.\n@required {resourceArn: str}\n@returns(200) {tags: map<str,str>?}\n\n@endgroup\n\n@group ListWaitingWorkflowSteps\n@endpoint POST /ListWaitingWorkflowSteps\n@desc Get a list of workflow steps that are waiting for action for workflows in your Amazon Web Services account.\n@optional {maxResults: int, nextToken: str}\n@returns(200) {steps: [WorkflowStepExecution]?, nextToken: str?}\n\n@endgroup\n\n@group ListWorkflowBuildVersions\n@endpoint POST /ListWorkflowBuildVersions\n@desc Returns a list of build versions for a specific workflow resource.\n@required {workflowVersionArn: str}\n@optional {maxResults: int, nextToken: str}\n@returns(200) {workflowSummaryList: [WorkflowSummary]?, nextToken: str?}\n\n@endgroup\n\n@group ListWorkflowExecutions\n@endpoint POST /ListWorkflowExecutions\n@desc Returns a list of workflow runtime instance metadata objects for a specific image build version.\n@required {imageBuildVersionArn: str}\n@optional {maxResults: int, nextToken: str}\n@returns(200) {requestId: str?, workflowExecutions: [WorkflowExecutionMetadata]?, imageBuildVersionArn: str?, message: str?, nextToken: str?}\n\n@endgroup\n\n@group ListWorkflowStepExecutions\n@endpoint POST /ListWorkflowStepExecutions\n@desc Returns runtime data for each step in a runtime instance of the workflow that you specify in the request.\n@required {workflowExecutionId: str}\n@optional {maxResults: int, nextToken: str}\n@returns(200) {requestId: str?, steps: [WorkflowStepMetadata]?, workflowBuildVersionArn: str?, workflowExecutionId: str?, imageBuildVersionArn: str?, message: str?, nextToken: str?}\n\n@endgroup\n\n@group ListWorkflows\n@endpoint POST /ListWorkflows\n@desc Lists workflow build versions based on filtering parameters.\n@optional {owner: str, filters: [Filter], byName: bool, maxResults: int, nextToken: str}\n@returns(200) {workflowVersionList: [WorkflowVersion]?, nextToken: str?}\n\n@endgroup\n\n@group PutComponentPolicy\n@endpoint PUT /PutComponentPolicy\n@desc Applies a policy to a component. We recommend that you call the RAM API CreateResourceShare to share resources. If you call the Image Builder API PutComponentPolicy, you must also call the RAM API PromoteResourceShareCreatedFromPolicy in order for the resource to be visible to all principals with whom the resource is shared.\n@required {componentArn: str, policy: str}\n@returns(200) {requestId: str?, componentArn: str?}\n\n@endgroup\n\n@group PutContainerRecipePolicy\n@endpoint PUT /PutContainerRecipePolicy\n@desc Applies a policy to a container image. We recommend that you call the RAM API CreateResourceShare (https://docs.aws.amazon.com//ram/latest/APIReference/API_CreateResourceShare.html) to share resources. If you call the Image Builder API PutContainerImagePolicy, you must also call the RAM API PromoteResourceShareCreatedFromPolicy (https://docs.aws.amazon.com//ram/latest/APIReference/API_PromoteResourceShareCreatedFromPolicy.html) in order for the resource to be visible to all principals with whom the resource is shared.\n@required {containerRecipeArn: str, policy: str}\n@returns(200) {requestId: str?, containerRecipeArn: str?}\n\n@endgroup\n\n@group PutImagePolicy\n@endpoint PUT /PutImagePolicy\n@desc Applies a policy to an image. We recommend that you call the RAM API CreateResourceShare to share resources. If you call the Image Builder API PutImagePolicy, you must also call the RAM API PromoteResourceShareCreatedFromPolicy in order for the resource to be visible to all principals with whom the resource is shared.\n@required {imageArn: str, policy: str}\n@returns(200) {requestId: str?, imageArn: str?}\n\n@endgroup\n\n@group PutImageRecipePolicy\n@endpoint PUT /PutImageRecipePolicy\n@desc Applies a policy to an image recipe. We recommend that you call the RAM API CreateResourceShare to share resources. If you call the Image Builder API PutImageRecipePolicy, you must also call the RAM API PromoteResourceShareCreatedFromPolicy in order for the resource to be visible to all principals with whom the resource is shared.\n@required {imageRecipeArn: str, policy: str}\n@returns(200) {requestId: str?, imageRecipeArn: str?}\n\n@endgroup\n\n@group SendWorkflowStepAction\n@endpoint PUT /SendWorkflowStepAction\n@desc Pauses or resumes image creation when the associated workflow runs a WaitForAction step.\n@required {stepExecutionId: str, imageBuildVersionArn: str, action: str, clientToken: str}\n@optional {reason: str}\n@returns(200) {stepExecutionId: str?, imageBuildVersionArn: str?, clientToken: str?}\n\n@endgroup\n\n@group StartImagePipelineExecution\n@endpoint PUT /StartImagePipelineExecution\n@desc Manually triggers a pipeline to create an image.\n@required {imagePipelineArn: str, clientToken: str}\n@returns(200) {requestId: str?, clientToken: str?, imageBuildVersionArn: str?}\n\n@endgroup\n\n@group StartResourceStateUpdate\n@endpoint PUT /StartResourceStateUpdate\n@desc Begin asynchronous resource state update for lifecycle changes to the specified image resources.\n@required {resourceArn: str, state: ResourceState, clientToken: str}\n@optional {executionRole: str, includeResources: ResourceStateUpdateIncludeResources, exclusionRules: ResourceStateUpdateExclusionRules, updateAt: str(timestamp)}\n@returns(200) {lifecycleExecutionId: str?, resourceArn: str?}\n\n@endgroup\n\n@group tags\n@endpoint POST /tags/{resourceArn}\n@desc Adds a tag to a resource.\n@required {resourceArn: str, tags: map<str,str>}\n\n@endpoint DELETE /tags/{resourceArn}\n@desc Removes a tag from a resource.\n@required {resourceArn: str, tagKeys: [str]}\n\n@endgroup\n\n@group UpdateDistributionConfiguration\n@endpoint PUT /UpdateDistributionConfiguration\n@desc Updates a new distribution configuration. Distribution configurations define and configure the outputs of your pipeline.\n@required {distributionConfigurationArn: str, distributions: [Distribution], clientToken: str}\n@optional {description: str}\n@returns(200) {requestId: str?, clientToken: str?, distributionConfigurationArn: str?}\n\n@endgroup\n\n@group UpdateImagePipeline\n@endpoint PUT /UpdateImagePipeline\n@desc Updates an image pipeline. Image pipelines enable you to automate the creation and distribution of images. You must specify exactly one recipe for your image, using either a containerRecipeArn or an imageRecipeArn.  UpdateImagePipeline does not support selective updates for the pipeline. You must specify all of the required properties in the update request, not just the properties that have changed.\n@required {imagePipelineArn: str, infrastructureConfigurationArn: str, clientToken: str}\n@optional {description: str, imageRecipeArn: str, containerRecipeArn: str, distributionConfigurationArn: str, imageTestsConfiguration: ImageTestsConfiguration, enhancedImageMetadataEnabled: bool, schedule: Schedule, status: str, imageScanningConfiguration: ImageScanningConfiguration, workflows: [WorkflowConfiguration], executionRole: str}\n@returns(200) {requestId: str?, clientToken: str?, imagePipelineArn: str?}\n\n@endgroup\n\n@group UpdateInfrastructureConfiguration\n@endpoint PUT /UpdateInfrastructureConfiguration\n@desc Updates a new infrastructure configuration. An infrastructure configuration defines the environment in which your image will be built and tested.\n@required {infrastructureConfigurationArn: str, instanceProfileName: str, clientToken: str}\n@optional {description: str, instanceTypes: [str], securityGroupIds: [str], subnetId: str, logging: Logging, keyPair: str, terminateInstanceOnFailure: bool, snsTopicArn: str, resourceTags: map<str,str>, instanceMetadataOptions: InstanceMetadataOptions}\n@returns(200) {requestId: str?, clientToken: str?, infrastructureConfigurationArn: str?}\n\n@endgroup\n\n@group UpdateLifecyclePolicy\n@endpoint PUT /UpdateLifecyclePolicy\n@desc Update the specified lifecycle policy.\n@required {lifecyclePolicyArn: str, executionRole: str, resourceType: str, policyDetails: [LifecyclePolicyDetail], resourceSelection: LifecyclePolicyResourceSelection, clientToken: str}\n@optional {description: str, status: str}\n@returns(200) {lifecyclePolicyArn: str?}\n\n@endgroup\n\n@end\n"}}