Imagebuilder
import { Imagebuilder } from "https://aws-api.deno.dev/v0.3/services/imagebuilder.ts?docs=full";
§Constructors
§Methods
CancelImageCreation cancels the creation of Image. This operation can only be used on images in a non-terminal state.
Creates a new component that can be used to build, validate, test, and assess your image.
Creates a new container recipe. Container recipes define how images are configured, tested, and assessed.
Creates a new distribution configuration. Distribution configurations define and configure the outputs of your pipeline.
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.
Creates a new image pipeline. Image pipelines enable you to automate the creation and distribution of images.
Creates a new image recipe. Image recipes define how images are configured, tested, and assessed.
Creates a new infrastructure configuration. An infrastructure configuration defines the environment in which your image will be built and tested.
Deletes a component build version.
Deletes a container recipe.
Deletes a distribution configuration.
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.
Deletes an image pipeline.
Deletes an image recipe.
Deletes an infrastructure configuration.
Gets a component object.
Gets a component policy.
Retrieves a container recipe.
Retrieves the policy for a container recipe.
Gets a distribution configuration.
Gets an image pipeline.
Gets an image policy.
Gets an image recipe.
Gets an image recipe policy.
Gets an infrastructure configuration.
Imports a component and transforms its data into a component document.
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.
Returns the list of component build versions for the specified semantic version.
Note: 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.
Returns the list of component build versions for the specified semantic version.
Note: 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.
Returns a list of container recipes.
Returns a list of distribution configurations.
Returns a list of image build versions.
List the Packages that are associated with an Image Build Version, as determined by Amazon Web Services Systems Manager Inventory at build time.
Returns a list of images created by the specified pipeline.
Returns a list of image pipelines.
Returns a list of image recipes.
Returns a list of infrastructure configurations.
Returns the list of tags for the specified resource.
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.
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.
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.
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.
Manually triggers a pipeline to create an image.
Updates a new distribution configuration. Distribution configurations define and configure the outputs of your pipeline.
Updates an image pipeline. Image pipelines enable you to automate the creation and distribution of images.
Note: 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.
Updates a new infrastructure configuration. An infrastructure configuration defines the environment in which your image will be built and tested.