[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-aws-labs-aws-lambda-microvms":3,"mdc-a0i8p9-key":42,"related-repo-aws-labs-aws-lambda-microvms":2652,"related-org-aws-labs-aws-lambda-microvms":2755},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":12,"stars":26,"repoUrl":27,"updatedAt":28,"license":29,"forks":30,"topics":31,"repo":37,"sourceUrl":40,"mdContent":41},"aws-lambda-microvms","build and run applications on AWS Lambda","Build, run, debug, and operate applications on AWS Lambda MicroVMs — Firecracker-isolated, snapshot-resumable serverless compute environments that run inside a container with up to 8-hour lifetimes. Triggers on: Lambda MicroVMs, Firecracker isolation, snapshot-resumable compute, suspend\u002Fresume, sandboxed or untrusted code execution, AI\u002Fagent code-execution sandboxes, interactive code playgrounds and notebooks (Jupyter, REPLs), reinforcement-learning environments, multi-tenant CI executors and build runners, sessionful game or simulation servers, isolated security scanners, long-lived sessions, or port-listening servers (gRPC, WebSocket, custom TCP). For standard event-driven Lambda functions, use the aws-lambda skill instead.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},"aws-labs","AWS Labs","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Faws-labs.png","awslabs",[13,17,20,23],{"name":14,"slug":15,"type":16},"Containers","containers","tag",{"name":18,"slug":19,"type":16},"Deployment","deployment",{"name":21,"slug":22,"type":16},"Serverless","serverless",{"name":24,"slug":25,"type":16},"AWS","aws",831,"https:\u002F\u002Fgithub.com\u002Fawslabs\u002Fagent-plugins","2026-07-12T08:39:02.879049",null,127,[32,33,34,25,35,36],"agent-plugins","agent-skills","agents","coding-agent-skills","coding-agents",{"repoUrl":27,"stars":26,"forks":30,"topics":38,"description":39},[32,33,34,25,35,36],"Agent Plugins for AWS equip AI coding agents with the skills to help you architect, deploy, and operate on AWS.","https:\u002F\u002Fgithub.com\u002Fawslabs\u002Fagent-plugins\u002Ftree\u002FHEAD\u002Fplugins\u002Faws-serverless\u002Fskills\u002Faws-lambda-microvms","---\nname: aws-lambda-microvms\ndescription: >\n  Build, run, debug, and operate applications on AWS Lambda MicroVMs —\n  Firecracker-isolated, snapshot-resumable serverless compute environments that\n  run inside a container with up to 8-hour lifetimes. Triggers on: Lambda\n  MicroVMs, Firecracker isolation, snapshot-resumable compute, suspend\u002Fresume,\n  sandboxed or untrusted code execution, AI\u002Fagent code-execution sandboxes,\n  interactive code playgrounds and notebooks (Jupyter, REPLs), reinforcement-learning\n  environments, multi-tenant CI executors and build runners, sessionful game or\n  simulation servers, isolated security scanners, long-lived sessions, or\n  port-listening servers (gRPC, WebSocket, custom TCP). For standard event-driven\n  Lambda functions, use the aws-lambda skill instead.\nargument-hint: \"[describe your workload or what you need help with]\"\nmetadata:\n  tags: lambda, microvms, firecracker, sandbox, isolation, snapshot, suspend-resume, sessions, agent-sandbox\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":43,"body":47},{"name":4,"description":6,"argument-hint":44,"metadata":45},"[describe your workload or what you need help with]",{"tags":46},"lambda, microvms, firecracker, sandbox, isolation, snapshot, suspend-resume, sessions, agent-sandbox",{"type":48,"children":49},"root",[50,58,68,73,125,133,183,191,216,223,230,303,308,314,344,350,363,369,607,613,1260,1285,1291,1303,1315,1342,1418,1467,1479,1588,1602,1608,1656,1671,1677,1690,1723,1878,1884,1897,2283,2288,2300,2306,2410,2416,2421,2522,2528,2559,2565,2646],{"type":51,"tag":52,"props":53,"children":54},"element","h1",{"id":4},[55],{"type":56,"value":57},"text","AWS Lambda MicroVMs",{"type":51,"tag":59,"props":60,"children":61},"blockquote",{},[62],{"type":51,"tag":63,"props":64,"children":65},"p",{},[66],{"type":56,"value":67},"The AWS MCP server is recommended for sandboxed execution and audit logging.",{"type":51,"tag":63,"props":69,"children":70},{},[71],{"type":56,"value":72},"AWS Lambda MicroVMs are serverless compute environments that combine Firecracker VM isolation with container-like efficiency. Each MicroVM:",{"type":51,"tag":74,"props":75,"children":76},"ul",{},[77,91,96,108,113],{"type":51,"tag":78,"props":79,"children":80},"li",{},[81,83,89],{"type":56,"value":82},"Runs your application as a ",{"type":51,"tag":84,"props":85,"children":86},"strong",{},[87],{"type":56,"value":88},"container inside a Firecracker microVM",{"type":56,"value":90}," — you can reproduce the environment locally.",{"type":51,"tag":78,"props":92,"children":93},{},[94],{"type":56,"value":95},"Runs Amazon Linux 2023 as the base OS inside the MicroVM.",{"type":51,"tag":78,"props":97,"children":98},{},[99,101,106],{"type":56,"value":100},"Boots from a ",{"type":51,"tag":84,"props":102,"children":103},{},[104],{"type":56,"value":105},"memory + disk snapshot",{"type":56,"value":107}," captured at image build time, so application init is skipped on run.",{"type":51,"tag":78,"props":109,"children":110},{},[111],{"type":56,"value":112},"Has a dedicated, TLS-terminated HTTPS endpoint reachable with an auth token.",{"type":51,"tag":78,"props":114,"children":115},{},[116,118,123],{"type":56,"value":117},"Can be ",{"type":51,"tag":84,"props":119,"children":120},{},[121],{"type":56,"value":122},"suspended and resumed",{"type":56,"value":124}," with state preserved; lives up to 8 hours.",{"type":51,"tag":63,"props":126,"children":127},{},[128],{"type":51,"tag":84,"props":129,"children":130},{},[131],{"type":56,"value":132},"Two-resource model:",{"type":51,"tag":74,"props":134,"children":135},{},[136,164],{"type":51,"tag":78,"props":137,"children":138},{},[139,146,148,154,156,162],{"type":51,"tag":140,"props":141,"children":143},"code",{"className":142},[],[144],{"type":56,"value":145},"MicrovmImage",{"type":56,"value":147}," — a versioned artifact built from ",{"type":51,"tag":140,"props":149,"children":151},{"className":150},[],[152],{"type":56,"value":153},"{S3 zip with Dockerfile} + baseImageArn",{"type":56,"value":155},". Each version has per-architecture\u002Fchipset ",{"type":51,"tag":140,"props":157,"children":159},{"className":158},[],[160],{"type":56,"value":161},"Build",{"type":56,"value":163},"s.",{"type":51,"tag":78,"props":165,"children":166},{},[167,173,175,181],{"type":51,"tag":140,"props":168,"children":170},{"className":169},[],[171],{"type":56,"value":172},"Microvm",{"type":56,"value":174}," — a running instance created (",{"type":51,"tag":140,"props":176,"children":178},{"className":177},[],[179],{"type":56,"value":180},"RunMicrovm",{"type":56,"value":182},") from an image version.",{"type":51,"tag":63,"props":184,"children":185},{},[186],{"type":51,"tag":84,"props":187,"children":188},{},[189],{"type":56,"value":190},"Two roles:",{"type":51,"tag":74,"props":192,"children":193},{},[194,205],{"type":51,"tag":78,"props":195,"children":196},{},[197,203],{"type":51,"tag":140,"props":198,"children":200},{"className":199},[],[201],{"type":56,"value":202},"buildRoleArn",{"type":56,"value":204}," — used during image build (S3 read, CloudWatch logs, optional ECR).",{"type":51,"tag":78,"props":206,"children":207},{},[208,214],{"type":51,"tag":140,"props":209,"children":211},{"className":210},[],[212],{"type":56,"value":213},"executionRoleArn",{"type":56,"value":215}," — assumed at runtime by the running MicroVM.",{"type":51,"tag":217,"props":218,"children":220},"h2",{"id":219},"when-to-use",[221],{"type":56,"value":222},"When to use",{"type":51,"tag":224,"props":225,"children":227},"h3",{"id":226},"choose-lambda-microvms-when",[228],{"type":56,"value":229},"Choose Lambda MicroVMs when",{"type":51,"tag":74,"props":231,"children":232},{},[233,243,253,263,273,283,293],{"type":51,"tag":78,"props":234,"children":235},{},[236,241],{"type":51,"tag":84,"props":237,"children":238},{},[239],{"type":56,"value":240},"Analytics workloads",{"type":56,"value":242}," — isolated compute for data processing, ETL jobs, or query execution with strong tenant separation.",{"type":51,"tag":78,"props":244,"children":245},{},[246,251],{"type":51,"tag":84,"props":247,"children":248},{},[249],{"type":56,"value":250},"AI \u002F agent code execution sandboxes",{"type":56,"value":252}," — fresh, isolated environment per session, fast resume between turns.",{"type":51,"tag":78,"props":254,"children":255},{},[256,261],{"type":51,"tag":84,"props":257,"children":258},{},[259],{"type":56,"value":260},"Interactive code playgrounds & notebooks",{"type":56,"value":262}," — Jupyter, REPLs, dev environments executing user code.",{"type":51,"tag":78,"props":264,"children":265},{},[266,271],{"type":51,"tag":84,"props":267,"children":268},{},[269],{"type":56,"value":270},"Reinforcement-learning environments",{"type":56,"value":272}," — clean per-episode envs with tool access.",{"type":51,"tag":78,"props":274,"children":275},{},[276,281],{"type":51,"tag":84,"props":277,"children":278},{},[279],{"type":56,"value":280},"Multi-tenant CI executors \u002F build runners",{"type":56,"value":282}," — strong tenant isolation.",{"type":51,"tag":78,"props":284,"children":285},{},[286,291],{"type":51,"tag":84,"props":287,"children":288},{},[289],{"type":56,"value":290},"Game \u002F simulation servers",{"type":56,"value":292}," — sessionful, long-lived (up to 8 hr) workloads.",{"type":51,"tag":78,"props":294,"children":295},{},[296,301],{"type":51,"tag":84,"props":297,"children":298},{},[299],{"type":56,"value":300},"Security scanning",{"type":56,"value":302}," — running untrusted analyzers in isolation.",{"type":51,"tag":63,"props":304,"children":305},{},[306],{"type":56,"value":307},"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":51,"tag":224,"props":309,"children":311},{"id":310},"choose-aws-lambda-functions-when",[312],{"type":56,"value":313},"Choose AWS Lambda (functions) when",{"type":51,"tag":74,"props":315,"children":316},{},[317,322,327,339],{"type":51,"tag":78,"props":318,"children":319},{},[320],{"type":56,"value":321},"The workload fits in 15 minutes.",{"type":51,"tag":78,"props":323,"children":324},{},[325],{"type":56,"value":326},"Per-invocation isolation is fine; no need for session state held in memory.",{"type":51,"tag":78,"props":328,"children":329},{},[330,332,337],{"type":56,"value":331},"Fully automatic scaling is preferred (no ",{"type":51,"tag":140,"props":333,"children":335},{"className":334},[],[336],{"type":56,"value":180},{"type":56,"value":338}," to manage).",{"type":51,"tag":78,"props":340,"children":341},{},[342],{"type":56,"value":343},"Event-source integrations (S3, SQS, EventBridge, etc.) drive the function.",{"type":51,"tag":224,"props":345,"children":347},{"id":346},"choose-something-else-when",[348],{"type":56,"value":349},"Choose something else when",{"type":51,"tag":74,"props":351,"children":352},{},[353,358],{"type":51,"tag":78,"props":354,"children":355},{},[356],{"type":56,"value":357},"Continuous compute beyond 8 hr → ECS \u002F EKS \u002F EC2.",{"type":51,"tag":78,"props":359,"children":360},{},[361],{"type":56,"value":362},"Lift-and-shift workloads needing kernel modifications or a non-Linux OS → EC2.",{"type":51,"tag":217,"props":364,"children":366},{"id":365},"typical-workflow",[367],{"type":56,"value":368},"Typical workflow",{"type":51,"tag":370,"props":371,"children":373},"ol",{"start":372},0,[374,392,410,472,496,543,568],{"type":51,"tag":78,"props":375,"children":376},{},[377,382,384,390],{"type":51,"tag":84,"props":378,"children":379},{},[380],{"type":56,"value":381},"Check regional availability",{"type":56,"value":383}," — confirm Lambda MicroVMs is available in your target region (run ",{"type":51,"tag":140,"props":385,"children":387},{"className":386},[],[388],{"type":56,"value":389},"aws lambda-microvms list-managed-microvm-images",{"type":56,"value":391},"). Your S3 artifact bucket and any network connectors must be in the same region as the image.",{"type":51,"tag":78,"props":393,"children":394},{},[395,400,402,408],{"type":51,"tag":84,"props":396,"children":397},{},[398],{"type":56,"value":399},"Package",{"type":56,"value":401}," an app: zip with a ",{"type":51,"tag":140,"props":403,"children":405},{"className":404},[],[406],{"type":56,"value":407},"Dockerfile",{"type":56,"value":409}," at the root, upload to S3 (same region as the image).",{"type":51,"tag":78,"props":411,"children":412},{},[413,418,420,426,428,434,436,442,443,449,450,456,457,463,464,470],{"type":51,"tag":84,"props":414,"children":415},{},[416],{"type":56,"value":417},"Implement lifecycle hooks",{"type":56,"value":419}," (optional but recommended) — HTTP endpoints on a port you specify (commonly ",{"type":51,"tag":140,"props":421,"children":423},{"className":422},[],[424],{"type":56,"value":425},"9000",{"type":56,"value":427},") for ",{"type":51,"tag":140,"props":429,"children":431},{"className":430},[],[432],{"type":56,"value":433},"\u002Frun",{"type":56,"value":435},", ",{"type":51,"tag":140,"props":437,"children":439},{"className":438},[],[440],{"type":56,"value":441},"\u002Fresume",{"type":56,"value":435},{"type":51,"tag":140,"props":444,"children":446},{"className":445},[],[447],{"type":56,"value":448},"\u002Fsuspend",{"type":56,"value":435},{"type":51,"tag":140,"props":451,"children":453},{"className":452},[],[454],{"type":56,"value":455},"\u002Fterminate",{"type":56,"value":435},{"type":51,"tag":140,"props":458,"children":460},{"className":459},[],[461],{"type":56,"value":462},"\u002Fready",{"type":56,"value":435},{"type":51,"tag":140,"props":465,"children":467},{"className":466},[],[468],{"type":56,"value":469},"\u002Fvalidate",{"type":56,"value":471},".",{"type":51,"tag":78,"props":473,"children":474},{},[475,480,482,487,489,494],{"type":51,"tag":84,"props":476,"children":477},{},[478],{"type":56,"value":479},"CreateMicrovmImage",{"type":56,"value":481}," — 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":51,"tag":140,"props":483,"children":485},{"className":484},[],[486],{"type":56,"value":462},{"type":56,"value":488},", snapshots disk + memory, optionally validates with ",{"type":51,"tag":140,"props":490,"children":492},{"className":491},[],[493],{"type":56,"value":469},{"type":56,"value":495},". 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":51,"tag":78,"props":497,"children":498},{},[499,503,505,510,512,518,520,526,528,534,536,542],{"type":51,"tag":84,"props":500,"children":501},{},[502],{"type":56,"value":180},{"type":56,"value":504}," — pick an image version, attach ",{"type":51,"tag":140,"props":506,"children":508},{"className":507},[],[509],{"type":56,"value":213},{"type":56,"value":511},", set ",{"type":51,"tag":140,"props":513,"children":515},{"className":514},[],[516],{"type":56,"value":517},"idlePolicy",{"type":56,"value":519},", ingress\u002Fegress connectors, and (optionally) a ",{"type":51,"tag":140,"props":521,"children":523},{"className":522},[],[524],{"type":56,"value":525},"runHookPayload",{"type":56,"value":527},". Receive an ",{"type":51,"tag":140,"props":529,"children":531},{"className":530},[],[532],{"type":56,"value":533},"endpoint",{"type":56,"value":535}," URL and ",{"type":51,"tag":140,"props":537,"children":539},{"className":538},[],[540],{"type":56,"value":541},"microvmId",{"type":56,"value":471},{"type":51,"tag":78,"props":544,"children":545},{},[546,551,553,559,561,567],{"type":51,"tag":84,"props":547,"children":548},{},[549],{"type":56,"value":550},"CreateMicrovmAuthToken",{"type":56,"value":552}," — get an auth token (max 60 min) with ",{"type":51,"tag":140,"props":554,"children":556},{"className":555},[],[557],{"type":56,"value":558},"allowedPorts",{"type":56,"value":560}," specifying which ports the token grants access to. Send traffic to the endpoint with ",{"type":51,"tag":140,"props":562,"children":564},{"className":563},[],[565],{"type":56,"value":566},"X-aws-proxy-auth: \u003Ctoken>",{"type":56,"value":471},{"type":51,"tag":78,"props":569,"children":570},{},[571,576,578,583,585,591,592,598,599,605],{"type":51,"tag":84,"props":572,"children":573},{},[574],{"type":56,"value":575},"Suspend \u002F Resume \u002F Terminate",{"type":56,"value":577}," — explicit APIs, or let the ",{"type":51,"tag":140,"props":579,"children":581},{"className":580},[],[582],{"type":56,"value":517},{"type":56,"value":584}," drive it (",{"type":51,"tag":140,"props":586,"children":588},{"className":587},[],[589],{"type":56,"value":590},"maxIdleDurationSeconds",{"type":56,"value":435},{"type":51,"tag":140,"props":593,"children":595},{"className":594},[],[596],{"type":56,"value":597},"suspendedDurationSeconds",{"type":56,"value":435},{"type":51,"tag":140,"props":600,"children":602},{"className":601},[],[603],{"type":56,"value":604},"autoResumeEnabled",{"type":56,"value":606},").",{"type":51,"tag":224,"props":608,"children":610},{"id":609},"core-cli-commands",[611],{"type":56,"value":612},"Core CLI commands",{"type":51,"tag":614,"props":615,"children":620},"pre",{"className":616,"code":617,"language":618,"meta":619,"style":619},"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","",[621],{"type":51,"tag":140,"props":622,"children":623},{"__ignoreMap":619},[624,636,662,680,724,765,789,799,808,817,838,897,916,954,976,984,993,1024,1052,1079,1116,1164,1172,1181,1208,1234],{"type":51,"tag":625,"props":626,"children":629},"span",{"class":627,"line":628},"line",1,[630],{"type":51,"tag":625,"props":631,"children":633},{"style":632},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic",[634],{"type":56,"value":635},"# Create an image (zip with Dockerfile at root in S3, plus a managed base image)\n",{"type":51,"tag":625,"props":637,"children":639},{"class":627,"line":638},2,[640,645,651,656],{"type":51,"tag":625,"props":641,"children":643},{"style":642},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[644],{"type":56,"value":25},{"type":51,"tag":625,"props":646,"children":648},{"style":647},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[649],{"type":56,"value":650}," lambda-microvms",{"type":51,"tag":625,"props":652,"children":653},{"style":647},[654],{"type":56,"value":655}," create-microvm-image",{"type":51,"tag":625,"props":657,"children":659},{"style":658},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[660],{"type":56,"value":661}," \\\n",{"type":51,"tag":625,"props":663,"children":665},{"class":627,"line":664},3,[666,671,676],{"type":51,"tag":625,"props":667,"children":668},{"style":647},[669],{"type":56,"value":670},"  --name",{"type":51,"tag":625,"props":672,"children":673},{"style":647},[674],{"type":56,"value":675}," my-image",{"type":51,"tag":625,"props":677,"children":678},{"style":658},[679],{"type":56,"value":661},{"type":51,"tag":625,"props":681,"children":683},{"class":627,"line":682},4,[684,689,694,700,705,710,715,720],{"type":51,"tag":625,"props":685,"children":686},{"style":647},[687],{"type":56,"value":688},"  --base-image-arn",{"type":51,"tag":625,"props":690,"children":691},{"style":647},[692],{"type":56,"value":693}," arn:aws:lambda:",{"type":51,"tag":625,"props":695,"children":697},{"style":696},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[698],{"type":56,"value":699},"\u003C",{"type":51,"tag":625,"props":701,"children":702},{"style":647},[703],{"type":56,"value":704},"regio",{"type":51,"tag":625,"props":706,"children":707},{"style":658},[708],{"type":56,"value":709},"n",{"type":51,"tag":625,"props":711,"children":712},{"style":696},[713],{"type":56,"value":714},">",{"type":51,"tag":625,"props":716,"children":717},{"style":647},[718],{"type":56,"value":719},":aws:microvm-image:al2023-1",{"type":51,"tag":625,"props":721,"children":722},{"style":658},[723],{"type":56,"value":661},{"type":51,"tag":625,"props":725,"children":727},{"class":627,"line":726},5,[728,733,738,742,747,752,756,761],{"type":51,"tag":625,"props":729,"children":730},{"style":647},[731],{"type":56,"value":732},"  --build-role-arn",{"type":51,"tag":625,"props":734,"children":735},{"style":647},[736],{"type":56,"value":737}," arn:aws:iam::",{"type":51,"tag":625,"props":739,"children":740},{"style":696},[741],{"type":56,"value":699},{"type":51,"tag":625,"props":743,"children":744},{"style":647},[745],{"type":56,"value":746},"acc",{"type":51,"tag":625,"props":748,"children":749},{"style":658},[750],{"type":56,"value":751},"t",{"type":51,"tag":625,"props":753,"children":754},{"style":696},[755],{"type":56,"value":714},{"type":51,"tag":625,"props":757,"children":758},{"style":647},[759],{"type":56,"value":760},":role\u002FMicroVMBuildRole",{"type":51,"tag":625,"props":762,"children":763},{"style":658},[764],{"type":56,"value":661},{"type":51,"tag":625,"props":766,"children":768},{"class":627,"line":767},6,[769,774,779,784],{"type":51,"tag":625,"props":770,"children":771},{"style":647},[772],{"type":56,"value":773},"  --code-artifact",{"type":51,"tag":625,"props":775,"children":776},{"style":696},[777],{"type":56,"value":778}," '",{"type":51,"tag":625,"props":780,"children":781},{"style":647},[782],{"type":56,"value":783},"{\"uri\":\"s3:\u002F\u002F\u003Cbucket>\u002F\u003Ckey>.zip\"}",{"type":51,"tag":625,"props":785,"children":786},{"style":696},[787],{"type":56,"value":788},"'\n",{"type":51,"tag":625,"props":790,"children":792},{"class":627,"line":791},7,[793],{"type":51,"tag":625,"props":794,"children":796},{"emptyLinePlaceholder":795},true,[797],{"type":56,"value":798},"\n",{"type":51,"tag":625,"props":800,"children":802},{"class":627,"line":801},8,[803],{"type":51,"tag":625,"props":804,"children":805},{"style":632},[806],{"type":56,"value":807},"# Run a MicroVM (returns endpoint + microvmId). --image-identifier takes the\n",{"type":51,"tag":625,"props":809,"children":811},{"class":627,"line":810},9,[812],{"type":51,"tag":625,"props":813,"children":814},{"style":632},[815],{"type":56,"value":816},"# image ARN (the bare name is rejected); --image-version is the full major.minor string.\n",{"type":51,"tag":625,"props":818,"children":820},{"class":627,"line":819},10,[821,825,829,834],{"type":51,"tag":625,"props":822,"children":823},{"style":642},[824],{"type":56,"value":25},{"type":51,"tag":625,"props":826,"children":827},{"style":647},[828],{"type":56,"value":650},{"type":51,"tag":625,"props":830,"children":831},{"style":647},[832],{"type":56,"value":833}," run-microvm",{"type":51,"tag":625,"props":835,"children":836},{"style":658},[837],{"type":56,"value":661},{"type":51,"tag":625,"props":839,"children":841},{"class":627,"line":840},11,[842,847,851,855,859,863,867,872,876,880,884,888,893],{"type":51,"tag":625,"props":843,"children":844},{"style":647},[845],{"type":56,"value":846},"  --image-identifier",{"type":51,"tag":625,"props":848,"children":849},{"style":647},[850],{"type":56,"value":693},{"type":51,"tag":625,"props":852,"children":853},{"style":696},[854],{"type":56,"value":699},{"type":51,"tag":625,"props":856,"children":857},{"style":647},[858],{"type":56,"value":704},{"type":51,"tag":625,"props":860,"children":861},{"style":658},[862],{"type":56,"value":709},{"type":51,"tag":625,"props":864,"children":865},{"style":696},[866],{"type":56,"value":714},{"type":51,"tag":625,"props":868,"children":869},{"style":647},[870],{"type":56,"value":871},":",{"type":51,"tag":625,"props":873,"children":874},{"style":696},[875],{"type":56,"value":699},{"type":51,"tag":625,"props":877,"children":878},{"style":647},[879],{"type":56,"value":746},{"type":51,"tag":625,"props":881,"children":882},{"style":658},[883],{"type":56,"value":751},{"type":51,"tag":625,"props":885,"children":886},{"style":696},[887],{"type":56,"value":714},{"type":51,"tag":625,"props":889,"children":890},{"style":647},[891],{"type":56,"value":892},":microvm-image:my-image",{"type":51,"tag":625,"props":894,"children":895},{"style":658},[896],{"type":56,"value":661},{"type":51,"tag":625,"props":898,"children":900},{"class":627,"line":899},12,[901,906,912],{"type":51,"tag":625,"props":902,"children":903},{"style":647},[904],{"type":56,"value":905},"  --image-version",{"type":51,"tag":625,"props":907,"children":909},{"style":908},"--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C",[910],{"type":56,"value":911}," 1.0",{"type":51,"tag":625,"props":913,"children":914},{"style":658},[915],{"type":56,"value":661},{"type":51,"tag":625,"props":917,"children":919},{"class":627,"line":918},13,[920,925,929,933,937,941,945,950],{"type":51,"tag":625,"props":921,"children":922},{"style":647},[923],{"type":56,"value":924},"  --execution-role-arn",{"type":51,"tag":625,"props":926,"children":927},{"style":647},[928],{"type":56,"value":737},{"type":51,"tag":625,"props":930,"children":931},{"style":696},[932],{"type":56,"value":699},{"type":51,"tag":625,"props":934,"children":935},{"style":647},[936],{"type":56,"value":746},{"type":51,"tag":625,"props":938,"children":939},{"style":658},[940],{"type":56,"value":751},{"type":51,"tag":625,"props":942,"children":943},{"style":696},[944],{"type":56,"value":714},{"type":51,"tag":625,"props":946,"children":947},{"style":647},[948],{"type":56,"value":949},":role\u002FMicroVMExecutionRole",{"type":51,"tag":625,"props":951,"children":952},{"style":658},[953],{"type":56,"value":661},{"type":51,"tag":625,"props":955,"children":957},{"class":627,"line":956},14,[958,963,967,972],{"type":51,"tag":625,"props":959,"children":960},{"style":647},[961],{"type":56,"value":962},"  --idle-policy",{"type":51,"tag":625,"props":964,"children":965},{"style":696},[966],{"type":56,"value":778},{"type":51,"tag":625,"props":968,"children":969},{"style":647},[970],{"type":56,"value":971},"{\"maxIdleDurationSeconds\":900,\"suspendedDurationSeconds\":300,\"autoResumeEnabled\":true}",{"type":51,"tag":625,"props":973,"children":974},{"style":696},[975],{"type":56,"value":788},{"type":51,"tag":625,"props":977,"children":979},{"class":627,"line":978},15,[980],{"type":51,"tag":625,"props":981,"children":982},{"emptyLinePlaceholder":795},[983],{"type":56,"value":798},{"type":51,"tag":625,"props":985,"children":987},{"class":627,"line":986},16,[988],{"type":51,"tag":625,"props":989,"children":990},{"style":632},[991],{"type":56,"value":992},"# Mint an auth token and call the endpoint\n",{"type":51,"tag":625,"props":994,"children":996},{"class":627,"line":995},17,[997,1002,1007,1011,1015,1020],{"type":51,"tag":625,"props":998,"children":999},{"style":658},[1000],{"type":56,"value":1001},"TOKEN",{"type":51,"tag":625,"props":1003,"children":1004},{"style":696},[1005],{"type":56,"value":1006},"=$(",{"type":51,"tag":625,"props":1008,"children":1009},{"style":642},[1010],{"type":56,"value":25},{"type":51,"tag":625,"props":1012,"children":1013},{"style":647},[1014],{"type":56,"value":650},{"type":51,"tag":625,"props":1016,"children":1017},{"style":647},[1018],{"type":56,"value":1019}," create-microvm-auth-token",{"type":51,"tag":625,"props":1021,"children":1022},{"style":658},[1023],{"type":56,"value":661},{"type":51,"tag":625,"props":1025,"children":1027},{"class":627,"line":1026},18,[1028,1033,1038,1043,1048],{"type":51,"tag":625,"props":1029,"children":1030},{"style":647},[1031],{"type":56,"value":1032},"  --microvm-identifier",{"type":51,"tag":625,"props":1034,"children":1035},{"style":647},[1036],{"type":56,"value":1037}," microvm-...",{"type":51,"tag":625,"props":1039,"children":1040},{"style":647},[1041],{"type":56,"value":1042}," --expiration-in-minutes",{"type":51,"tag":625,"props":1044,"children":1045},{"style":908},[1046],{"type":56,"value":1047}," 30",{"type":51,"tag":625,"props":1049,"children":1050},{"style":658},[1051],{"type":56,"value":661},{"type":51,"tag":625,"props":1053,"children":1055},{"class":627,"line":1054},19,[1056,1061,1065,1070,1075],{"type":51,"tag":625,"props":1057,"children":1058},{"style":647},[1059],{"type":56,"value":1060},"  --allowed-ports",{"type":51,"tag":625,"props":1062,"children":1063},{"style":696},[1064],{"type":56,"value":778},{"type":51,"tag":625,"props":1066,"children":1067},{"style":647},[1068],{"type":56,"value":1069},"[{\"port\":8080}]",{"type":51,"tag":625,"props":1071,"children":1072},{"style":696},[1073],{"type":56,"value":1074},"'",{"type":51,"tag":625,"props":1076,"children":1077},{"style":658},[1078],{"type":56,"value":661},{"type":51,"tag":625,"props":1080,"children":1082},{"class":627,"line":1081},20,[1083,1088,1092,1097,1101,1106,1111],{"type":51,"tag":625,"props":1084,"children":1085},{"style":647},[1086],{"type":56,"value":1087},"  --query",{"type":51,"tag":625,"props":1089,"children":1090},{"style":696},[1091],{"type":56,"value":778},{"type":51,"tag":625,"props":1093,"children":1094},{"style":647},[1095],{"type":56,"value":1096},"authToken.\"X-aws-proxy-auth\"",{"type":51,"tag":625,"props":1098,"children":1099},{"style":696},[1100],{"type":56,"value":1074},{"type":51,"tag":625,"props":1102,"children":1103},{"style":647},[1104],{"type":56,"value":1105}," --output",{"type":51,"tag":625,"props":1107,"children":1108},{"style":647},[1109],{"type":56,"value":1110}," text",{"type":51,"tag":625,"props":1112,"children":1113},{"style":696},[1114],{"type":56,"value":1115},")\n",{"type":51,"tag":625,"props":1117,"children":1119},{"class":627,"line":1118},21,[1120,1125,1130,1135,1140,1145,1149,1154,1159],{"type":51,"tag":625,"props":1121,"children":1122},{"style":642},[1123],{"type":56,"value":1124},"curl",{"type":51,"tag":625,"props":1126,"children":1127},{"style":696},[1128],{"type":56,"value":1129}," \"",{"type":51,"tag":625,"props":1131,"children":1132},{"style":647},[1133],{"type":56,"value":1134},"\u003Cendpoint>\u002F",{"type":51,"tag":625,"props":1136,"children":1137},{"style":696},[1138],{"type":56,"value":1139},"\"",{"type":51,"tag":625,"props":1141,"children":1142},{"style":647},[1143],{"type":56,"value":1144}," -H",{"type":51,"tag":625,"props":1146,"children":1147},{"style":696},[1148],{"type":56,"value":1129},{"type":51,"tag":625,"props":1150,"children":1151},{"style":647},[1152],{"type":56,"value":1153},"X-aws-proxy-auth: ",{"type":51,"tag":625,"props":1155,"children":1156},{"style":658},[1157],{"type":56,"value":1158},"$TOKEN",{"type":51,"tag":625,"props":1160,"children":1161},{"style":696},[1162],{"type":56,"value":1163},"\"\n",{"type":51,"tag":625,"props":1165,"children":1167},{"class":627,"line":1166},22,[1168],{"type":51,"tag":625,"props":1169,"children":1170},{"emptyLinePlaceholder":795},[1171],{"type":56,"value":798},{"type":51,"tag":625,"props":1173,"children":1175},{"class":627,"line":1174},23,[1176],{"type":51,"tag":625,"props":1177,"children":1178},{"style":632},[1179],{"type":56,"value":1180},"# Lifecycle\n",{"type":51,"tag":625,"props":1182,"children":1184},{"class":627,"line":1183},24,[1185,1189,1193,1198,1203],{"type":51,"tag":625,"props":1186,"children":1187},{"style":642},[1188],{"type":56,"value":25},{"type":51,"tag":625,"props":1190,"children":1191},{"style":647},[1192],{"type":56,"value":650},{"type":51,"tag":625,"props":1194,"children":1195},{"style":647},[1196],{"type":56,"value":1197}," suspend-microvm",{"type":51,"tag":625,"props":1199,"children":1200},{"style":647},[1201],{"type":56,"value":1202},"   --microvm-identifier",{"type":51,"tag":625,"props":1204,"children":1205},{"style":647},[1206],{"type":56,"value":1207}," microvm-...\n",{"type":51,"tag":625,"props":1209,"children":1211},{"class":627,"line":1210},25,[1212,1216,1220,1225,1230],{"type":51,"tag":625,"props":1213,"children":1214},{"style":642},[1215],{"type":56,"value":25},{"type":51,"tag":625,"props":1217,"children":1218},{"style":647},[1219],{"type":56,"value":650},{"type":51,"tag":625,"props":1221,"children":1222},{"style":647},[1223],{"type":56,"value":1224}," resume-microvm",{"type":51,"tag":625,"props":1226,"children":1227},{"style":647},[1228],{"type":56,"value":1229},"    --microvm-identifier",{"type":51,"tag":625,"props":1231,"children":1232},{"style":647},[1233],{"type":56,"value":1207},{"type":51,"tag":625,"props":1235,"children":1237},{"class":627,"line":1236},26,[1238,1242,1246,1251,1256],{"type":51,"tag":625,"props":1239,"children":1240},{"style":642},[1241],{"type":56,"value":25},{"type":51,"tag":625,"props":1243,"children":1244},{"style":647},[1245],{"type":56,"value":650},{"type":51,"tag":625,"props":1247,"children":1248},{"style":647},[1249],{"type":56,"value":1250}," terminate-microvm",{"type":51,"tag":625,"props":1252,"children":1253},{"style":647},[1254],{"type":56,"value":1255}," --microvm-identifier",{"type":51,"tag":625,"props":1257,"children":1258},{"style":647},[1259],{"type":56,"value":1207},{"type":51,"tag":63,"props":1261,"children":1262},{},[1263,1265,1275,1277,1283],{"type":56,"value":1264},"See ",{"type":51,"tag":1266,"props":1267,"children":1269},"a",{"href":1268},"references\u002Fgetting-started.md",[1270],{"type":51,"tag":140,"props":1271,"children":1273},{"className":1272},[],[1274],{"type":56,"value":1268},{"type":56,"value":1276}," for the full walkthrough including ",{"type":51,"tag":140,"props":1278,"children":1280},{"className":1279},[],[1281],{"type":56,"value":1282},"--hooks",{"type":56,"value":1284}," config and lifecycle hooks.",{"type":51,"tag":217,"props":1286,"children":1288},{"id":1287},"hook-configuration",[1289],{"type":56,"value":1290},"Hook configuration",{"type":51,"tag":63,"props":1292,"children":1293},{},[1294,1296,1301],{"type":56,"value":1295},"Hooks are organized into two groups under the ",{"type":51,"tag":140,"props":1297,"children":1299},{"className":1298},[],[1300],{"type":56,"value":1282},{"type":56,"value":1302}," parameter:",{"type":51,"tag":224,"props":1304,"children":1306},{"id":1305},"microvmimagehooks-build-time",[1307,1313],{"type":51,"tag":140,"props":1308,"children":1310},{"className":1309},[],[1311],{"type":56,"value":1312},"microvmImageHooks",{"type":56,"value":1314}," (build-time)",{"type":51,"tag":59,"props":1316,"children":1317},{},[1318],{"type":51,"tag":63,"props":1319,"children":1320},{},[1321,1326,1328,1333,1335,1340],{"type":51,"tag":84,"props":1322,"children":1323},{},[1324],{"type":56,"value":1325},"Recommendation:",{"type":56,"value":1327}," Implement the image build hooks (",{"type":51,"tag":140,"props":1329,"children":1331},{"className":1330},[],[1332],{"type":56,"value":462},{"type":56,"value":1334}," and ",{"type":51,"tag":140,"props":1336,"children":1338},{"className":1337},[],[1339],{"type":56,"value":469},{"type":56,"value":1341},") for best performance. They enable the platform to capture a complete snapshot and prefetch the portions accessed at run time.",{"type":51,"tag":1343,"props":1344,"children":1345},"table",{},[1346,1370],{"type":51,"tag":1347,"props":1348,"children":1349},"thead",{},[1350],{"type":51,"tag":1351,"props":1352,"children":1353},"tr",{},[1354,1360,1365],{"type":51,"tag":1355,"props":1356,"children":1357},"th",{},[1358],{"type":56,"value":1359},"Hook",{"type":51,"tag":1355,"props":1361,"children":1362},{},[1363],{"type":56,"value":1364},"Purpose",{"type":51,"tag":1355,"props":1366,"children":1367},{},[1368],{"type":56,"value":1369},"Timeout range",{"type":51,"tag":1371,"props":1372,"children":1373},"tbody",{},[1374,1397],{"type":51,"tag":1351,"props":1375,"children":1376},{},[1377,1387,1392],{"type":51,"tag":1378,"props":1379,"children":1380},"td",{},[1381],{"type":51,"tag":140,"props":1382,"children":1384},{"className":1383},[],[1385],{"type":56,"value":1386},"ready",{"type":51,"tag":1378,"props":1388,"children":1389},{},[1390],{"type":56,"value":1391},"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":51,"tag":1378,"props":1393,"children":1394},{},[1395],{"type":56,"value":1396},"1–3600s (default 30s)",{"type":51,"tag":1351,"props":1398,"children":1399},{},[1400,1409,1414],{"type":51,"tag":1378,"props":1401,"children":1402},{},[1403],{"type":51,"tag":140,"props":1404,"children":1406},{"className":1405},[],[1407],{"type":56,"value":1408},"validate",{"type":51,"tag":1378,"props":1410,"children":1411},{},[1412],{"type":56,"value":1413},"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":51,"tag":1378,"props":1415,"children":1416},{},[1417],{"type":56,"value":1396},{"type":51,"tag":59,"props":1419,"children":1420},{},[1421,1438],{"type":51,"tag":63,"props":1422,"children":1423},{},[1424,1436],{"type":51,"tag":84,"props":1425,"children":1426},{},[1427,1429,1434],{"type":56,"value":1428},"Why implement ",{"type":51,"tag":140,"props":1430,"children":1432},{"className":1431},[],[1433],{"type":56,"value":462},{"type":56,"value":1435},"?",{"type":56,"value":1437}," 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":51,"tag":63,"props":1439,"children":1440},{},[1441,1451,1453,1458,1460,1465],{"type":51,"tag":84,"props":1442,"children":1443},{},[1444,1445,1450],{"type":56,"value":1428},{"type":51,"tag":140,"props":1446,"children":1448},{"className":1447},[],[1449],{"type":56,"value":469},{"type":56,"value":1435},{"type":56,"value":1452}," It lets the platform verify the snapshot is correct, and also samples which portions of the snapshot are accessed during ",{"type":51,"tag":140,"props":1454,"children":1456},{"className":1455},[],[1457],{"type":56,"value":180},{"type":56,"value":1459},". This allows the platform to ",{"type":51,"tag":84,"props":1461,"children":1462},{},[1463],{"type":56,"value":1464},"prefetch",{"type":56,"value":1466}," those portions on future launches, reducing cold-start times.",{"type":51,"tag":224,"props":1468,"children":1470},{"id":1469},"microvmhooks-runtime",[1471,1477],{"type":51,"tag":140,"props":1472,"children":1474},{"className":1473},[],[1475],{"type":56,"value":1476},"microvmHooks",{"type":56,"value":1478}," (runtime)",{"type":51,"tag":1343,"props":1480,"children":1481},{},[1482,1500],{"type":51,"tag":1347,"props":1483,"children":1484},{},[1485],{"type":51,"tag":1351,"props":1486,"children":1487},{},[1488,1492,1496],{"type":51,"tag":1355,"props":1489,"children":1490},{},[1491],{"type":56,"value":1359},{"type":51,"tag":1355,"props":1493,"children":1494},{},[1495],{"type":56,"value":1364},{"type":51,"tag":1355,"props":1497,"children":1498},{},[1499],{"type":56,"value":1369},{"type":51,"tag":1371,"props":1501,"children":1502},{},[1503,1525,1546,1567],{"type":51,"tag":1351,"props":1504,"children":1505},{},[1506,1515,1520],{"type":51,"tag":1378,"props":1507,"children":1508},{},[1509],{"type":51,"tag":140,"props":1510,"children":1512},{"className":1511},[],[1513],{"type":56,"value":1514},"run",{"type":51,"tag":1378,"props":1516,"children":1517},{},[1518],{"type":56,"value":1519},"Fires once after run from snapshot",{"type":51,"tag":1378,"props":1521,"children":1522},{},[1523],{"type":56,"value":1524},"1–60s (default 1s)",{"type":51,"tag":1351,"props":1526,"children":1527},{},[1528,1537,1542],{"type":51,"tag":1378,"props":1529,"children":1530},{},[1531],{"type":51,"tag":140,"props":1532,"children":1534},{"className":1533},[],[1535],{"type":56,"value":1536},"resume",{"type":51,"tag":1378,"props":1538,"children":1539},{},[1540],{"type":56,"value":1541},"Fires after SUSPENDED → RUNNING",{"type":51,"tag":1378,"props":1543,"children":1544},{},[1545],{"type":56,"value":1524},{"type":51,"tag":1351,"props":1547,"children":1548},{},[1549,1558,1563],{"type":51,"tag":1378,"props":1550,"children":1551},{},[1552],{"type":51,"tag":140,"props":1553,"children":1555},{"className":1554},[],[1556],{"type":56,"value":1557},"suspend",{"type":51,"tag":1378,"props":1559,"children":1560},{},[1561],{"type":56,"value":1562},"Fires before RUNNING → SUSPENDED",{"type":51,"tag":1378,"props":1564,"children":1565},{},[1566],{"type":56,"value":1524},{"type":51,"tag":1351,"props":1568,"children":1569},{},[1570,1579,1584],{"type":51,"tag":1378,"props":1571,"children":1572},{},[1573],{"type":51,"tag":140,"props":1574,"children":1576},{"className":1575},[],[1577],{"type":56,"value":1578},"terminate",{"type":51,"tag":1378,"props":1580,"children":1581},{},[1582],{"type":56,"value":1583},"Fires before termination",{"type":51,"tag":1378,"props":1585,"children":1586},{},[1587],{"type":56,"value":1524},{"type":51,"tag":63,"props":1589,"children":1590},{},[1591,1592,1600],{"type":56,"value":1264},{"type":51,"tag":1266,"props":1593,"children":1594},{"href":1268},[1595],{"type":51,"tag":140,"props":1596,"children":1598},{"className":1597},[],[1599],{"type":56,"value":1268},{"type":56,"value":1601}," for a full example enabling all hooks.",{"type":51,"tag":217,"props":1603,"children":1605},{"id":1604},"per-microvm-size-limits",[1606],{"type":56,"value":1607},"Per-MicroVM size limits",{"type":51,"tag":1343,"props":1609,"children":1610},{},[1611,1627],{"type":51,"tag":1347,"props":1612,"children":1613},{},[1614],{"type":51,"tag":1351,"props":1615,"children":1616},{},[1617,1622],{"type":51,"tag":1355,"props":1618,"children":1619},{},[1620],{"type":56,"value":1621},"Resource",{"type":51,"tag":1355,"props":1623,"children":1624},{},[1625],{"type":56,"value":1626},"Limit",{"type":51,"tag":1371,"props":1628,"children":1629},{},[1630,1643],{"type":51,"tag":1351,"props":1631,"children":1632},{},[1633,1638],{"type":51,"tag":1378,"props":1634,"children":1635},{},[1636],{"type":56,"value":1637},"Maximum vCPUs per MicroVM",{"type":51,"tag":1378,"props":1639,"children":1640},{},[1641],{"type":56,"value":1642},"16",{"type":51,"tag":1351,"props":1644,"children":1645},{},[1646,1651],{"type":51,"tag":1378,"props":1647,"children":1648},{},[1649],{"type":56,"value":1650},"Maximum memory per MicroVM",{"type":51,"tag":1378,"props":1652,"children":1653},{},[1654],{"type":56,"value":1655},"32 GB",{"type":51,"tag":59,"props":1657,"children":1658},{},[1659],{"type":51,"tag":63,"props":1660,"children":1661},{},[1662,1664,1669],{"type":56,"value":1663},"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":51,"tag":84,"props":1665,"children":1666},{},[1667],{"type":56,"value":1668},"check the AWS docs \u002F Service Quotas console.",{"type":56,"value":1670}," Most are soft quotas, raisable through Service Quotas \u002F Support.",{"type":51,"tag":217,"props":1672,"children":1674},{"id":1673},"additional-capabilities",[1675],{"type":56,"value":1676},"Additional capabilities",{"type":51,"tag":63,"props":1678,"children":1679},{},[1680,1682,1688],{"type":56,"value":1681},"By default, the container runs with a restricted set of Linux capabilities. Set ",{"type":51,"tag":140,"props":1683,"children":1685},{"className":1684},[],[1686],{"type":56,"value":1687},"--additional-os-capabilities '[\"ALL\"]'",{"type":56,"value":1689}," at image creation time only when required by your use case:",{"type":51,"tag":74,"props":1691,"children":1692},{},[1693,1703,1713],{"type":51,"tag":78,"props":1694,"children":1695},{},[1696,1701],{"type":51,"tag":84,"props":1697,"children":1698},{},[1699],{"type":56,"value":1700},"Filesystem mounts",{"type":56,"value":1702}," — EFS, FUSE-based filesystems.",{"type":51,"tag":78,"props":1704,"children":1705},{},[1706,1711],{"type":51,"tag":84,"props":1707,"children":1708},{},[1709],{"type":56,"value":1710},"Nested containers",{"type":56,"value":1712}," — running additional containers with containerd inside the MicroVM.",{"type":51,"tag":78,"props":1714,"children":1715},{},[1716,1721],{"type":51,"tag":84,"props":1717,"children":1718},{},[1719],{"type":56,"value":1720},"eBPF programs",{"type":56,"value":1722}," — tracing, profiling, or custom network policies.",{"type":51,"tag":614,"props":1724,"children":1726},{"className":616,"code":1725,"language":618,"meta":619,"style":619},"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",[1727],{"type":51,"tag":140,"props":1728,"children":1729},{"__ignoreMap":619},[1730,1749,1764,1799,1834,1857],{"type":51,"tag":625,"props":1731,"children":1732},{"class":627,"line":628},[1733,1737,1741,1745],{"type":51,"tag":625,"props":1734,"children":1735},{"style":642},[1736],{"type":56,"value":25},{"type":51,"tag":625,"props":1738,"children":1739},{"style":647},[1740],{"type":56,"value":650},{"type":51,"tag":625,"props":1742,"children":1743},{"style":647},[1744],{"type":56,"value":655},{"type":51,"tag":625,"props":1746,"children":1747},{"style":658},[1748],{"type":56,"value":661},{"type":51,"tag":625,"props":1750,"children":1751},{"class":627,"line":638},[1752,1756,1760],{"type":51,"tag":625,"props":1753,"children":1754},{"style":647},[1755],{"type":56,"value":670},{"type":51,"tag":625,"props":1757,"children":1758},{"style":647},[1759],{"type":56,"value":675},{"type":51,"tag":625,"props":1761,"children":1762},{"style":658},[1763],{"type":56,"value":661},{"type":51,"tag":625,"props":1765,"children":1766},{"class":627,"line":664},[1767,1771,1775,1779,1783,1787,1791,1795],{"type":51,"tag":625,"props":1768,"children":1769},{"style":647},[1770],{"type":56,"value":688},{"type":51,"tag":625,"props":1772,"children":1773},{"style":647},[1774],{"type":56,"value":693},{"type":51,"tag":625,"props":1776,"children":1777},{"style":696},[1778],{"type":56,"value":699},{"type":51,"tag":625,"props":1780,"children":1781},{"style":647},[1782],{"type":56,"value":704},{"type":51,"tag":625,"props":1784,"children":1785},{"style":658},[1786],{"type":56,"value":709},{"type":51,"tag":625,"props":1788,"children":1789},{"style":696},[1790],{"type":56,"value":714},{"type":51,"tag":625,"props":1792,"children":1793},{"style":647},[1794],{"type":56,"value":719},{"type":51,"tag":625,"props":1796,"children":1797},{"style":658},[1798],{"type":56,"value":661},{"type":51,"tag":625,"props":1800,"children":1801},{"class":627,"line":682},[1802,1806,1810,1814,1818,1822,1826,1830],{"type":51,"tag":625,"props":1803,"children":1804},{"style":647},[1805],{"type":56,"value":732},{"type":51,"tag":625,"props":1807,"children":1808},{"style":647},[1809],{"type":56,"value":737},{"type":51,"tag":625,"props":1811,"children":1812},{"style":696},[1813],{"type":56,"value":699},{"type":51,"tag":625,"props":1815,"children":1816},{"style":647},[1817],{"type":56,"value":746},{"type":51,"tag":625,"props":1819,"children":1820},{"style":658},[1821],{"type":56,"value":751},{"type":51,"tag":625,"props":1823,"children":1824},{"style":696},[1825],{"type":56,"value":714},{"type":51,"tag":625,"props":1827,"children":1828},{"style":647},[1829],{"type":56,"value":760},{"type":51,"tag":625,"props":1831,"children":1832},{"style":658},[1833],{"type":56,"value":661},{"type":51,"tag":625,"props":1835,"children":1836},{"class":627,"line":726},[1837,1841,1845,1849,1853],{"type":51,"tag":625,"props":1838,"children":1839},{"style":647},[1840],{"type":56,"value":773},{"type":51,"tag":625,"props":1842,"children":1843},{"style":696},[1844],{"type":56,"value":778},{"type":51,"tag":625,"props":1846,"children":1847},{"style":647},[1848],{"type":56,"value":783},{"type":51,"tag":625,"props":1850,"children":1851},{"style":696},[1852],{"type":56,"value":1074},{"type":51,"tag":625,"props":1854,"children":1855},{"style":658},[1856],{"type":56,"value":661},{"type":51,"tag":625,"props":1858,"children":1859},{"class":627,"line":767},[1860,1865,1869,1874],{"type":51,"tag":625,"props":1861,"children":1862},{"style":647},[1863],{"type":56,"value":1864},"  --additional-os-capabilities",{"type":51,"tag":625,"props":1866,"children":1867},{"style":696},[1868],{"type":56,"value":778},{"type":51,"tag":625,"props":1870,"children":1871},{"style":647},[1872],{"type":56,"value":1873},"[\"ALL\"]",{"type":51,"tag":625,"props":1875,"children":1876},{"style":696},[1877],{"type":56,"value":788},{"type":51,"tag":224,"props":1879,"children":1881},{"id":1880},"shell-ingress-for-agent-use-cases",[1882],{"type":56,"value":1883},"Shell ingress for agent use cases",{"type":51,"tag":63,"props":1885,"children":1886},{},[1887,1889,1895],{"type":56,"value":1888},"For programmatic shell access (agent workflows, remote command execution), use the ",{"type":51,"tag":140,"props":1890,"children":1892},{"className":1891},[],[1893],{"type":56,"value":1894},"SHELL_INGRESS",{"type":56,"value":1896}," network connector:",{"type":51,"tag":614,"props":1898,"children":1900},{"className":616,"code":1899,"language":618,"meta":619,"style":619},"# 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",[1901],{"type":51,"tag":140,"props":1902,"children":1903},{"__ignoreMap":619},[1904,1912,1931,1986,2021,2046,2065,2073,2080,2088,2096,2124,2139,2156,2187,2194,2202,2210,2218,2243],{"type":51,"tag":625,"props":1905,"children":1906},{"class":627,"line":628},[1907],{"type":51,"tag":625,"props":1908,"children":1909},{"style":632},[1910],{"type":56,"value":1911},"# 1. Run with SHELL_INGRESS enabled\n",{"type":51,"tag":625,"props":1913,"children":1914},{"class":627,"line":638},[1915,1919,1923,1927],{"type":51,"tag":625,"props":1916,"children":1917},{"style":642},[1918],{"type":56,"value":25},{"type":51,"tag":625,"props":1920,"children":1921},{"style":647},[1922],{"type":56,"value":650},{"type":51,"tag":625,"props":1924,"children":1925},{"style":647},[1926],{"type":56,"value":833},{"type":51,"tag":625,"props":1928,"children":1929},{"style":658},[1930],{"type":56,"value":661},{"type":51,"tag":625,"props":1932,"children":1933},{"class":627,"line":664},[1934,1938,1942,1946,1950,1954,1958,1962,1966,1970,1974,1978,1982],{"type":51,"tag":625,"props":1935,"children":1936},{"style":647},[1937],{"type":56,"value":846},{"type":51,"tag":625,"props":1939,"children":1940},{"style":647},[1941],{"type":56,"value":693},{"type":51,"tag":625,"props":1943,"children":1944},{"style":696},[1945],{"type":56,"value":699},{"type":51,"tag":625,"props":1947,"children":1948},{"style":647},[1949],{"type":56,"value":704},{"type":51,"tag":625,"props":1951,"children":1952},{"style":658},[1953],{"type":56,"value":709},{"type":51,"tag":625,"props":1955,"children":1956},{"style":696},[1957],{"type":56,"value":714},{"type":51,"tag":625,"props":1959,"children":1960},{"style":647},[1961],{"type":56,"value":871},{"type":51,"tag":625,"props":1963,"children":1964},{"style":696},[1965],{"type":56,"value":699},{"type":51,"tag":625,"props":1967,"children":1968},{"style":647},[1969],{"type":56,"value":746},{"type":51,"tag":625,"props":1971,"children":1972},{"style":658},[1973],{"type":56,"value":751},{"type":51,"tag":625,"props":1975,"children":1976},{"style":696},[1977],{"type":56,"value":714},{"type":51,"tag":625,"props":1979,"children":1980},{"style":647},[1981],{"type":56,"value":892},{"type":51,"tag":625,"props":1983,"children":1984},{"style":658},[1985],{"type":56,"value":661},{"type":51,"tag":625,"props":1987,"children":1988},{"class":627,"line":682},[1989,1993,1997,2001,2005,2009,2013,2017],{"type":51,"tag":625,"props":1990,"children":1991},{"style":647},[1992],{"type":56,"value":924},{"type":51,"tag":625,"props":1994,"children":1995},{"style":647},[1996],{"type":56,"value":737},{"type":51,"tag":625,"props":1998,"children":1999},{"style":696},[2000],{"type":56,"value":699},{"type":51,"tag":625,"props":2002,"children":2003},{"style":647},[2004],{"type":56,"value":746},{"type":51,"tag":625,"props":2006,"children":2007},{"style":658},[2008],{"type":56,"value":751},{"type":51,"tag":625,"props":2010,"children":2011},{"style":696},[2012],{"type":56,"value":714},{"type":51,"tag":625,"props":2014,"children":2015},{"style":647},[2016],{"type":56,"value":949},{"type":51,"tag":625,"props":2018,"children":2019},{"style":658},[2020],{"type":56,"value":661},{"type":51,"tag":625,"props":2022,"children":2023},{"class":627,"line":726},[2024,2029,2033,2038,2042],{"type":51,"tag":625,"props":2025,"children":2026},{"style":647},[2027],{"type":56,"value":2028},"  --ingress-network-connectors",{"type":51,"tag":625,"props":2030,"children":2031},{"style":696},[2032],{"type":56,"value":778},{"type":51,"tag":625,"props":2034,"children":2035},{"style":647},[2036],{"type":56,"value":2037},"[\"arn:aws:lambda:\u003Cregion>:aws:network-connector:aws-network-connector:SHELL_INGRESS\"]",{"type":51,"tag":625,"props":2039,"children":2040},{"style":696},[2041],{"type":56,"value":1074},{"type":51,"tag":625,"props":2043,"children":2044},{"style":658},[2045],{"type":56,"value":661},{"type":51,"tag":625,"props":2047,"children":2048},{"class":627,"line":767},[2049,2053,2057,2061],{"type":51,"tag":625,"props":2050,"children":2051},{"style":647},[2052],{"type":56,"value":962},{"type":51,"tag":625,"props":2054,"children":2055},{"style":696},[2056],{"type":56,"value":778},{"type":51,"tag":625,"props":2058,"children":2059},{"style":647},[2060],{"type":56,"value":971},{"type":51,"tag":625,"props":2062,"children":2063},{"style":696},[2064],{"type":56,"value":788},{"type":51,"tag":625,"props":2066,"children":2067},{"class":627,"line":791},[2068],{"type":51,"tag":625,"props":2069,"children":2070},{"style":632},[2071],{"type":56,"value":2072},"# Response includes microvmId and endpoint\n",{"type":51,"tag":625,"props":2074,"children":2075},{"class":627,"line":801},[2076],{"type":51,"tag":625,"props":2077,"children":2078},{"emptyLinePlaceholder":795},[2079],{"type":56,"value":798},{"type":51,"tag":625,"props":2081,"children":2082},{"class":627,"line":810},[2083],{"type":51,"tag":625,"props":2084,"children":2085},{"style":632},[2086],{"type":56,"value":2087},"# 2. Mint a shell auth token (max 60 min; use shortest duration needed)\n",{"type":51,"tag":625,"props":2089,"children":2090},{"class":627,"line":819},[2091],{"type":51,"tag":625,"props":2092,"children":2093},{"style":632},[2094],{"type":56,"value":2095},"# Treat the token as a secret — avoid logging, storing in files, or shell history.\n",{"type":51,"tag":625,"props":2097,"children":2098},{"class":627,"line":840},[2099,2103,2107,2111,2115,2120],{"type":51,"tag":625,"props":2100,"children":2101},{"style":658},[2102],{"type":56,"value":1001},{"type":51,"tag":625,"props":2104,"children":2105},{"style":696},[2106],{"type":56,"value":1006},{"type":51,"tag":625,"props":2108,"children":2109},{"style":642},[2110],{"type":56,"value":25},{"type":51,"tag":625,"props":2112,"children":2113},{"style":647},[2114],{"type":56,"value":650},{"type":51,"tag":625,"props":2116,"children":2117},{"style":647},[2118],{"type":56,"value":2119}," create-microvm-shell-auth-token",{"type":51,"tag":625,"props":2121,"children":2122},{"style":658},[2123],{"type":56,"value":661},{"type":51,"tag":625,"props":2125,"children":2126},{"class":627,"line":899},[2127,2131,2135],{"type":51,"tag":625,"props":2128,"children":2129},{"style":647},[2130],{"type":56,"value":1032},{"type":51,"tag":625,"props":2132,"children":2133},{"style":647},[2134],{"type":56,"value":1037},{"type":51,"tag":625,"props":2136,"children":2137},{"style":658},[2138],{"type":56,"value":661},{"type":51,"tag":625,"props":2140,"children":2141},{"class":627,"line":918},[2142,2147,2152],{"type":51,"tag":625,"props":2143,"children":2144},{"style":647},[2145],{"type":56,"value":2146},"  --expiration-in-minutes",{"type":51,"tag":625,"props":2148,"children":2149},{"style":908},[2150],{"type":56,"value":2151}," 15",{"type":51,"tag":625,"props":2153,"children":2154},{"style":658},[2155],{"type":56,"value":661},{"type":51,"tag":625,"props":2157,"children":2158},{"class":627,"line":956},[2159,2163,2167,2171,2175,2179,2183],{"type":51,"tag":625,"props":2160,"children":2161},{"style":647},[2162],{"type":56,"value":1087},{"type":51,"tag":625,"props":2164,"children":2165},{"style":696},[2166],{"type":56,"value":778},{"type":51,"tag":625,"props":2168,"children":2169},{"style":647},[2170],{"type":56,"value":1096},{"type":51,"tag":625,"props":2172,"children":2173},{"style":696},[2174],{"type":56,"value":1074},{"type":51,"tag":625,"props":2176,"children":2177},{"style":647},[2178],{"type":56,"value":1105},{"type":51,"tag":625,"props":2180,"children":2181},{"style":647},[2182],{"type":56,"value":1110},{"type":51,"tag":625,"props":2184,"children":2185},{"style":696},[2186],{"type":56,"value":1115},{"type":51,"tag":625,"props":2188,"children":2189},{"class":627,"line":978},[2190],{"type":51,"tag":625,"props":2191,"children":2192},{"emptyLinePlaceholder":795},[2193],{"type":56,"value":798},{"type":51,"tag":625,"props":2195,"children":2196},{"class":627,"line":986},[2197],{"type":51,"tag":625,"props":2198,"children":2199},{"style":632},[2200],{"type":56,"value":2201},"# 3. Connect via WebSocket (port 8022)\n",{"type":51,"tag":625,"props":2203,"children":2204},{"class":627,"line":995},[2205],{"type":51,"tag":625,"props":2206,"children":2207},{"style":632},[2208],{"type":56,"value":2209},"# CLI args are visible in process listings (ps aux). For shared hosts,\n",{"type":51,"tag":625,"props":2211,"children":2212},{"class":627,"line":1026},[2213],{"type":51,"tag":625,"props":2214,"children":2215},{"style":632},[2216],{"type":56,"value":2217},"# pipe the header via a file descriptor or use a wrapper script.\n",{"type":51,"tag":625,"props":2219,"children":2220},{"class":627,"line":1054},[2221,2226,2230,2235,2239],{"type":51,"tag":625,"props":2222,"children":2223},{"style":642},[2224],{"type":56,"value":2225},"websocat",{"type":51,"tag":625,"props":2227,"children":2228},{"style":696},[2229],{"type":56,"value":1129},{"type":51,"tag":625,"props":2231,"children":2232},{"style":647},[2233],{"type":56,"value":2234},"wss:\u002F\u002F\u003Cendpoint>\u002Fshell",{"type":51,"tag":625,"props":2236,"children":2237},{"style":696},[2238],{"type":56,"value":1139},{"type":51,"tag":625,"props":2240,"children":2241},{"style":658},[2242],{"type":56,"value":661},{"type":51,"tag":625,"props":2244,"children":2245},{"class":627,"line":1081},[2246,2251,2255,2260,2265,2269,2274,2279],{"type":51,"tag":625,"props":2247,"children":2248},{"style":647},[2249],{"type":56,"value":2250},"  -H",{"type":51,"tag":625,"props":2252,"children":2253},{"style":696},[2254],{"type":56,"value":1129},{"type":51,"tag":625,"props":2256,"children":2257},{"style":647},[2258],{"type":56,"value":2259},"Sec-WebSocket-Protocol: lambda-microvms.authentication.",{"type":51,"tag":625,"props":2261,"children":2262},{"style":696},[2263],{"type":56,"value":2264},"${",{"type":51,"tag":625,"props":2266,"children":2267},{"style":658},[2268],{"type":56,"value":1001},{"type":51,"tag":625,"props":2270,"children":2271},{"style":696},[2272],{"type":56,"value":2273},"}",{"type":51,"tag":625,"props":2275,"children":2276},{"style":647},[2277],{"type":56,"value":2278},", lambda-microvms, lambda-microvms.port.8022",{"type":51,"tag":625,"props":2280,"children":2281},{"style":696},[2282],{"type":56,"value":1163},{"type":51,"tag":63,"props":2284,"children":2285},{},[2286],{"type":56,"value":2287},"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":51,"tag":63,"props":2289,"children":2290},{},[2291,2293,2299],{"type":56,"value":2292},"Prerequisites: MicroVM must be run with SHELL_INGRESS attached, and caller also needs ",{"type":51,"tag":140,"props":2294,"children":2296},{"className":2295},[],[2297],{"type":56,"value":2298},"lambda:CreateMicrovmShellAuthToken",{"type":56,"value":471},{"type":51,"tag":217,"props":2301,"children":2303},{"id":2302},"known-constraints",[2304],{"type":56,"value":2305},"Known constraints",{"type":51,"tag":74,"props":2307,"children":2308},{},[2309,2319,2337,2347,2365,2375],{"type":51,"tag":78,"props":2310,"children":2311},{},[2312,2317],{"type":51,"tag":84,"props":2313,"children":2314},{},[2315],{"type":56,"value":2316},"Image is single-size",{"type":56,"value":2318}," — you can't ship multiple instance sizes from one image. Plan one image per size.",{"type":51,"tag":78,"props":2320,"children":2321},{},[2322,2327,2329,2335],{"type":51,"tag":84,"props":2323,"children":2324},{},[2325],{"type":56,"value":2326},"Image versions incur storage cost",{"type":56,"value":2328}," even when no MicroVMs are running on them. Use ",{"type":51,"tag":140,"props":2330,"children":2332},{"className":2331},[],[2333],{"type":56,"value":2334},"delete-microvm-image-version",{"type":56,"value":2336}," to clean up.",{"type":51,"tag":78,"props":2338,"children":2339},{},[2340,2345],{"type":51,"tag":84,"props":2341,"children":2342},{},[2343],{"type":56,"value":2344},"Suspend → resume can't switch network connectors.",{"type":56,"value":2346}," LNC is bound at run time.",{"type":51,"tag":78,"props":2348,"children":2349},{},[2350,2355,2357,2363],{"type":51,"tag":84,"props":2351,"children":2352},{},[2353],{"type":56,"value":2354},"No self-suspend from inside the MicroVM.",{"type":56,"value":2356}," Call ",{"type":51,"tag":140,"props":2358,"children":2360},{"className":2359},[],[2361],{"type":56,"value":2362},"SuspendMicrovm",{"type":56,"value":2364}," from outside (via the public API).",{"type":51,"tag":78,"props":2366,"children":2367},{},[2368,2373],{"type":51,"tag":84,"props":2369,"children":2370},{},[2371],{"type":56,"value":2372},"Auth token max TTL is 60 min.",{"type":56,"value":2374}," Refresh ahead of expiry for long-running clients.",{"type":51,"tag":78,"props":2376,"children":2377},{},[2378,2408],{"type":51,"tag":84,"props":2379,"children":2380},{},[2381,2383,2388,2389,2394,2395,2400,2401,2406],{"type":56,"value":2382},"Runtime hooks (",{"type":51,"tag":140,"props":2384,"children":2386},{"className":2385},[],[2387],{"type":56,"value":433},{"type":56,"value":435},{"type":51,"tag":140,"props":2390,"children":2392},{"className":2391},[],[2393],{"type":56,"value":441},{"type":56,"value":435},{"type":51,"tag":140,"props":2396,"children":2398},{"className":2397},[],[2399],{"type":56,"value":448},{"type":56,"value":435},{"type":51,"tag":140,"props":2402,"children":2404},{"className":2403},[],[2405],{"type":56,"value":455},{"type":56,"value":2407},") are fast-notification only",{"type":56,"value":2409}," (1–60s timeout). Don't use them for slow init.",{"type":51,"tag":217,"props":2411,"children":2413},{"id":2412},"reference-index",[2414],{"type":56,"value":2415},"Reference index",{"type":51,"tag":63,"props":2417,"children":2418},{},[2419],{"type":56,"value":2420},"Pick the reference that matches your task:",{"type":51,"tag":74,"props":2422,"children":2423},{},[2424,2437,2451,2465,2487,2508],{"type":51,"tag":78,"props":2425,"children":2426},{},[2427,2435],{"type":51,"tag":1266,"props":2428,"children":2429},{"href":1268},[2430],{"type":51,"tag":140,"props":2431,"children":2433},{"className":2432},[],[2434],{"type":56,"value":1268},{"type":56,"value":2436}," — prerequisites (S3 bucket, build role trust policy), packaging, end-to-end CLI walkthrough, first run + token + curl.",{"type":51,"tag":78,"props":2438,"children":2439},{},[2440,2449],{"type":51,"tag":1266,"props":2441,"children":2443},{"href":2442},"references\u002Flifecycle-model.md",[2444],{"type":51,"tag":140,"props":2445,"children":2447},{"className":2446},[],[2448],{"type":56,"value":2442},{"type":56,"value":2450}," — image vs. MicroVM state machines, the six lifecycle hooks (paths, timeouts, what to do in each), idle\u002Fsuspend\u002Fresume semantics, hook payloads.",{"type":51,"tag":78,"props":2452,"children":2453},{},[2454,2463],{"type":51,"tag":1266,"props":2455,"children":2457},{"href":2456},"references\u002Fsnapshots-and-uniqueness.md",[2458],{"type":51,"tag":140,"props":2459,"children":2461},{"className":2460},[],[2462],{"type":56,"value":2456},{"type":56,"value":2464}," — what gets snapshotted, the uniqueness pitfall, CSPRNGs by language, env vars vs. run configuration, snapshot size inspection.",{"type":51,"tag":78,"props":2466,"children":2467},{},[2468,2477,2479,2485],{"type":51,"tag":1266,"props":2469,"children":2471},{"href":2470},"references\u002Fnetworking.md",[2472],{"type":51,"tag":140,"props":2473,"children":2475},{"className":2474},[],[2476],{"type":56,"value":2470},{"type":56,"value":2478}," — ingress vs. egress connectors, port routing, ",{"type":51,"tag":140,"props":2480,"children":2482},{"className":2481},[],[2483],{"type":56,"value":2484},"X-aws-proxy-*",{"type":56,"value":2486}," headers, WebSocket subprotocols, HTTP\u002F2 \u002F gRPC, VPC egress.",{"type":51,"tag":78,"props":2488,"children":2489},{},[2490,2499,2501,2507],{"type":51,"tag":1266,"props":2491,"children":2493},{"href":2492},"references\u002Fiam-and-security.md",[2494],{"type":51,"tag":140,"props":2495,"children":2497},{"className":2496},[],[2498],{"type":56,"value":2492},{"type":56,"value":2500}," — build role vs. execution role, trust policies, auth tokens (regular vs. shell), ",{"type":51,"tag":140,"props":2502,"children":2504},{"className":2503},[],[2505],{"type":56,"value":2506},"lambda:PassNetworkConnector",{"type":56,"value":471},{"type":51,"tag":78,"props":2509,"children":2510},{},[2511,2520],{"type":51,"tag":1266,"props":2512,"children":2514},{"href":2513},"references\u002Ftroubleshooting.md",[2515],{"type":51,"tag":140,"props":2516,"children":2518},{"className":2517},[],[2519],{"type":56,"value":2513},{"type":56,"value":2521}," — image build error codes, run\u002Fconnect failures, hook timeouts, network connector issues, debugging via shell access.",{"type":51,"tag":217,"props":2523,"children":2525},{"id":2524},"conventions-used-in-references",[2526],{"type":56,"value":2527},"Conventions used in references",{"type":51,"tag":74,"props":2529,"children":2530},{},[2531],{"type":51,"tag":78,"props":2532,"children":2533},{},[2534,2536,2542,2544,2550,2552,2558],{"type":56,"value":2535},"The runtime-side default proxy port is ",{"type":51,"tag":140,"props":2537,"children":2539},{"className":2538},[],[2540],{"type":56,"value":2541},"8080",{"type":56,"value":2543},". Override per-request with ",{"type":51,"tag":140,"props":2545,"children":2547},{"className":2546},[],[2548],{"type":56,"value":2549},"X-aws-proxy-port",{"type":56,"value":2551}," or per-WebSocket with subprotocol ",{"type":51,"tag":140,"props":2553,"children":2555},{"className":2554},[],[2556],{"type":56,"value":2557},"lambda-microvms.port.\u003Cn>",{"type":56,"value":471},{"type":51,"tag":217,"props":2560,"children":2562},{"id":2561},"security-considerations",[2563],{"type":56,"value":2564},"Security considerations",{"type":51,"tag":74,"props":2566,"children":2567},{},[2568,2600,2616,2626,2636],{"type":51,"tag":78,"props":2569,"children":2570},{},[2571,2576,2578,2584,2586,2592,2594,2599],{"type":51,"tag":84,"props":2572,"children":2573},{},[2574],{"type":56,"value":2575},"Confused deputy prevention",{"type":56,"value":2577}," — add ",{"type":51,"tag":140,"props":2579,"children":2581},{"className":2580},[],[2582],{"type":56,"value":2583},"aws:SourceAccount",{"type":56,"value":2585}," (or ",{"type":51,"tag":140,"props":2587,"children":2589},{"className":2588},[],[2590],{"type":56,"value":2591},"aws:SourceArn",{"type":56,"value":2593},") condition keys to trust policies. See ",{"type":51,"tag":140,"props":2595,"children":2597},{"className":2596},[],[2598],{"type":56,"value":2492},{"type":56,"value":471},{"type":51,"tag":78,"props":2601,"children":2602},{},[2603,2608,2610,2615],{"type":51,"tag":84,"props":2604,"children":2605},{},[2606],{"type":56,"value":2607},"Snapshot uniqueness",{"type":56,"value":2609}," — snapshots share memory state. Reseed CSPRNGs and rotate secrets on resume. See ",{"type":51,"tag":140,"props":2611,"children":2613},{"className":2612},[],[2614],{"type":56,"value":2456},{"type":56,"value":471},{"type":51,"tag":78,"props":2617,"children":2618},{},[2619,2624],{"type":51,"tag":84,"props":2620,"children":2621},{},[2622],{"type":56,"value":2623},"Network isolation",{"type":56,"value":2625}," — use VPC egress connectors to restrict outbound traffic.",{"type":51,"tag":78,"props":2627,"children":2628},{},[2629,2634],{"type":51,"tag":84,"props":2630,"children":2631},{},[2632],{"type":56,"value":2633},"Least-privilege execution roles",{"type":56,"value":2635}," — scope IAM policies to specific regions, accounts, and resource prefixes.",{"type":51,"tag":78,"props":2637,"children":2638},{},[2639,2644],{"type":51,"tag":84,"props":2640,"children":2641},{},[2642],{"type":56,"value":2643},"Logging",{"type":56,"value":2645}," — enable CloudTrail for MicroVM lifecycle events.",{"type":51,"tag":2647,"props":2648,"children":2649},"style",{},[2650],{"type":56,"value":2651},"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":2653,"total":2754},[2654,2671,2689,2701,2718,2729,2739],{"slug":2655,"name":2655,"fn":2656,"description":2657,"org":2658,"tags":2659,"stars":26,"repoUrl":27,"updatedAt":2670},"amazon-location-service","integrate Amazon Location Service maps","Integrates Amazon Location Service APIs for AWS applications. Use this skill when users want to add maps (interactive MapLibre or static images); geocode addresses to coordinates or reverse geocode coordinates to addresses; calculate routes, travel times, or service areas; find places and businesses through text search, nearby search, or autocomplete suggestions; retrieve detailed place information including hours, contacts, and addresses; monitor geographical boundaries with geofences; or track device locations. Covers authentication, SDK integration, and all Amazon Location Service capabilities.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[2660,2663,2664,2667],{"name":2661,"slug":2662,"type":16},"API Development","api-development",{"name":24,"slug":25,"type":16},{"name":2665,"slug":2666,"type":16},"Maps","maps",{"name":2668,"slug":2669,"type":16},"Navigation","navigation","2026-07-12T08:39:49.88311",{"slug":2672,"name":2672,"fn":2673,"description":2674,"org":2675,"tags":2676,"stars":26,"repoUrl":27,"updatedAt":2688},"amplify-workflow","build and deploy apps with AWS Amplify","Build and deploy full-stack web and mobile apps with AWS Amplify Gen2 (TypeScript code-first). Covers auth (Cognito), data (AppSync\u002FDynamoDB including schema modeling, enum types, relationships, authorization rules), storage (S3), functions, APIs, and AI (Amplify AI Kit with Bedrock). Supports React, Next.js, Vue, Angular, React Native, Flutter, Swift, and Android. Always use this skill for Amplify Gen2 topics — even for questions you think you know — it contains validated, version-specific patterns that prevent common mistakes. TRIGGER when: user mentions Amplify Gen2; project has amplify\u002F directory or amplify_outputs; code imports @aws-amplify packages; user asks about defineBackend, defineAuth, defineData, defineStorage, or npx ampx. SKIP: Amplify Gen1 (amplify CLI v6), standalone SAM\u002FCDK without Amplify (use aws-serverless), direct Bedrock without Amplify AI Kit (use bedrock).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[2677,2680,2681,2684,2685],{"name":2678,"slug":2679,"type":16},"Auth","auth",{"name":24,"slug":25,"type":16},{"name":2682,"slug":2683,"type":16},"Database","database",{"name":18,"slug":19,"type":16},{"name":2686,"slug":2687,"type":16},"TypeScript","typescript","2026-07-12T08:39:43.500162",{"slug":2690,"name":2690,"fn":2691,"description":2692,"org":2693,"tags":2694,"stars":26,"repoUrl":27,"updatedAt":2700},"api-gateway","build and manage Amazon API Gateway APIs","Build, manage, and operate APIs with Amazon API Gateway (REST, HTTP, and WebSocket). Triggers on phrases like: API Gateway, REST API, HTTP API, WebSocket API, custom domain, Lambda authorizer, usage plan, throttling, CORS, VPC link, private API. Also covers troubleshooting API Gateway errors (4xx, 5xx, timeout, CORS failures) and IaC templates containing API Gateway resources. For general REST API design unrelated to AWS, do not trigger.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[2695,2696,2697],{"name":2661,"slug":2662,"type":16},{"name":24,"slug":25,"type":16},{"name":2698,"slug":2699,"type":16},"REST API","rest-api","2026-07-12T08:39:00.149339",{"slug":2702,"name":2702,"fn":2703,"description":2704,"org":2705,"tags":2706,"stars":26,"repoUrl":27,"updatedAt":2717},"aws-architecture-diagram","generate AWS architecture diagrams","Generate validated AWS architecture diagrams as draw.io XML using official AWS4 icon libraries. Use this skill whenever the user wants to create, generate, or design AWS architecture diagrams, cloud infrastructure diagrams, or system design visuals. Also triggers for requests to visualize existing infrastructure from CloudFormation, CDK, or Terraform code. Supports two modes: analyze an existing codebase to auto-generate diagrams, or brainstorm interactively from scratch. Exports .drawio files with optional PNG\u002FSVG\u002FPDF export via draw.io desktop CLI.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[2707,2710,2711,2714],{"name":2708,"slug":2709,"type":16},"Architecture","architecture",{"name":24,"slug":25,"type":16},{"name":2712,"slug":2713,"type":16},"Design","design",{"name":2715,"slug":2716,"type":16},"Diagrams","diagrams","2026-07-12T08:37:11.012278",{"slug":2719,"name":2719,"fn":2720,"description":2721,"org":2722,"tags":2723,"stars":26,"repoUrl":27,"updatedAt":2728},"aws-lambda","build and deploy AWS Lambda functions","Design, build, deploy, test, and debug serverless applications with AWS Lambda. Triggers on phrases like: Lambda function, event source, serverless application, API Gateway, EventBridge, Step Functions, serverless API, event-driven architecture, Lambda trigger. For deploying non-serverless apps to AWS, use deploy-on-aws plugin instead.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[2724,2725,2726,2727],{"name":2661,"slug":2662,"type":16},{"name":24,"slug":25,"type":16},{"name":18,"slug":19,"type":16},{"name":21,"slug":22,"type":16},"2026-07-12T08:38:58.598492",{"slug":2730,"name":2730,"fn":2731,"description":2732,"org":2733,"tags":2734,"stars":26,"repoUrl":27,"updatedAt":2738},"aws-lambda-durable-functions","build resilient AWS Lambda durable functions","Build resilient, long-running, multi-step applications with AWS Lambda durable functions with automatic state persistence, retry logic, and orchestration for long-running executions. Covers the critical replay model, step operations, wait\u002Fcallback patterns, error handling with saga pattern, testing with LocalDurableTestRunner. Triggers on phrases like: lambda durable functions, workflow orchestration, state machines, retry\u002Fcheckpoint patterns, long-running stateful Lambda functions, saga pattern, human-in-the-loop callbacks, and reliable serverless applications.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[2735,2736,2737],{"name":2708,"slug":2709,"type":16},{"name":24,"slug":25,"type":16},{"name":21,"slug":22,"type":16},"2026-07-12T08:39:05.546173",{"slug":2740,"name":2740,"fn":2741,"description":2742,"org":2743,"tags":2744,"stars":26,"repoUrl":27,"updatedAt":2753},"aws-lambda-managed-instances","configure AWS Lambda Managed Instances","Evaluate, configure, and migrate workloads to AWS Lambda Managed Instances (LMI). Triggers on: Lambda Managed Instances, LMI, capacity provider, multi-concurrency Lambda, dedicated instance Lambda, EC2-backed Lambda, cold start elimination, Graviton Lambda, instance type for Lambda, scheduled scaling for LMI, Lambda cost optimization with Reserved Instances or Savings Plans. Also trigger when users describe high-volume predictable workloads seeking cost savings, want to scale LMI capacity on a schedule, or compare Lambda vs EC2 for steady-state traffic. For standard Lambda without LMI, use the aws-lambda skill instead.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[2745,2746,2747,2750],{"name":24,"slug":25,"type":16},{"name":18,"slug":19,"type":16},{"name":2748,"slug":2749,"type":16},"Infrastructure","infrastructure",{"name":2751,"slug":2752,"type":16},"Performance","performance","2026-07-12T08:39:07.007071",33,{"items":2756,"total":2930},[2757,2776,2793,2803,2816,2829,2839,2849,2870,2885,2900,2915],{"slug":2758,"name":2758,"fn":2759,"description":2760,"org":2761,"tags":2762,"stars":2773,"repoUrl":2774,"updatedAt":2775},"agentcore-investigation","investigate Bedrock AgentCore runtime sessions","Investigate Bedrock AgentCore runtime sessions via CloudWatch Logs Insights — resolve session\u002Ftrace IDs, query OTEL spans, filter noise, build timelines. Use when debugging AgentCore agent sessions, tracing tool calls, or analyzing latency.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[2763,2764,2767,2770],{"name":24,"slug":25,"type":16},{"name":2765,"slug":2766,"type":16},"Debugging","debugging",{"name":2768,"slug":2769,"type":16},"Logs","logs",{"name":2771,"slug":2772,"type":16},"Observability","observability",9427,"https:\u002F\u002Fgithub.com\u002Fawslabs\u002Fmcp","2026-07-12T08:37:22.601527",{"slug":2777,"name":2778,"fn":2779,"description":2780,"org":2781,"tags":2782,"stars":2773,"repoUrl":2774,"updatedAt":2792},"amazon-aurora-dsql","amazon aurora dsql","build applications with Aurora DSQL","Build with Aurora DSQL — manage schemas, execute queries, handle migrations, diagnose query plans, load data, and develop applications with a serverless, distributed SQL database. Covers IAM auth, multi-tenant patterns, MySQL-to-DSQL and PostgreSQL-to-DSQL schema conversion, FK replacement code generation, OCC retry patterns, ORM migration (Django\u002FHibernate\u002FRails), DDL operations, query plan explainability, SQL compatibility validation, and bulk data loading. Triggers on phrases like: DSQL, Aurora DSQL, create DSQL table, DSQL schema, migrate to DSQL, distributed SQL database, serverless PostgreSQL-compatible database, DSQL query plan, DSQL EXPLAIN ANALYZE, why is my DSQL query slow, DSQL foreign key, DSQL OCC retry, DSQL multi-region, load into DSQL, load CSV into DSQL, bulk load DSQL, aurora-dsql-loader.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[2783,2786,2787,2788,2789],{"name":2784,"slug":2785,"type":16},"Aurora","aurora",{"name":24,"slug":25,"type":16},{"name":2682,"slug":2683,"type":16},{"name":21,"slug":22,"type":16},{"name":2790,"slug":2791,"type":16},"SQL","sql","2026-07-12T08:36:45.053393",{"slug":2794,"name":2795,"fn":2779,"description":2780,"org":2796,"tags":2797,"stars":2773,"repoUrl":2774,"updatedAt":2802},"aurora-dsql","aurora dsql",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[2798,2799,2800,2801],{"name":24,"slug":25,"type":16},{"name":2682,"slug":2683,"type":16},{"name":21,"slug":22,"type":16},{"name":2790,"slug":2791,"type":16},"2026-07-12T08:36:42.694299",{"slug":2804,"name":2805,"fn":2779,"description":2780,"org":2806,"tags":2807,"stars":2773,"repoUrl":2774,"updatedAt":2815},"aws-dsql","aws dsql",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[2808,2809,2810,2813,2814],{"name":24,"slug":25,"type":16},{"name":2682,"slug":2683,"type":16},{"name":2811,"slug":2812,"type":16},"Migration","migration",{"name":21,"slug":22,"type":16},{"name":2790,"slug":2791,"type":16},"2026-07-12T08:36:38.584057",{"slug":2817,"name":2818,"fn":2779,"description":2780,"org":2819,"tags":2820,"stars":2773,"repoUrl":2774,"updatedAt":2828},"distributed-postgres","distributed postgres",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[2821,2822,2823,2826,2827],{"name":24,"slug":25,"type":16},{"name":2682,"slug":2683,"type":16},{"name":2824,"slug":2825,"type":16},"PostgreSQL","postgresql",{"name":21,"slug":22,"type":16},{"name":2790,"slug":2791,"type":16},"2026-07-12T08:36:46.530743",{"slug":2830,"name":2831,"fn":2779,"description":2780,"org":2832,"tags":2833,"stars":2773,"repoUrl":2774,"updatedAt":2838},"distributed-sql","distributed sql",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[2834,2835,2836,2837],{"name":24,"slug":25,"type":16},{"name":2682,"slug":2683,"type":16},{"name":21,"slug":22,"type":16},{"name":2790,"slug":2791,"type":16},"2026-07-12T08:36:48.104182",{"slug":2840,"name":2840,"fn":2779,"description":2780,"org":2841,"tags":2842,"stars":2773,"repoUrl":2774,"updatedAt":2848},"dsql",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[2843,2844,2845,2846,2847],{"name":24,"slug":25,"type":16},{"name":2682,"slug":2683,"type":16},{"name":2811,"slug":2812,"type":16},{"name":21,"slug":22,"type":16},{"name":2790,"slug":2791,"type":16},"2026-07-12T08:36:36.374512",{"slug":2850,"name":2850,"fn":2851,"description":2852,"org":2853,"tags":2854,"stars":2867,"repoUrl":2868,"updatedAt":2869},"cost-efficiency-analyzer","analyze cost efficiency and expenses","Analyzes cost structure, cost efficiency, and expense management from P&L data. Use when the user asks about costs, expenses, COGS, operating expenses, cost ratios, cost control, spending efficiency, margin compression from cost side, or wants to understand where money is going. Also use for \"are we spending too much\", \"cost breakdown\", \"expense analysis\", or \"how efficient are our operations\". NOT for revenue or top-line analysis.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[2855,2858,2861,2864],{"name":2856,"slug":2857,"type":16},"Accounting","accounting",{"name":2859,"slug":2860,"type":16},"Analytics","analytics",{"name":2862,"slug":2863,"type":16},"Cost Optimization","cost-optimization",{"name":2865,"slug":2866,"type":16},"Finance","finance",3176,"https:\u002F\u002Fgithub.com\u002Fawslabs\u002Fagentcore-samples","2026-07-12T08:40:03.29555",{"slug":2871,"name":2871,"fn":2872,"description":2873,"org":2874,"tags":2875,"stars":2867,"repoUrl":2868,"updatedAt":2884},"executive-financial-briefing","generate executive financial briefings","Generates a concise executive-level financial briefing or summary suitable for a CEO, CFO, or board presentation. Use when the user asks for a summary, briefing, executive summary, board update, financial overview, financial health check, or \"how is the business doing\". Covers the full P&L picture in one page. Also use for \"give me the highlights\", \"what do I need to know\", or \"quick financial update\".",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[2876,2877,2878,2881],{"name":24,"slug":25,"type":16},{"name":2865,"slug":2866,"type":16},{"name":2879,"slug":2880,"type":16},"Management","management",{"name":2882,"slug":2883,"type":16},"Reporting","reporting","2026-07-12T08:40:02.066471",{"slug":2886,"name":2886,"fn":2887,"description":2888,"org":2889,"tags":2890,"stars":2867,"repoUrl":2868,"updatedAt":2899},"multi-quarter-trend-analysis","analyze multi-quarter financial trends","Analyzes financial trends across multiple quarters by comparing P&L metrics over time. Use when the user wants to see trends, patterns, trajectories, or directional movement across 3 or more quarters. Also use for \"how are we trending\", \"show me the trend\", \"track performance over time\", \"quarter over quarter comparison across all quarters\", or any multi-period longitudinal analysis.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[2891,2892,2893,2896],{"name":2859,"slug":2860,"type":16},{"name":2865,"slug":2866,"type":16},{"name":2894,"slug":2895,"type":16},"Financial Statements","financial-statements",{"name":2897,"slug":2898,"type":16},"Variance Analysis","variance-analysis","2026-07-12T08:40:00.79141",{"slug":2901,"name":2901,"fn":2902,"description":2903,"org":2904,"tags":2905,"stars":2867,"repoUrl":2868,"updatedAt":2914},"pdf","process and manipulate PDF documents","Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text\u002Ftables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting\u002Fdecrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[2906,2909,2912],{"name":2907,"slug":2908,"type":16},"Automation","automation",{"name":2910,"slug":2911,"type":16},"Documents","documents",{"name":2913,"slug":2901,"type":16},"PDF","2026-07-12T08:41:44.135656",{"slug":2916,"name":2916,"fn":2917,"description":2918,"org":2919,"tags":2920,"stars":2867,"repoUrl":2868,"updatedAt":2929},"quarterly-kpi-calculator","calculate quarterly financial KPIs","Calculates quarterly financial KPIs from P&L data. P&L figures can be provided directly by the user or fetched from the financial data MCP server. Use when the user wants KPI calculations such as Gross Margin %, EBITDA Margin %, Operating Expense Ratio, or Revenue Growth % QoQ. Also use for quarterly performance review, P&L analysis, or interpreting financial ratios against benchmarks.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[2921,2922,2925,2926],{"name":2856,"slug":2857,"type":16},{"name":2923,"slug":2924,"type":16},"Data Analysis","data-analysis",{"name":2865,"slug":2866,"type":16},{"name":2927,"slug":2928,"type":16},"KPI","kpi","2026-07-12T08:39:59.54971",150]