LambdaMicrovmsClient

Provides APIs to create, manage, and operate AWS Lambda MicroVMs and their associated MicroVM Image environments.

Properties

Link copied to clipboard
abstract override val config: LambdaMicrovmsClient.Config

LambdaMicrovmsClient's configuration

Functions

Link copied to clipboard

Creates an authentication token for accessing a running MicroVM. The token grants access to the specified ports on the MicroVM endpoint.

Link copied to clipboard

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.

Link copied to clipboard

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.

Link copied to clipboard

Deletes a MicroVM image. This operation is idempotent; deleting an image that has already been deleted succeeds without error.

Link copied to clipboard

Deletes a specific version of a MicroVM image. This operation is idempotent; deleting a version that has already been deleted succeeds without error.

Link copied to clipboard
abstract suspend fun getMicrovm(input: GetMicrovmRequest): GetMicrovmResponse

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.

Link copied to clipboard

Retrieves the details of a MicroVM image, including its state, versions, and configuration.

Link copied to clipboard

Retrieves the details of a specific MicroVM image build, including its state, target architecture, and snapshot information.

Link copied to clipboard

Retrieves the details of a specific version of a MicroVM image, including its configuration, state, and build information.

Link copied to clipboard
abstract suspend fun listManagedMicrovmImages(input: ListManagedMicrovmImagesRequest = ListManagedMicrovmImagesRequest { }): ListManagedMicrovmImagesResponse

Lists AWS managed MicroVM images available for use as base images. We recommend using pagination to ensure that the operation returns quickly and successfully.

Link copied to clipboard

Lists versions of a managed MicroVM image. We recommend using pagination to ensure that the operation returns quickly and successfully.

Link copied to clipboard

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.

Link copied to clipboard
abstract suspend fun listMicrovmImages(input: ListMicrovmImagesRequest = ListMicrovmImagesRequest { }): ListMicrovmImagesResponse

Lists MicroVM images in the account with optional name filtering. We recommend using pagination to ensure that the operation returns quickly and successfully.

Link copied to clipboard

Lists versions of a MicroVM image. We recommend using pagination to ensure that the operation returns quickly and successfully.

Link copied to clipboard
abstract suspend fun listMicrovms(input: ListMicrovmsRequest = ListMicrovmsRequest { }): ListMicrovmsResponse

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.

Link copied to clipboard
abstract suspend fun listTags(input: ListTagsRequest): ListTagsResponse

Lists the tags associated with a Lambda MicroVM resource.

Link copied to clipboard

Resumes a suspended MicroVM, restoring it to RUNNING state with all state intact. The MicroVM must be in SUSPENDED state.

Link copied to clipboard
abstract suspend fun runMicrovm(input: RunMicrovmRequest): RunMicrovmResponse

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.

Link copied to clipboard

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.

Link copied to clipboard
abstract suspend fun tagResource(input: TagResourceRequest): TagResourceResponse

Adds tags to a Lambda MicroVM resource.

Link copied to clipboard

Terminates a MicroVM. This operation is idempotent; terminating a MicroVM that has already been terminated succeeds without error.

Link copied to clipboard

Removes tags from a Lambda MicroVM resource.

Link copied to clipboard

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.

Link copied to clipboard

Updates the status of a specific MicroVM image version.

Inherited functions

Link copied to clipboard
expect abstract fun close()
Link copied to clipboard

Creates an authentication token for accessing a running MicroVM. The token grants access to the specified ports on the MicroVM endpoint.

Link copied to clipboard

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.

Link copied to clipboard

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.

Link copied to clipboard

Deletes a MicroVM image. This operation is idempotent; deleting an image that has already been deleted succeeds without error.

Link copied to clipboard

Deletes a specific version of a MicroVM image. This operation is idempotent; deleting a version that has already been deleted succeeds without error.

Link copied to clipboard

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.

Link copied to clipboard

Retrieves the details of a MicroVM image, including its state, versions, and configuration.

Link copied to clipboard

Retrieves the details of a specific MicroVM image build, including its state, target architecture, and snapshot information.

Link copied to clipboard

Retrieves the details of a specific version of a MicroVM image, including its configuration, state, and build information.

Link copied to clipboard

Lists AWS managed MicroVM images available for use as base images. We recommend using pagination to ensure that the operation returns quickly and successfully.

Link copied to clipboard

Lists versions of a managed MicroVM image. We recommend using pagination to ensure that the operation returns quickly and successfully.

Link copied to clipboard

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.

Link copied to clipboard

Lists MicroVM images in the account with optional name filtering. We recommend using pagination to ensure that the operation returns quickly and successfully.

Link copied to clipboard

Lists versions of a MicroVM image. We recommend using pagination to ensure that the operation returns quickly and successfully.

Link copied to clipboard

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.

Link copied to clipboard
inline suspend fun LambdaMicrovmsClient.listTags(crossinline block: ListTagsRequest.Builder.() -> Unit): ListTagsResponse

Lists the tags associated with a Lambda MicroVM resource.

Link copied to clipboard

Resumes a suspended MicroVM, restoring it to RUNNING state with all state intact. The MicroVM must be in SUSPENDED state.

Link copied to clipboard

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.

Link copied to clipboard

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.

Link copied to clipboard

Adds tags to a Lambda MicroVM resource.

Link copied to clipboard

Terminates a MicroVM. This operation is idempotent; terminating a MicroVM that has already been terminated succeeds without error.

Link copied to clipboard

Removes tags from a Lambda MicroVM resource.

Link copied to clipboard

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.

Link copied to clipboard

Updates the status of a specific MicroVM image version.

Link copied to clipboard

Create a copy of the client with one or more configuration values overridden. This method allows the caller to perform scoped config overrides for one or more client operations.