@ThreadSafe @Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AWSimagebuilderClient extends AmazonWebServiceClient implements AWSimagebuilder
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.
LOGGING_AWS_REQUEST_METRICENDPOINT_PREFIXaddRequestHandler, addRequestHandler, configureRegion, getClientConfiguration, getEndpointPrefix, getMonitoringListeners, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerOverride, getSignerRegionOverride, getTimeOffset, makeImmutable, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, withEndpoint, withRegion, withRegion, withTimeOffsetpublic static AWSimagebuilderClientBuilder builder()
public CancelImageCreationResult cancelImageCreation(CancelImageCreationRequest request)
CancelImageCreation cancels the creation of Image. This operation can only be used on images in a non-terminal state.
cancelImageCreation in interface AWSimagebuildercancelImageCreationRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.IdempotentParameterMismatchException - You have specified a client token for an operation using parameter values that differ from a previous
request that used the same client token.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.ResourceInUseException - The resource that you are trying to operate on is currently in use. Review the message details and retry
later.public CancelLifecycleExecutionResult cancelLifecycleExecution(CancelLifecycleExecutionRequest request)
Cancel a specific image lifecycle policy runtime instance.
cancelLifecycleExecution in interface AWSimagebuildercancelLifecycleExecutionRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.IdempotentParameterMismatchException - You have specified a client token for an operation using parameter values that differ from a previous
request that used the same client token.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.ResourceInUseException - The resource that you are trying to operate on is currently in use. Review the message details and retry
later.public CreateComponentResult createComponent(CreateComponentRequest request)
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 AWSimagebuildercreateComponentRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.IdempotentParameterMismatchException - You have specified a client token for an operation using parameter values that differ from a previous
request that used the same client token.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.InvalidVersionNumberException - Your version number is out of bounds or does not follow the required syntax.ResourceInUseException - The resource that you are trying to operate on is currently in use. Review the message details and retry
later.InvalidParameterCombinationException - You have specified two or more mutually exclusive parameters. Review the error message for details.ServiceQuotaExceededException - You have exceeded the number of permitted resources or operations for this service. For service quotas,
see EC2
Image Builder endpoints and quotas.public CreateContainerRecipeResult createContainerRecipe(CreateContainerRecipeRequest request)
Creates a new container recipe. Container recipes define how images are configured, tested, and assessed.
createContainerRecipe in interface AWSimagebuildercreateContainerRecipeRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.IdempotentParameterMismatchException - You have specified a client token for an operation using parameter values that differ from a previous
request that used the same client token.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.InvalidVersionNumberException - Your version number is out of bounds or does not follow the required syntax.ResourceInUseException - The resource that you are trying to operate on is currently in use. Review the message details and retry
later.ResourceAlreadyExistsException - The resource that you are trying to create already exists.ServiceQuotaExceededException - You have exceeded the number of permitted resources or operations for this service. For service quotas,
see EC2
Image Builder endpoints and quotas.public CreateDistributionConfigurationResult createDistributionConfiguration(CreateDistributionConfigurationRequest request)
Creates a new distribution configuration. Distribution configurations define and configure the outputs of your pipeline.
createDistributionConfiguration in interface AWSimagebuildercreateDistributionConfigurationRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.IdempotentParameterMismatchException - You have specified a client token for an operation using parameter values that differ from a previous
request that used the same client token.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.ResourceInUseException - The resource that you are trying to operate on is currently in use. Review the message details and retry
later.ResourceAlreadyExistsException - The resource that you are trying to create already exists.InvalidParameterCombinationException - You have specified two or more mutually exclusive parameters. Review the error message for details.ServiceQuotaExceededException - You have exceeded the number of permitted resources or operations for this service. For service quotas,
see EC2
Image Builder endpoints and quotas.public CreateImageResult createImage(CreateImageRequest request)
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 AWSimagebuildercreateImageRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.IdempotentParameterMismatchException - You have specified a client token for an operation using parameter values that differ from a previous
request that used the same client token.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.ResourceInUseException - The resource that you are trying to operate on is currently in use. Review the message details and retry
later.ServiceQuotaExceededException - You have exceeded the number of permitted resources or operations for this service. For service quotas,
see EC2
Image Builder endpoints and quotas.public CreateImagePipelineResult createImagePipeline(CreateImagePipelineRequest request)
Creates a new image pipeline. Image pipelines enable you to automate the creation and distribution of images.
createImagePipeline in interface AWSimagebuildercreateImagePipelineRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.IdempotentParameterMismatchException - You have specified a client token for an operation using parameter values that differ from a previous
request that used the same client token.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.ResourceInUseException - The resource that you are trying to operate on is currently in use. Review the message details and retry
later.ResourceAlreadyExistsException - The resource that you are trying to create already exists.ServiceQuotaExceededException - You have exceeded the number of permitted resources or operations for this service. For service quotas,
see EC2
Image Builder endpoints and quotas.public CreateImageRecipeResult createImageRecipe(CreateImageRecipeRequest request)
Creates a new image recipe. Image recipes define how images are configured, tested, and assessed.
createImageRecipe in interface AWSimagebuildercreateImageRecipeRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.IdempotentParameterMismatchException - You have specified a client token for an operation using parameter values that differ from a previous
request that used the same client token.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.InvalidVersionNumberException - Your version number is out of bounds or does not follow the required syntax.ResourceInUseException - The resource that you are trying to operate on is currently in use. Review the message details and retry
later.ResourceAlreadyExistsException - The resource that you are trying to create already exists.ServiceQuotaExceededException - You have exceeded the number of permitted resources or operations for this service. For service quotas,
see EC2
Image Builder endpoints and quotas.public CreateInfrastructureConfigurationResult createInfrastructureConfiguration(CreateInfrastructureConfigurationRequest request)
Creates a new infrastructure configuration. An infrastructure configuration defines the environment in which your image will be built and tested.
createInfrastructureConfiguration in interface AWSimagebuildercreateInfrastructureConfigurationRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.IdempotentParameterMismatchException - You have specified a client token for an operation using parameter values that differ from a previous
request that used the same client token.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.ResourceInUseException - The resource that you are trying to operate on is currently in use. Review the message details and retry
later.ResourceAlreadyExistsException - The resource that you are trying to create already exists.ServiceQuotaExceededException - You have exceeded the number of permitted resources or operations for this service. For service quotas,
see EC2
Image Builder endpoints and quotas.public CreateLifecyclePolicyResult createLifecyclePolicy(CreateLifecyclePolicyRequest request)
Create a lifecycle policy resource.
createLifecyclePolicy in interface AWSimagebuildercreateLifecyclePolicyRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.IdempotentParameterMismatchException - You have specified a client token for an operation using parameter values that differ from a previous
request that used the same client token.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.ResourceInUseException - The resource that you are trying to operate on is currently in use. Review the message details and retry
later.ResourceAlreadyExistsException - The resource that you are trying to create already exists.ServiceQuotaExceededException - You have exceeded the number of permitted resources or operations for this service. For service quotas,
see EC2
Image Builder endpoints and quotas.public DeleteComponentResult deleteComponent(DeleteComponentRequest request)
Deletes a component build version.
deleteComponent in interface AWSimagebuilderdeleteComponentRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.ResourceDependencyException - You have attempted to mutate or delete a resource with a dependency that prohibits this action. See the
error message for more details.public DeleteContainerRecipeResult deleteContainerRecipe(DeleteContainerRecipeRequest request)
Deletes a container recipe.
deleteContainerRecipe in interface AWSimagebuilderdeleteContainerRecipeRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.ResourceDependencyException - You have attempted to mutate or delete a resource with a dependency that prohibits this action. See the
error message for more details.public DeleteDistributionConfigurationResult deleteDistributionConfiguration(DeleteDistributionConfigurationRequest request)
Deletes a distribution configuration.
deleteDistributionConfiguration in interface AWSimagebuilderdeleteDistributionConfigurationRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.InvalidRequestException - You have requested an action that that the service doesn't support.ServiceUnavailableException - The service is unable to process your request at this time.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.ResourceDependencyException - You have attempted to mutate or delete a resource with a dependency that prohibits this action. See the
error message for more details.public DeleteImageResult deleteImage(DeleteImageRequest request)
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 AWSimagebuilderdeleteImageRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.InvalidRequestException - You have requested an action that that the service doesn't support.ServiceUnavailableException - The service is unable to process your request at this time.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.ResourceDependencyException - You have attempted to mutate or delete a resource with a dependency that prohibits this action. See the
error message for more details.public DeleteImagePipelineResult deleteImagePipeline(DeleteImagePipelineRequest request)
Deletes an image pipeline.
deleteImagePipeline in interface AWSimagebuilderdeleteImagePipelineRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.ResourceDependencyException - You have attempted to mutate or delete a resource with a dependency that prohibits this action. See the
error message for more details.public DeleteImageRecipeResult deleteImageRecipe(DeleteImageRecipeRequest request)
Deletes an image recipe.
deleteImageRecipe in interface AWSimagebuilderdeleteImageRecipeRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.ResourceDependencyException - You have attempted to mutate or delete a resource with a dependency that prohibits this action. See the
error message for more details.public DeleteInfrastructureConfigurationResult deleteInfrastructureConfiguration(DeleteInfrastructureConfigurationRequest request)
Deletes an infrastructure configuration.
deleteInfrastructureConfiguration in interface AWSimagebuilderdeleteInfrastructureConfigurationRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.ResourceDependencyException - You have attempted to mutate or delete a resource with a dependency that prohibits this action. See the
error message for more details.public DeleteLifecyclePolicyResult deleteLifecyclePolicy(DeleteLifecyclePolicyRequest request)
Delete the specified lifecycle policy resource.
deleteLifecyclePolicy in interface AWSimagebuilderdeleteLifecyclePolicyRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.InvalidRequestException - You have requested an action that that the service doesn't support.ServiceUnavailableException - The service is unable to process your request at this time.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.ResourceDependencyException - You have attempted to mutate or delete a resource with a dependency that prohibits this action. See the
error message for more details.public GetComponentResult getComponent(GetComponentRequest request)
Gets a component object.
getComponent in interface AWSimagebuildergetComponentRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public GetComponentPolicyResult getComponentPolicy(GetComponentPolicyRequest request)
Gets a component policy.
getComponentPolicy in interface AWSimagebuildergetComponentPolicyRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ServiceUnavailableException - The service is unable to process your request at this time.ResourceNotFoundException - At least one of the resources referenced by your request does not exist.InvalidRequestException - You have requested an action that that the service doesn't support.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public GetContainerRecipeResult getContainerRecipe(GetContainerRecipeRequest request)
Retrieves a container recipe.
getContainerRecipe in interface AWSimagebuildergetContainerRecipeRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public GetContainerRecipePolicyResult getContainerRecipePolicy(GetContainerRecipePolicyRequest request)
Retrieves the policy for a container recipe.
getContainerRecipePolicy in interface AWSimagebuildergetContainerRecipePolicyRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.ResourceNotFoundException - At least one of the resources referenced by your request does not exist.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public GetDistributionConfigurationResult getDistributionConfiguration(GetDistributionConfigurationRequest request)
Gets a distribution configuration.
getDistributionConfiguration in interface AWSimagebuildergetDistributionConfigurationRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public GetImageResult getImage(GetImageRequest request)
Gets an image.
getImage in interface AWSimagebuildergetImageRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public GetImagePipelineResult getImagePipeline(GetImagePipelineRequest request)
Gets an image pipeline.
getImagePipeline in interface AWSimagebuildergetImagePipelineRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public GetImagePolicyResult getImagePolicy(GetImagePolicyRequest request)
Gets an image policy.
getImagePolicy in interface AWSimagebuildergetImagePolicyRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ServiceUnavailableException - The service is unable to process your request at this time.ResourceNotFoundException - At least one of the resources referenced by your request does not exist.InvalidRequestException - You have requested an action that that the service doesn't support.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public GetImageRecipeResult getImageRecipe(GetImageRecipeRequest request)
Gets an image recipe.
getImageRecipe in interface AWSimagebuildergetImageRecipeRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public GetImageRecipePolicyResult getImageRecipePolicy(GetImageRecipePolicyRequest request)
Gets an image recipe policy.
getImageRecipePolicy in interface AWSimagebuildergetImageRecipePolicyRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.ResourceNotFoundException - At least one of the resources referenced by your request does not exist.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public GetInfrastructureConfigurationResult getInfrastructureConfiguration(GetInfrastructureConfigurationRequest request)
Gets an infrastructure configuration.
getInfrastructureConfiguration in interface AWSimagebuildergetInfrastructureConfigurationRequest - GetInfrastructureConfiguration request object.ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public GetLifecycleExecutionResult getLifecycleExecution(GetLifecycleExecutionRequest request)
Get the runtime information that was logged for a specific runtime instance of the lifecycle policy.
getLifecycleExecution in interface AWSimagebuildergetLifecycleExecutionRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public GetLifecyclePolicyResult getLifecyclePolicy(GetLifecyclePolicyRequest request)
Get details for the specified image lifecycle policy.
getLifecyclePolicy in interface AWSimagebuildergetLifecyclePolicyRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public GetWorkflowExecutionResult getWorkflowExecution(GetWorkflowExecutionRequest request)
Get the runtime information that was logged for a specific runtime instance of the workflow.
getWorkflowExecution in interface AWSimagebuildergetWorkflowExecutionRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public GetWorkflowStepExecutionResult getWorkflowStepExecution(GetWorkflowStepExecutionRequest request)
Get the runtime information that was logged for a specific runtime instance of the workflow step.
getWorkflowStepExecution in interface AWSimagebuildergetWorkflowStepExecutionRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public ImportComponentResult importComponent(ImportComponentRequest request)
Imports a component and transforms its data into a component document.
importComponent in interface AWSimagebuilderimportComponentRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.IdempotentParameterMismatchException - You have specified a client token for an operation using parameter values that differ from a previous
request that used the same client token.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.InvalidVersionNumberException - Your version number is out of bounds or does not follow the required syntax.ResourceInUseException - The resource that you are trying to operate on is currently in use. Review the message details and retry
later.InvalidParameterCombinationException - You have specified two or more mutually exclusive parameters. Review the error message for details.public ImportVmImageResult importVmImage(ImportVmImageRequest request)
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 AWSimagebuilderimportVmImageRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.public ListComponentBuildVersionsResult listComponentBuildVersions(ListComponentBuildVersionsRequest request)
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 AWSimagebuilderlistComponentBuildVersionsRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.InvalidPaginationTokenException - You have provided an invalid pagination token in your request.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public ListComponentsResult listComponents(ListComponentsRequest request)
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: <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 AWSimagebuilderlistComponentsRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.InvalidPaginationTokenException - You have provided an invalid pagination token in your request.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public ListContainerRecipesResult listContainerRecipes(ListContainerRecipesRequest request)
Returns a list of container recipes.
listContainerRecipes in interface AWSimagebuilderlistContainerRecipesRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.InvalidPaginationTokenException - You have provided an invalid pagination token in your request.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public ListDistributionConfigurationsResult listDistributionConfigurations(ListDistributionConfigurationsRequest request)
Returns a list of distribution configurations.
listDistributionConfigurations in interface AWSimagebuilderlistDistributionConfigurationsRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.InvalidPaginationTokenException - You have provided an invalid pagination token in your request.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public ListImageBuildVersionsResult listImageBuildVersions(ListImageBuildVersionsRequest request)
Returns a list of image build versions.
listImageBuildVersions in interface AWSimagebuilderlistImageBuildVersionsRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.InvalidPaginationTokenException - You have provided an invalid pagination token in your request.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public ListImagePackagesResult listImagePackages(ListImagePackagesRequest request)
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 AWSimagebuilderlistImagePackagesRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.InvalidPaginationTokenException - You have provided an invalid pagination token in your request.ResourceNotFoundException - At least one of the resources referenced by your request does not exist.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public ListImagePipelineImagesResult listImagePipelineImages(ListImagePipelineImagesRequest request)
Returns a list of images created by the specified pipeline.
listImagePipelineImages in interface AWSimagebuilderlistImagePipelineImagesRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.InvalidPaginationTokenException - You have provided an invalid pagination token in your request.ResourceNotFoundException - At least one of the resources referenced by your request does not exist.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public ListImagePipelinesResult listImagePipelines(ListImagePipelinesRequest request)
Returns a list of image pipelines.
listImagePipelines in interface AWSimagebuilderlistImagePipelinesRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.InvalidPaginationTokenException - You have provided an invalid pagination token in your request.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public ListImageRecipesResult listImageRecipes(ListImageRecipesRequest request)
Returns a list of image recipes.
listImageRecipes in interface AWSimagebuilderlistImageRecipesRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.InvalidPaginationTokenException - You have provided an invalid pagination token in your request.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public ListImageScanFindingAggregationsResult listImageScanFindingAggregations(ListImageScanFindingAggregationsRequest request)
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
listImageScanFindingAggregations in interface AWSimagebuilderlistImageScanFindingAggregationsRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.InvalidPaginationTokenException - You have provided an invalid pagination token in your request.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public ListImageScanFindingsResult listImageScanFindings(ListImageScanFindingsRequest request)
Returns a list of image scan findings for your account.
listImageScanFindings in interface AWSimagebuilderlistImageScanFindingsRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.InvalidPaginationTokenException - You have provided an invalid pagination token in your request.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public ListImagesResult listImages(ListImagesRequest request)
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.
listImages in interface AWSimagebuilderlistImagesRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.InvalidPaginationTokenException - You have provided an invalid pagination token in your request.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public ListInfrastructureConfigurationsResult listInfrastructureConfigurations(ListInfrastructureConfigurationsRequest request)
Returns a list of infrastructure configurations.
listInfrastructureConfigurations in interface AWSimagebuilderlistInfrastructureConfigurationsRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.InvalidPaginationTokenException - You have provided an invalid pagination token in your request.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public ListLifecycleExecutionResourcesResult listLifecycleExecutionResources(ListLifecycleExecutionResourcesRequest request)
List resources that the runtime instance of the image lifecycle identified for lifecycle actions.
listLifecycleExecutionResources in interface AWSimagebuilderlistLifecycleExecutionResourcesRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.InvalidPaginationTokenException - You have provided an invalid pagination token in your request.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public ListLifecycleExecutionsResult listLifecycleExecutions(ListLifecycleExecutionsRequest request)
Get the lifecycle runtime history for the specified resource.
listLifecycleExecutions in interface AWSimagebuilderlistLifecycleExecutionsRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.InvalidPaginationTokenException - You have provided an invalid pagination token in your request.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public ListLifecyclePoliciesResult listLifecyclePolicies(ListLifecyclePoliciesRequest request)
Get a list of lifecycle policies in your Amazon Web Services account.
listLifecyclePolicies in interface AWSimagebuilderlistLifecyclePoliciesRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.InvalidPaginationTokenException - You have provided an invalid pagination token in your request.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest request)
Returns the list of tags for the specified resource.
listTagsForResource in interface AWSimagebuilderlistTagsForResourceRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.InvalidParameterException - The specified parameter is invalid. Review the available parameters for the API request.ResourceNotFoundException - At least one of the resources referenced by your request does not exist.public ListWorkflowExecutionsResult listWorkflowExecutions(ListWorkflowExecutionsRequest request)
Returns a list of workflow runtime instance metadata objects for a specific image build version.
listWorkflowExecutions in interface AWSimagebuilderlistWorkflowExecutionsRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.InvalidPaginationTokenException - You have provided an invalid pagination token in your request.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public ListWorkflowStepExecutionsResult listWorkflowStepExecutions(ListWorkflowStepExecutionsRequest request)
Shows runtime data for each step in a runtime instance of the workflow that you specify in the request.
listWorkflowStepExecutions in interface AWSimagebuilderlistWorkflowStepExecutionsRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.InvalidPaginationTokenException - You have provided an invalid pagination token in your request.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public PutComponentPolicyResult putComponentPolicy(PutComponentPolicyRequest request)
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 AWSimagebuilderputComponentPolicyRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.InvalidParameterValueException - The value that you provided for the specified parameter is invalid.ResourceNotFoundException - At least one of the resources referenced by your request does not exist.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public PutContainerRecipePolicyResult putContainerRecipePolicy(PutContainerRecipePolicyRequest request)
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 AWSimagebuilderputContainerRecipePolicyRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.InvalidParameterValueException - The value that you provided for the specified parameter is invalid.ResourceNotFoundException - At least one of the resources referenced by your request does not exist.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public PutImagePolicyResult putImagePolicy(PutImagePolicyRequest request)
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 AWSimagebuilderputImagePolicyRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.InvalidParameterValueException - The value that you provided for the specified parameter is invalid.ResourceNotFoundException - At least one of the resources referenced by your request does not exist.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public PutImageRecipePolicyResult putImageRecipePolicy(PutImageRecipePolicyRequest request)
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 AWSimagebuilderputImageRecipePolicyRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.InvalidParameterValueException - The value that you provided for the specified parameter is invalid.ResourceNotFoundException - At least one of the resources referenced by your request does not exist.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.public StartImagePipelineExecutionResult startImagePipelineExecution(StartImagePipelineExecutionRequest request)
Manually triggers a pipeline to create an image.
startImagePipelineExecution in interface AWSimagebuilderstartImagePipelineExecutionRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.ResourceNotFoundException - At least one of the resources referenced by your request does not exist.IdempotentParameterMismatchException - You have specified a client token for an operation using parameter values that differ from a previous
request that used the same client token.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.ResourceInUseException - The resource that you are trying to operate on is currently in use. Review the message details and retry
later.public StartResourceStateUpdateResult startResourceStateUpdate(StartResourceStateUpdateRequest request)
Begin asynchronous resource state update for lifecycle changes to the specified image resources.
startResourceStateUpdate in interface AWSimagebuilderstartResourceStateUpdateRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.ResourceNotFoundException - At least one of the resources referenced by your request does not exist.IdempotentParameterMismatchException - You have specified a client token for an operation using parameter values that differ from a previous
request that used the same client token.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.ResourceInUseException - The resource that you are trying to operate on is currently in use. Review the message details and retry
later.public TagResourceResult tagResource(TagResourceRequest request)
Adds a tag to a resource.
tagResource in interface AWSimagebuildertagResourceRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.InvalidParameterException - The specified parameter is invalid. Review the available parameters for the API request.ResourceNotFoundException - At least one of the resources referenced by your request does not exist.public UntagResourceResult untagResource(UntagResourceRequest request)
Removes a tag from a resource.
untagResource in interface AWSimagebuilderuntagResourceRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.InvalidParameterException - The specified parameter is invalid. Review the available parameters for the API request.ResourceNotFoundException - At least one of the resources referenced by your request does not exist.public UpdateDistributionConfigurationResult updateDistributionConfiguration(UpdateDistributionConfigurationRequest request)
Updates a new distribution configuration. Distribution configurations define and configure the outputs of your pipeline.
updateDistributionConfiguration in interface AWSimagebuilderupdateDistributionConfigurationRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.IdempotentParameterMismatchException - You have specified a client token for an operation using parameter values that differ from a previous
request that used the same client token.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.ResourceInUseException - The resource that you are trying to operate on is currently in use. Review the message details and retry
later.InvalidParameterCombinationException - You have specified two or more mutually exclusive parameters. Review the error message for details.public UpdateImagePipelineResult updateImagePipeline(UpdateImagePipelineRequest request)
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 AWSimagebuilderupdateImagePipelineRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.IdempotentParameterMismatchException - You have specified a client token for an operation using parameter values that differ from a previous
request that used the same client token.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.ResourceInUseException - The resource that you are trying to operate on is currently in use. Review the message details and retry
later.public UpdateInfrastructureConfigurationResult updateInfrastructureConfiguration(UpdateInfrastructureConfigurationRequest request)
Updates a new infrastructure configuration. An infrastructure configuration defines the environment in which your image will be built and tested.
updateInfrastructureConfiguration in interface AWSimagebuilderupdateInfrastructureConfigurationRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.IdempotentParameterMismatchException - You have specified a client token for an operation using parameter values that differ from a previous
request that used the same client token.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.ResourceInUseException - The resource that you are trying to operate on is currently in use. Review the message details and retry
later.public UpdateLifecyclePolicyResult updateLifecyclePolicy(UpdateLifecyclePolicyRequest request)
Update the specified lifecycle policy.
updateLifecyclePolicy in interface AWSimagebuilderupdateLifecyclePolicyRequest - ServiceException - This exception is thrown when the service encounters an unrecoverable exception.ClientException - These errors are usually caused by a client action, such as using an action or resource on behalf of a
user that doesn't have permissions to use the action or resource, or specifying an invalid resource
identifier.ServiceUnavailableException - The service is unable to process your request at this time.InvalidRequestException - You have requested an action that that the service doesn't support.IdempotentParameterMismatchException - You have specified a client token for an operation using parameter values that differ from a previous
request that used the same client token.ForbiddenException - You are not authorized to perform the requested operation.CallRateLimitExceededException - You have exceeded the permitted request rate for the specific operation.ResourceInUseException - The resource that you are trying to operate on is currently in use. Review the message details and retry
later.InvalidParameterCombinationException - You have specified two or more mutually exclusive parameters. Review the error message for details.public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
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 the request.
getCachedResponseMetadata in interface AWSimagebuilderrequest - The originally executed requestpublic void shutdown()
AmazonWebServiceClientshutdown in interface AWSimagebuildershutdown in class AmazonWebServiceClient