@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_METRIC
ENDPOINT_PREFIX
addRequestHandler, addRequestHandler, configureRegion, getClientConfiguration, getEndpointPrefix, getMonitoringListeners, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerOverride, getSignerRegionOverride, getTimeOffset, makeImmutable, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, withEndpoint, withRegion, withRegion, withTimeOffset
public 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 AWSimagebuilder
cancelImageCreationRequest
- 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 made a request for an action that is not supported by the service.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.
createComponent
in interface AWSimagebuilder
createComponentRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
createContainerRecipeRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
createDistributionConfigurationRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
createImageRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
createImagePipelineRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
createImageRecipeRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
createInfrastructureConfigurationRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
deleteComponentRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
deleteContainerRecipeRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
deleteDistributionConfigurationRequest
- 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 made a request for an action that is not supported by the service.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.
deleteImage
in interface AWSimagebuilder
deleteImageRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
deleteImagePipelineRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
deleteImageRecipeRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
deleteInfrastructureConfigurationRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
getComponentRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
getComponentPolicyRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
getContainerRecipeRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
getContainerRecipePolicyRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
getDistributionConfigurationRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
getImageRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
getImagePipelineRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
getImagePolicyRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
getImageRecipeRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
getImageRecipePolicyRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
getInfrastructureConfigurationRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
importComponentRequest
- 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 made a request for an action that is not supported by the service.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 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: When you retrieve or reference a resource with a semantic version, you can use wildcards (x) to filter your results. When you use a wildcard in any node, all nodes to the right of the first wildcard must also be wildcards. For example, specifying "1.2.x", or "1.x.x" works to filter list results, but neither "1.x.2", nor "x.2.x" will work. You do not have to specify the build - Image Builder automatically uses a wildcard for that, if applicable.
listComponentBuildVersions
in interface AWSimagebuilder
listComponentBuildVersionsRequest
- 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 made a request for an action that is not supported by the service.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 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: When you retrieve or reference a resource with a semantic version, you can use wildcards (x) to filter your results. When you use a wildcard in any node, all nodes to the right of the first wildcard must also be wildcards. For example, specifying "1.2.x", or "1.x.x" works to filter list results, but neither "1.x.2", nor "x.2.x" will work. You do not have to specify the build - Image Builder automatically uses a wildcard for that, if applicable.
listComponents
in interface AWSimagebuilder
listComponentsRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
listContainerRecipesRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
listDistributionConfigurationsRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
listImageBuildVersionsRequest
- 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 made a request for an action that is not supported by the service.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 EC2 Systems Manager Inventory at build time.
listImagePackages
in interface AWSimagebuilder
listImagePackagesRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
listImagePipelineImagesRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
listImagePipelinesRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
listImageRecipesRequest
- 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 made a request for an action that is not supported by the service.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.
listImages
in interface AWSimagebuilder
listImagesRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
listInfrastructureConfigurationsRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
listTagsForResourceRequest
- 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 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 AWSimagebuilder
putComponentPolicyRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
putContainerRecipePolicyRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
putImagePolicyRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
putImageRecipePolicyRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
startImagePipelineExecutionRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
tagResourceRequest
- 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 AWSimagebuilder
untagResourceRequest
- 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 AWSimagebuilder
updateDistributionConfigurationRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
updateImagePipelineRequest
- 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 made a request for an action that is not supported by the service.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 AWSimagebuilder
updateInfrastructureConfigurationRequest
- 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 made a request for an action that is not supported by the service.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 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 AWSimagebuilder
request
- The originally executed requestpublic void shutdown()
AmazonWebServiceClient
shutdown
in interface AWSimagebuilder
shutdown
in class AmazonWebServiceClient