[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-aws-aws-lambda-microvms":3,"mdc-b4nyvl-key":32,"related-repo-aws-aws-lambda-microvms":2639,"related-org-aws-aws-lambda-microvms":2745},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":21,"repoUrl":22,"updatedAt":23,"license":24,"forks":25,"topics":26,"repo":27,"sourceUrl":30,"mdContent":31},"aws-lambda-microvms","build and operate AWS Lambda MicroVMs","Builds, runs, debugs, and operates applications on AWS Lambda MicroVMs — Firecracker-isolated, snapshot-resumable serverless compute environments running inside a container with up to 8 hr lifetimes. Applicable when workloads need strong isolation between tenants, isolated serverless compute, sandbox compute, or secure multi-tenant execution. Also suited for AI\u002Fagent code-execution sandboxes, interactive code playgrounds and notebooks (Jupyter, REPLs, dev environments running user-supplied code), reinforcement-learning environments, multi-tenant CI executors and build runners, sessionful game or simulation servers, or isolated security scanners. Also applicable when the workload needs long-lived sessions, a real port-listening server (gRPC, WebSocket, custom TCP protocols), state preserved across periods of inactivity (suspend\u002Fresume), container-level access (FUSE, eBPF, custom syscalls), or session-affine routing.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"aws","AWS (Amazon)","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Faws.png",[12,16,19],{"name":13,"slug":14,"type":15},"Serverless","serverless","tag",{"name":17,"slug":18,"type":15},"Infrastructure","infrastructure",{"name":20,"slug":8,"type":15},"AWS",1822,"https:\u002F\u002Fgithub.com\u002Faws\u002Fagent-toolkit-for-aws","2026-07-16T06:00:44.325315",null,157,[],{"repoUrl":22,"stars":21,"forks":25,"topics":28,"description":29},[],"Official, AWS-supported MCP servers, skills, and plugins to help AI agents build on AWS","https:\u002F\u002Fgithub.com\u002Faws\u002Fagent-toolkit-for-aws\u002Ftree\u002FHEAD\u002Fskills\u002Fspecialized-skills\u002Fserverless-skills\u002Faws-lambda-microvms","---\nname: aws-lambda-microvms\ndescription: Builds, runs, debugs, and operates applications on AWS Lambda MicroVMs — Firecracker-isolated, snapshot-resumable serverless compute environments running inside a container with up to 8 hr lifetimes. Applicable when workloads need strong isolation between tenants, isolated serverless compute, sandbox compute, or secure multi-tenant execution. Also suited for AI\u002Fagent code-execution sandboxes, interactive code playgrounds and notebooks (Jupyter, REPLs, dev environments running user-supplied code), reinforcement-learning environments, multi-tenant CI executors and build runners, sessionful game or simulation servers, or isolated security scanners. Also applicable when the workload needs long-lived sessions, a real port-listening server (gRPC, WebSocket, custom TCP protocols), state preserved across periods of inactivity (suspend\u002Fresume), container-level access (FUSE, eBPF, custom syscalls), or session-affine routing.\nversion: 1\n---\n\n# AWS Lambda MicroVMs\n\n> The AWS MCP server is recommended for sandboxed execution and audit logging.\n\nAWS Lambda MicroVMs are serverless compute environments that combine Firecracker VM isolation with container-like efficiency. Each MicroVM:\n\n- Runs your application as a **container inside a Firecracker microVM** — you can reproduce the environment locally.\n- Runs Amazon Linux 2023 as the base OS inside the MicroVM.\n- Boots from a **memory + disk snapshot** captured at image build time, so application init is skipped on run.\n- Has a dedicated, TLS-terminated HTTPS endpoint reachable with an auth token.\n- Can be **suspended and resumed** with state preserved; lives up to 8 hours.\n\n**Two-resource model:**\n\n- `MicrovmImage` — a versioned artifact built from `{S3 zip with Dockerfile} + baseImageArn`. Each version has per-architecture\u002Fchipset `Build`s.\n- `Microvm` — a running instance created (`RunMicrovm`) from an image version.\n\n**Two roles:**\n\n- `buildRoleArn` — used during image build (S3 read, CloudWatch logs, optional ECR).\n- `executionRoleArn` — assumed at runtime by the running MicroVM.\n\n## When to use\n\n### Choose Lambda MicroVMs when\n\n- **Analytics workloads** — isolated compute for data processing, ETL jobs, or query execution with strong tenant separation.\n- **AI \u002F agent code execution sandboxes** — fresh, isolated environment per session, fast resume between turns.\n- **Interactive code playgrounds & notebooks** — Jupyter, REPLs, dev environments executing user code.\n- **Reinforcement-learning environments** — clean per-episode envs with tool access.\n- **Multi-tenant CI executors \u002F build runners** — strong tenant isolation.\n- **Game \u002F simulation servers** — sessionful, long-lived (up to 8 hr) workloads.\n- **Security scanning** — running untrusted analyzers in isolation.\n\nIn general, Lambda MicroVMs are suited for long-lived sessions, real port-listening servers (gRPC, WebSocket, custom TCP protocols), state preserved across periods of inactivity (suspend\u002Fresume), container-level access (FUSE, eBPF, custom syscalls), or session-affine routing to a specific compute environment.\n\n### Choose AWS Lambda (functions) when\n\n- The workload fits in 15 minutes.\n- Per-invocation isolation is fine; no need for session state held in memory.\n- Fully automatic scaling is preferred (no `RunMicrovm` to manage).\n- Event-source integrations (S3, SQS, EventBridge, etc.) drive the function.\n\n### Choose something else when\n\n- Continuous compute beyond 8 hr → ECS \u002F EKS \u002F EC2.\n- Lift-and-shift workloads needing kernel modifications or a non-Linux OS → EC2.\n\n## Typical workflow\n\n0. **Check regional availability** — confirm Lambda MicroVMs is available in your target region (run `aws lambda-microvms list-managed-microvm-images`). Your S3 artifact bucket and any network connectors must be in the same region as the image.\n1. **Package** an app: zip with a `Dockerfile` at the root, upload to S3 (same region as the image).\n2. **Implement lifecycle hooks** (optional but recommended) — HTTP endpoints on a port you specify (commonly `9000`) for `\u002Frun`, `\u002Fresume`, `\u002Fsuspend`, `\u002Fterminate`, `\u002Fready`, `\u002Fvalidate`.\n3. **CreateMicrovmImage** — pointing at the S3 artifact, a managed base image, and a build role. Lambda compiles the Dockerfile into an OCI image, starts your app, calls `\u002Fready`, snapshots disk + memory, optionally validates with `\u002Fvalidate`. Lambda will periodically release new managed image versions, and customers should re-build using the latest version to ensure they have up to date images.\n4. **RunMicrovm** — pick an image version, attach `executionRoleArn`, set `idlePolicy`, ingress\u002Fegress connectors, and (optionally) a `runHookPayload`. Receive an `endpoint` URL and `microvmId`.\n5. **CreateMicrovmAuthToken** — get an auth token (max 60 min) with `allowedPorts` specifying which ports the token grants access to. Send traffic to the endpoint with `X-aws-proxy-auth: \u003Ctoken>`.\n6. **Suspend \u002F Resume \u002F Terminate** — explicit APIs, or let the `idlePolicy` drive it (`maxIdleDurationSeconds`, `suspendedDurationSeconds`, `autoResumeEnabled`).\n\n### Core CLI commands\n\n```bash\n# Create an image (zip with Dockerfile at root in S3, plus a managed base image)\naws lambda-microvms create-microvm-image \\\n  --name my-image \\\n  --base-image-arn arn:aws:lambda:\u003Cregion>:aws:microvm-image:al2023-1 \\\n  --build-role-arn arn:aws:iam::\u003Cacct>:role\u002FMicroVMBuildRole \\\n  --code-artifact '{\"uri\":\"s3:\u002F\u002F\u003Cbucket>\u002F\u003Ckey>.zip\"}'\n\n# Run a MicroVM (returns endpoint + microvmId). --image-identifier takes the\n# image ARN (the bare name is rejected); --image-version is the full major.minor string.\naws lambda-microvms run-microvm \\\n  --image-identifier arn:aws:lambda:\u003Cregion>:\u003Cacct>:microvm-image:my-image \\\n  --image-version 1.0 \\\n  --execution-role-arn arn:aws:iam::\u003Cacct>:role\u002FMicroVMExecutionRole \\\n  --idle-policy '{\"maxIdleDurationSeconds\":900,\"suspendedDurationSeconds\":300,\"autoResumeEnabled\":true}'\n\n# Mint an auth token and call the endpoint\nTOKEN=$(aws lambda-microvms create-microvm-auth-token \\\n  --microvm-identifier microvm-... --expiration-in-minutes 30 \\\n  --allowed-ports '[{\"port\":8080}]' \\\n  --query 'authToken.\"X-aws-proxy-auth\"' --output text)\ncurl \"\u003Cendpoint>\u002F\" -H \"X-aws-proxy-auth: $TOKEN\"\n\n# Lifecycle\naws lambda-microvms suspend-microvm   --microvm-identifier microvm-...\naws lambda-microvms resume-microvm    --microvm-identifier microvm-...\naws lambda-microvms terminate-microvm --microvm-identifier microvm-...\n```\n\nSee [`references\u002Fgetting-started.md`](references\u002Fgetting-started.md) for the full walkthrough including `--hooks` config and lifecycle hooks.\n\n## Hook configuration\n\nHooks are organized into two groups under the `--hooks` parameter:\n\n### `microvmImageHooks` (build-time)\n\n> **Recommendation:** Implement the image build hooks (`\u002Fready` and `\u002Fvalidate`) for best performance. They enable the platform to capture a complete snapshot and prefetch the portions accessed at run time.\n\n| Hook | Purpose | Timeout range |\n|---|---|---|\n| `ready` | Called during application boot. When this hook returns a 200 status code, it signals to the platform that the application is ready to be snapshotted. Use this to ensure your application is fully booted before a snapshot is taken. If your application is not yet ready, return a 503 status code until it is ready for snapshotting. | 1–3600s (default 30s) |\n| `validate` | Called after running your application from the microVM snapshot. Use this hook to validate the application is ready to serve traffic. This hook additionally allows the platform to sample the portions of the snapshot that are used when your application is ran, allowing Lambda to prefetch those portions of the snapshot to reduce latency. To get the best performance, run mock payloads through the application during validate. When this hook returns a 200, it signals to the Lambda the MicroVM image is valid. If your application needs more time to run its validate workflow, return a 503 status code. | 1–3600s (default 30s) |\n\n> **Why implement `\u002Fready`?** It signals the platform that your application has fully booted. Without it, the snapshot may be taken mid-initialization, meaning the cached state is incomplete and every run repeats part of the boot sequence.\n>\n> **Why implement `\u002Fvalidate`?** It lets the platform verify the snapshot is correct, and also samples which portions of the snapshot are accessed during `RunMicrovm`. This allows the platform to **prefetch** those portions on future launches, reducing cold-start times.\n\n### `microvmHooks` (runtime)\n\n| Hook | Purpose | Timeout range |\n|---|---|---|\n| `run` | Fires once after run from snapshot | 1–60s (default 1s) |\n| `resume` | Fires after SUSPENDED → RUNNING | 1–60s (default 1s) |\n| `suspend` | Fires before RUNNING → SUSPENDED | 1–60s (default 1s) |\n| `terminate` | Fires before termination | 1–60s (default 1s) |\n\nSee [`references\u002Fgetting-started.md`](references\u002Fgetting-started.md) for a full example enabling all hooks.\n\n## Per-MicroVM size limits\n\n| Resource | Limit |\n|---|---|\n| Maximum vCPUs per MicroVM | 16 |\n| Maximum memory per MicroVM | 32 GB |\n\n> For all other quotas — concurrent MicroVMs per account, launch rate, image count, max execution duration, auth token TTL, Lambda Network Connector (LNC) limits, per-ENI bandwidth, etc. — **check the AWS docs \u002F Service Quotas console.** Most are soft quotas, raisable through Service Quotas \u002F Support.\n\n## Additional capabilities\n\nBy default, the container runs with a restricted set of Linux capabilities. Set `--additional-os-capabilities '[\"ALL\"]'` at image creation time only when required by your use case:\n\n- **Filesystem mounts** — EFS, FUSE-based filesystems.\n- **Nested containers** — running additional containers with containerd inside the MicroVM.\n- **eBPF programs** — tracing, profiling, or custom network policies.\n\n```bash\naws lambda-microvms create-microvm-image \\\n  --name my-image \\\n  --base-image-arn arn:aws:lambda:\u003Cregion>:aws:microvm-image:al2023-1 \\\n  --build-role-arn arn:aws:iam::\u003Cacct>:role\u002FMicroVMBuildRole \\\n  --code-artifact '{\"uri\":\"s3:\u002F\u002F\u003Cbucket>\u002F\u003Ckey>.zip\"}' \\\n  --additional-os-capabilities '[\"ALL\"]'\n```\n\n### Shell ingress for agent use cases\n\nFor programmatic shell access (agent workflows, remote command execution), use the `SHELL_INGRESS` network connector:\n\n```bash\n# 1. Run with SHELL_INGRESS enabled\naws lambda-microvms run-microvm \\\n  --image-identifier arn:aws:lambda:\u003Cregion>:\u003Cacct>:microvm-image:my-image \\\n  --execution-role-arn arn:aws:iam::\u003Cacct>:role\u002FMicroVMExecutionRole \\\n  --ingress-network-connectors '[\"arn:aws:lambda:\u003Cregion>:aws:network-connector:aws-network-connector:SHELL_INGRESS\"]' \\\n  --idle-policy '{\"maxIdleDurationSeconds\":900,\"suspendedDurationSeconds\":300,\"autoResumeEnabled\":true}'\n# Response includes microvmId and endpoint\n\n# 2. Mint a shell auth token (max 60 min; use shortest duration needed)\n# Treat the token as a secret — avoid logging, storing in files, or shell history.\nTOKEN=$(aws lambda-microvms create-microvm-shell-auth-token \\\n  --microvm-identifier microvm-... \\\n  --expiration-in-minutes 15 \\\n  --query 'authToken.\"X-aws-proxy-auth\"' --output text)\n\n# 3. Connect via WebSocket (port 8022)\n# CLI args are visible in process listings (ps aux). For shared hosts,\n# pipe the header via a file descriptor or use a wrapper script.\nwebsocat \"wss:\u002F\u002F\u003Cendpoint>\u002Fshell\" \\\n  -H \"Sec-WebSocket-Protocol: lambda-microvms.authentication.${TOKEN}, lambda-microvms, lambda-microvms.port.8022\"\n```\n\nThe shell drops into the same container as the running application — same network namespace, filesystem, and process tree. This provides an interactive PTY over a WebSocket-based shell channel accessible from any client (terminal or browser), suitable for agent-driven workflows that need to execute commands inside the MicroVM.\n\nPrerequisites: MicroVM must be run with SHELL_INGRESS attached, and caller also needs `lambda:CreateMicrovmShellAuthToken`.\n\n## Known constraints\n\n- **Image is single-size** — you can't ship multiple instance sizes from one image. Plan one image per size.\n- **Image versions incur storage cost** even when no MicroVMs are running on them. Use `delete-microvm-image-version` to clean up.\n- **Suspend → resume can't switch network connectors.** LNC is bound at run time.\n- **No self-suspend from inside the MicroVM.** Call `SuspendMicrovm` from outside (via the public API).\n- **Auth token max TTL is 60 min.** Refresh ahead of expiry for long-running clients.\n- **Runtime hooks (`\u002Frun`, `\u002Fresume`, `\u002Fsuspend`, `\u002Fterminate`) are fast-notification only** (1–60s timeout). Don't use them for slow init.\n\n## Reference index\n\nPick the reference that matches your task:\n\n- [`references\u002Fgetting-started.md`](references\u002Fgetting-started.md) — prerequisites (S3 bucket, build role trust policy), packaging, end-to-end CLI walkthrough, first run + token + curl.\n- [`references\u002Flifecycle-model.md`](references\u002Flifecycle-model.md) — image vs. MicroVM state machines, the six lifecycle hooks (paths, timeouts, what to do in each), idle\u002Fsuspend\u002Fresume semantics, hook payloads.\n- [`references\u002Fsnapshots-and-uniqueness.md`](references\u002Fsnapshots-and-uniqueness.md) — what gets snapshotted, the uniqueness pitfall, CSPRNGs by language, env vars vs. run configuration, snapshot size inspection.\n- [`references\u002Fnetworking.md`](references\u002Fnetworking.md) — ingress vs. egress connectors, port routing, `X-aws-proxy-*` headers, WebSocket subprotocols, HTTP\u002F2 \u002F gRPC, VPC egress.\n- [`references\u002Fiam-and-security.md`](references\u002Fiam-and-security.md) — build role vs. execution role, trust policies, auth tokens (regular vs. shell), `lambda:PassNetworkConnector`.\n- [`references\u002Ftroubleshooting.md`](references\u002Ftroubleshooting.md) — image build error codes, run\u002Fconnect failures, hook timeouts, network connector issues, debugging via shell access.\n\n## Conventions used in references\n\n- The runtime-side default proxy port is `8080`. Override per-request with `X-aws-proxy-port` or per-WebSocket with subprotocol `lambda-microvms.port.\u003Cn>`.\n\n## Security considerations\n\n- **Confused deputy prevention** — add `aws:SourceAccount` (or `aws:SourceArn`) condition keys to trust policies. See `references\u002Fiam-and-security.md`.\n- **Snapshot uniqueness** — snapshots share memory state. Reseed CSPRNGs and rotate secrets on resume. See `references\u002Fsnapshots-and-uniqueness.md`.\n- **Network isolation** — use VPC egress connectors to restrict outbound traffic.\n- **Least-privilege execution roles** — scope IAM policies to specific regions, accounts, and resource prefixes.\n- **Logging** — enable CloudTrail for MicroVM lifecycle events.\n",{"data":33,"body":35},{"name":4,"description":6,"version":34},1,{"type":36,"children":37},"root",[38,46,56,61,113,121,171,179,204,211,218,291,296,302,332,338,351,357,595,601,1247,1272,1278,1290,1302,1329,1405,1454,1466,1575,1589,1595,1643,1658,1664,1677,1710,1865,1871,1884,2270,2275,2287,2293,2397,2403,2408,2509,2515,2546,2552,2633],{"type":39,"tag":40,"props":41,"children":42},"element","h1",{"id":4},[43],{"type":44,"value":45},"text","AWS Lambda MicroVMs",{"type":39,"tag":47,"props":48,"children":49},"blockquote",{},[50],{"type":39,"tag":51,"props":52,"children":53},"p",{},[54],{"type":44,"value":55},"The AWS MCP server is recommended for sandboxed execution and audit logging.",{"type":39,"tag":51,"props":57,"children":58},{},[59],{"type":44,"value":60},"AWS Lambda MicroVMs are serverless compute environments that combine Firecracker VM isolation with container-like efficiency. Each MicroVM:",{"type":39,"tag":62,"props":63,"children":64},"ul",{},[65,79,84,96,101],{"type":39,"tag":66,"props":67,"children":68},"li",{},[69,71,77],{"type":44,"value":70},"Runs your application as a ",{"type":39,"tag":72,"props":73,"children":74},"strong",{},[75],{"type":44,"value":76},"container inside a Firecracker microVM",{"type":44,"value":78}," — you can reproduce the environment locally.",{"type":39,"tag":66,"props":80,"children":81},{},[82],{"type":44,"value":83},"Runs Amazon Linux 2023 as the base OS inside the MicroVM.",{"type":39,"tag":66,"props":85,"children":86},{},[87,89,94],{"type":44,"value":88},"Boots from a ",{"type":39,"tag":72,"props":90,"children":91},{},[92],{"type":44,"value":93},"memory + disk snapshot",{"type":44,"value":95}," captured at image build time, so application init is skipped on run.",{"type":39,"tag":66,"props":97,"children":98},{},[99],{"type":44,"value":100},"Has a dedicated, TLS-terminated HTTPS endpoint reachable with an auth token.",{"type":39,"tag":66,"props":102,"children":103},{},[104,106,111],{"type":44,"value":105},"Can be ",{"type":39,"tag":72,"props":107,"children":108},{},[109],{"type":44,"value":110},"suspended and resumed",{"type":44,"value":112}," with state preserved; lives up to 8 hours.",{"type":39,"tag":51,"props":114,"children":115},{},[116],{"type":39,"tag":72,"props":117,"children":118},{},[119],{"type":44,"value":120},"Two-resource model:",{"type":39,"tag":62,"props":122,"children":123},{},[124,152],{"type":39,"tag":66,"props":125,"children":126},{},[127,134,136,142,144,150],{"type":39,"tag":128,"props":129,"children":131},"code",{"className":130},[],[132],{"type":44,"value":133},"MicrovmImage",{"type":44,"value":135}," — a versioned artifact built from ",{"type":39,"tag":128,"props":137,"children":139},{"className":138},[],[140],{"type":44,"value":141},"{S3 zip with Dockerfile} + baseImageArn",{"type":44,"value":143},". Each version has per-architecture\u002Fchipset ",{"type":39,"tag":128,"props":145,"children":147},{"className":146},[],[148],{"type":44,"value":149},"Build",{"type":44,"value":151},"s.",{"type":39,"tag":66,"props":153,"children":154},{},[155,161,163,169],{"type":39,"tag":128,"props":156,"children":158},{"className":157},[],[159],{"type":44,"value":160},"Microvm",{"type":44,"value":162}," — a running instance created (",{"type":39,"tag":128,"props":164,"children":166},{"className":165},[],[167],{"type":44,"value":168},"RunMicrovm",{"type":44,"value":170},") from an image version.",{"type":39,"tag":51,"props":172,"children":173},{},[174],{"type":39,"tag":72,"props":175,"children":176},{},[177],{"type":44,"value":178},"Two roles:",{"type":39,"tag":62,"props":180,"children":181},{},[182,193],{"type":39,"tag":66,"props":183,"children":184},{},[185,191],{"type":39,"tag":128,"props":186,"children":188},{"className":187},[],[189],{"type":44,"value":190},"buildRoleArn",{"type":44,"value":192}," — used during image build (S3 read, CloudWatch logs, optional ECR).",{"type":39,"tag":66,"props":194,"children":195},{},[196,202],{"type":39,"tag":128,"props":197,"children":199},{"className":198},[],[200],{"type":44,"value":201},"executionRoleArn",{"type":44,"value":203}," — assumed at runtime by the running MicroVM.",{"type":39,"tag":205,"props":206,"children":208},"h2",{"id":207},"when-to-use",[209],{"type":44,"value":210},"When to use",{"type":39,"tag":212,"props":213,"children":215},"h3",{"id":214},"choose-lambda-microvms-when",[216],{"type":44,"value":217},"Choose Lambda MicroVMs when",{"type":39,"tag":62,"props":219,"children":220},{},[221,231,241,251,261,271,281],{"type":39,"tag":66,"props":222,"children":223},{},[224,229],{"type":39,"tag":72,"props":225,"children":226},{},[227],{"type":44,"value":228},"Analytics workloads",{"type":44,"value":230}," — isolated compute for data processing, ETL jobs, or query execution with strong tenant separation.",{"type":39,"tag":66,"props":232,"children":233},{},[234,239],{"type":39,"tag":72,"props":235,"children":236},{},[237],{"type":44,"value":238},"AI \u002F agent code execution sandboxes",{"type":44,"value":240}," — fresh, isolated environment per session, fast resume between turns.",{"type":39,"tag":66,"props":242,"children":243},{},[244,249],{"type":39,"tag":72,"props":245,"children":246},{},[247],{"type":44,"value":248},"Interactive code playgrounds & notebooks",{"type":44,"value":250}," — Jupyter, REPLs, dev environments executing user code.",{"type":39,"tag":66,"props":252,"children":253},{},[254,259],{"type":39,"tag":72,"props":255,"children":256},{},[257],{"type":44,"value":258},"Reinforcement-learning environments",{"type":44,"value":260}," — clean per-episode envs with tool access.",{"type":39,"tag":66,"props":262,"children":263},{},[264,269],{"type":39,"tag":72,"props":265,"children":266},{},[267],{"type":44,"value":268},"Multi-tenant CI executors \u002F build runners",{"type":44,"value":270}," — strong tenant isolation.",{"type":39,"tag":66,"props":272,"children":273},{},[274,279],{"type":39,"tag":72,"props":275,"children":276},{},[277],{"type":44,"value":278},"Game \u002F simulation servers",{"type":44,"value":280}," — sessionful, long-lived (up to 8 hr) workloads.",{"type":39,"tag":66,"props":282,"children":283},{},[284,289],{"type":39,"tag":72,"props":285,"children":286},{},[287],{"type":44,"value":288},"Security scanning",{"type":44,"value":290}," — running untrusted analyzers in isolation.",{"type":39,"tag":51,"props":292,"children":293},{},[294],{"type":44,"value":295},"In general, Lambda MicroVMs are suited for long-lived sessions, real port-listening servers (gRPC, WebSocket, custom TCP protocols), state preserved across periods of inactivity (suspend\u002Fresume), container-level access (FUSE, eBPF, custom syscalls), or session-affine routing to a specific compute environment.",{"type":39,"tag":212,"props":297,"children":299},{"id":298},"choose-aws-lambda-functions-when",[300],{"type":44,"value":301},"Choose AWS Lambda (functions) when",{"type":39,"tag":62,"props":303,"children":304},{},[305,310,315,327],{"type":39,"tag":66,"props":306,"children":307},{},[308],{"type":44,"value":309},"The workload fits in 15 minutes.",{"type":39,"tag":66,"props":311,"children":312},{},[313],{"type":44,"value":314},"Per-invocation isolation is fine; no need for session state held in memory.",{"type":39,"tag":66,"props":316,"children":317},{},[318,320,325],{"type":44,"value":319},"Fully automatic scaling is preferred (no ",{"type":39,"tag":128,"props":321,"children":323},{"className":322},[],[324],{"type":44,"value":168},{"type":44,"value":326}," to manage).",{"type":39,"tag":66,"props":328,"children":329},{},[330],{"type":44,"value":331},"Event-source integrations (S3, SQS, EventBridge, etc.) drive the function.",{"type":39,"tag":212,"props":333,"children":335},{"id":334},"choose-something-else-when",[336],{"type":44,"value":337},"Choose something else when",{"type":39,"tag":62,"props":339,"children":340},{},[341,346],{"type":39,"tag":66,"props":342,"children":343},{},[344],{"type":44,"value":345},"Continuous compute beyond 8 hr → ECS \u002F EKS \u002F EC2.",{"type":39,"tag":66,"props":347,"children":348},{},[349],{"type":44,"value":350},"Lift-and-shift workloads needing kernel modifications or a non-Linux OS → EC2.",{"type":39,"tag":205,"props":352,"children":354},{"id":353},"typical-workflow",[355],{"type":44,"value":356},"Typical workflow",{"type":39,"tag":358,"props":359,"children":361},"ol",{"start":360},0,[362,380,398,460,484,531,556],{"type":39,"tag":66,"props":363,"children":364},{},[365,370,372,378],{"type":39,"tag":72,"props":366,"children":367},{},[368],{"type":44,"value":369},"Check regional availability",{"type":44,"value":371}," — confirm Lambda MicroVMs is available in your target region (run ",{"type":39,"tag":128,"props":373,"children":375},{"className":374},[],[376],{"type":44,"value":377},"aws lambda-microvms list-managed-microvm-images",{"type":44,"value":379},"). Your S3 artifact bucket and any network connectors must be in the same region as the image.",{"type":39,"tag":66,"props":381,"children":382},{},[383,388,390,396],{"type":39,"tag":72,"props":384,"children":385},{},[386],{"type":44,"value":387},"Package",{"type":44,"value":389}," an app: zip with a ",{"type":39,"tag":128,"props":391,"children":393},{"className":392},[],[394],{"type":44,"value":395},"Dockerfile",{"type":44,"value":397}," at the root, upload to S3 (same region as the image).",{"type":39,"tag":66,"props":399,"children":400},{},[401,406,408,414,416,422,424,430,431,437,438,444,445,451,452,458],{"type":39,"tag":72,"props":402,"children":403},{},[404],{"type":44,"value":405},"Implement lifecycle hooks",{"type":44,"value":407}," (optional but recommended) — HTTP endpoints on a port you specify (commonly ",{"type":39,"tag":128,"props":409,"children":411},{"className":410},[],[412],{"type":44,"value":413},"9000",{"type":44,"value":415},") for ",{"type":39,"tag":128,"props":417,"children":419},{"className":418},[],[420],{"type":44,"value":421},"\u002Frun",{"type":44,"value":423},", ",{"type":39,"tag":128,"props":425,"children":427},{"className":426},[],[428],{"type":44,"value":429},"\u002Fresume",{"type":44,"value":423},{"type":39,"tag":128,"props":432,"children":434},{"className":433},[],[435],{"type":44,"value":436},"\u002Fsuspend",{"type":44,"value":423},{"type":39,"tag":128,"props":439,"children":441},{"className":440},[],[442],{"type":44,"value":443},"\u002Fterminate",{"type":44,"value":423},{"type":39,"tag":128,"props":446,"children":448},{"className":447},[],[449],{"type":44,"value":450},"\u002Fready",{"type":44,"value":423},{"type":39,"tag":128,"props":453,"children":455},{"className":454},[],[456],{"type":44,"value":457},"\u002Fvalidate",{"type":44,"value":459},".",{"type":39,"tag":66,"props":461,"children":462},{},[463,468,470,475,477,482],{"type":39,"tag":72,"props":464,"children":465},{},[466],{"type":44,"value":467},"CreateMicrovmImage",{"type":44,"value":469}," — pointing at the S3 artifact, a managed base image, and a build role. Lambda compiles the Dockerfile into an OCI image, starts your app, calls ",{"type":39,"tag":128,"props":471,"children":473},{"className":472},[],[474],{"type":44,"value":450},{"type":44,"value":476},", snapshots disk + memory, optionally validates with ",{"type":39,"tag":128,"props":478,"children":480},{"className":479},[],[481],{"type":44,"value":457},{"type":44,"value":483},". Lambda will periodically release new managed image versions, and customers should re-build using the latest version to ensure they have up to date images.",{"type":39,"tag":66,"props":485,"children":486},{},[487,491,493,498,500,506,508,514,516,522,524,530],{"type":39,"tag":72,"props":488,"children":489},{},[490],{"type":44,"value":168},{"type":44,"value":492}," — pick an image version, attach ",{"type":39,"tag":128,"props":494,"children":496},{"className":495},[],[497],{"type":44,"value":201},{"type":44,"value":499},", set ",{"type":39,"tag":128,"props":501,"children":503},{"className":502},[],[504],{"type":44,"value":505},"idlePolicy",{"type":44,"value":507},", ingress\u002Fegress connectors, and (optionally) a ",{"type":39,"tag":128,"props":509,"children":511},{"className":510},[],[512],{"type":44,"value":513},"runHookPayload",{"type":44,"value":515},". Receive an ",{"type":39,"tag":128,"props":517,"children":519},{"className":518},[],[520],{"type":44,"value":521},"endpoint",{"type":44,"value":523}," URL and ",{"type":39,"tag":128,"props":525,"children":527},{"className":526},[],[528],{"type":44,"value":529},"microvmId",{"type":44,"value":459},{"type":39,"tag":66,"props":532,"children":533},{},[534,539,541,547,549,555],{"type":39,"tag":72,"props":535,"children":536},{},[537],{"type":44,"value":538},"CreateMicrovmAuthToken",{"type":44,"value":540}," — get an auth token (max 60 min) with ",{"type":39,"tag":128,"props":542,"children":544},{"className":543},[],[545],{"type":44,"value":546},"allowedPorts",{"type":44,"value":548}," specifying which ports the token grants access to. Send traffic to the endpoint with ",{"type":39,"tag":128,"props":550,"children":552},{"className":551},[],[553],{"type":44,"value":554},"X-aws-proxy-auth: \u003Ctoken>",{"type":44,"value":459},{"type":39,"tag":66,"props":557,"children":558},{},[559,564,566,571,573,579,580,586,587,593],{"type":39,"tag":72,"props":560,"children":561},{},[562],{"type":44,"value":563},"Suspend \u002F Resume \u002F Terminate",{"type":44,"value":565}," — explicit APIs, or let the ",{"type":39,"tag":128,"props":567,"children":569},{"className":568},[],[570],{"type":44,"value":505},{"type":44,"value":572}," drive it (",{"type":39,"tag":128,"props":574,"children":576},{"className":575},[],[577],{"type":44,"value":578},"maxIdleDurationSeconds",{"type":44,"value":423},{"type":39,"tag":128,"props":581,"children":583},{"className":582},[],[584],{"type":44,"value":585},"suspendedDurationSeconds",{"type":44,"value":423},{"type":39,"tag":128,"props":588,"children":590},{"className":589},[],[591],{"type":44,"value":592},"autoResumeEnabled",{"type":44,"value":594},").",{"type":39,"tag":212,"props":596,"children":598},{"id":597},"core-cli-commands",[599],{"type":44,"value":600},"Core CLI commands",{"type":39,"tag":602,"props":603,"children":608},"pre",{"className":604,"code":605,"language":606,"meta":607,"style":607},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","# Create an image (zip with Dockerfile at root in S3, plus a managed base image)\naws lambda-microvms create-microvm-image \\\n  --name my-image \\\n  --base-image-arn arn:aws:lambda:\u003Cregion>:aws:microvm-image:al2023-1 \\\n  --build-role-arn arn:aws:iam::\u003Cacct>:role\u002FMicroVMBuildRole \\\n  --code-artifact '{\"uri\":\"s3:\u002F\u002F\u003Cbucket>\u002F\u003Ckey>.zip\"}'\n\n# Run a MicroVM (returns endpoint + microvmId). --image-identifier takes the\n# image ARN (the bare name is rejected); --image-version is the full major.minor string.\naws lambda-microvms run-microvm \\\n  --image-identifier arn:aws:lambda:\u003Cregion>:\u003Cacct>:microvm-image:my-image \\\n  --image-version 1.0 \\\n  --execution-role-arn arn:aws:iam::\u003Cacct>:role\u002FMicroVMExecutionRole \\\n  --idle-policy '{\"maxIdleDurationSeconds\":900,\"suspendedDurationSeconds\":300,\"autoResumeEnabled\":true}'\n\n# Mint an auth token and call the endpoint\nTOKEN=$(aws lambda-microvms create-microvm-auth-token \\\n  --microvm-identifier microvm-... --expiration-in-minutes 30 \\\n  --allowed-ports '[{\"port\":8080}]' \\\n  --query 'authToken.\"X-aws-proxy-auth\"' --output text)\ncurl \"\u003Cendpoint>\u002F\" -H \"X-aws-proxy-auth: $TOKEN\"\n\n# Lifecycle\naws lambda-microvms suspend-microvm   --microvm-identifier microvm-...\naws lambda-microvms resume-microvm    --microvm-identifier microvm-...\naws lambda-microvms terminate-microvm --microvm-identifier microvm-...\n","bash","",[609],{"type":39,"tag":128,"props":610,"children":611},{"__ignoreMap":607},[612,623,649,667,711,752,776,786,795,804,825,884,903,941,963,971,980,1011,1039,1066,1103,1151,1159,1168,1195,1221],{"type":39,"tag":613,"props":614,"children":616},"span",{"class":615,"line":34},"line",[617],{"type":39,"tag":613,"props":618,"children":620},{"style":619},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic",[621],{"type":44,"value":622},"# Create an image (zip with Dockerfile at root in S3, plus a managed base image)\n",{"type":39,"tag":613,"props":624,"children":626},{"class":615,"line":625},2,[627,632,638,643],{"type":39,"tag":613,"props":628,"children":630},{"style":629},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[631],{"type":44,"value":8},{"type":39,"tag":613,"props":633,"children":635},{"style":634},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[636],{"type":44,"value":637}," lambda-microvms",{"type":39,"tag":613,"props":639,"children":640},{"style":634},[641],{"type":44,"value":642}," create-microvm-image",{"type":39,"tag":613,"props":644,"children":646},{"style":645},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[647],{"type":44,"value":648}," \\\n",{"type":39,"tag":613,"props":650,"children":652},{"class":615,"line":651},3,[653,658,663],{"type":39,"tag":613,"props":654,"children":655},{"style":634},[656],{"type":44,"value":657},"  --name",{"type":39,"tag":613,"props":659,"children":660},{"style":634},[661],{"type":44,"value":662}," my-image",{"type":39,"tag":613,"props":664,"children":665},{"style":645},[666],{"type":44,"value":648},{"type":39,"tag":613,"props":668,"children":670},{"class":615,"line":669},4,[671,676,681,687,692,697,702,707],{"type":39,"tag":613,"props":672,"children":673},{"style":634},[674],{"type":44,"value":675},"  --base-image-arn",{"type":39,"tag":613,"props":677,"children":678},{"style":634},[679],{"type":44,"value":680}," arn:aws:lambda:",{"type":39,"tag":613,"props":682,"children":684},{"style":683},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[685],{"type":44,"value":686},"\u003C",{"type":39,"tag":613,"props":688,"children":689},{"style":634},[690],{"type":44,"value":691},"regio",{"type":39,"tag":613,"props":693,"children":694},{"style":645},[695],{"type":44,"value":696},"n",{"type":39,"tag":613,"props":698,"children":699},{"style":683},[700],{"type":44,"value":701},">",{"type":39,"tag":613,"props":703,"children":704},{"style":634},[705],{"type":44,"value":706},":aws:microvm-image:al2023-1",{"type":39,"tag":613,"props":708,"children":709},{"style":645},[710],{"type":44,"value":648},{"type":39,"tag":613,"props":712,"children":714},{"class":615,"line":713},5,[715,720,725,729,734,739,743,748],{"type":39,"tag":613,"props":716,"children":717},{"style":634},[718],{"type":44,"value":719},"  --build-role-arn",{"type":39,"tag":613,"props":721,"children":722},{"style":634},[723],{"type":44,"value":724}," arn:aws:iam::",{"type":39,"tag":613,"props":726,"children":727},{"style":683},[728],{"type":44,"value":686},{"type":39,"tag":613,"props":730,"children":731},{"style":634},[732],{"type":44,"value":733},"acc",{"type":39,"tag":613,"props":735,"children":736},{"style":645},[737],{"type":44,"value":738},"t",{"type":39,"tag":613,"props":740,"children":741},{"style":683},[742],{"type":44,"value":701},{"type":39,"tag":613,"props":744,"children":745},{"style":634},[746],{"type":44,"value":747},":role\u002FMicroVMBuildRole",{"type":39,"tag":613,"props":749,"children":750},{"style":645},[751],{"type":44,"value":648},{"type":39,"tag":613,"props":753,"children":755},{"class":615,"line":754},6,[756,761,766,771],{"type":39,"tag":613,"props":757,"children":758},{"style":634},[759],{"type":44,"value":760},"  --code-artifact",{"type":39,"tag":613,"props":762,"children":763},{"style":683},[764],{"type":44,"value":765}," '",{"type":39,"tag":613,"props":767,"children":768},{"style":634},[769],{"type":44,"value":770},"{\"uri\":\"s3:\u002F\u002F\u003Cbucket>\u002F\u003Ckey>.zip\"}",{"type":39,"tag":613,"props":772,"children":773},{"style":683},[774],{"type":44,"value":775},"'\n",{"type":39,"tag":613,"props":777,"children":779},{"class":615,"line":778},7,[780],{"type":39,"tag":613,"props":781,"children":783},{"emptyLinePlaceholder":782},true,[784],{"type":44,"value":785},"\n",{"type":39,"tag":613,"props":787,"children":789},{"class":615,"line":788},8,[790],{"type":39,"tag":613,"props":791,"children":792},{"style":619},[793],{"type":44,"value":794},"# Run a MicroVM (returns endpoint + microvmId). --image-identifier takes the\n",{"type":39,"tag":613,"props":796,"children":798},{"class":615,"line":797},9,[799],{"type":39,"tag":613,"props":800,"children":801},{"style":619},[802],{"type":44,"value":803},"# image ARN (the bare name is rejected); --image-version is the full major.minor string.\n",{"type":39,"tag":613,"props":805,"children":807},{"class":615,"line":806},10,[808,812,816,821],{"type":39,"tag":613,"props":809,"children":810},{"style":629},[811],{"type":44,"value":8},{"type":39,"tag":613,"props":813,"children":814},{"style":634},[815],{"type":44,"value":637},{"type":39,"tag":613,"props":817,"children":818},{"style":634},[819],{"type":44,"value":820}," run-microvm",{"type":39,"tag":613,"props":822,"children":823},{"style":645},[824],{"type":44,"value":648},{"type":39,"tag":613,"props":826,"children":828},{"class":615,"line":827},11,[829,834,838,842,846,850,854,859,863,867,871,875,880],{"type":39,"tag":613,"props":830,"children":831},{"style":634},[832],{"type":44,"value":833},"  --image-identifier",{"type":39,"tag":613,"props":835,"children":836},{"style":634},[837],{"type":44,"value":680},{"type":39,"tag":613,"props":839,"children":840},{"style":683},[841],{"type":44,"value":686},{"type":39,"tag":613,"props":843,"children":844},{"style":634},[845],{"type":44,"value":691},{"type":39,"tag":613,"props":847,"children":848},{"style":645},[849],{"type":44,"value":696},{"type":39,"tag":613,"props":851,"children":852},{"style":683},[853],{"type":44,"value":701},{"type":39,"tag":613,"props":855,"children":856},{"style":634},[857],{"type":44,"value":858},":",{"type":39,"tag":613,"props":860,"children":861},{"style":683},[862],{"type":44,"value":686},{"type":39,"tag":613,"props":864,"children":865},{"style":634},[866],{"type":44,"value":733},{"type":39,"tag":613,"props":868,"children":869},{"style":645},[870],{"type":44,"value":738},{"type":39,"tag":613,"props":872,"children":873},{"style":683},[874],{"type":44,"value":701},{"type":39,"tag":613,"props":876,"children":877},{"style":634},[878],{"type":44,"value":879},":microvm-image:my-image",{"type":39,"tag":613,"props":881,"children":882},{"style":645},[883],{"type":44,"value":648},{"type":39,"tag":613,"props":885,"children":887},{"class":615,"line":886},12,[888,893,899],{"type":39,"tag":613,"props":889,"children":890},{"style":634},[891],{"type":44,"value":892},"  --image-version",{"type":39,"tag":613,"props":894,"children":896},{"style":895},"--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C",[897],{"type":44,"value":898}," 1.0",{"type":39,"tag":613,"props":900,"children":901},{"style":645},[902],{"type":44,"value":648},{"type":39,"tag":613,"props":904,"children":906},{"class":615,"line":905},13,[907,912,916,920,924,928,932,937],{"type":39,"tag":613,"props":908,"children":909},{"style":634},[910],{"type":44,"value":911},"  --execution-role-arn",{"type":39,"tag":613,"props":913,"children":914},{"style":634},[915],{"type":44,"value":724},{"type":39,"tag":613,"props":917,"children":918},{"style":683},[919],{"type":44,"value":686},{"type":39,"tag":613,"props":921,"children":922},{"style":634},[923],{"type":44,"value":733},{"type":39,"tag":613,"props":925,"children":926},{"style":645},[927],{"type":44,"value":738},{"type":39,"tag":613,"props":929,"children":930},{"style":683},[931],{"type":44,"value":701},{"type":39,"tag":613,"props":933,"children":934},{"style":634},[935],{"type":44,"value":936},":role\u002FMicroVMExecutionRole",{"type":39,"tag":613,"props":938,"children":939},{"style":645},[940],{"type":44,"value":648},{"type":39,"tag":613,"props":942,"children":944},{"class":615,"line":943},14,[945,950,954,959],{"type":39,"tag":613,"props":946,"children":947},{"style":634},[948],{"type":44,"value":949},"  --idle-policy",{"type":39,"tag":613,"props":951,"children":952},{"style":683},[953],{"type":44,"value":765},{"type":39,"tag":613,"props":955,"children":956},{"style":634},[957],{"type":44,"value":958},"{\"maxIdleDurationSeconds\":900,\"suspendedDurationSeconds\":300,\"autoResumeEnabled\":true}",{"type":39,"tag":613,"props":960,"children":961},{"style":683},[962],{"type":44,"value":775},{"type":39,"tag":613,"props":964,"children":966},{"class":615,"line":965},15,[967],{"type":39,"tag":613,"props":968,"children":969},{"emptyLinePlaceholder":782},[970],{"type":44,"value":785},{"type":39,"tag":613,"props":972,"children":974},{"class":615,"line":973},16,[975],{"type":39,"tag":613,"props":976,"children":977},{"style":619},[978],{"type":44,"value":979},"# Mint an auth token and call the endpoint\n",{"type":39,"tag":613,"props":981,"children":983},{"class":615,"line":982},17,[984,989,994,998,1002,1007],{"type":39,"tag":613,"props":985,"children":986},{"style":645},[987],{"type":44,"value":988},"TOKEN",{"type":39,"tag":613,"props":990,"children":991},{"style":683},[992],{"type":44,"value":993},"=$(",{"type":39,"tag":613,"props":995,"children":996},{"style":629},[997],{"type":44,"value":8},{"type":39,"tag":613,"props":999,"children":1000},{"style":634},[1001],{"type":44,"value":637},{"type":39,"tag":613,"props":1003,"children":1004},{"style":634},[1005],{"type":44,"value":1006}," create-microvm-auth-token",{"type":39,"tag":613,"props":1008,"children":1009},{"style":645},[1010],{"type":44,"value":648},{"type":39,"tag":613,"props":1012,"children":1014},{"class":615,"line":1013},18,[1015,1020,1025,1030,1035],{"type":39,"tag":613,"props":1016,"children":1017},{"style":634},[1018],{"type":44,"value":1019},"  --microvm-identifier",{"type":39,"tag":613,"props":1021,"children":1022},{"style":634},[1023],{"type":44,"value":1024}," microvm-...",{"type":39,"tag":613,"props":1026,"children":1027},{"style":634},[1028],{"type":44,"value":1029}," --expiration-in-minutes",{"type":39,"tag":613,"props":1031,"children":1032},{"style":895},[1033],{"type":44,"value":1034}," 30",{"type":39,"tag":613,"props":1036,"children":1037},{"style":645},[1038],{"type":44,"value":648},{"type":39,"tag":613,"props":1040,"children":1042},{"class":615,"line":1041},19,[1043,1048,1052,1057,1062],{"type":39,"tag":613,"props":1044,"children":1045},{"style":634},[1046],{"type":44,"value":1047},"  --allowed-ports",{"type":39,"tag":613,"props":1049,"children":1050},{"style":683},[1051],{"type":44,"value":765},{"type":39,"tag":613,"props":1053,"children":1054},{"style":634},[1055],{"type":44,"value":1056},"[{\"port\":8080}]",{"type":39,"tag":613,"props":1058,"children":1059},{"style":683},[1060],{"type":44,"value":1061},"'",{"type":39,"tag":613,"props":1063,"children":1064},{"style":645},[1065],{"type":44,"value":648},{"type":39,"tag":613,"props":1067,"children":1069},{"class":615,"line":1068},20,[1070,1075,1079,1084,1088,1093,1098],{"type":39,"tag":613,"props":1071,"children":1072},{"style":634},[1073],{"type":44,"value":1074},"  --query",{"type":39,"tag":613,"props":1076,"children":1077},{"style":683},[1078],{"type":44,"value":765},{"type":39,"tag":613,"props":1080,"children":1081},{"style":634},[1082],{"type":44,"value":1083},"authToken.\"X-aws-proxy-auth\"",{"type":39,"tag":613,"props":1085,"children":1086},{"style":683},[1087],{"type":44,"value":1061},{"type":39,"tag":613,"props":1089,"children":1090},{"style":634},[1091],{"type":44,"value":1092}," --output",{"type":39,"tag":613,"props":1094,"children":1095},{"style":634},[1096],{"type":44,"value":1097}," text",{"type":39,"tag":613,"props":1099,"children":1100},{"style":683},[1101],{"type":44,"value":1102},")\n",{"type":39,"tag":613,"props":1104,"children":1106},{"class":615,"line":1105},21,[1107,1112,1117,1122,1127,1132,1136,1141,1146],{"type":39,"tag":613,"props":1108,"children":1109},{"style":629},[1110],{"type":44,"value":1111},"curl",{"type":39,"tag":613,"props":1113,"children":1114},{"style":683},[1115],{"type":44,"value":1116}," \"",{"type":39,"tag":613,"props":1118,"children":1119},{"style":634},[1120],{"type":44,"value":1121},"\u003Cendpoint>\u002F",{"type":39,"tag":613,"props":1123,"children":1124},{"style":683},[1125],{"type":44,"value":1126},"\"",{"type":39,"tag":613,"props":1128,"children":1129},{"style":634},[1130],{"type":44,"value":1131}," -H",{"type":39,"tag":613,"props":1133,"children":1134},{"style":683},[1135],{"type":44,"value":1116},{"type":39,"tag":613,"props":1137,"children":1138},{"style":634},[1139],{"type":44,"value":1140},"X-aws-proxy-auth: ",{"type":39,"tag":613,"props":1142,"children":1143},{"style":645},[1144],{"type":44,"value":1145},"$TOKEN",{"type":39,"tag":613,"props":1147,"children":1148},{"style":683},[1149],{"type":44,"value":1150},"\"\n",{"type":39,"tag":613,"props":1152,"children":1154},{"class":615,"line":1153},22,[1155],{"type":39,"tag":613,"props":1156,"children":1157},{"emptyLinePlaceholder":782},[1158],{"type":44,"value":785},{"type":39,"tag":613,"props":1160,"children":1162},{"class":615,"line":1161},23,[1163],{"type":39,"tag":613,"props":1164,"children":1165},{"style":619},[1166],{"type":44,"value":1167},"# Lifecycle\n",{"type":39,"tag":613,"props":1169,"children":1171},{"class":615,"line":1170},24,[1172,1176,1180,1185,1190],{"type":39,"tag":613,"props":1173,"children":1174},{"style":629},[1175],{"type":44,"value":8},{"type":39,"tag":613,"props":1177,"children":1178},{"style":634},[1179],{"type":44,"value":637},{"type":39,"tag":613,"props":1181,"children":1182},{"style":634},[1183],{"type":44,"value":1184}," suspend-microvm",{"type":39,"tag":613,"props":1186,"children":1187},{"style":634},[1188],{"type":44,"value":1189},"   --microvm-identifier",{"type":39,"tag":613,"props":1191,"children":1192},{"style":634},[1193],{"type":44,"value":1194}," microvm-...\n",{"type":39,"tag":613,"props":1196,"children":1198},{"class":615,"line":1197},25,[1199,1203,1207,1212,1217],{"type":39,"tag":613,"props":1200,"children":1201},{"style":629},[1202],{"type":44,"value":8},{"type":39,"tag":613,"props":1204,"children":1205},{"style":634},[1206],{"type":44,"value":637},{"type":39,"tag":613,"props":1208,"children":1209},{"style":634},[1210],{"type":44,"value":1211}," resume-microvm",{"type":39,"tag":613,"props":1213,"children":1214},{"style":634},[1215],{"type":44,"value":1216},"    --microvm-identifier",{"type":39,"tag":613,"props":1218,"children":1219},{"style":634},[1220],{"type":44,"value":1194},{"type":39,"tag":613,"props":1222,"children":1224},{"class":615,"line":1223},26,[1225,1229,1233,1238,1243],{"type":39,"tag":613,"props":1226,"children":1227},{"style":629},[1228],{"type":44,"value":8},{"type":39,"tag":613,"props":1230,"children":1231},{"style":634},[1232],{"type":44,"value":637},{"type":39,"tag":613,"props":1234,"children":1235},{"style":634},[1236],{"type":44,"value":1237}," terminate-microvm",{"type":39,"tag":613,"props":1239,"children":1240},{"style":634},[1241],{"type":44,"value":1242}," --microvm-identifier",{"type":39,"tag":613,"props":1244,"children":1245},{"style":634},[1246],{"type":44,"value":1194},{"type":39,"tag":51,"props":1248,"children":1249},{},[1250,1252,1262,1264,1270],{"type":44,"value":1251},"See ",{"type":39,"tag":1253,"props":1254,"children":1256},"a",{"href":1255},"references\u002Fgetting-started.md",[1257],{"type":39,"tag":128,"props":1258,"children":1260},{"className":1259},[],[1261],{"type":44,"value":1255},{"type":44,"value":1263}," for the full walkthrough including ",{"type":39,"tag":128,"props":1265,"children":1267},{"className":1266},[],[1268],{"type":44,"value":1269},"--hooks",{"type":44,"value":1271}," config and lifecycle hooks.",{"type":39,"tag":205,"props":1273,"children":1275},{"id":1274},"hook-configuration",[1276],{"type":44,"value":1277},"Hook configuration",{"type":39,"tag":51,"props":1279,"children":1280},{},[1281,1283,1288],{"type":44,"value":1282},"Hooks are organized into two groups under the ",{"type":39,"tag":128,"props":1284,"children":1286},{"className":1285},[],[1287],{"type":44,"value":1269},{"type":44,"value":1289}," parameter:",{"type":39,"tag":212,"props":1291,"children":1293},{"id":1292},"microvmimagehooks-build-time",[1294,1300],{"type":39,"tag":128,"props":1295,"children":1297},{"className":1296},[],[1298],{"type":44,"value":1299},"microvmImageHooks",{"type":44,"value":1301}," (build-time)",{"type":39,"tag":47,"props":1303,"children":1304},{},[1305],{"type":39,"tag":51,"props":1306,"children":1307},{},[1308,1313,1315,1320,1322,1327],{"type":39,"tag":72,"props":1309,"children":1310},{},[1311],{"type":44,"value":1312},"Recommendation:",{"type":44,"value":1314}," Implement the image build hooks (",{"type":39,"tag":128,"props":1316,"children":1318},{"className":1317},[],[1319],{"type":44,"value":450},{"type":44,"value":1321}," and ",{"type":39,"tag":128,"props":1323,"children":1325},{"className":1324},[],[1326],{"type":44,"value":457},{"type":44,"value":1328},") for best performance. They enable the platform to capture a complete snapshot and prefetch the portions accessed at run time.",{"type":39,"tag":1330,"props":1331,"children":1332},"table",{},[1333,1357],{"type":39,"tag":1334,"props":1335,"children":1336},"thead",{},[1337],{"type":39,"tag":1338,"props":1339,"children":1340},"tr",{},[1341,1347,1352],{"type":39,"tag":1342,"props":1343,"children":1344},"th",{},[1345],{"type":44,"value":1346},"Hook",{"type":39,"tag":1342,"props":1348,"children":1349},{},[1350],{"type":44,"value":1351},"Purpose",{"type":39,"tag":1342,"props":1353,"children":1354},{},[1355],{"type":44,"value":1356},"Timeout range",{"type":39,"tag":1358,"props":1359,"children":1360},"tbody",{},[1361,1384],{"type":39,"tag":1338,"props":1362,"children":1363},{},[1364,1374,1379],{"type":39,"tag":1365,"props":1366,"children":1367},"td",{},[1368],{"type":39,"tag":128,"props":1369,"children":1371},{"className":1370},[],[1372],{"type":44,"value":1373},"ready",{"type":39,"tag":1365,"props":1375,"children":1376},{},[1377],{"type":44,"value":1378},"Called during application boot. When this hook returns a 200 status code, it signals to the platform that the application is ready to be snapshotted. Use this to ensure your application is fully booted before a snapshot is taken. If your application is not yet ready, return a 503 status code until it is ready for snapshotting.",{"type":39,"tag":1365,"props":1380,"children":1381},{},[1382],{"type":44,"value":1383},"1–3600s (default 30s)",{"type":39,"tag":1338,"props":1385,"children":1386},{},[1387,1396,1401],{"type":39,"tag":1365,"props":1388,"children":1389},{},[1390],{"type":39,"tag":128,"props":1391,"children":1393},{"className":1392},[],[1394],{"type":44,"value":1395},"validate",{"type":39,"tag":1365,"props":1397,"children":1398},{},[1399],{"type":44,"value":1400},"Called after running your application from the microVM snapshot. Use this hook to validate the application is ready to serve traffic. This hook additionally allows the platform to sample the portions of the snapshot that are used when your application is ran, allowing Lambda to prefetch those portions of the snapshot to reduce latency. To get the best performance, run mock payloads through the application during validate. When this hook returns a 200, it signals to the Lambda the MicroVM image is valid. If your application needs more time to run its validate workflow, return a 503 status code.",{"type":39,"tag":1365,"props":1402,"children":1403},{},[1404],{"type":44,"value":1383},{"type":39,"tag":47,"props":1406,"children":1407},{},[1408,1425],{"type":39,"tag":51,"props":1409,"children":1410},{},[1411,1423],{"type":39,"tag":72,"props":1412,"children":1413},{},[1414,1416,1421],{"type":44,"value":1415},"Why implement ",{"type":39,"tag":128,"props":1417,"children":1419},{"className":1418},[],[1420],{"type":44,"value":450},{"type":44,"value":1422},"?",{"type":44,"value":1424}," It signals the platform that your application has fully booted. Without it, the snapshot may be taken mid-initialization, meaning the cached state is incomplete and every run repeats part of the boot sequence.",{"type":39,"tag":51,"props":1426,"children":1427},{},[1428,1438,1440,1445,1447,1452],{"type":39,"tag":72,"props":1429,"children":1430},{},[1431,1432,1437],{"type":44,"value":1415},{"type":39,"tag":128,"props":1433,"children":1435},{"className":1434},[],[1436],{"type":44,"value":457},{"type":44,"value":1422},{"type":44,"value":1439}," It lets the platform verify the snapshot is correct, and also samples which portions of the snapshot are accessed during ",{"type":39,"tag":128,"props":1441,"children":1443},{"className":1442},[],[1444],{"type":44,"value":168},{"type":44,"value":1446},". This allows the platform to ",{"type":39,"tag":72,"props":1448,"children":1449},{},[1450],{"type":44,"value":1451},"prefetch",{"type":44,"value":1453}," those portions on future launches, reducing cold-start times.",{"type":39,"tag":212,"props":1455,"children":1457},{"id":1456},"microvmhooks-runtime",[1458,1464],{"type":39,"tag":128,"props":1459,"children":1461},{"className":1460},[],[1462],{"type":44,"value":1463},"microvmHooks",{"type":44,"value":1465}," (runtime)",{"type":39,"tag":1330,"props":1467,"children":1468},{},[1469,1487],{"type":39,"tag":1334,"props":1470,"children":1471},{},[1472],{"type":39,"tag":1338,"props":1473,"children":1474},{},[1475,1479,1483],{"type":39,"tag":1342,"props":1476,"children":1477},{},[1478],{"type":44,"value":1346},{"type":39,"tag":1342,"props":1480,"children":1481},{},[1482],{"type":44,"value":1351},{"type":39,"tag":1342,"props":1484,"children":1485},{},[1486],{"type":44,"value":1356},{"type":39,"tag":1358,"props":1488,"children":1489},{},[1490,1512,1533,1554],{"type":39,"tag":1338,"props":1491,"children":1492},{},[1493,1502,1507],{"type":39,"tag":1365,"props":1494,"children":1495},{},[1496],{"type":39,"tag":128,"props":1497,"children":1499},{"className":1498},[],[1500],{"type":44,"value":1501},"run",{"type":39,"tag":1365,"props":1503,"children":1504},{},[1505],{"type":44,"value":1506},"Fires once after run from snapshot",{"type":39,"tag":1365,"props":1508,"children":1509},{},[1510],{"type":44,"value":1511},"1–60s (default 1s)",{"type":39,"tag":1338,"props":1513,"children":1514},{},[1515,1524,1529],{"type":39,"tag":1365,"props":1516,"children":1517},{},[1518],{"type":39,"tag":128,"props":1519,"children":1521},{"className":1520},[],[1522],{"type":44,"value":1523},"resume",{"type":39,"tag":1365,"props":1525,"children":1526},{},[1527],{"type":44,"value":1528},"Fires after SUSPENDED → RUNNING",{"type":39,"tag":1365,"props":1530,"children":1531},{},[1532],{"type":44,"value":1511},{"type":39,"tag":1338,"props":1534,"children":1535},{},[1536,1545,1550],{"type":39,"tag":1365,"props":1537,"children":1538},{},[1539],{"type":39,"tag":128,"props":1540,"children":1542},{"className":1541},[],[1543],{"type":44,"value":1544},"suspend",{"type":39,"tag":1365,"props":1546,"children":1547},{},[1548],{"type":44,"value":1549},"Fires before RUNNING → SUSPENDED",{"type":39,"tag":1365,"props":1551,"children":1552},{},[1553],{"type":44,"value":1511},{"type":39,"tag":1338,"props":1555,"children":1556},{},[1557,1566,1571],{"type":39,"tag":1365,"props":1558,"children":1559},{},[1560],{"type":39,"tag":128,"props":1561,"children":1563},{"className":1562},[],[1564],{"type":44,"value":1565},"terminate",{"type":39,"tag":1365,"props":1567,"children":1568},{},[1569],{"type":44,"value":1570},"Fires before termination",{"type":39,"tag":1365,"props":1572,"children":1573},{},[1574],{"type":44,"value":1511},{"type":39,"tag":51,"props":1576,"children":1577},{},[1578,1579,1587],{"type":44,"value":1251},{"type":39,"tag":1253,"props":1580,"children":1581},{"href":1255},[1582],{"type":39,"tag":128,"props":1583,"children":1585},{"className":1584},[],[1586],{"type":44,"value":1255},{"type":44,"value":1588}," for a full example enabling all hooks.",{"type":39,"tag":205,"props":1590,"children":1592},{"id":1591},"per-microvm-size-limits",[1593],{"type":44,"value":1594},"Per-MicroVM size limits",{"type":39,"tag":1330,"props":1596,"children":1597},{},[1598,1614],{"type":39,"tag":1334,"props":1599,"children":1600},{},[1601],{"type":39,"tag":1338,"props":1602,"children":1603},{},[1604,1609],{"type":39,"tag":1342,"props":1605,"children":1606},{},[1607],{"type":44,"value":1608},"Resource",{"type":39,"tag":1342,"props":1610,"children":1611},{},[1612],{"type":44,"value":1613},"Limit",{"type":39,"tag":1358,"props":1615,"children":1616},{},[1617,1630],{"type":39,"tag":1338,"props":1618,"children":1619},{},[1620,1625],{"type":39,"tag":1365,"props":1621,"children":1622},{},[1623],{"type":44,"value":1624},"Maximum vCPUs per MicroVM",{"type":39,"tag":1365,"props":1626,"children":1627},{},[1628],{"type":44,"value":1629},"16",{"type":39,"tag":1338,"props":1631,"children":1632},{},[1633,1638],{"type":39,"tag":1365,"props":1634,"children":1635},{},[1636],{"type":44,"value":1637},"Maximum memory per MicroVM",{"type":39,"tag":1365,"props":1639,"children":1640},{},[1641],{"type":44,"value":1642},"32 GB",{"type":39,"tag":47,"props":1644,"children":1645},{},[1646],{"type":39,"tag":51,"props":1647,"children":1648},{},[1649,1651,1656],{"type":44,"value":1650},"For all other quotas — concurrent MicroVMs per account, launch rate, image count, max execution duration, auth token TTL, Lambda Network Connector (LNC) limits, per-ENI bandwidth, etc. — ",{"type":39,"tag":72,"props":1652,"children":1653},{},[1654],{"type":44,"value":1655},"check the AWS docs \u002F Service Quotas console.",{"type":44,"value":1657}," Most are soft quotas, raisable through Service Quotas \u002F Support.",{"type":39,"tag":205,"props":1659,"children":1661},{"id":1660},"additional-capabilities",[1662],{"type":44,"value":1663},"Additional capabilities",{"type":39,"tag":51,"props":1665,"children":1666},{},[1667,1669,1675],{"type":44,"value":1668},"By default, the container runs with a restricted set of Linux capabilities. Set ",{"type":39,"tag":128,"props":1670,"children":1672},{"className":1671},[],[1673],{"type":44,"value":1674},"--additional-os-capabilities '[\"ALL\"]'",{"type":44,"value":1676}," at image creation time only when required by your use case:",{"type":39,"tag":62,"props":1678,"children":1679},{},[1680,1690,1700],{"type":39,"tag":66,"props":1681,"children":1682},{},[1683,1688],{"type":39,"tag":72,"props":1684,"children":1685},{},[1686],{"type":44,"value":1687},"Filesystem mounts",{"type":44,"value":1689}," — EFS, FUSE-based filesystems.",{"type":39,"tag":66,"props":1691,"children":1692},{},[1693,1698],{"type":39,"tag":72,"props":1694,"children":1695},{},[1696],{"type":44,"value":1697},"Nested containers",{"type":44,"value":1699}," — running additional containers with containerd inside the MicroVM.",{"type":39,"tag":66,"props":1701,"children":1702},{},[1703,1708],{"type":39,"tag":72,"props":1704,"children":1705},{},[1706],{"type":44,"value":1707},"eBPF programs",{"type":44,"value":1709}," — tracing, profiling, or custom network policies.",{"type":39,"tag":602,"props":1711,"children":1713},{"className":604,"code":1712,"language":606,"meta":607,"style":607},"aws lambda-microvms create-microvm-image \\\n  --name my-image \\\n  --base-image-arn arn:aws:lambda:\u003Cregion>:aws:microvm-image:al2023-1 \\\n  --build-role-arn arn:aws:iam::\u003Cacct>:role\u002FMicroVMBuildRole \\\n  --code-artifact '{\"uri\":\"s3:\u002F\u002F\u003Cbucket>\u002F\u003Ckey>.zip\"}' \\\n  --additional-os-capabilities '[\"ALL\"]'\n",[1714],{"type":39,"tag":128,"props":1715,"children":1716},{"__ignoreMap":607},[1717,1736,1751,1786,1821,1844],{"type":39,"tag":613,"props":1718,"children":1719},{"class":615,"line":34},[1720,1724,1728,1732],{"type":39,"tag":613,"props":1721,"children":1722},{"style":629},[1723],{"type":44,"value":8},{"type":39,"tag":613,"props":1725,"children":1726},{"style":634},[1727],{"type":44,"value":637},{"type":39,"tag":613,"props":1729,"children":1730},{"style":634},[1731],{"type":44,"value":642},{"type":39,"tag":613,"props":1733,"children":1734},{"style":645},[1735],{"type":44,"value":648},{"type":39,"tag":613,"props":1737,"children":1738},{"class":615,"line":625},[1739,1743,1747],{"type":39,"tag":613,"props":1740,"children":1741},{"style":634},[1742],{"type":44,"value":657},{"type":39,"tag":613,"props":1744,"children":1745},{"style":634},[1746],{"type":44,"value":662},{"type":39,"tag":613,"props":1748,"children":1749},{"style":645},[1750],{"type":44,"value":648},{"type":39,"tag":613,"props":1752,"children":1753},{"class":615,"line":651},[1754,1758,1762,1766,1770,1774,1778,1782],{"type":39,"tag":613,"props":1755,"children":1756},{"style":634},[1757],{"type":44,"value":675},{"type":39,"tag":613,"props":1759,"children":1760},{"style":634},[1761],{"type":44,"value":680},{"type":39,"tag":613,"props":1763,"children":1764},{"style":683},[1765],{"type":44,"value":686},{"type":39,"tag":613,"props":1767,"children":1768},{"style":634},[1769],{"type":44,"value":691},{"type":39,"tag":613,"props":1771,"children":1772},{"style":645},[1773],{"type":44,"value":696},{"type":39,"tag":613,"props":1775,"children":1776},{"style":683},[1777],{"type":44,"value":701},{"type":39,"tag":613,"props":1779,"children":1780},{"style":634},[1781],{"type":44,"value":706},{"type":39,"tag":613,"props":1783,"children":1784},{"style":645},[1785],{"type":44,"value":648},{"type":39,"tag":613,"props":1787,"children":1788},{"class":615,"line":669},[1789,1793,1797,1801,1805,1809,1813,1817],{"type":39,"tag":613,"props":1790,"children":1791},{"style":634},[1792],{"type":44,"value":719},{"type":39,"tag":613,"props":1794,"children":1795},{"style":634},[1796],{"type":44,"value":724},{"type":39,"tag":613,"props":1798,"children":1799},{"style":683},[1800],{"type":44,"value":686},{"type":39,"tag":613,"props":1802,"children":1803},{"style":634},[1804],{"type":44,"value":733},{"type":39,"tag":613,"props":1806,"children":1807},{"style":645},[1808],{"type":44,"value":738},{"type":39,"tag":613,"props":1810,"children":1811},{"style":683},[1812],{"type":44,"value":701},{"type":39,"tag":613,"props":1814,"children":1815},{"style":634},[1816],{"type":44,"value":747},{"type":39,"tag":613,"props":1818,"children":1819},{"style":645},[1820],{"type":44,"value":648},{"type":39,"tag":613,"props":1822,"children":1823},{"class":615,"line":713},[1824,1828,1832,1836,1840],{"type":39,"tag":613,"props":1825,"children":1826},{"style":634},[1827],{"type":44,"value":760},{"type":39,"tag":613,"props":1829,"children":1830},{"style":683},[1831],{"type":44,"value":765},{"type":39,"tag":613,"props":1833,"children":1834},{"style":634},[1835],{"type":44,"value":770},{"type":39,"tag":613,"props":1837,"children":1838},{"style":683},[1839],{"type":44,"value":1061},{"type":39,"tag":613,"props":1841,"children":1842},{"style":645},[1843],{"type":44,"value":648},{"type":39,"tag":613,"props":1845,"children":1846},{"class":615,"line":754},[1847,1852,1856,1861],{"type":39,"tag":613,"props":1848,"children":1849},{"style":634},[1850],{"type":44,"value":1851},"  --additional-os-capabilities",{"type":39,"tag":613,"props":1853,"children":1854},{"style":683},[1855],{"type":44,"value":765},{"type":39,"tag":613,"props":1857,"children":1858},{"style":634},[1859],{"type":44,"value":1860},"[\"ALL\"]",{"type":39,"tag":613,"props":1862,"children":1863},{"style":683},[1864],{"type":44,"value":775},{"type":39,"tag":212,"props":1866,"children":1868},{"id":1867},"shell-ingress-for-agent-use-cases",[1869],{"type":44,"value":1870},"Shell ingress for agent use cases",{"type":39,"tag":51,"props":1872,"children":1873},{},[1874,1876,1882],{"type":44,"value":1875},"For programmatic shell access (agent workflows, remote command execution), use the ",{"type":39,"tag":128,"props":1877,"children":1879},{"className":1878},[],[1880],{"type":44,"value":1881},"SHELL_INGRESS",{"type":44,"value":1883}," network connector:",{"type":39,"tag":602,"props":1885,"children":1887},{"className":604,"code":1886,"language":606,"meta":607,"style":607},"# 1. Run with SHELL_INGRESS enabled\naws lambda-microvms run-microvm \\\n  --image-identifier arn:aws:lambda:\u003Cregion>:\u003Cacct>:microvm-image:my-image \\\n  --execution-role-arn arn:aws:iam::\u003Cacct>:role\u002FMicroVMExecutionRole \\\n  --ingress-network-connectors '[\"arn:aws:lambda:\u003Cregion>:aws:network-connector:aws-network-connector:SHELL_INGRESS\"]' \\\n  --idle-policy '{\"maxIdleDurationSeconds\":900,\"suspendedDurationSeconds\":300,\"autoResumeEnabled\":true}'\n# Response includes microvmId and endpoint\n\n# 2. Mint a shell auth token (max 60 min; use shortest duration needed)\n# Treat the token as a secret — avoid logging, storing in files, or shell history.\nTOKEN=$(aws lambda-microvms create-microvm-shell-auth-token \\\n  --microvm-identifier microvm-... \\\n  --expiration-in-minutes 15 \\\n  --query 'authToken.\"X-aws-proxy-auth\"' --output text)\n\n# 3. Connect via WebSocket (port 8022)\n# CLI args are visible in process listings (ps aux). For shared hosts,\n# pipe the header via a file descriptor or use a wrapper script.\nwebsocat \"wss:\u002F\u002F\u003Cendpoint>\u002Fshell\" \\\n  -H \"Sec-WebSocket-Protocol: lambda-microvms.authentication.${TOKEN}, lambda-microvms, lambda-microvms.port.8022\"\n",[1888],{"type":39,"tag":128,"props":1889,"children":1890},{"__ignoreMap":607},[1891,1899,1918,1973,2008,2033,2052,2060,2067,2075,2083,2111,2126,2143,2174,2181,2189,2197,2205,2230],{"type":39,"tag":613,"props":1892,"children":1893},{"class":615,"line":34},[1894],{"type":39,"tag":613,"props":1895,"children":1896},{"style":619},[1897],{"type":44,"value":1898},"# 1. Run with SHELL_INGRESS enabled\n",{"type":39,"tag":613,"props":1900,"children":1901},{"class":615,"line":625},[1902,1906,1910,1914],{"type":39,"tag":613,"props":1903,"children":1904},{"style":629},[1905],{"type":44,"value":8},{"type":39,"tag":613,"props":1907,"children":1908},{"style":634},[1909],{"type":44,"value":637},{"type":39,"tag":613,"props":1911,"children":1912},{"style":634},[1913],{"type":44,"value":820},{"type":39,"tag":613,"props":1915,"children":1916},{"style":645},[1917],{"type":44,"value":648},{"type":39,"tag":613,"props":1919,"children":1920},{"class":615,"line":651},[1921,1925,1929,1933,1937,1941,1945,1949,1953,1957,1961,1965,1969],{"type":39,"tag":613,"props":1922,"children":1923},{"style":634},[1924],{"type":44,"value":833},{"type":39,"tag":613,"props":1926,"children":1927},{"style":634},[1928],{"type":44,"value":680},{"type":39,"tag":613,"props":1930,"children":1931},{"style":683},[1932],{"type":44,"value":686},{"type":39,"tag":613,"props":1934,"children":1935},{"style":634},[1936],{"type":44,"value":691},{"type":39,"tag":613,"props":1938,"children":1939},{"style":645},[1940],{"type":44,"value":696},{"type":39,"tag":613,"props":1942,"children":1943},{"style":683},[1944],{"type":44,"value":701},{"type":39,"tag":613,"props":1946,"children":1947},{"style":634},[1948],{"type":44,"value":858},{"type":39,"tag":613,"props":1950,"children":1951},{"style":683},[1952],{"type":44,"value":686},{"type":39,"tag":613,"props":1954,"children":1955},{"style":634},[1956],{"type":44,"value":733},{"type":39,"tag":613,"props":1958,"children":1959},{"style":645},[1960],{"type":44,"value":738},{"type":39,"tag":613,"props":1962,"children":1963},{"style":683},[1964],{"type":44,"value":701},{"type":39,"tag":613,"props":1966,"children":1967},{"style":634},[1968],{"type":44,"value":879},{"type":39,"tag":613,"props":1970,"children":1971},{"style":645},[1972],{"type":44,"value":648},{"type":39,"tag":613,"props":1974,"children":1975},{"class":615,"line":669},[1976,1980,1984,1988,1992,1996,2000,2004],{"type":39,"tag":613,"props":1977,"children":1978},{"style":634},[1979],{"type":44,"value":911},{"type":39,"tag":613,"props":1981,"children":1982},{"style":634},[1983],{"type":44,"value":724},{"type":39,"tag":613,"props":1985,"children":1986},{"style":683},[1987],{"type":44,"value":686},{"type":39,"tag":613,"props":1989,"children":1990},{"style":634},[1991],{"type":44,"value":733},{"type":39,"tag":613,"props":1993,"children":1994},{"style":645},[1995],{"type":44,"value":738},{"type":39,"tag":613,"props":1997,"children":1998},{"style":683},[1999],{"type":44,"value":701},{"type":39,"tag":613,"props":2001,"children":2002},{"style":634},[2003],{"type":44,"value":936},{"type":39,"tag":613,"props":2005,"children":2006},{"style":645},[2007],{"type":44,"value":648},{"type":39,"tag":613,"props":2009,"children":2010},{"class":615,"line":713},[2011,2016,2020,2025,2029],{"type":39,"tag":613,"props":2012,"children":2013},{"style":634},[2014],{"type":44,"value":2015},"  --ingress-network-connectors",{"type":39,"tag":613,"props":2017,"children":2018},{"style":683},[2019],{"type":44,"value":765},{"type":39,"tag":613,"props":2021,"children":2022},{"style":634},[2023],{"type":44,"value":2024},"[\"arn:aws:lambda:\u003Cregion>:aws:network-connector:aws-network-connector:SHELL_INGRESS\"]",{"type":39,"tag":613,"props":2026,"children":2027},{"style":683},[2028],{"type":44,"value":1061},{"type":39,"tag":613,"props":2030,"children":2031},{"style":645},[2032],{"type":44,"value":648},{"type":39,"tag":613,"props":2034,"children":2035},{"class":615,"line":754},[2036,2040,2044,2048],{"type":39,"tag":613,"props":2037,"children":2038},{"style":634},[2039],{"type":44,"value":949},{"type":39,"tag":613,"props":2041,"children":2042},{"style":683},[2043],{"type":44,"value":765},{"type":39,"tag":613,"props":2045,"children":2046},{"style":634},[2047],{"type":44,"value":958},{"type":39,"tag":613,"props":2049,"children":2050},{"style":683},[2051],{"type":44,"value":775},{"type":39,"tag":613,"props":2053,"children":2054},{"class":615,"line":778},[2055],{"type":39,"tag":613,"props":2056,"children":2057},{"style":619},[2058],{"type":44,"value":2059},"# Response includes microvmId and endpoint\n",{"type":39,"tag":613,"props":2061,"children":2062},{"class":615,"line":788},[2063],{"type":39,"tag":613,"props":2064,"children":2065},{"emptyLinePlaceholder":782},[2066],{"type":44,"value":785},{"type":39,"tag":613,"props":2068,"children":2069},{"class":615,"line":797},[2070],{"type":39,"tag":613,"props":2071,"children":2072},{"style":619},[2073],{"type":44,"value":2074},"# 2. Mint a shell auth token (max 60 min; use shortest duration needed)\n",{"type":39,"tag":613,"props":2076,"children":2077},{"class":615,"line":806},[2078],{"type":39,"tag":613,"props":2079,"children":2080},{"style":619},[2081],{"type":44,"value":2082},"# Treat the token as a secret — avoid logging, storing in files, or shell history.\n",{"type":39,"tag":613,"props":2084,"children":2085},{"class":615,"line":827},[2086,2090,2094,2098,2102,2107],{"type":39,"tag":613,"props":2087,"children":2088},{"style":645},[2089],{"type":44,"value":988},{"type":39,"tag":613,"props":2091,"children":2092},{"style":683},[2093],{"type":44,"value":993},{"type":39,"tag":613,"props":2095,"children":2096},{"style":629},[2097],{"type":44,"value":8},{"type":39,"tag":613,"props":2099,"children":2100},{"style":634},[2101],{"type":44,"value":637},{"type":39,"tag":613,"props":2103,"children":2104},{"style":634},[2105],{"type":44,"value":2106}," create-microvm-shell-auth-token",{"type":39,"tag":613,"props":2108,"children":2109},{"style":645},[2110],{"type":44,"value":648},{"type":39,"tag":613,"props":2112,"children":2113},{"class":615,"line":886},[2114,2118,2122],{"type":39,"tag":613,"props":2115,"children":2116},{"style":634},[2117],{"type":44,"value":1019},{"type":39,"tag":613,"props":2119,"children":2120},{"style":634},[2121],{"type":44,"value":1024},{"type":39,"tag":613,"props":2123,"children":2124},{"style":645},[2125],{"type":44,"value":648},{"type":39,"tag":613,"props":2127,"children":2128},{"class":615,"line":905},[2129,2134,2139],{"type":39,"tag":613,"props":2130,"children":2131},{"style":634},[2132],{"type":44,"value":2133},"  --expiration-in-minutes",{"type":39,"tag":613,"props":2135,"children":2136},{"style":895},[2137],{"type":44,"value":2138}," 15",{"type":39,"tag":613,"props":2140,"children":2141},{"style":645},[2142],{"type":44,"value":648},{"type":39,"tag":613,"props":2144,"children":2145},{"class":615,"line":943},[2146,2150,2154,2158,2162,2166,2170],{"type":39,"tag":613,"props":2147,"children":2148},{"style":634},[2149],{"type":44,"value":1074},{"type":39,"tag":613,"props":2151,"children":2152},{"style":683},[2153],{"type":44,"value":765},{"type":39,"tag":613,"props":2155,"children":2156},{"style":634},[2157],{"type":44,"value":1083},{"type":39,"tag":613,"props":2159,"children":2160},{"style":683},[2161],{"type":44,"value":1061},{"type":39,"tag":613,"props":2163,"children":2164},{"style":634},[2165],{"type":44,"value":1092},{"type":39,"tag":613,"props":2167,"children":2168},{"style":634},[2169],{"type":44,"value":1097},{"type":39,"tag":613,"props":2171,"children":2172},{"style":683},[2173],{"type":44,"value":1102},{"type":39,"tag":613,"props":2175,"children":2176},{"class":615,"line":965},[2177],{"type":39,"tag":613,"props":2178,"children":2179},{"emptyLinePlaceholder":782},[2180],{"type":44,"value":785},{"type":39,"tag":613,"props":2182,"children":2183},{"class":615,"line":973},[2184],{"type":39,"tag":613,"props":2185,"children":2186},{"style":619},[2187],{"type":44,"value":2188},"# 3. Connect via WebSocket (port 8022)\n",{"type":39,"tag":613,"props":2190,"children":2191},{"class":615,"line":982},[2192],{"type":39,"tag":613,"props":2193,"children":2194},{"style":619},[2195],{"type":44,"value":2196},"# CLI args are visible in process listings (ps aux). For shared hosts,\n",{"type":39,"tag":613,"props":2198,"children":2199},{"class":615,"line":1013},[2200],{"type":39,"tag":613,"props":2201,"children":2202},{"style":619},[2203],{"type":44,"value":2204},"# pipe the header via a file descriptor or use a wrapper script.\n",{"type":39,"tag":613,"props":2206,"children":2207},{"class":615,"line":1041},[2208,2213,2217,2222,2226],{"type":39,"tag":613,"props":2209,"children":2210},{"style":629},[2211],{"type":44,"value":2212},"websocat",{"type":39,"tag":613,"props":2214,"children":2215},{"style":683},[2216],{"type":44,"value":1116},{"type":39,"tag":613,"props":2218,"children":2219},{"style":634},[2220],{"type":44,"value":2221},"wss:\u002F\u002F\u003Cendpoint>\u002Fshell",{"type":39,"tag":613,"props":2223,"children":2224},{"style":683},[2225],{"type":44,"value":1126},{"type":39,"tag":613,"props":2227,"children":2228},{"style":645},[2229],{"type":44,"value":648},{"type":39,"tag":613,"props":2231,"children":2232},{"class":615,"line":1068},[2233,2238,2242,2247,2252,2256,2261,2266],{"type":39,"tag":613,"props":2234,"children":2235},{"style":634},[2236],{"type":44,"value":2237},"  -H",{"type":39,"tag":613,"props":2239,"children":2240},{"style":683},[2241],{"type":44,"value":1116},{"type":39,"tag":613,"props":2243,"children":2244},{"style":634},[2245],{"type":44,"value":2246},"Sec-WebSocket-Protocol: lambda-microvms.authentication.",{"type":39,"tag":613,"props":2248,"children":2249},{"style":683},[2250],{"type":44,"value":2251},"${",{"type":39,"tag":613,"props":2253,"children":2254},{"style":645},[2255],{"type":44,"value":988},{"type":39,"tag":613,"props":2257,"children":2258},{"style":683},[2259],{"type":44,"value":2260},"}",{"type":39,"tag":613,"props":2262,"children":2263},{"style":634},[2264],{"type":44,"value":2265},", lambda-microvms, lambda-microvms.port.8022",{"type":39,"tag":613,"props":2267,"children":2268},{"style":683},[2269],{"type":44,"value":1150},{"type":39,"tag":51,"props":2271,"children":2272},{},[2273],{"type":44,"value":2274},"The shell drops into the same container as the running application — same network namespace, filesystem, and process tree. This provides an interactive PTY over a WebSocket-based shell channel accessible from any client (terminal or browser), suitable for agent-driven workflows that need to execute commands inside the MicroVM.",{"type":39,"tag":51,"props":2276,"children":2277},{},[2278,2280,2286],{"type":44,"value":2279},"Prerequisites: MicroVM must be run with SHELL_INGRESS attached, and caller also needs ",{"type":39,"tag":128,"props":2281,"children":2283},{"className":2282},[],[2284],{"type":44,"value":2285},"lambda:CreateMicrovmShellAuthToken",{"type":44,"value":459},{"type":39,"tag":205,"props":2288,"children":2290},{"id":2289},"known-constraints",[2291],{"type":44,"value":2292},"Known constraints",{"type":39,"tag":62,"props":2294,"children":2295},{},[2296,2306,2324,2334,2352,2362],{"type":39,"tag":66,"props":2297,"children":2298},{},[2299,2304],{"type":39,"tag":72,"props":2300,"children":2301},{},[2302],{"type":44,"value":2303},"Image is single-size",{"type":44,"value":2305}," — you can't ship multiple instance sizes from one image. Plan one image per size.",{"type":39,"tag":66,"props":2307,"children":2308},{},[2309,2314,2316,2322],{"type":39,"tag":72,"props":2310,"children":2311},{},[2312],{"type":44,"value":2313},"Image versions incur storage cost",{"type":44,"value":2315}," even when no MicroVMs are running on them. Use ",{"type":39,"tag":128,"props":2317,"children":2319},{"className":2318},[],[2320],{"type":44,"value":2321},"delete-microvm-image-version",{"type":44,"value":2323}," to clean up.",{"type":39,"tag":66,"props":2325,"children":2326},{},[2327,2332],{"type":39,"tag":72,"props":2328,"children":2329},{},[2330],{"type":44,"value":2331},"Suspend → resume can't switch network connectors.",{"type":44,"value":2333}," LNC is bound at run time.",{"type":39,"tag":66,"props":2335,"children":2336},{},[2337,2342,2344,2350],{"type":39,"tag":72,"props":2338,"children":2339},{},[2340],{"type":44,"value":2341},"No self-suspend from inside the MicroVM.",{"type":44,"value":2343}," Call ",{"type":39,"tag":128,"props":2345,"children":2347},{"className":2346},[],[2348],{"type":44,"value":2349},"SuspendMicrovm",{"type":44,"value":2351}," from outside (via the public API).",{"type":39,"tag":66,"props":2353,"children":2354},{},[2355,2360],{"type":39,"tag":72,"props":2356,"children":2357},{},[2358],{"type":44,"value":2359},"Auth token max TTL is 60 min.",{"type":44,"value":2361}," Refresh ahead of expiry for long-running clients.",{"type":39,"tag":66,"props":2363,"children":2364},{},[2365,2395],{"type":39,"tag":72,"props":2366,"children":2367},{},[2368,2370,2375,2376,2381,2382,2387,2388,2393],{"type":44,"value":2369},"Runtime hooks (",{"type":39,"tag":128,"props":2371,"children":2373},{"className":2372},[],[2374],{"type":44,"value":421},{"type":44,"value":423},{"type":39,"tag":128,"props":2377,"children":2379},{"className":2378},[],[2380],{"type":44,"value":429},{"type":44,"value":423},{"type":39,"tag":128,"props":2383,"children":2385},{"className":2384},[],[2386],{"type":44,"value":436},{"type":44,"value":423},{"type":39,"tag":128,"props":2389,"children":2391},{"className":2390},[],[2392],{"type":44,"value":443},{"type":44,"value":2394},") are fast-notification only",{"type":44,"value":2396}," (1–60s timeout). Don't use them for slow init.",{"type":39,"tag":205,"props":2398,"children":2400},{"id":2399},"reference-index",[2401],{"type":44,"value":2402},"Reference index",{"type":39,"tag":51,"props":2404,"children":2405},{},[2406],{"type":44,"value":2407},"Pick the reference that matches your task:",{"type":39,"tag":62,"props":2409,"children":2410},{},[2411,2424,2438,2452,2474,2495],{"type":39,"tag":66,"props":2412,"children":2413},{},[2414,2422],{"type":39,"tag":1253,"props":2415,"children":2416},{"href":1255},[2417],{"type":39,"tag":128,"props":2418,"children":2420},{"className":2419},[],[2421],{"type":44,"value":1255},{"type":44,"value":2423}," — prerequisites (S3 bucket, build role trust policy), packaging, end-to-end CLI walkthrough, first run + token + curl.",{"type":39,"tag":66,"props":2425,"children":2426},{},[2427,2436],{"type":39,"tag":1253,"props":2428,"children":2430},{"href":2429},"references\u002Flifecycle-model.md",[2431],{"type":39,"tag":128,"props":2432,"children":2434},{"className":2433},[],[2435],{"type":44,"value":2429},{"type":44,"value":2437}," — image vs. MicroVM state machines, the six lifecycle hooks (paths, timeouts, what to do in each), idle\u002Fsuspend\u002Fresume semantics, hook payloads.",{"type":39,"tag":66,"props":2439,"children":2440},{},[2441,2450],{"type":39,"tag":1253,"props":2442,"children":2444},{"href":2443},"references\u002Fsnapshots-and-uniqueness.md",[2445],{"type":39,"tag":128,"props":2446,"children":2448},{"className":2447},[],[2449],{"type":44,"value":2443},{"type":44,"value":2451}," — what gets snapshotted, the uniqueness pitfall, CSPRNGs by language, env vars vs. run configuration, snapshot size inspection.",{"type":39,"tag":66,"props":2453,"children":2454},{},[2455,2464,2466,2472],{"type":39,"tag":1253,"props":2456,"children":2458},{"href":2457},"references\u002Fnetworking.md",[2459],{"type":39,"tag":128,"props":2460,"children":2462},{"className":2461},[],[2463],{"type":44,"value":2457},{"type":44,"value":2465}," — ingress vs. egress connectors, port routing, ",{"type":39,"tag":128,"props":2467,"children":2469},{"className":2468},[],[2470],{"type":44,"value":2471},"X-aws-proxy-*",{"type":44,"value":2473}," headers, WebSocket subprotocols, HTTP\u002F2 \u002F gRPC, VPC egress.",{"type":39,"tag":66,"props":2475,"children":2476},{},[2477,2486,2488,2494],{"type":39,"tag":1253,"props":2478,"children":2480},{"href":2479},"references\u002Fiam-and-security.md",[2481],{"type":39,"tag":128,"props":2482,"children":2484},{"className":2483},[],[2485],{"type":44,"value":2479},{"type":44,"value":2487}," — build role vs. execution role, trust policies, auth tokens (regular vs. shell), ",{"type":39,"tag":128,"props":2489,"children":2491},{"className":2490},[],[2492],{"type":44,"value":2493},"lambda:PassNetworkConnector",{"type":44,"value":459},{"type":39,"tag":66,"props":2496,"children":2497},{},[2498,2507],{"type":39,"tag":1253,"props":2499,"children":2501},{"href":2500},"references\u002Ftroubleshooting.md",[2502],{"type":39,"tag":128,"props":2503,"children":2505},{"className":2504},[],[2506],{"type":44,"value":2500},{"type":44,"value":2508}," — image build error codes, run\u002Fconnect failures, hook timeouts, network connector issues, debugging via shell access.",{"type":39,"tag":205,"props":2510,"children":2512},{"id":2511},"conventions-used-in-references",[2513],{"type":44,"value":2514},"Conventions used in references",{"type":39,"tag":62,"props":2516,"children":2517},{},[2518],{"type":39,"tag":66,"props":2519,"children":2520},{},[2521,2523,2529,2531,2537,2539,2545],{"type":44,"value":2522},"The runtime-side default proxy port is ",{"type":39,"tag":128,"props":2524,"children":2526},{"className":2525},[],[2527],{"type":44,"value":2528},"8080",{"type":44,"value":2530},". Override per-request with ",{"type":39,"tag":128,"props":2532,"children":2534},{"className":2533},[],[2535],{"type":44,"value":2536},"X-aws-proxy-port",{"type":44,"value":2538}," or per-WebSocket with subprotocol ",{"type":39,"tag":128,"props":2540,"children":2542},{"className":2541},[],[2543],{"type":44,"value":2544},"lambda-microvms.port.\u003Cn>",{"type":44,"value":459},{"type":39,"tag":205,"props":2547,"children":2549},{"id":2548},"security-considerations",[2550],{"type":44,"value":2551},"Security considerations",{"type":39,"tag":62,"props":2553,"children":2554},{},[2555,2587,2603,2613,2623],{"type":39,"tag":66,"props":2556,"children":2557},{},[2558,2563,2565,2571,2573,2579,2581,2586],{"type":39,"tag":72,"props":2559,"children":2560},{},[2561],{"type":44,"value":2562},"Confused deputy prevention",{"type":44,"value":2564}," — add ",{"type":39,"tag":128,"props":2566,"children":2568},{"className":2567},[],[2569],{"type":44,"value":2570},"aws:SourceAccount",{"type":44,"value":2572}," (or ",{"type":39,"tag":128,"props":2574,"children":2576},{"className":2575},[],[2577],{"type":44,"value":2578},"aws:SourceArn",{"type":44,"value":2580},") condition keys to trust policies. See ",{"type":39,"tag":128,"props":2582,"children":2584},{"className":2583},[],[2585],{"type":44,"value":2479},{"type":44,"value":459},{"type":39,"tag":66,"props":2588,"children":2589},{},[2590,2595,2597,2602],{"type":39,"tag":72,"props":2591,"children":2592},{},[2593],{"type":44,"value":2594},"Snapshot uniqueness",{"type":44,"value":2596}," — snapshots share memory state. Reseed CSPRNGs and rotate secrets on resume. See ",{"type":39,"tag":128,"props":2598,"children":2600},{"className":2599},[],[2601],{"type":44,"value":2443},{"type":44,"value":459},{"type":39,"tag":66,"props":2604,"children":2605},{},[2606,2611],{"type":39,"tag":72,"props":2607,"children":2608},{},[2609],{"type":44,"value":2610},"Network isolation",{"type":44,"value":2612}," — use VPC egress connectors to restrict outbound traffic.",{"type":39,"tag":66,"props":2614,"children":2615},{},[2616,2621],{"type":39,"tag":72,"props":2617,"children":2618},{},[2619],{"type":44,"value":2620},"Least-privilege execution roles",{"type":44,"value":2622}," — scope IAM policies to specific regions, accounts, and resource prefixes.",{"type":39,"tag":66,"props":2624,"children":2625},{},[2626,2631],{"type":39,"tag":72,"props":2627,"children":2628},{},[2629],{"type":44,"value":2630},"Logging",{"type":44,"value":2632}," — enable CloudTrail for MicroVM lifecycle events.",{"type":39,"tag":2634,"props":2635,"children":2636},"style",{},[2637],{"type":44,"value":2638},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":2640,"total":2744},[2641,2658,2673,2688,2703,2713,2728],{"slug":2642,"name":2642,"fn":2643,"description":2644,"org":2645,"tags":2646,"stars":21,"repoUrl":22,"updatedAt":2657},"agents-build","add capabilities to existing agent projects","Use when adding capabilities to an existing agent project — memory, app integration, VPC, multi-agent, migration, model changes, browser, code interpreter, or resource removal. Triggers on: \"add memory\", \"remember across sessions\", \"call agent from app\", \"invoke agent from code\", \"auth to call agent\", \"streaming responses\", \"VPC\", \"VPC connectivity\", \"VPC error\", \"can't reach from VPC\", \"multi-agent\", \"A2A\", \"A2A auth\", \"orchestrator not delegating\", \"specialist not called\", \"migrate Bedrock Agent\", \"after import\", \"migration issue\", \"framework for migration\", \"change model\", \"browser tool\", \"code interpreter\", \"delete agent\", \"tear down\", \"agentcore remove\", \"cross-account memory\", \"resource-based policy on memory\", \"pay for x402 content\", \"402 Payment Required\", \"microtransactions\", \"paid API or tool\". Not for connecting to external APIs via Gateway — use agents-connect. Not for scaffolding a new project — use agents-get-started. Not for CLI\u002Fdev server errors — use agents-debug. Strands vs LangGraph in a migration context routes here.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2647,2650,2653,2654],{"name":2648,"slug":2649,"type":15},"Agents","agents",{"name":2651,"slug":2652,"type":15},"Automation","automation",{"name":20,"slug":8,"type":15},{"name":2655,"slug":2656,"type":15},"Engineering","engineering","2026-07-12T08:42:53.812877",{"slug":2659,"name":2659,"fn":2660,"description":2661,"org":2662,"tags":2663,"stars":21,"repoUrl":22,"updatedAt":2672},"agents-connect","connect agents to external services","Use when connecting your agent to external APIs, tools, or services via Gateway, or restricting tool access with Cedar policies. Handles gateway setup, target types, outbound auth (OAuth, API key, IAM), credentials, and Cedar policy authoring. Triggers on: \"connect to API\", \"add gateway\", \"connect to MCP server\", \"Lambda tools\", \"OpenAPI\", \"gateway target\", \"Cedar policy\", \"restrict tools\", \"policy engine\", \"gateway auth error\", \"store API key\", \"outbound credential\", \"env var API key\", \"API key None after deploy\", \"credential not available after deploy\", \"should this be a gateway target\", \"give my agent tools\", \"add tools to agent\". Not for inbound auth (who can call your agent) — use agents-harden. Not for debugging agent behavior — use agents-debug. Not for VPC networking errors (agent can't reach APIs due to VPC) — use agents-build. Not for creating or hosting a new MCP server project — use agents-get-started.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2664,2665,2668,2671],{"name":2648,"slug":2649,"type":15},{"name":2666,"slug":2667,"type":15},"API Development","api-development",{"name":2669,"slug":2670,"type":15},"Authentication","authentication",{"name":20,"slug":8,"type":15},"2026-07-16T06:00:38.866147",{"slug":2674,"name":2674,"fn":2675,"description":2676,"org":2677,"tags":2678,"stars":21,"repoUrl":22,"updatedAt":2687},"agents-debug","debug agent and environment issues","Use when your agent or environment is broken — wrong answers, errors, timeouts, tool failures, or CLI issues. Reads traces and logs to diagnose root causes. Also checks prerequisites when the CLI itself isn't working. Triggers on: \"agent not working\", \"wrong answer\", \"agent error\", \"tool call failing\", \"debug agent\", \"check logs\", \"read traces\", \"broken\", \"500 error\", \"424 error\", \"model access denied\", \"command not found\", \"stuck in DELETING\", \"maxVms exceeded\", \"cold start diagnosis\", \"cold start slow\", \"agentcore create error\", \"create failed\", \"exit code 7\", \"connection refused local dev\". Not for deploy failures — use agents-deploy. Not for performance tuning without errors — use agents-optimize. Not for VPC configuration — use agents-build. Not for observability setup or missing logs — use agents-optimize.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2679,2680,2681,2684],{"name":2648,"slug":2649,"type":15},{"name":20,"slug":8,"type":15},{"name":2682,"slug":2683,"type":15},"Debugging","debugging",{"name":2685,"slug":2686,"type":15},"Observability","observability","2026-07-16T06:00:44.679093",{"slug":2689,"name":2689,"fn":2690,"description":2691,"org":2692,"tags":2693,"stars":21,"repoUrl":22,"updatedAt":2702},"agents-deploy","deploy AI agents to AWS","Use when deploying your agent to AWS, or when a deploy has failed. Handles pre-flight validation, CDK\u002FIAM\u002Fquota error diagnosis, version management, rollback, and canary deployments. Triggers on: \"deploy my agent\", \"agentcore deploy\", \"deploy failed\", \"CDK error\", \"rollback\", \"canary deploy\", \"pin version\", \"redeploy\", \"deploy stuck\". Not for production hardening — use agents-harden. Not for adding capabilities before deploy — use agents-build or agents-connect. Not for VPC configuration errors — use agents-build.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2694,2695,2696,2699],{"name":2648,"slug":2649,"type":15},{"name":20,"slug":8,"type":15},{"name":2697,"slug":2698,"type":15},"CI\u002FCD","ci-cd",{"name":2700,"slug":2701,"type":15},"Deployment","deployment","2026-07-12T08:42:55.059577",{"slug":2704,"name":2704,"fn":2705,"description":2706,"org":2707,"tags":2708,"stars":21,"repoUrl":22,"updatedAt":2712},"agents-get-started","scaffold and deploy new agent projects","Use when a developer wants to create a new agent project or get started with AgentCore. Handles framework selection, project scaffolding, first deploy, and first invocation. Triggers on: \"build an agent\", \"create an agent\", \"get started\", \"new project\", \"agentcore create\", \"which framework\", \"Strands vs LangGraph\", \"hello world agent\", \"first agent\", \"create MCP server\", \"host MCP server\", \"agentcore dev\", \"dev server\", \"what port\", \"local development\". Not for adding capabilities to existing projects — use agents-build or agents-connect. Strands vs LangGraph in a migration context routes to agents-build, not here. Connecting to an existing MCP server routes to agents-connect, not here.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2709,2710,2711],{"name":2648,"slug":2649,"type":15},{"name":20,"slug":8,"type":15},{"name":2700,"slug":2701,"type":15},"2026-07-12T08:42:51.963247",{"slug":2714,"name":2714,"fn":2715,"description":2716,"org":2717,"tags":2718,"stars":21,"repoUrl":22,"updatedAt":2727},"agents-harden","harden agents for production","Use when preparing your agent for production — IAM scoping, inbound auth (JWT, SigV4), secrets management, cold start optimization, session lifecycle, rate limiting, input validation, and quota guidance. Triggers on: \"production checklist\", \"harden agent\", \"production ready\", \"secure agent\", \"inbound auth\", \"going live\", \"cold start optimization\", \"session lifecycle\", \"StopRuntimeSession\", \"quota\", \"throttling\", \"maxVms\", \"rate limit\", \"security audit of outbound API calls\", \"gateway target audit for production\", \"restrict who can call\", \"lock down endpoint\", \"only our app can call\". Not for Cedar tool-restriction policies — use agents-connect. Not for quality measurement — use agents-optimize. Not for outbound credential storage or API key wiring — use agents-connect. Not for A2A agent-to-agent auth — use agents-build. Cold start observation and diagnosis (not optimization) routes to agents-debug.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2719,2720,2721,2724],{"name":2648,"slug":2649,"type":15},{"name":20,"slug":8,"type":15},{"name":2722,"slug":2723,"type":15},"Best Practices","best-practices",{"name":2725,"slug":2726,"type":15},"Security","security","2026-07-16T06:00:42.174705",{"slug":2729,"name":2729,"fn":2730,"description":2731,"org":2732,"tags":2733,"stars":21,"repoUrl":22,"updatedAt":2743},"agents-optimize","optimize agent quality and performance","Use when measuring or improving agent quality and performance — set up evaluators, online monitoring, CI\u002FCD quality gates, observability, or cost optimization. Triggers on: \"evaluate my agent\", \"add evaluator\", \"measure quality\", \"quality gate\", \"run evals\", \"agent too slow\", \"why is it slow\", \"reduce latency\", \"set up observability\", \"CloudWatch dashboard\", \"how much does my agent cost\", \"cost optimization\", \"logs not showing up\", \"logs missing\", \"spans not found\", \"eval failing\", \"eval error\", \"dev traces\", \"local traces\", \"agentcore dev traces\", \"traces to CloudWatch\". Not for debugging errors or crashes — use agents-debug. Slow but correct routes here; broken routes to debug.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2734,2735,2736,2739,2740],{"name":2648,"slug":2649,"type":15},{"name":20,"slug":8,"type":15},{"name":2737,"slug":2738,"type":15},"Evals","evals",{"name":2685,"slug":2686,"type":15},{"name":2741,"slug":2742,"type":15},"Performance","performance","2026-07-12T08:42:56.488105",114,{"items":2746,"total":2861},[2747,2754,2761,2768,2775,2781,2788,2796,2811,2824,2836,2851],{"slug":2642,"name":2642,"fn":2643,"description":2644,"org":2748,"tags":2749,"stars":21,"repoUrl":22,"updatedAt":2657},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2750,2751,2752,2753],{"name":2648,"slug":2649,"type":15},{"name":2651,"slug":2652,"type":15},{"name":20,"slug":8,"type":15},{"name":2655,"slug":2656,"type":15},{"slug":2659,"name":2659,"fn":2660,"description":2661,"org":2755,"tags":2756,"stars":21,"repoUrl":22,"updatedAt":2672},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2757,2758,2759,2760],{"name":2648,"slug":2649,"type":15},{"name":2666,"slug":2667,"type":15},{"name":2669,"slug":2670,"type":15},{"name":20,"slug":8,"type":15},{"slug":2674,"name":2674,"fn":2675,"description":2676,"org":2762,"tags":2763,"stars":21,"repoUrl":22,"updatedAt":2687},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2764,2765,2766,2767],{"name":2648,"slug":2649,"type":15},{"name":20,"slug":8,"type":15},{"name":2682,"slug":2683,"type":15},{"name":2685,"slug":2686,"type":15},{"slug":2689,"name":2689,"fn":2690,"description":2691,"org":2769,"tags":2770,"stars":21,"repoUrl":22,"updatedAt":2702},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2771,2772,2773,2774],{"name":2648,"slug":2649,"type":15},{"name":20,"slug":8,"type":15},{"name":2697,"slug":2698,"type":15},{"name":2700,"slug":2701,"type":15},{"slug":2704,"name":2704,"fn":2705,"description":2706,"org":2776,"tags":2777,"stars":21,"repoUrl":22,"updatedAt":2712},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2778,2779,2780],{"name":2648,"slug":2649,"type":15},{"name":20,"slug":8,"type":15},{"name":2700,"slug":2701,"type":15},{"slug":2714,"name":2714,"fn":2715,"description":2716,"org":2782,"tags":2783,"stars":21,"repoUrl":22,"updatedAt":2727},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2784,2785,2786,2787],{"name":2648,"slug":2649,"type":15},{"name":20,"slug":8,"type":15},{"name":2722,"slug":2723,"type":15},{"name":2725,"slug":2726,"type":15},{"slug":2729,"name":2729,"fn":2730,"description":2731,"org":2789,"tags":2790,"stars":21,"repoUrl":22,"updatedAt":2743},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2791,2792,2793,2794,2795],{"name":2648,"slug":2649,"type":15},{"name":20,"slug":8,"type":15},{"name":2737,"slug":2738,"type":15},{"name":2685,"slug":2686,"type":15},{"name":2741,"slug":2742,"type":15},{"slug":2797,"name":2797,"fn":2798,"description":2799,"org":2800,"tags":2801,"stars":21,"repoUrl":22,"updatedAt":2810},"amazon-aurora-mysql","manage Amazon Aurora MySQL clusters","Amazon Aurora MySQL — creates, modifies, and advises on Aurora MySQL clusters specifically (MySQL-compatible engine, Aurora serverless, parallel query). Trigger for Aurora MySQL cluster operations, ACU sizing, I\u002FO-Optimized storage, commitment pricing, or MySQL upgrade planning. Aurora MySQL uses full (VPC-based) configuration — express configuration is PostgreSQL-only. For Aurora PostgreSQL, use amazon-aurora-postgresql instead. Contains safety guardrails and response templates that override defaults.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2802,2803,2806,2809],{"name":20,"slug":8,"type":15},{"name":2804,"slug":2805,"type":15},"Database","database",{"name":2807,"slug":2808,"type":15},"MySQL","mysql",{"name":13,"slug":14,"type":15},"2026-07-12T08:43:13.27939",{"slug":2812,"name":2812,"fn":2813,"description":2814,"org":2815,"tags":2816,"stars":21,"repoUrl":22,"updatedAt":2823},"amazon-aurora-postgresql","configure Amazon Aurora PostgreSQL clusters","Amazon Aurora PostgreSQL — creates, modifies, and advises on Aurora PostgreSQL clusters specifically (PostgreSQL-compatible engine, Aurora serverless, express configuration, pgvector, Babelfish). Trigger for Aurora PostgreSQL cluster operations, express-configuration quick-start, ACU sizing, I\u002FO-Optimized storage, commitment pricing, or PostgreSQL upgrade planning. For Aurora MySQL, use amazon-aurora-mysql instead. Contains safety guardrails, express-first routing, and response templates that override defaults.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2817,2818,2819,2822],{"name":20,"slug":8,"type":15},{"name":2804,"slug":2805,"type":15},{"name":2820,"slug":2821,"type":15},"PostgreSQL","postgresql",{"name":13,"slug":14,"type":15},"2026-07-16T06:00:34.789624",{"slug":2825,"name":2825,"fn":2826,"description":2827,"org":2828,"tags":2829,"stars":21,"repoUrl":22,"updatedAt":2835},"amazon-bedrock","build generative AI apps with Amazon Bedrock","Builds generative AI applications on Amazon Bedrock. Covers model invocation (Converse API, InvokeModel), RAG with Knowledge Bases, Bedrock Agents, Guardrails, and AgentCore. Use when invoking models, setting up Knowledge Bases, creating agents, applying guardrails, deploying to AgentCore, migrating\u002Fporting\u002Fconverting a Bedrock Agent (including inline agents) to an AgentCore Harness, troubleshooting Bedrock errors (ThrottlingException, AccessDeniedException), or choosing models (Claude, Llama, Nova, Titan). ALSO USE for prompt caching setup and debugging, quota health checks and throttling diagnosis, cost attribution and tracking, migrating between Claude model generations (4.5 to 4.6 to 4.7), chunking strategies, API selection (Converse vs InvokeModel), guardrail capabilities, and model selection. Also covers AgentCore Payments setup (x402, microtransactions, Payment Manager, Connector, Instrument, Coinbase CDP, Stripe Privy, 402 Payment Required, pay for content, paid endpoint, agent payments). NOT for custom model training, Rekognition, or Comprehend.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2830,2831,2832],{"name":2648,"slug":2649,"type":15},{"name":20,"slug":8,"type":15},{"name":2833,"slug":2834,"type":15},"LLM","llm","2026-07-25T05:30:35.20899",{"slug":2837,"name":2837,"fn":2838,"description":2839,"org":2840,"tags":2841,"stars":21,"repoUrl":22,"updatedAt":2850},"amazon-documentdb","manage Amazon DocumentDB clusters","Manages Amazon DocumentDB end-to-end — serverless-on-8.0 cluster setup, TLS\u002FVPC\u002Fdriver config, flexible-schema and vector-search data modeling, MongoDB compatibility assessment, DMS-based migration, slow-query diagnosis, major version upgrades (4.0→5.0→8.0), Well-Architected reviews (41-check wa_review.py), cost estimation, and security hardening. Retrieve for every DocumentDB question and when the user asks to set up or migrate MongoDB to AWS — DocumentDB is AWS's MongoDB-compatible managed database. Triggers: JSON document store, document database, MongoDB on AWS, Nested fields, Lambda cannot connect, TLS handshake, VPC port 27017, IAM auth, Secrets Manager, encryption at rest, $graphLookup, flexible schema, COLLSCAN, compound index, DMS migration, CDC cutover, $vectorSearch, RAG, Global Clusters, DR replication, cost sizing, audit, health check, production-readiness.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2842,2843,2844,2847],{"name":20,"slug":8,"type":15},{"name":2804,"slug":2805,"type":15},{"name":2845,"slug":2846,"type":15},"MongoDB","mongodb",{"name":2848,"slug":2849,"type":15},"NoSQL","nosql","2026-07-12T08:43:00.455878",{"slug":2852,"name":2852,"fn":2853,"description":2854,"org":2855,"tags":2856,"stars":21,"repoUrl":22,"updatedAt":2860},"amazon-dynamodb","design and debug DynamoDB data layers","Designs, reviews, and debugs DynamoDB data layers from design axioms — enumerates access patterns, chooses partition\u002Fsort keys and GSIs, decides single-table vs. multi-table, configures Streams, Global Tables, TTL, and zero-ETL integrations to OpenSearch\u002FRedshift\u002FSageMaker Lakehouse, and produces a defensible data-layer design with a monthly cost estimate and optional live validation. Applies whenever a user is designing, reviewing, or refactoring anything backed by DynamoDB — schemas, access patterns, GSIs, single- vs. multi-table choices, Streams consumers, transactional outboxes, Global Tables, zero-ETL pipelines — even when they don't say \"axioms\" or \"design review.\" Also applies when debugging hot partitions, throttling, unbounded Scans, LWW conflicts, or surprise bills on DynamoDB workloads.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2857,2858,2859],{"name":20,"slug":8,"type":15},{"name":2804,"slug":2805,"type":15},{"name":2848,"slug":2849,"type":15},"2026-07-16T06:00:37.690386",115]