ImagebuilderClient

EC2 Image Builder is a fully managed Amazon Web Services service that makes it easier to automate the creation, management, and deployment of customized, secure, and up-to-date "golden" server images that are pre-installed and pre-configured with software and settings to meet specific IT standards.

Installation

NPM
npm install @aws-sdk/client-imagebuilder
Yarn
yarn add @aws-sdk/client-imagebuilder
pnpm
pnpm add @aws-sdk/client-imagebuilder

ImagebuilderClient Operations

Command
Summary
CancelImageCreationCommand

CancelImageCreation cancels the creation of Image. This operation can only be used on images in a non-terminal state.

CancelLifecycleExecutionCommand

Cancel a specific image lifecycle policy runtime instance.

CreateComponentCommand

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.

CreateContainerRecipeCommand

Creates a new container recipe. Container recipes define how images are configured, tested, and assessed.

CreateDistributionConfigurationCommand

Creates a new distribution configuration. Distribution configurations define and configure the outputs of your pipeline.

CreateImageCommand

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.

CreateImagePipelineCommand

Creates a new image pipeline. Image pipelines enable you to automate the creation and distribution of images.

CreateImageRecipeCommand

Creates a new image recipe. Image recipes define how images are configured, tested, and assessed.

CreateInfrastructureConfigurationCommand

Creates a new infrastructure configuration. An infrastructure configuration defines the environment in which your image will be built and tested.

CreateLifecyclePolicyCommand

Create a lifecycle policy resource.

CreateWorkflowCommand

Create a new workflow or a new version of an existing workflow.

DeleteComponentCommand

Deletes a component build version.

DeleteContainerRecipeCommand

Deletes a container recipe.

DeleteDistributionConfigurationCommand

Deletes a distribution configuration.

DeleteImageCommand

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.

DeleteImagePipelineCommand

Deletes an image pipeline.

DeleteImageRecipeCommand

Deletes an image recipe.

DeleteInfrastructureConfigurationCommand

Deletes an infrastructure configuration.

DeleteLifecyclePolicyCommand

Delete the specified lifecycle policy resource.

DeleteWorkflowCommand

Deletes a specific workflow resource.

GetComponentCommand

Gets a component object.

GetComponentPolicyCommand

Gets a component policy.

GetContainerRecipeCommand

Retrieves a container recipe.

GetContainerRecipePolicyCommand

Retrieves the policy for a container recipe.

GetDistributionConfigurationCommand

Gets a distribution configuration.

GetImageCommand

Gets an image.

GetImagePipelineCommand

Gets an image pipeline.

GetImagePolicyCommand

Gets an image policy.

GetImageRecipeCommand

Gets an image recipe.

GetImageRecipePolicyCommand

Gets an image recipe policy.

GetInfrastructureConfigurationCommand

Gets an infrastructure configuration.

GetLifecycleExecutionCommand

Get the runtime information that was logged for a specific runtime instance of the lifecycle policy.

GetLifecyclePolicyCommand

Get details for the specified image lifecycle policy.

GetMarketplaceResourceCommand

Verify the subscription and perform resource dependency checks on the requested Amazon Web Services Marketplace resource. For Amazon Web Services Marketplace components, the response contains fields to download the components and their artifacts.

GetWorkflowCommand

Get a workflow resource object.

GetWorkflowExecutionCommand

Get the runtime information that was logged for a specific runtime instance of the workflow.

GetWorkflowStepExecutionCommand

Get the runtime information that was logged for a specific runtime instance of the workflow step.

ImportComponentCommand

Imports a component and transforms its data into a component document.

ImportDiskImageCommand

Import a Windows operating system image from a verified Microsoft ISO disk file. The following disk images are supported:

  • Windows 11 Enterprise

ImportVmImageCommand

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.

ListComponentBuildVersionsCommand

Returns the list of component build versions for the specified component version Amazon Resource Name (ARN).

ListComponentsCommand

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.

ListContainerRecipesCommand

Returns a list of container recipes.

ListDistributionConfigurationsCommand

Returns a list of distribution configurations.

ListImageBuildVersionsCommand

Returns a list of image build versions.

ListImagePackagesCommand

