@Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AbstractAWSimagebuilder extends Object implements AWSimagebuilder
AWSimagebuilder
. Convenient method forms pass through to the corresponding
overload that takes a request object, which throws an UnsupportedOperationException
.ENDPOINT_PREFIX
public CancelImageCreationResult cancelImageCreation(CancelImageCreationRequest request)
AWSimagebuilder
CancelImageCreation cancels the creation of Image. This operation can only be used on images in a non-terminal state.
cancelImageCreation
in interface AWSimagebuilder
public CreateComponentResult createComponent(CreateComponentRequest request)
AWSimagebuilder
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.
createComponent
in interface AWSimagebuilder
public CreateContainerRecipeResult createContainerRecipe(CreateContainerRecipeRequest request)
AWSimagebuilder
Creates a new container recipe. Container recipes define how images are configured, tested, and assessed.
createContainerRecipe
in interface AWSimagebuilder
public CreateDistributionConfigurationResult createDistributionConfiguration(CreateDistributionConfigurationRequest request)
AWSimagebuilder
Creates a new distribution configuration. Distribution configurations define and configure the outputs of your pipeline.
createDistributionConfiguration
in interface AWSimagebuilder
public CreateImageResult createImage(CreateImageRequest request)
AWSimagebuilder
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.
createImage
in interface AWSimagebuilder
public CreateImagePipelineResult createImagePipeline(CreateImagePipelineRequest request)
AWSimagebuilder
Creates a new image pipeline. Image pipelines enable you to automate the creation and distribution of images.
createImagePipeline
in interface AWSimagebuilder
public CreateImageRecipeResult createImageRecipe(CreateImageRecipeRequest request)
AWSimagebuilder
Creates a new image recipe. Image recipes define how images are configured, tested, and assessed.
createImageRecipe
in interface AWSimagebuilder
public CreateInfrastructureConfigurationResult createInfrastructureConfiguration(CreateInfrastructureConfigurationRequest request)
AWSimagebuilder
Creates a new infrastructure configuration. An infrastructure configuration defines the environment in which your image will be built and tested.
createInfrastructureConfiguration
in interface AWSimagebuilder
public DeleteComponentResult deleteComponent(DeleteComponentRequest request)
AWSimagebuilder
Deletes a component build version.
deleteComponent
in interface AWSimagebuilder
public DeleteContainerRecipeResult deleteContainerRecipe(DeleteContainerRecipeRequest request)
AWSimagebuilder
Deletes a container recipe.
deleteContainerRecipe
in interface AWSimagebuilder
public DeleteDistributionConfigurationResult deleteDistributionConfiguration(DeleteDistributionConfigurationRequest request)
AWSimagebuilder
Deletes a distribution configuration.
deleteDistributionConfiguration
in interface AWSimagebuilder
public DeleteImageResult deleteImage(DeleteImageRequest request)
AWSimagebuilder
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.
deleteImage
in interface AWSimagebuilder
public DeleteImagePipelineResult deleteImagePipeline(DeleteImagePipelineRequest request)
AWSimagebuilder
Deletes an image pipeline.
deleteImagePipeline
in interface AWSimagebuilder
public DeleteImageRecipeResult deleteImageRecipe(DeleteImageRecipeRequest request)
AWSimagebuilder
Deletes an image recipe.
deleteImageRecipe
in interface AWSimagebuilder
public DeleteInfrastructureConfigurationResult deleteInfrastructureConfiguration(DeleteInfrastructureConfigurationRequest request)
AWSimagebuilder
Deletes an infrastructure configuration.
deleteInfrastructureConfiguration
in interface AWSimagebuilder
public GetComponentResult getComponent(GetComponentRequest request)
AWSimagebuilder
Gets a component object.
getComponent
in interface AWSimagebuilder
public GetComponentPolicyResult getComponentPolicy(GetComponentPolicyRequest request)
AWSimagebuilder
Gets a component policy.
getComponentPolicy
in interface AWSimagebuilder
public GetContainerRecipeResult getContainerRecipe(GetContainerRecipeRequest request)
AWSimagebuilder
Retrieves a container recipe.
getContainerRecipe
in interface AWSimagebuilder
public GetContainerRecipePolicyResult getContainerRecipePolicy(GetContainerRecipePolicyRequest request)
AWSimagebuilder
Retrieves the policy for a container recipe.
getContainerRecipePolicy
in interface AWSimagebuilder
public GetDistributionConfigurationResult getDistributionConfiguration(GetDistributionConfigurationRequest request)
AWSimagebuilder
Gets a distribution configuration.
getDistributionConfiguration
in interface AWSimagebuilder
public GetImageResult getImage(GetImageRequest request)
AWSimagebuilder
Gets an image.
getImage
in interface AWSimagebuilder
public GetImagePipelineResult getImagePipeline(GetImagePipelineRequest request)
AWSimagebuilder
Gets an image pipeline.
getImagePipeline
in interface AWSimagebuilder
public GetImagePolicyResult getImagePolicy(GetImagePolicyRequest request)
AWSimagebuilder
Gets an image policy.
getImagePolicy
in interface AWSimagebuilder
public GetImageRecipeResult getImageRecipe(GetImageRecipeRequest request)
AWSimagebuilder
Gets an image recipe.
getImageRecipe
in interface AWSimagebuilder
public GetImageRecipePolicyResult getImageRecipePolicy(GetImageRecipePolicyRequest request)
AWSimagebuilder
Gets an image recipe policy.
getImageRecipePolicy
in interface AWSimagebuilder
public GetInfrastructureConfigurationResult getInfrastructureConfiguration(GetInfrastructureConfigurationRequest request)
AWSimagebuilder
Gets an infrastructure configuration.
getInfrastructureConfiguration
in interface AWSimagebuilder
request
- GetInfrastructureConfiguration request object.public ImportComponentResult importComponent(ImportComponentRequest request)
AWSimagebuilder
Imports a component and transforms its data into a component document.
importComponent
in interface AWSimagebuilder
public ImportVmImageResult importVmImage(ImportVmImageRequest request)
AWSimagebuilder
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.
importVmImage
in interface AWSimagebuilder
public ListComponentBuildVersionsResult listComponentBuildVersions(ListComponentBuildVersionsRequest request)
AWSimagebuilder
Returns the list of component build versions for the specified semantic version.
The semantic version has four nodes: <major>.<minor>.<patch>/<build>. 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.
listComponentBuildVersions
in interface AWSimagebuilder
public ListComponentsResult listComponents(ListComponentsRequest request)
AWSimagebuilder
Returns the list of component build versions for the specified semantic version.
The semantic version has four nodes: <major>.<minor>.<patch>/<build>. 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.
listComponents
in interface AWSimagebuilder
public ListContainerRecipesResult listContainerRecipes(ListContainerRecipesRequest request)
AWSimagebuilder
Returns a list of container recipes.
listContainerRecipes
in interface AWSimagebuilder
public ListDistributionConfigurationsResult listDistributionConfigurations(ListDistributionConfigurationsRequest request)
AWSimagebuilder
Returns a list of distribution configurations.
listDistributionConfigurations
in interface AWSimagebuilder
public ListImageBuildVersionsResult listImageBuildVersions(ListImageBuildVersionsRequest request)
AWSimagebuilder
Returns a list of image build versions.
listImageBuildVersions
in interface AWSimagebuilder
public ListImagePackagesResult listImagePackages(ListImagePackagesRequest request)
AWSimagebuilder
List the Packages that are associated with an Image Build Version, as determined by Amazon Web Services Systems Manager Inventory at build time.
listImagePackages
in interface AWSimagebuilder
public ListImagePipelineImagesResult listImagePipelineImages(ListImagePipelineImagesRequest request)
AWSimagebuilder
Returns a list of images created by the specified pipeline.
listImagePipelineImages
in interface AWSimagebuilder
public ListImagePipelinesResult listImagePipelines(ListImagePipelinesRequest request)
AWSimagebuilder
Returns a list of image pipelines.
listImagePipelines
in interface AWSimagebuilder
public ListImageRecipesResult listImageRecipes(ListImageRecipesRequest request)
AWSimagebuilder
Returns a list of image recipes.
listImageRecipes
in interface AWSimagebuilder
public ListImagesResult listImages(ListImagesRequest request)
AWSimagebuilder
Returns the list of images that you have access to.
listImages
in interface AWSimagebuilder
public ListInfrastructureConfigurationsResult listInfrastructureConfigurations(ListInfrastructureConfigurationsRequest request)
AWSimagebuilder
Returns a list of infrastructure configurations.
listInfrastructureConfigurations
in interface AWSimagebuilder
public ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest request)
AWSimagebuilder
Returns the list of tags for the specified resource.
listTagsForResource
in interface AWSimagebuilder
public PutComponentPolicyResult putComponentPolicy(PutComponentPolicyRequest request)
AWSimagebuilder
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.
putComponentPolicy
in interface AWSimagebuilder
public PutContainerRecipePolicyResult putContainerRecipePolicy(PutContainerRecipePolicyRequest request)
AWSimagebuilder
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.
putContainerRecipePolicy
in interface AWSimagebuilder
public PutImagePolicyResult putImagePolicy(PutImagePolicyRequest request)
AWSimagebuilder
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.
putImagePolicy
in interface AWSimagebuilder
public PutImageRecipePolicyResult putImageRecipePolicy(PutImageRecipePolicyRequest request)
AWSimagebuilder
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.
putImageRecipePolicy
in interface AWSimagebuilder
public StartImagePipelineExecutionResult startImagePipelineExecution(StartImagePipelineExecutionRequest request)
AWSimagebuilder
Manually triggers a pipeline to create an image.
startImagePipelineExecution
in interface AWSimagebuilder
public TagResourceResult tagResource(TagResourceRequest request)
AWSimagebuilder
Adds a tag to a resource.
tagResource
in interface AWSimagebuilder
public UntagResourceResult untagResource(UntagResourceRequest request)
AWSimagebuilder
Removes a tag from a resource.
untagResource
in interface AWSimagebuilder
public UpdateDistributionConfigurationResult updateDistributionConfiguration(UpdateDistributionConfigurationRequest request)
AWSimagebuilder
Updates a new distribution configuration. Distribution configurations define and configure the outputs of your pipeline.
updateDistributionConfiguration
in interface AWSimagebuilder
public UpdateImagePipelineResult updateImagePipeline(UpdateImagePipelineRequest request)
AWSimagebuilder
Updates an image pipeline. Image pipelines enable you to automate the creation and distribution of images.
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.
updateImagePipeline
in interface AWSimagebuilder
public UpdateInfrastructureConfigurationResult updateInfrastructureConfiguration(UpdateInfrastructureConfigurationRequest request)
AWSimagebuilder
Updates a new infrastructure configuration. An infrastructure configuration defines the environment in which your image will be built and tested.
updateInfrastructureConfiguration
in interface AWSimagebuilder
public void shutdown()
AWSimagebuilder
shutdown
in interface AWSimagebuilder
public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
AWSimagebuilder
Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing a request.
getCachedResponseMetadata
in interface AWSimagebuilder
request
- The originally executed request.