Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1424154118.9 KB

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.

put/2025-09-09/microvm-images/{imageIdentifier}

Path parameters

imageIdentifierstring required

The ARN or ID of the MicroVmImage

The unique identifier (ARN or ID) of the MicroVM image to update.

Request body

baseImageArnstring required

A string which is not empty or blank (only whitespace).

baseImageVersionstring

The specific version of the base MicroVM image to use.

buildRoleArnstring required

The ARN of an IAM role that the service assumes to perform actions on behalf of the caller.

descriptionstring

The description of the MicroVM image.

egressNetworkConnectorsNetworkConnector[]

The list of egress network connectors available to the MicroVM at runtime.

additionalOsCapabilitiesCapability[]

List of capabilities granted to the application when booted

environmentVariablesobject

Environment variables set in the MicroVM runtime environment.

clientTokenstring

A unique, case-sensitive identifier you provide to ensure the idempotency of the request.

Response

Success

imageArnstring required

The ARN of the MicroVM image.

namestring required

The name of the MicroVM image.

state'CREATING' | 'CREATED' | 'CREATE_FAILED' | 'UPDATING' | 'UPDATED' | 'UPDATE_FAILED' | 'DELETING' | 'DELETE_FAILED' | 'DELETED' required

The current state of the MicroVM image.

latestActiveImageVersionstring

The latest active version of the MicroVM image.

latestFailedImageVersionstring

The latest failed version of the MicroVM image, if any.

createdAtstring date-time required

The timestamp when the MicroVM image was created.

baseImageArnstring required

The ARN of the base MicroVM image.

baseImageVersionstring

The specific version of the base MicroVM image.

buildRoleArnstring required

The ARN of the IAM build role.

descriptionstring

The description of the MicroVM image.

egressNetworkConnectorsNetworkConnector[]

The list of egress network connectors available to the MicroVM at runtime.

additionalOsCapabilitiesCapability[]

Additional OS capabilities granted to the MicroVM runtime environment.

environmentVariablesobject

Environment variables set in the MicroVM runtime environment.

updatedAtstring date-time required

The timestamp when the MicroVM image was last updated.

imageVersionstring required

The version of the MicroVM image.