List the Packages that are associated with an Image Build Version, as determined by Amazon Web Services Systems Manager Inventory at build time.

ListImagePipelineImagesCommand

Returns a list of images created by the specified pipeline.

ListImagePipelinesCommand

Returns a list of image pipelines.

ListImageRecipesCommand

Returns a list of image recipes.

ListImageScanFindingAggregationsCommand

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

ListImageScanFindingsCommand

Returns a list of image scan findings for your account.

ListImagesCommand

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.

ListInfrastructureConfigurationsCommand

Returns a list of infrastructure configurations.

ListLifecycleExecutionResourcesCommand

List resources that the runtime instance of the image lifecycle identified for lifecycle actions.

ListLifecycleExecutionsCommand

Get the lifecycle runtime history for the specified resource.

ListLifecyclePoliciesCommand

Get a list of lifecycle policies in your Amazon Web Services account.

ListTagsForResourceCommand

Returns the list of tags for the specified resource.

ListWaitingWorkflowStepsCommand

Get a list of workflow steps that are waiting for action for workflows in your Amazon Web Services account.

ListWorkflowBuildVersionsCommand

Returns a list of build versions for a specific workflow resource.

ListWorkflowExecutionsCommand

Returns a list of workflow runtime instance metadata objects for a specific image build version.

ListWorkflowStepExecutionsCommand

Returns runtime data for each step in a runtime instance of the workflow that you specify in the request.

ListWorkflowsCommand

Lists workflow build versions based on filtering parameters.

PutComponentPolicyCommand

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.

PutContainerRecipePolicyCommand

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.

PutImagePolicyCommand

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.

PutImageRecipePolicyCommand

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.

SendWorkflowStepActionCommand

Pauses or resumes image creation when the associated workflow runs a WaitForAction step.

StartImagePipelineExecutionCommand

Manually triggers a pipeline to create an image.

StartResourceStateUpdateCommand

Begin asynchronous resource state update for lifecycle changes to the specified image resources.

TagResourceCommand

Adds a tag to a resource.

UntagResourceCommand

Removes a tag from a resource.

UpdateDistributionConfigurationCommand

Updates a new distribution configuration. Distribution configurations define and configure the outputs of your pipeline.

UpdateImagePipelineCommand

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.

UpdateInfrastructureConfigurationCommand

Updates a new infrastructure configuration. An infrastructure configuration defines the environment in which your image will be built and tested.

UpdateLifecyclePolicyCommand

Update the specified lifecycle policy.

ImagebuilderClient Configuration

Parameter
Type
Description
defaultsMode
Optional
DefaultsMode | Provider<DefaultsMode>
The @smithy/smithy-client#DefaultsMode that will be used to determine how certain default configuration options are resolved in the SDK.
disableHostPrefix
Optional
boolean
Disable dynamically changing the endpoint of the client based on the hostPrefix trait of an operation.
extensions
Optional
RuntimeExtension[]
Optional extensions
logger
Optional
Logger
Optional logger for logging debug/info/warn/error.
maxAttempts
Optional
number | Provider<number>
Value for how many times a request will be made at most in case of retry.
profile
Optional
string
Setting a client profile is similar to setting a value for the AWS_PROFILE environment variable. Setting a profile on a client in code only affects the single client instance, unlike AWS_PROFILE.When set, and only for environments where an AWS configuration file exists, fields configurable by this file will be retrieved from the specified profile within that file. Conflicting code configuration and environment variables will still have higher priority.For client credential resolution that involves checking the AWS configuration file, the client's profile (this value) will be used unless a different profile is set in the credential provider options.
region
Optional
string | Provider<string>
The AWS region to which this client will send requests
requestHandler
Optional
__HttpHandlerUserInput
The HTTP handler to use or its constructor options. Fetch in browser and Https in Nodejs.
retryMode
Optional
string | Provider<string>
Specifies which retry algorithm to use.
useDualstackEndpoint
Optional
boolean | Provider<boolean>
Enables IPv6/IPv4 dualstack endpoint.
useFipsEndpoint
Optional
boolean | Provider<boolean>
Enables FIPS compatible endpoints.
Additional config fields are described in the full configuration type: ImagebuilderClientConfig