Skip to content

AgentLaunchOptions

Everything a launch takes beyond what the layer fixes (egress on, the image).

optional agentToken?: string;

Persist this secret privately before launch when recovery is needed.


optional autoResume?: boolean;

optional clientToken?: string;

Persist once per intended launch and reuse with the identical request.


optional disableLogging?: boolean;

Turns per-VM logging off. Cannot be combined with logGroup or logStream.


optional egressNetworkConnectors?: string[];

Customer-managed VPC egress connector ARNs. When given they replace the managed internet connector, and the VPC must route to Bedrock.


optional executionRoleArn?: string;

The execution role. Optional in the model; every real launch needs one.


imageIdentifier: string;

The image ARN from findImage or buildImage, or a bare image name, which the core resolves with one ListMicrovmImages read.


optional imageVersion?: string;

Pins the launch to one image version rather than the latest active one.


optional launchEnv?: Record<string, string>;

The base environment for every exec in the VM. See RunOptions.launchEnv.


optional logGroup?: string;

Per-VM CloudWatch log group. Omitted keeps the service’s default destination.


optional logStream?: string;

An exact log stream inside logGroup.


optional maxDurationSec?: number;

optional maxIdleSec?: number;

optional readyTimeout?: number;

How long to wait for RUNNING. The wait for the daemon after it is the core’s defaultReadyTimeoutSeconds.


optional shell?: boolean;

Launch shell-capable. See RunOptions.shell.


optional suspendedSec?: number;

This page is generated from bindings/microvms-js/index.d.ts by TypeDoc 0.28.20 and typedoc-plugin-markdown 4.13.1, run from site/scripts/gen-reference.mjs on every pnpm run sync, so an edit made here is overwritten by the next run.

To change the page, change the doc comment in the binding’s Rust source, then regenerate the declarations with mise run dts. mise run dts:check fails when the committed file no longer matches the source.