Interface LambdaMicrovmsAsyncClient
- All Superinterfaces:
AutoCloseable,AwsClient,SdkAutoCloseable,SdkClient
builder()
method.The asynchronous client performs non-blocking I/O when configured with any SdkAsyncHttpClient
supported in the SDK. However, full non-blocking is not guaranteed as the async client may perform blocking calls in
some cases such as credentials retrieval and endpoint discovery as part of the async API call.
Provides APIs to create, manage, and operate AWS Lambda MicroVMs and their associated MicroVM Image environments.
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final StringValue for looking up the service's metadata from theServiceMetadataProvider.static final String -
Method Summary
Modifier and TypeMethodDescriptionbuilder()Create a builder that can be used to configure and create aLambdaMicrovmsAsyncClient.static LambdaMicrovmsAsyncClientcreate()Create aLambdaMicrovmsAsyncClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider.createMicrovmAuthToken(Consumer<CreateMicrovmAuthTokenRequest.Builder> createMicrovmAuthTokenRequest) Creates an authentication token for accessing a running MicroVM.createMicrovmAuthToken(CreateMicrovmAuthTokenRequest createMicrovmAuthTokenRequest) Creates an authentication token for accessing a running MicroVM.createMicrovmImage(Consumer<CreateMicrovmImageRequest.Builder> createMicrovmImageRequest) Creates a MicroVM image from the specified code artifact and base image.createMicrovmImage(CreateMicrovmImageRequest createMicrovmImageRequest) Creates a MicroVM image from the specified code artifact and base image.createMicrovmShellAuthToken(Consumer<CreateMicrovmShellAuthTokenRequest.Builder> createMicrovmShellAuthTokenRequest) Creates a shell authentication token for interactive shell access to a running MicroVM.createMicrovmShellAuthToken(CreateMicrovmShellAuthTokenRequest createMicrovmShellAuthTokenRequest) Creates a shell authentication token for interactive shell access to a running MicroVM.deleteMicrovmImage(Consumer<DeleteMicrovmImageRequest.Builder> deleteMicrovmImageRequest) Deletes a MicroVM image.deleteMicrovmImage(DeleteMicrovmImageRequest deleteMicrovmImageRequest) Deletes a MicroVM image.deleteMicrovmImageVersion(Consumer<DeleteMicrovmImageVersionRequest.Builder> deleteMicrovmImageVersionRequest) Deletes a specific version of a MicroVM image.deleteMicrovmImageVersion(DeleteMicrovmImageVersionRequest deleteMicrovmImageVersionRequest) Deletes a specific version of a MicroVM image.default CompletableFuture<GetMicrovmResponse> getMicrovm(Consumer<GetMicrovmRequest.Builder> getMicrovmRequest) Retrieves the details of a specific MicroVM, including its state, endpoint, image information, and configuration.default CompletableFuture<GetMicrovmResponse> getMicrovm(GetMicrovmRequest getMicrovmRequest) Retrieves the details of a specific MicroVM, including its state, endpoint, image information, and configuration.default CompletableFuture<GetMicrovmImageResponse> getMicrovmImage(Consumer<GetMicrovmImageRequest.Builder> getMicrovmImageRequest) Retrieves the details of a MicroVM image, including its state, versions, and configuration.default CompletableFuture<GetMicrovmImageResponse> getMicrovmImage(GetMicrovmImageRequest getMicrovmImageRequest) Retrieves the details of a MicroVM image, including its state, versions, and configuration.getMicrovmImageBuild(Consumer<GetMicrovmImageBuildRequest.Builder> getMicrovmImageBuildRequest) Retrieves the details of a specific MicroVM image build, including its state, target architecture, and snapshot information.getMicrovmImageBuild(GetMicrovmImageBuildRequest getMicrovmImageBuildRequest) Retrieves the details of a specific MicroVM image build, including its state, target architecture, and snapshot information.getMicrovmImageVersion(Consumer<GetMicrovmImageVersionRequest.Builder> getMicrovmImageVersionRequest) Retrieves the details of a specific version of a MicroVM image, including its configuration, state, and build information.getMicrovmImageVersion(GetMicrovmImageVersionRequest getMicrovmImageVersionRequest) Retrieves the details of a specific version of a MicroVM image, including its configuration, state, and build information.listManagedMicrovmImages(Consumer<ListManagedMicrovmImagesRequest.Builder> listManagedMicrovmImagesRequest) Lists AWS managed MicroVM images available for use as base images.listManagedMicrovmImages(ListManagedMicrovmImagesRequest listManagedMicrovmImagesRequest) Lists AWS managed MicroVM images available for use as base images.listManagedMicrovmImagesPaginator(Consumer<ListManagedMicrovmImagesRequest.Builder> listManagedMicrovmImagesRequest) This is a variant oflistManagedMicrovmImages(software.amazon.awssdk.services.lambdamicrovms.model.ListManagedMicrovmImagesRequest)operation.listManagedMicrovmImagesPaginator(ListManagedMicrovmImagesRequest listManagedMicrovmImagesRequest) This is a variant oflistManagedMicrovmImages(software.amazon.awssdk.services.lambdamicrovms.model.ListManagedMicrovmImagesRequest)operation.listManagedMicrovmImageVersions(Consumer<ListManagedMicrovmImageVersionsRequest.Builder> listManagedMicrovmImageVersionsRequest) Lists versions of a managed MicroVM image.listManagedMicrovmImageVersions(ListManagedMicrovmImageVersionsRequest listManagedMicrovmImageVersionsRequest) Lists versions of a managed MicroVM image.listManagedMicrovmImageVersionsPaginator(Consumer<ListManagedMicrovmImageVersionsRequest.Builder> listManagedMicrovmImageVersionsRequest) This is a variant oflistManagedMicrovmImageVersions(software.amazon.awssdk.services.lambdamicrovms.model.ListManagedMicrovmImageVersionsRequest)operation.listManagedMicrovmImageVersionsPaginator(ListManagedMicrovmImageVersionsRequest listManagedMicrovmImageVersionsRequest) This is a variant oflistManagedMicrovmImageVersions(software.amazon.awssdk.services.lambdamicrovms.model.ListManagedMicrovmImageVersionsRequest)operation.listMicrovmImageBuilds(Consumer<ListMicrovmImageBuildsRequest.Builder> listMicrovmImageBuildsRequest) Lists builds for a MicroVM image version with optional filtering by architecture and chipset.listMicrovmImageBuilds(ListMicrovmImageBuildsRequest listMicrovmImageBuildsRequest) Lists builds for a MicroVM image version with optional filtering by architecture and chipset.default ListMicrovmImageBuildsPublisherlistMicrovmImageBuildsPaginator(Consumer<ListMicrovmImageBuildsRequest.Builder> listMicrovmImageBuildsRequest) This is a variant oflistMicrovmImageBuilds(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmImageBuildsRequest)operation.default ListMicrovmImageBuildsPublisherlistMicrovmImageBuildsPaginator(ListMicrovmImageBuildsRequest listMicrovmImageBuildsRequest) This is a variant oflistMicrovmImageBuilds(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmImageBuildsRequest)operation.listMicrovmImages(Consumer<ListMicrovmImagesRequest.Builder> listMicrovmImagesRequest) Lists MicroVM images in the account with optional name filtering.listMicrovmImages(ListMicrovmImagesRequest listMicrovmImagesRequest) Lists MicroVM images in the account with optional name filtering.default ListMicrovmImagesPublisherlistMicrovmImagesPaginator(Consumer<ListMicrovmImagesRequest.Builder> listMicrovmImagesRequest) This is a variant oflistMicrovmImages(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmImagesRequest)operation.default ListMicrovmImagesPublisherlistMicrovmImagesPaginator(ListMicrovmImagesRequest listMicrovmImagesRequest) This is a variant oflistMicrovmImages(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmImagesRequest)operation.listMicrovmImageVersions(Consumer<ListMicrovmImageVersionsRequest.Builder> listMicrovmImageVersionsRequest) Lists versions of a MicroVM image.listMicrovmImageVersions(ListMicrovmImageVersionsRequest listMicrovmImageVersionsRequest) Lists versions of a MicroVM image.listMicrovmImageVersionsPaginator(Consumer<ListMicrovmImageVersionsRequest.Builder> listMicrovmImageVersionsRequest) This is a variant oflistMicrovmImageVersions(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmImageVersionsRequest)operation.listMicrovmImageVersionsPaginator(ListMicrovmImageVersionsRequest listMicrovmImageVersionsRequest) This is a variant oflistMicrovmImageVersions(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmImageVersionsRequest)operation.default CompletableFuture<ListMicrovmsResponse> listMicrovms(Consumer<ListMicrovmsRequest.Builder> listMicrovmsRequest) Lists MicroVMs in the account with optional filtering by image and version.default CompletableFuture<ListMicrovmsResponse> listMicrovms(ListMicrovmsRequest listMicrovmsRequest) Lists MicroVMs in the account with optional filtering by image and version.default ListMicrovmsPublisherlistMicrovmsPaginator(Consumer<ListMicrovmsRequest.Builder> listMicrovmsRequest) This is a variant oflistMicrovms(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmsRequest)operation.default ListMicrovmsPublisherlistMicrovmsPaginator(ListMicrovmsRequest listMicrovmsRequest) This is a variant oflistMicrovms(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmsRequest)operation.default CompletableFuture<ListTagsResponse> listTags(Consumer<ListTagsRequest.Builder> listTagsRequest) Lists the tags associated with a Lambda MicroVM resource.default CompletableFuture<ListTagsResponse> listTags(ListTagsRequest listTagsRequest) Lists the tags associated with a Lambda MicroVM resource.default CompletableFuture<ResumeMicrovmResponse> resumeMicrovm(Consumer<ResumeMicrovmRequest.Builder> resumeMicrovmRequest) Resumes a suspended MicroVM, restoring it to RUNNING state with all state intact.default CompletableFuture<ResumeMicrovmResponse> resumeMicrovm(ResumeMicrovmRequest resumeMicrovmRequest) Resumes a suspended MicroVM, restoring it to RUNNING state with all state intact.default CompletableFuture<RunMicrovmResponse> runMicrovm(Consumer<RunMicrovmRequest.Builder> runMicrovmRequest) Runs a new MicroVM from the specified image.default CompletableFuture<RunMicrovmResponse> runMicrovm(RunMicrovmRequest runMicrovmRequest) Runs a new MicroVM from the specified image.The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfigurationdefault CompletableFuture<SuspendMicrovmResponse> suspendMicrovm(Consumer<SuspendMicrovmRequest.Builder> suspendMicrovmRequest) Suspends a running MicroVM, preserving its full memory and disk state.default CompletableFuture<SuspendMicrovmResponse> suspendMicrovm(SuspendMicrovmRequest suspendMicrovmRequest) Suspends a running MicroVM, preserving its full memory and disk state.default CompletableFuture<TagResourceResponse> tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) Adds tags to a Lambda MicroVM resource.default CompletableFuture<TagResourceResponse> tagResource(TagResourceRequest tagResourceRequest) Adds tags to a Lambda MicroVM resource.terminateMicrovm(Consumer<TerminateMicrovmRequest.Builder> terminateMicrovmRequest) Terminates a MicroVM.terminateMicrovm(TerminateMicrovmRequest terminateMicrovmRequest) Terminates a MicroVM.default CompletableFuture<UntagResourceResponse> untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) Removes tags from a Lambda MicroVM resource.default CompletableFuture<UntagResourceResponse> untagResource(UntagResourceRequest untagResourceRequest) Removes tags from a Lambda MicroVM resource.updateMicrovmImage(Consumer<UpdateMicrovmImageRequest.Builder> updateMicrovmImageRequest) Updates the configuration of a MicroVM image and triggers a new version build.updateMicrovmImage(UpdateMicrovmImageRequest updateMicrovmImageRequest) Updates the configuration of a MicroVM image and triggers a new version build.updateMicrovmImageVersion(Consumer<UpdateMicrovmImageVersionRequest.Builder> updateMicrovmImageVersionRequest) Updates the status of a specific MicroVM image version.updateMicrovmImageVersion(UpdateMicrovmImageVersionRequest updateMicrovmImageVersionRequest) Updates the status of a specific MicroVM image version.Methods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable
closeMethods inherited from interface software.amazon.awssdk.core.SdkClient
serviceName
-
Field Details
-
SERVICE_NAME
- See Also:
-
SERVICE_METADATA_ID
Value for looking up the service's metadata from theServiceMetadataProvider.- See Also:
-
-
Method Details
-
createMicrovmAuthToken
default CompletableFuture<CreateMicrovmAuthTokenResponse> createMicrovmAuthToken(CreateMicrovmAuthTokenRequest createMicrovmAuthTokenRequest) Creates an authentication token for accessing a running MicroVM. The token grants access to the specified ports on the MicroVM endpoint.
- Parameters:
createMicrovmAuthTokenRequest-- Returns:
- A Java Future containing the result of the CreateMicrovmAuthToken operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createMicrovmAuthToken
default CompletableFuture<CreateMicrovmAuthTokenResponse> createMicrovmAuthToken(Consumer<CreateMicrovmAuthTokenRequest.Builder> createMicrovmAuthTokenRequest) Creates an authentication token for accessing a running MicroVM. The token grants access to the specified ports on the MicroVM endpoint.
This is a convenience which creates an instance of the
CreateMicrovmAuthTokenRequest.Builderavoiding the need to create one manually viaCreateMicrovmAuthTokenRequest.builder()- Parameters:
createMicrovmAuthTokenRequest- AConsumerthat will call methods onCreateMicrovmAuthTokenRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the CreateMicrovmAuthToken operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createMicrovmImage
default CompletableFuture<CreateMicrovmImageResponse> createMicrovmImage(CreateMicrovmImageRequest createMicrovmImageRequest) Creates a MicroVM image from the specified code artifact and base image. The build is asynchronous — the image transitions from CREATING to CREATED on success, or CREATE_FAILED on failure. Use GetMicrovmImage to poll for completion.
- Parameters:
createMicrovmImageRequest-- Returns:
- A Java Future containing the result of the CreateMicrovmImage operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ConflictException The request could not be completed due to a conflict with the current state of the resource.
- ValidationException The input does not satisfy the constraints specified by the service.
- ServiceQuotaExceededException You have exceeded a service quota for Lambda MicroVMs.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createMicrovmImage
default CompletableFuture<CreateMicrovmImageResponse> createMicrovmImage(Consumer<CreateMicrovmImageRequest.Builder> createMicrovmImageRequest) Creates a MicroVM image from the specified code artifact and base image. The build is asynchronous — the image transitions from CREATING to CREATED on success, or CREATE_FAILED on failure. Use GetMicrovmImage to poll for completion.
This is a convenience which creates an instance of the
CreateMicrovmImageRequest.Builderavoiding the need to create one manually viaCreateMicrovmImageRequest.builder()- Parameters:
createMicrovmImageRequest- AConsumerthat will call methods onCreateMicrovmImageRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the CreateMicrovmImage operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ConflictException The request could not be completed due to a conflict with the current state of the resource.
- ValidationException The input does not satisfy the constraints specified by the service.
- ServiceQuotaExceededException You have exceeded a service quota for Lambda MicroVMs.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createMicrovmShellAuthToken
default CompletableFuture<CreateMicrovmShellAuthTokenResponse> createMicrovmShellAuthToken(CreateMicrovmShellAuthTokenRequest createMicrovmShellAuthTokenRequest) Creates a shell authentication token for interactive shell access to a running MicroVM. The MicroVM must have been run with the SHELL_INGRESS network connector attached.
- Parameters:
createMicrovmShellAuthTokenRequest-- Returns:
- A Java Future containing the result of the CreateMicrovmShellAuthToken operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createMicrovmShellAuthToken
default CompletableFuture<CreateMicrovmShellAuthTokenResponse> createMicrovmShellAuthToken(Consumer<CreateMicrovmShellAuthTokenRequest.Builder> createMicrovmShellAuthTokenRequest) Creates a shell authentication token for interactive shell access to a running MicroVM. The MicroVM must have been run with the SHELL_INGRESS network connector attached.
This is a convenience which creates an instance of the
CreateMicrovmShellAuthTokenRequest.Builderavoiding the need to create one manually viaCreateMicrovmShellAuthTokenRequest.builder()- Parameters:
createMicrovmShellAuthTokenRequest- AConsumerthat will call methods onCreateMicrovmShellAuthTokenRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the CreateMicrovmShellAuthToken operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteMicrovmImage
default CompletableFuture<DeleteMicrovmImageResponse> deleteMicrovmImage(DeleteMicrovmImageRequest deleteMicrovmImageRequest) Deletes a MicroVM image. This operation is idempotent; deleting an image that has already been deleted succeeds without error.
- Parameters:
deleteMicrovmImageRequest-- Returns:
- A Java Future containing the result of the DeleteMicrovmImage operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ConflictException The request could not be completed due to a conflict with the current state of the resource.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteMicrovmImage
default CompletableFuture<DeleteMicrovmImageResponse> deleteMicrovmImage(Consumer<DeleteMicrovmImageRequest.Builder> deleteMicrovmImageRequest) Deletes a MicroVM image. This operation is idempotent; deleting an image that has already been deleted succeeds without error.
This is a convenience which creates an instance of the
DeleteMicrovmImageRequest.Builderavoiding the need to create one manually viaDeleteMicrovmImageRequest.builder()- Parameters:
deleteMicrovmImageRequest- AConsumerthat will call methods onDeleteMicrovmImageRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the DeleteMicrovmImage operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ConflictException The request could not be completed due to a conflict with the current state of the resource.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteMicrovmImageVersion
default CompletableFuture<DeleteMicrovmImageVersionResponse> deleteMicrovmImageVersion(DeleteMicrovmImageVersionRequest deleteMicrovmImageVersionRequest) Deletes a specific version of a MicroVM image. This operation is idempotent; deleting a version that has already been deleted succeeds without error.
- Parameters:
deleteMicrovmImageVersionRequest-- Returns:
- A Java Future containing the result of the DeleteMicrovmImageVersion operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ConflictException The request could not be completed due to a conflict with the current state of the resource.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteMicrovmImageVersion
default CompletableFuture<DeleteMicrovmImageVersionResponse> deleteMicrovmImageVersion(Consumer<DeleteMicrovmImageVersionRequest.Builder> deleteMicrovmImageVersionRequest) Deletes a specific version of a MicroVM image. This operation is idempotent; deleting a version that has already been deleted succeeds without error.
This is a convenience which creates an instance of the
DeleteMicrovmImageVersionRequest.Builderavoiding the need to create one manually viaDeleteMicrovmImageVersionRequest.builder()- Parameters:
deleteMicrovmImageVersionRequest- AConsumerthat will call methods onDeleteMicrovmImageVersionRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the DeleteMicrovmImageVersion operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ConflictException The request could not be completed due to a conflict with the current state of the resource.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
getMicrovm
Retrieves the details of a specific MicroVM, including its state, endpoint, image information, and configuration. The state field is eventually consistent — determine readiness by connecting to the endpoint.
- Parameters:
getMicrovmRequest-- Returns:
- A Java Future containing the result of the GetMicrovm operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
getMicrovm
default CompletableFuture<GetMicrovmResponse> getMicrovm(Consumer<GetMicrovmRequest.Builder> getMicrovmRequest) Retrieves the details of a specific MicroVM, including its state, endpoint, image information, and configuration. The state field is eventually consistent — determine readiness by connecting to the endpoint.
This is a convenience which creates an instance of the
GetMicrovmRequest.Builderavoiding the need to create one manually viaGetMicrovmRequest.builder()- Parameters:
getMicrovmRequest- AConsumerthat will call methods onGetMicrovmRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the GetMicrovm operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
getMicrovmImage
default CompletableFuture<GetMicrovmImageResponse> getMicrovmImage(GetMicrovmImageRequest getMicrovmImageRequest) Retrieves the details of a MicroVM image, including its state, versions, and configuration.
- Parameters:
getMicrovmImageRequest-- Returns:
- A Java Future containing the result of the GetMicrovmImage operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
getMicrovmImage
default CompletableFuture<GetMicrovmImageResponse> getMicrovmImage(Consumer<GetMicrovmImageRequest.Builder> getMicrovmImageRequest) Retrieves the details of a MicroVM image, including its state, versions, and configuration.
This is a convenience which creates an instance of the
GetMicrovmImageRequest.Builderavoiding the need to create one manually viaGetMicrovmImageRequest.builder()- Parameters:
getMicrovmImageRequest- AConsumerthat will call methods onGetMicrovmImageRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the GetMicrovmImage operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
getMicrovmImageBuild
default CompletableFuture<GetMicrovmImageBuildResponse> getMicrovmImageBuild(GetMicrovmImageBuildRequest getMicrovmImageBuildRequest) Retrieves the details of a specific MicroVM image build, including its state, target architecture, and snapshot information.
- Parameters:
getMicrovmImageBuildRequest-- Returns:
- A Java Future containing the result of the GetMicrovmImageBuild operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
getMicrovmImageBuild
default CompletableFuture<GetMicrovmImageBuildResponse> getMicrovmImageBuild(Consumer<GetMicrovmImageBuildRequest.Builder> getMicrovmImageBuildRequest) Retrieves the details of a specific MicroVM image build, including its state, target architecture, and snapshot information.
This is a convenience which creates an instance of the
GetMicrovmImageBuildRequest.Builderavoiding the need to create one manually viaGetMicrovmImageBuildRequest.builder()- Parameters:
getMicrovmImageBuildRequest- AConsumerthat will call methods onGetMicrovmImageBuildRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the GetMicrovmImageBuild operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
getMicrovmImageVersion
default CompletableFuture<GetMicrovmImageVersionResponse> getMicrovmImageVersion(GetMicrovmImageVersionRequest getMicrovmImageVersionRequest) Retrieves the details of a specific version of a MicroVM image, including its configuration, state, and build information.
- Parameters:
getMicrovmImageVersionRequest-- Returns:
- A Java Future containing the result of the GetMicrovmImageVersion operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
getMicrovmImageVersion
default CompletableFuture<GetMicrovmImageVersionResponse> getMicrovmImageVersion(Consumer<GetMicrovmImageVersionRequest.Builder> getMicrovmImageVersionRequest) Retrieves the details of a specific version of a MicroVM image, including its configuration, state, and build information.
This is a convenience which creates an instance of the
GetMicrovmImageVersionRequest.Builderavoiding the need to create one manually viaGetMicrovmImageVersionRequest.builder()- Parameters:
getMicrovmImageVersionRequest- AConsumerthat will call methods onGetMicrovmImageVersionRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the GetMicrovmImageVersion operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listManagedMicrovmImageVersions
default CompletableFuture<ListManagedMicrovmImageVersionsResponse> listManagedMicrovmImageVersions(ListManagedMicrovmImageVersionsRequest listManagedMicrovmImageVersionsRequest) Lists versions of a managed MicroVM image. We recommend using pagination to ensure that the operation returns quickly and successfully.
- Parameters:
listManagedMicrovmImageVersionsRequest-- Returns:
- A Java Future containing the result of the ListManagedMicrovmImageVersions operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listManagedMicrovmImageVersions
default CompletableFuture<ListManagedMicrovmImageVersionsResponse> listManagedMicrovmImageVersions(Consumer<ListManagedMicrovmImageVersionsRequest.Builder> listManagedMicrovmImageVersionsRequest) Lists versions of a managed MicroVM image. We recommend using pagination to ensure that the operation returns quickly and successfully.
This is a convenience which creates an instance of the
ListManagedMicrovmImageVersionsRequest.Builderavoiding the need to create one manually viaListManagedMicrovmImageVersionsRequest.builder()- Parameters:
listManagedMicrovmImageVersionsRequest- AConsumerthat will call methods onListManagedMicrovmImageVersionsRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the ListManagedMicrovmImageVersions operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listManagedMicrovmImageVersionsPaginator
default ListManagedMicrovmImageVersionsPublisher listManagedMicrovmImageVersionsPaginator(ListManagedMicrovmImageVersionsRequest listManagedMicrovmImageVersionsRequest) This is a variant of
listManagedMicrovmImageVersions(software.amazon.awssdk.services.lambdamicrovms.model.ListManagedMicrovmImageVersionsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.lambdamicrovms.paginators.ListManagedMicrovmImageVersionsPublisher publisher = client.listManagedMicrovmImageVersionsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.lambdamicrovms.paginators.ListManagedMicrovmImageVersionsPublisher publisher = client.listManagedMicrovmImageVersionsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.lambdamicrovms.model.ListManagedMicrovmImageVersionsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.lambdamicrovms.model.ListManagedMicrovmImageVersionsResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listManagedMicrovmImageVersions(software.amazon.awssdk.services.lambdamicrovms.model.ListManagedMicrovmImageVersionsRequest)operation.- Parameters:
listManagedMicrovmImageVersionsRequest-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listManagedMicrovmImageVersionsPaginator
default ListManagedMicrovmImageVersionsPublisher listManagedMicrovmImageVersionsPaginator(Consumer<ListManagedMicrovmImageVersionsRequest.Builder> listManagedMicrovmImageVersionsRequest) This is a variant of
listManagedMicrovmImageVersions(software.amazon.awssdk.services.lambdamicrovms.model.ListManagedMicrovmImageVersionsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.lambdamicrovms.paginators.ListManagedMicrovmImageVersionsPublisher publisher = client.listManagedMicrovmImageVersionsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.lambdamicrovms.paginators.ListManagedMicrovmImageVersionsPublisher publisher = client.listManagedMicrovmImageVersionsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.lambdamicrovms.model.ListManagedMicrovmImageVersionsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.lambdamicrovms.model.ListManagedMicrovmImageVersionsResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listManagedMicrovmImageVersions(software.amazon.awssdk.services.lambdamicrovms.model.ListManagedMicrovmImageVersionsRequest)operation.
This is a convenience which creates an instance of the
ListManagedMicrovmImageVersionsRequest.Builderavoiding the need to create one manually viaListManagedMicrovmImageVersionsRequest.builder()- Parameters:
listManagedMicrovmImageVersionsRequest- AConsumerthat will call methods onListManagedMicrovmImageVersionsRequest.Builderto create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listManagedMicrovmImages
default CompletableFuture<ListManagedMicrovmImagesResponse> listManagedMicrovmImages(ListManagedMicrovmImagesRequest listManagedMicrovmImagesRequest) Lists AWS managed MicroVM images available for use as base images. We recommend using pagination to ensure that the operation returns quickly and successfully.
- Parameters:
listManagedMicrovmImagesRequest-- Returns:
- A Java Future containing the result of the ListManagedMicrovmImages operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listManagedMicrovmImages
default CompletableFuture<ListManagedMicrovmImagesResponse> listManagedMicrovmImages(Consumer<ListManagedMicrovmImagesRequest.Builder> listManagedMicrovmImagesRequest) Lists AWS managed MicroVM images available for use as base images. We recommend using pagination to ensure that the operation returns quickly and successfully.
This is a convenience which creates an instance of the
ListManagedMicrovmImagesRequest.Builderavoiding the need to create one manually viaListManagedMicrovmImagesRequest.builder()- Parameters:
listManagedMicrovmImagesRequest- AConsumerthat will call methods onListManagedMicrovmImagesRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the ListManagedMicrovmImages operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listManagedMicrovmImagesPaginator
default ListManagedMicrovmImagesPublisher listManagedMicrovmImagesPaginator(ListManagedMicrovmImagesRequest listManagedMicrovmImagesRequest) This is a variant of
listManagedMicrovmImages(software.amazon.awssdk.services.lambdamicrovms.model.ListManagedMicrovmImagesRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.lambdamicrovms.paginators.ListManagedMicrovmImagesPublisher publisher = client.listManagedMicrovmImagesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.lambdamicrovms.paginators.ListManagedMicrovmImagesPublisher publisher = client.listManagedMicrovmImagesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.lambdamicrovms.model.ListManagedMicrovmImagesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.lambdamicrovms.model.ListManagedMicrovmImagesResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listManagedMicrovmImages(software.amazon.awssdk.services.lambdamicrovms.model.ListManagedMicrovmImagesRequest)operation.- Parameters:
listManagedMicrovmImagesRequest-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listManagedMicrovmImagesPaginator
default ListManagedMicrovmImagesPublisher listManagedMicrovmImagesPaginator(Consumer<ListManagedMicrovmImagesRequest.Builder> listManagedMicrovmImagesRequest) This is a variant of
listManagedMicrovmImages(software.amazon.awssdk.services.lambdamicrovms.model.ListManagedMicrovmImagesRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.lambdamicrovms.paginators.ListManagedMicrovmImagesPublisher publisher = client.listManagedMicrovmImagesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.lambdamicrovms.paginators.ListManagedMicrovmImagesPublisher publisher = client.listManagedMicrovmImagesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.lambdamicrovms.model.ListManagedMicrovmImagesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.lambdamicrovms.model.ListManagedMicrovmImagesResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listManagedMicrovmImages(software.amazon.awssdk.services.lambdamicrovms.model.ListManagedMicrovmImagesRequest)operation.
This is a convenience which creates an instance of the
ListManagedMicrovmImagesRequest.Builderavoiding the need to create one manually viaListManagedMicrovmImagesRequest.builder()- Parameters:
listManagedMicrovmImagesRequest- AConsumerthat will call methods onListManagedMicrovmImagesRequest.Builderto create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listMicrovmImageBuilds
default CompletableFuture<ListMicrovmImageBuildsResponse> listMicrovmImageBuilds(ListMicrovmImageBuildsRequest listMicrovmImageBuildsRequest) Lists builds for a MicroVM image version with optional filtering by architecture and chipset. We recommend using pagination to ensure that the operation returns quickly and successfully.
- Parameters:
listMicrovmImageBuildsRequest-- Returns:
- A Java Future containing the result of the ListMicrovmImageBuilds operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listMicrovmImageBuilds
default CompletableFuture<ListMicrovmImageBuildsResponse> listMicrovmImageBuilds(Consumer<ListMicrovmImageBuildsRequest.Builder> listMicrovmImageBuildsRequest) Lists builds for a MicroVM image version with optional filtering by architecture and chipset. We recommend using pagination to ensure that the operation returns quickly and successfully.
This is a convenience which creates an instance of the
ListMicrovmImageBuildsRequest.Builderavoiding the need to create one manually viaListMicrovmImageBuildsRequest.builder()- Parameters:
listMicrovmImageBuildsRequest- AConsumerthat will call methods onListMicrovmImageBuildsRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the ListMicrovmImageBuilds operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listMicrovmImageBuildsPaginator
default ListMicrovmImageBuildsPublisher listMicrovmImageBuildsPaginator(ListMicrovmImageBuildsRequest listMicrovmImageBuildsRequest) This is a variant of
listMicrovmImageBuilds(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmImageBuildsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.lambdamicrovms.paginators.ListMicrovmImageBuildsPublisher publisher = client.listMicrovmImageBuildsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.lambdamicrovms.paginators.ListMicrovmImageBuildsPublisher publisher = client.listMicrovmImageBuildsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmImageBuildsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmImageBuildsResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listMicrovmImageBuilds(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmImageBuildsRequest)operation.- Parameters:
listMicrovmImageBuildsRequest-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listMicrovmImageBuildsPaginator
default ListMicrovmImageBuildsPublisher listMicrovmImageBuildsPaginator(Consumer<ListMicrovmImageBuildsRequest.Builder> listMicrovmImageBuildsRequest) This is a variant of
listMicrovmImageBuilds(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmImageBuildsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.lambdamicrovms.paginators.ListMicrovmImageBuildsPublisher publisher = client.listMicrovmImageBuildsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.lambdamicrovms.paginators.ListMicrovmImageBuildsPublisher publisher = client.listMicrovmImageBuildsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmImageBuildsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmImageBuildsResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listMicrovmImageBuilds(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmImageBuildsRequest)operation.
This is a convenience which creates an instance of the
ListMicrovmImageBuildsRequest.Builderavoiding the need to create one manually viaListMicrovmImageBuildsRequest.builder()- Parameters:
listMicrovmImageBuildsRequest- AConsumerthat will call methods onListMicrovmImageBuildsRequest.Builderto create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listMicrovmImageVersions
default CompletableFuture<ListMicrovmImageVersionsResponse> listMicrovmImageVersions(ListMicrovmImageVersionsRequest listMicrovmImageVersionsRequest) Lists versions of a MicroVM image. We recommend using pagination to ensure that the operation returns quickly and successfully.
- Parameters:
listMicrovmImageVersionsRequest-- Returns:
- A Java Future containing the result of the ListMicrovmImageVersions operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listMicrovmImageVersions
default CompletableFuture<ListMicrovmImageVersionsResponse> listMicrovmImageVersions(Consumer<ListMicrovmImageVersionsRequest.Builder> listMicrovmImageVersionsRequest) Lists versions of a MicroVM image. We recommend using pagination to ensure that the operation returns quickly and successfully.
This is a convenience which creates an instance of the
ListMicrovmImageVersionsRequest.Builderavoiding the need to create one manually viaListMicrovmImageVersionsRequest.builder()- Parameters:
listMicrovmImageVersionsRequest- AConsumerthat will call methods onListMicrovmImageVersionsRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the ListMicrovmImageVersions operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listMicrovmImageVersionsPaginator
default ListMicrovmImageVersionsPublisher listMicrovmImageVersionsPaginator(ListMicrovmImageVersionsRequest listMicrovmImageVersionsRequest) This is a variant of
listMicrovmImageVersions(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmImageVersionsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.lambdamicrovms.paginators.ListMicrovmImageVersionsPublisher publisher = client.listMicrovmImageVersionsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.lambdamicrovms.paginators.ListMicrovmImageVersionsPublisher publisher = client.listMicrovmImageVersionsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmImageVersionsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmImageVersionsResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listMicrovmImageVersions(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmImageVersionsRequest)operation.- Parameters:
listMicrovmImageVersionsRequest-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listMicrovmImageVersionsPaginator
default ListMicrovmImageVersionsPublisher listMicrovmImageVersionsPaginator(Consumer<ListMicrovmImageVersionsRequest.Builder> listMicrovmImageVersionsRequest) This is a variant of
listMicrovmImageVersions(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmImageVersionsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.lambdamicrovms.paginators.ListMicrovmImageVersionsPublisher publisher = client.listMicrovmImageVersionsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.lambdamicrovms.paginators.ListMicrovmImageVersionsPublisher publisher = client.listMicrovmImageVersionsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmImageVersionsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmImageVersionsResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listMicrovmImageVersions(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmImageVersionsRequest)operation.
This is a convenience which creates an instance of the
ListMicrovmImageVersionsRequest.Builderavoiding the need to create one manually viaListMicrovmImageVersionsRequest.builder()- Parameters:
listMicrovmImageVersionsRequest- AConsumerthat will call methods onListMicrovmImageVersionsRequest.Builderto create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listMicrovmImages
default CompletableFuture<ListMicrovmImagesResponse> listMicrovmImages(ListMicrovmImagesRequest listMicrovmImagesRequest) Lists MicroVM images in the account with optional name filtering. We recommend using pagination to ensure that the operation returns quickly and successfully.
- Parameters:
listMicrovmImagesRequest-- Returns:
- A Java Future containing the result of the ListMicrovmImages operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listMicrovmImages
default CompletableFuture<ListMicrovmImagesResponse> listMicrovmImages(Consumer<ListMicrovmImagesRequest.Builder> listMicrovmImagesRequest) Lists MicroVM images in the account with optional name filtering. We recommend using pagination to ensure that the operation returns quickly and successfully.
This is a convenience which creates an instance of the
ListMicrovmImagesRequest.Builderavoiding the need to create one manually viaListMicrovmImagesRequest.builder()- Parameters:
listMicrovmImagesRequest- AConsumerthat will call methods onListMicrovmImagesRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the ListMicrovmImages operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listMicrovmImagesPaginator
default ListMicrovmImagesPublisher listMicrovmImagesPaginator(ListMicrovmImagesRequest listMicrovmImagesRequest) This is a variant of
listMicrovmImages(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmImagesRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.lambdamicrovms.paginators.ListMicrovmImagesPublisher publisher = client.listMicrovmImagesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.lambdamicrovms.paginators.ListMicrovmImagesPublisher publisher = client.listMicrovmImagesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmImagesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmImagesResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listMicrovmImages(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmImagesRequest)operation.- Parameters:
listMicrovmImagesRequest-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listMicrovmImagesPaginator
default ListMicrovmImagesPublisher listMicrovmImagesPaginator(Consumer<ListMicrovmImagesRequest.Builder> listMicrovmImagesRequest) This is a variant of
listMicrovmImages(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmImagesRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.lambdamicrovms.paginators.ListMicrovmImagesPublisher publisher = client.listMicrovmImagesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.lambdamicrovms.paginators.ListMicrovmImagesPublisher publisher = client.listMicrovmImagesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmImagesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmImagesResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listMicrovmImages(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmImagesRequest)operation.
This is a convenience which creates an instance of the
ListMicrovmImagesRequest.Builderavoiding the need to create one manually viaListMicrovmImagesRequest.builder()- Parameters:
listMicrovmImagesRequest- AConsumerthat will call methods onListMicrovmImagesRequest.Builderto create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listMicrovms
default CompletableFuture<ListMicrovmsResponse> listMicrovms(ListMicrovmsRequest listMicrovmsRequest) Lists MicroVMs in the account with optional filtering by image and version. We recommend using pagination to ensure that the operation returns quickly and successfully.
- Parameters:
listMicrovmsRequest-- Returns:
- A Java Future containing the result of the ListMicrovms operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listMicrovms
default CompletableFuture<ListMicrovmsResponse> listMicrovms(Consumer<ListMicrovmsRequest.Builder> listMicrovmsRequest) Lists MicroVMs in the account with optional filtering by image and version. We recommend using pagination to ensure that the operation returns quickly and successfully.
This is a convenience which creates an instance of the
ListMicrovmsRequest.Builderavoiding the need to create one manually viaListMicrovmsRequest.builder()- Parameters:
listMicrovmsRequest- AConsumerthat will call methods onListMicrovmsRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the ListMicrovms operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listMicrovmsPaginator
This is a variant of
listMicrovms(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.lambdamicrovms.paginators.ListMicrovmsPublisher publisher = client.listMicrovmsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.lambdamicrovms.paginators.ListMicrovmsPublisher publisher = client.listMicrovmsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmsResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listMicrovms(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmsRequest)operation.- Parameters:
listMicrovmsRequest-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listMicrovmsPaginator
default ListMicrovmsPublisher listMicrovmsPaginator(Consumer<ListMicrovmsRequest.Builder> listMicrovmsRequest) This is a variant of
listMicrovms(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.lambdamicrovms.paginators.ListMicrovmsPublisher publisher = client.listMicrovmsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.lambdamicrovms.paginators.ListMicrovmsPublisher publisher = client.listMicrovmsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmsResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listMicrovms(software.amazon.awssdk.services.lambdamicrovms.model.ListMicrovmsRequest)operation.
This is a convenience which creates an instance of the
ListMicrovmsRequest.Builderavoiding the need to create one manually viaListMicrovmsRequest.builder()- Parameters:
listMicrovmsRequest- AConsumerthat will call methods onListMicrovmsRequest.Builderto create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listTags
Lists the tags associated with a Lambda MicroVM resource.
- Parameters:
listTagsRequest-- Returns:
- A Java Future containing the result of the ListTags operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- TooManyRequestsException The request throughput limit was exceeded. Retry the request later.
- ResourceNotFoundException The specified resource does not exist.
- ServiceException The AWS Lambda MicroVMs service encountered an internal error.
- InvalidParameterValueException One of the parameters in the request is not valid.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listTags
default CompletableFuture<ListTagsResponse> listTags(Consumer<ListTagsRequest.Builder> listTagsRequest) Lists the tags associated with a Lambda MicroVM resource.
This is a convenience which creates an instance of the
ListTagsRequest.Builderavoiding the need to create one manually viaListTagsRequest.builder()- Parameters:
listTagsRequest- AConsumerthat will call methods onListTagsRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the ListTags operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- TooManyRequestsException The request throughput limit was exceeded. Retry the request later.
- ResourceNotFoundException The specified resource does not exist.
- ServiceException The AWS Lambda MicroVMs service encountered an internal error.
- InvalidParameterValueException One of the parameters in the request is not valid.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
resumeMicrovm
default CompletableFuture<ResumeMicrovmResponse> resumeMicrovm(ResumeMicrovmRequest resumeMicrovmRequest) Resumes a suspended MicroVM, restoring it to RUNNING state with all state intact. The MicroVM must be in SUSPENDED state.
- Parameters:
resumeMicrovmRequest-- Returns:
- A Java Future containing the result of the ResumeMicrovm operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ConflictException The request could not be completed due to a conflict with the current state of the resource.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
resumeMicrovm
default CompletableFuture<ResumeMicrovmResponse> resumeMicrovm(Consumer<ResumeMicrovmRequest.Builder> resumeMicrovmRequest) Resumes a suspended MicroVM, restoring it to RUNNING state with all state intact. The MicroVM must be in SUSPENDED state.
This is a convenience which creates an instance of the
ResumeMicrovmRequest.Builderavoiding the need to create one manually viaResumeMicrovmRequest.builder()- Parameters:
resumeMicrovmRequest- AConsumerthat will call methods onResumeMicrovmRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the ResumeMicrovm operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ConflictException The request could not be completed due to a conflict with the current state of the resource.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
runMicrovm
Runs a new MicroVM from the specified image. The MicroVM starts in PENDING state and transitions to RUNNING once provisioning completes. To connect, generate an authentication token using CreateMicrovmAuthToken.
- Parameters:
runMicrovmRequest-- Returns:
- A Java Future containing the result of the RunMicrovm operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ConflictException The request could not be completed due to a conflict with the current state of the resource.
- ValidationException The input does not satisfy the constraints specified by the service.
- ServiceQuotaExceededException You have exceeded a service quota for Lambda MicroVMs.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
runMicrovm
default CompletableFuture<RunMicrovmResponse> runMicrovm(Consumer<RunMicrovmRequest.Builder> runMicrovmRequest) Runs a new MicroVM from the specified image. The MicroVM starts in PENDING state and transitions to RUNNING once provisioning completes. To connect, generate an authentication token using CreateMicrovmAuthToken.
This is a convenience which creates an instance of the
RunMicrovmRequest.Builderavoiding the need to create one manually viaRunMicrovmRequest.builder()- Parameters:
runMicrovmRequest- AConsumerthat will call methods onRunMicrovmRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the RunMicrovm operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ConflictException The request could not be completed due to a conflict with the current state of the resource.
- ValidationException The input does not satisfy the constraints specified by the service.
- ServiceQuotaExceededException You have exceeded a service quota for Lambda MicroVMs.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
suspendMicrovm
default CompletableFuture<SuspendMicrovmResponse> suspendMicrovm(SuspendMicrovmRequest suspendMicrovmRequest) Suspends a running MicroVM, preserving its full memory and disk state. The MicroVM transitions through SUSPENDING to SUSPENDED. To restore, call ResumeMicrovm or send traffic to the endpoint if autoResumeEnabled is true.
- Parameters:
suspendMicrovmRequest-- Returns:
- A Java Future containing the result of the SuspendMicrovm operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ConflictException The request could not be completed due to a conflict with the current state of the resource.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
suspendMicrovm
default CompletableFuture<SuspendMicrovmResponse> suspendMicrovm(Consumer<SuspendMicrovmRequest.Builder> suspendMicrovmRequest) Suspends a running MicroVM, preserving its full memory and disk state. The MicroVM transitions through SUSPENDING to SUSPENDED. To restore, call ResumeMicrovm or send traffic to the endpoint if autoResumeEnabled is true.
This is a convenience which creates an instance of the
SuspendMicrovmRequest.Builderavoiding the need to create one manually viaSuspendMicrovmRequest.builder()- Parameters:
suspendMicrovmRequest- AConsumerthat will call methods onSuspendMicrovmRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the SuspendMicrovm operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ConflictException The request could not be completed due to a conflict with the current state of the resource.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
tagResource
Adds tags to a Lambda MicroVM resource.
- Parameters:
tagResourceRequest-- Returns:
- A Java Future containing the result of the TagResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- TooManyRequestsException The request throughput limit was exceeded. Retry the request later.
- ResourceNotFoundException The specified resource does not exist.
- ServiceException The AWS Lambda MicroVMs service encountered an internal error.
- InvalidParameterValueException One of the parameters in the request is not valid.
- ResourceConflictException The resource already exists, or another operation is in progress.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
tagResource
default CompletableFuture<TagResourceResponse> tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) Adds tags to a Lambda MicroVM resource.
This is a convenience which creates an instance of the
TagResourceRequest.Builderavoiding the need to create one manually viaTagResourceRequest.builder()- Parameters:
tagResourceRequest- AConsumerthat will call methods onTagResourceRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the TagResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- TooManyRequestsException The request throughput limit was exceeded. Retry the request later.
- ResourceNotFoundException The specified resource does not exist.
- ServiceException The AWS Lambda MicroVMs service encountered an internal error.
- InvalidParameterValueException One of the parameters in the request is not valid.
- ResourceConflictException The resource already exists, or another operation is in progress.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
terminateMicrovm
default CompletableFuture<TerminateMicrovmResponse> terminateMicrovm(TerminateMicrovmRequest terminateMicrovmRequest) Terminates a MicroVM. This operation is idempotent; terminating a MicroVM that has already been terminated succeeds without error.
- Parameters:
terminateMicrovmRequest-- Returns:
- A Java Future containing the result of the TerminateMicrovm operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ConflictException The request could not be completed due to a conflict with the current state of the resource.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
terminateMicrovm
default CompletableFuture<TerminateMicrovmResponse> terminateMicrovm(Consumer<TerminateMicrovmRequest.Builder> terminateMicrovmRequest) Terminates a MicroVM. This operation is idempotent; terminating a MicroVM that has already been terminated succeeds without error.
This is a convenience which creates an instance of the
TerminateMicrovmRequest.Builderavoiding the need to create one manually viaTerminateMicrovmRequest.builder()- Parameters:
terminateMicrovmRequest- AConsumerthat will call methods onTerminateMicrovmRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the TerminateMicrovm operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ConflictException The request could not be completed due to a conflict with the current state of the resource.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
untagResource
default CompletableFuture<UntagResourceResponse> untagResource(UntagResourceRequest untagResourceRequest) Removes tags from a Lambda MicroVM resource.
- Parameters:
untagResourceRequest-- Returns:
- A Java Future containing the result of the UntagResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- TooManyRequestsException The request throughput limit was exceeded. Retry the request later.
- ResourceNotFoundException The specified resource does not exist.
- ServiceException The AWS Lambda MicroVMs service encountered an internal error.
- InvalidParameterValueException One of the parameters in the request is not valid.
- ResourceConflictException The resource already exists, or another operation is in progress.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
untagResource
default CompletableFuture<UntagResourceResponse> untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) Removes tags from a Lambda MicroVM resource.
This is a convenience which creates an instance of the
UntagResourceRequest.Builderavoiding the need to create one manually viaUntagResourceRequest.builder()- Parameters:
untagResourceRequest- AConsumerthat will call methods onUntagResourceRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the UntagResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- TooManyRequestsException The request throughput limit was exceeded. Retry the request later.
- ResourceNotFoundException The specified resource does not exist.
- ServiceException The AWS Lambda MicroVMs service encountered an internal error.
- InvalidParameterValueException One of the parameters in the request is not valid.
- ResourceConflictException The resource already exists, or another operation is in progress.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
updateMicrovmImage
default CompletableFuture<UpdateMicrovmImageResponse> updateMicrovmImage(UpdateMicrovmImageRequest updateMicrovmImageRequest) Updates the configuration of a MicroVM image and triggers a new version build. This operation uses PUT semantics — all required fields (codeArtifact, baseImageArn, buildRoleArn) must be provided with every request.
- Parameters:
updateMicrovmImageRequest-- Returns:
- A Java Future containing the result of the UpdateMicrovmImage operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ConflictException The request could not be completed due to a conflict with the current state of the resource.
- ValidationException The input does not satisfy the constraints specified by the service.
- ServiceQuotaExceededException You have exceeded a service quota for Lambda MicroVMs.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
updateMicrovmImage
default CompletableFuture<UpdateMicrovmImageResponse> updateMicrovmImage(Consumer<UpdateMicrovmImageRequest.Builder> updateMicrovmImageRequest) Updates the configuration of a MicroVM image and triggers a new version build. This operation uses PUT semantics — all required fields (codeArtifact, baseImageArn, buildRoleArn) must be provided with every request.
This is a convenience which creates an instance of the
UpdateMicrovmImageRequest.Builderavoiding the need to create one manually viaUpdateMicrovmImageRequest.builder()- Parameters:
updateMicrovmImageRequest- AConsumerthat will call methods onUpdateMicrovmImageRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the UpdateMicrovmImage operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ConflictException The request could not be completed due to a conflict with the current state of the resource.
- ValidationException The input does not satisfy the constraints specified by the service.
- ServiceQuotaExceededException You have exceeded a service quota for Lambda MicroVMs.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
updateMicrovmImageVersion
default CompletableFuture<UpdateMicrovmImageVersionResponse> updateMicrovmImageVersion(UpdateMicrovmImageVersionRequest updateMicrovmImageVersionRequest) Updates the status of a specific MicroVM image version.
- Parameters:
updateMicrovmImageVersionRequest-- Returns:
- A Java Future containing the result of the UpdateMicrovmImageVersion operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ConflictException The request could not be completed due to a conflict with the current state of the resource.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
updateMicrovmImageVersion
default CompletableFuture<UpdateMicrovmImageVersionResponse> updateMicrovmImageVersion(Consumer<UpdateMicrovmImageVersionRequest.Builder> updateMicrovmImageVersionRequest) Updates the status of a specific MicroVM image version.
This is a convenience which creates an instance of the
UpdateMicrovmImageVersionRequest.Builderavoiding the need to create one manually viaUpdateMicrovmImageVersionRequest.builder()- Parameters:
updateMicrovmImageVersionRequest- AConsumerthat will call methods onUpdateMicrovmImageVersionRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the UpdateMicrovmImageVersion operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException An internal server error occurred. Retry the request later.
- AccessDeniedException You do not have sufficient access to perform this action.
- ResourceNotFoundException The specified resource does not exist.
- ThrottlingException The request was denied due to request throttling. Retry the request later.
- ConflictException The request could not be completed due to a conflict with the current state of the resource.
- ValidationException The input does not satisfy the constraints specified by the service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LambdaMicrovmsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
serviceClientConfiguration
Description copied from interface:SdkClientThe SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration- Specified by:
serviceClientConfigurationin interfaceAwsClient- Specified by:
serviceClientConfigurationin interfaceSdkClient- Returns:
- SdkServiceClientConfiguration
-
create
Create aLambdaMicrovmsAsyncClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider. -
builder
Create a builder that can be used to configure and create aLambdaMicrovmsAsyncClient.
-