From 5a685fb6b2c4a3d497d1719bf1065e426944ea2f Mon Sep 17 00:00:00 2001
From: Michael Wunderlich <mwunderl@amazon.com>
Date: Tue, 14 Apr 2026 16:35:00 +0000
Subject: [PATCH 1/3] Add compute tutorials (batch 5)

---
 .../184-ec2-ebs-volume-types/ec2-ebs-types.sh | 15 +++++++++++
 .../lambda-dead-letter.sh                     | 25 +++++++++++++++++++
 .../ec2-instance-types.sh                     | 11 ++++++++
 .../lambda-container.sh                       | 13 ++++++++++
 .../193-ec2-regions-and-zones/ec2-metadata.sh | 13 ++++++++++
 5 files changed, 77 insertions(+)
 create mode 100644 tuts/184-ec2-ebs-volume-types/ec2-ebs-types.sh
 create mode 100644 tuts/185-lambda-dead-letter-queue/lambda-dead-letter.sh
 create mode 100644 tuts/187-ec2-instance-types/ec2-instance-types.sh
 create mode 100644 tuts/192-lambda-runtimes-and-quotas/lambda-container.sh
 create mode 100644 tuts/193-ec2-regions-and-zones/ec2-metadata.sh

diff --git a/tuts/184-ec2-ebs-volume-types/ec2-ebs-types.sh b/tuts/184-ec2-ebs-volume-types/ec2-ebs-types.sh
new file mode 100644
index 00000000..f12d748f
--- /dev/null
+++ b/tuts/184-ec2-ebs-volume-types/ec2-ebs-types.sh
@@ -0,0 +1,15 @@
+#!/bin/bash
+WORK_DIR=$(mktemp -d); exec > >(tee -a "$WORK_DIR/tut.log") 2>&1
+REGION=${AWS_DEFAULT_REGION:-$(aws configure get region 2>/dev/null)}; [ -z "$REGION" ] && echo "ERROR: No region" && exit 1; export AWS_DEFAULT_REGION="$REGION"; echo "Region: $REGION"
+echo "Step 1: Listing EBS volume types"
+echo "  gp3: General Purpose SSD (default)"
+echo "  gp2: Previous gen General Purpose SSD"
+echo "  io2: Provisioned IOPS SSD"
+echo "  st1: Throughput Optimized HDD"
+echo "  sc1: Cold HDD"
+echo "Step 2: Listing your volumes by type"
+aws ec2 describe-volumes --query "Volumes[].{Id:VolumeId,Type:VolumeType,Size:Size,State:State,IOPS:Iops}" --output table 2>/dev/null || echo "  No volumes"
+echo "Step 3: Describing volume modifications"
+aws ec2 describe-volumes-modifications --query "VolumesModifications[:5].{Id:VolumeId,Status:ModificationState,OrigType:OriginalVolumeType,TargetType:TargetVolumeType}" --output table 2>/dev/null || echo "  No modifications"
+echo ""; echo "Tutorial complete. No resources created — read-only."
+rm -rf "$WORK_DIR"
diff --git a/tuts/185-lambda-dead-letter-queue/lambda-dead-letter.sh b/tuts/185-lambda-dead-letter-queue/lambda-dead-letter.sh
new file mode 100644
index 00000000..a76b660e
--- /dev/null
+++ b/tuts/185-lambda-dead-letter-queue/lambda-dead-letter.sh
@@ -0,0 +1,25 @@
+#!/bin/bash
+WORK_DIR=$(mktemp -d); exec > >(tee -a "$WORK_DIR/tut.log") 2>&1
+REGION=${AWS_DEFAULT_REGION:-$(aws configure get region 2>/dev/null)}; [ -z "$REGION" ] && echo "ERROR: No region" && exit 1; export AWS_DEFAULT_REGION="$REGION"; echo "Region: $REGION"
+RANDOM_ID=$(openssl rand -hex 4); F="dlq-func-${RANDOM_ID}"; R="dlq-func-role-${RANDOM_ID}"; Q="dlq-func-q-${RANDOM_ID}"
+handle_error() { echo "ERROR on line $1"; trap - ERR; cleanup; exit 1; }; trap 'handle_error $LINENO' ERR
+cleanup() { echo "Cleaning up..."; aws lambda delete-function --function-name "$F" 2>/dev/null; [ -n "$QU" ] && aws sqs delete-queue --queue-url "$QU" 2>/dev/null; aws iam detach-role-policy --role-name "$R" --policy-arn arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole 2>/dev/null; aws iam detach-role-policy --role-name "$R" --policy-arn arn:aws:iam::aws:policy/AmazonSQSFullAccess 2>/dev/null; aws iam delete-role --role-name "$R" 2>/dev/null; rm -rf "$WORK_DIR"; echo "Done."; }
+RA=$(aws iam create-role --role-name "$R" --assume-role-policy-document '{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Principal":{"Service":"lambda.amazonaws.com"},"Action":"sts:AssumeRole"}]}' --query Role.Arn --output text)
+aws iam attach-role-policy --role-name "$R" --policy-arn arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole
+aws iam attach-role-policy --role-name "$R" --policy-arn arn:aws:iam::aws:policy/AmazonSQSFullAccess; sleep 10
+QU=$(aws sqs create-queue --queue-name "$Q" --query QueueUrl --output text)
+QA=$(aws sqs get-queue-attributes --queue-url "$QU" --attribute-names QueueArn --query Attributes.QueueArn --output text)
+echo "Step 1: Creating function that always fails"
+echo "def handler(e,c): raise Exception('Intentional failure')" > "$WORK_DIR/i.py"
+(cd "$WORK_DIR" && zip f.zip i.py > /dev/null)
+aws lambda create-function --function-name "$F" --zip-file "fileb://$WORK_DIR/f.zip" --handler i.handler --runtime python3.12 --role "$RA" --dead-letter-config "{\"TargetArn\":\"$QA\"}" --architectures x86_64 > /dev/null
+aws lambda wait function-active-v2 --function-name "$F"
+echo "  Function with DLQ configured"
+echo "Step 2: Invoking async (will fail and go to DLQ)"
+aws lambda invoke --function-name "$F" --invocation-type Event --cli-binary-format raw-in-base64-out --payload '{}' "$WORK_DIR/out.json" > /dev/null
+echo "  Invoked async — Lambda will retry twice then send to DLQ"
+echo "Step 3: Checking DLQ (after retries, ~3 min)"
+echo "  DLQ messages: $(aws sqs get-queue-attributes --queue-url "$QU" --attribute-names ApproximateNumberOfMessages --query Attributes.ApproximateNumberOfMessages --output text)"
+echo "  (Message will appear after Lambda exhausts retries)"
+echo ""; echo "Tutorial complete."
+echo "Do you want to clean up? (y/n): "; read -r C; [[ "$C" =~ ^[Yy]$ ]] && cleanup
diff --git a/tuts/187-ec2-instance-types/ec2-instance-types.sh b/tuts/187-ec2-instance-types/ec2-instance-types.sh
new file mode 100644
index 00000000..d2200fec
--- /dev/null
+++ b/tuts/187-ec2-instance-types/ec2-instance-types.sh
@@ -0,0 +1,11 @@
+#!/bin/bash
+WORK_DIR=$(mktemp -d); exec > >(tee -a "$WORK_DIR/tut.log") 2>&1
+REGION=${AWS_DEFAULT_REGION:-$(aws configure get region 2>/dev/null)}; [ -z "$REGION" ] && echo "ERROR: No region" && exit 1; export AWS_DEFAULT_REGION="$REGION"; echo "Region: $REGION"
+echo "Step 1: Listing instance type families"
+aws ec2 describe-instance-types --filters "Name=instance-type,Values=t3.*" --query 'InstanceTypes[].{Type:InstanceType,vCPUs:VCpuInfo.DefaultVCpus,Memory:MemoryInfo.SizeInMiB}' --output table
+echo "Step 2: Describing a specific type"
+aws ec2 describe-instance-types --instance-types t3.micro --query 'InstanceTypes[0].{Type:InstanceType,vCPUs:VCpuInfo.DefaultVCpus,Memory:MemoryInfo.SizeInMiB,Network:NetworkInfo.NetworkPerformance,Arch:ProcessorInfo.SupportedArchitectures}' --output table
+echo "Step 3: Finding instances by criteria"
+aws ec2 describe-instance-types --filters "Name=vcpu-info.default-vcpus,Values=2" "Name=memory-info.size-in-mib,Values=4096" --query 'InstanceTypes[:5].{Type:InstanceType,vCPUs:VCpuInfo.DefaultVCpus,Memory:MemoryInfo.SizeInMiB}' --output table
+echo ""; echo "Tutorial complete. No resources created — read-only."
+rm -rf "$WORK_DIR"
diff --git a/tuts/192-lambda-runtimes-and-quotas/lambda-container.sh b/tuts/192-lambda-runtimes-and-quotas/lambda-container.sh
new file mode 100644
index 00000000..f2aa8c58
--- /dev/null
+++ b/tuts/192-lambda-runtimes-and-quotas/lambda-container.sh
@@ -0,0 +1,13 @@
+#!/bin/bash
+WORK_DIR=$(mktemp -d); exec > >(tee -a "$WORK_DIR/tut.log") 2>&1
+REGION=${AWS_DEFAULT_REGION:-$(aws configure get region 2>/dev/null)}; [ -z "$REGION" ] && echo "ERROR: No region" && exit 1; export AWS_DEFAULT_REGION="$REGION"; echo "Region: $REGION"
+echo "Step 1: Listing Lambda runtimes"
+aws lambda list-layers --compatible-runtime python3.12 --query 'Layers[:5].{Name:LayerName,Version:LatestMatchingVersion.Version}' --output table 2>/dev/null || echo "  No compatible layers"
+echo "Step 2: Getting Lambda service quotas"
+aws lambda get-account-settings --query 'AccountLimit.{CodeSize:TotalCodeSize,ConcurrentExec:ConcurrentExecutions,FunctionCount:FunctionCount}' --output table
+echo "Step 3: Listing functions by runtime"
+aws lambda list-functions --query 'Functions[?Runtime==`python3.12`][:5].{Name:FunctionName,Runtime:Runtime,Size:CodeSize}' --output table 2>/dev/null || echo "  No Python 3.12 functions"
+echo "Step 4: Listing event source mappings"
+aws lambda list-event-source-mappings --query 'EventSourceMappings[:5].{Function:FunctionArn,Source:EventSourceArn,State:State}' --output table 2>/dev/null || echo "  No event source mappings"
+echo ""; echo "Tutorial complete. No resources created — read-only."
+rm -rf "$WORK_DIR"
diff --git a/tuts/193-ec2-regions-and-zones/ec2-metadata.sh b/tuts/193-ec2-regions-and-zones/ec2-metadata.sh
new file mode 100644
index 00000000..4af9fbba
--- /dev/null
+++ b/tuts/193-ec2-regions-and-zones/ec2-metadata.sh
@@ -0,0 +1,13 @@
+#!/bin/bash
+WORK_DIR=$(mktemp -d); exec > >(tee -a "$WORK_DIR/tut.log") 2>&1
+REGION=${AWS_DEFAULT_REGION:-$(aws configure get region 2>/dev/null)}; [ -z "$REGION" ] && echo "ERROR: No region" && exit 1; export AWS_DEFAULT_REGION="$REGION"; echo "Region: $REGION"
+echo "Step 1: Describing your running instances"
+aws ec2 describe-instances --filters "Name=instance-state-name,Values=running" --query 'Reservations[].Instances[:3].{Id:InstanceId,Type:InstanceType,State:State.Name,AZ:Placement.AvailabilityZone}' --output table 2>/dev/null || echo "  No running instances"
+echo "Step 2: Describing instance status"
+aws ec2 describe-instance-status --query 'InstanceStatuses[:3].{Id:InstanceId,System:SystemStatus.Status,Instance:InstanceStatus.Status}' --output table 2>/dev/null || echo "  No instance status"
+echo "Step 3: Listing regions"
+aws ec2 describe-regions --query 'Regions[:10].{Name:RegionName,Endpoint:Endpoint}' --output table
+echo "Step 4: Listing availability zones"
+aws ec2 describe-availability-zones --query 'AvailabilityZones[:5].{Zone:ZoneName,State:State,Type:ZoneType}' --output table
+echo ""; echo "Tutorial complete. No resources created — read-only."
+rm -rf "$WORK_DIR"

From d7a1e5601f03cd5e31a1643f5445b2e671008993 Mon Sep 17 00:00:00 2001
From: Michael Wunderlich <mwunderl@amazon.com>
Date: Tue, 21 Apr 2026 05:17:16 +0000
Subject: [PATCH 2/3] Apply technical requirements (R1, R2, R9, R10, R13)

- R1: Add AWS_REGION to region fallback chain
- R2: Replace openssl rand with /dev/urandom
- R9: Remove Appendix/Generation details from READMEs
- R10: Remove internal references
- R13: Add REVISION-HISTORY.md
---
 tuts/184-ec2-ebs-volume-types/REVISION-HISTORY.md       | 8 ++++++++
 tuts/184-ec2-ebs-volume-types/ec2-ebs-types.sh          | 2 +-
 tuts/185-lambda-dead-letter-queue/REVISION-HISTORY.md   | 8 ++++++++
 tuts/185-lambda-dead-letter-queue/lambda-dead-letter.sh | 4 ++--
 tuts/187-ec2-instance-types/REVISION-HISTORY.md         | 8 ++++++++
 tuts/187-ec2-instance-types/ec2-instance-types.sh       | 2 +-
 tuts/192-lambda-runtimes-and-quotas/REVISION-HISTORY.md | 8 ++++++++
 tuts/192-lambda-runtimes-and-quotas/lambda-container.sh | 2 +-
 tuts/193-ec2-regions-and-zones/REVISION-HISTORY.md      | 8 ++++++++
 tuts/193-ec2-regions-and-zones/ec2-metadata.sh          | 2 +-
 10 files changed, 46 insertions(+), 6 deletions(-)
 create mode 100644 tuts/184-ec2-ebs-volume-types/REVISION-HISTORY.md
 create mode 100644 tuts/185-lambda-dead-letter-queue/REVISION-HISTORY.md
 create mode 100644 tuts/187-ec2-instance-types/REVISION-HISTORY.md
 create mode 100644 tuts/192-lambda-runtimes-and-quotas/REVISION-HISTORY.md
 create mode 100644 tuts/193-ec2-regions-and-zones/REVISION-HISTORY.md

diff --git a/tuts/184-ec2-ebs-volume-types/REVISION-HISTORY.md b/tuts/184-ec2-ebs-volume-types/REVISION-HISTORY.md
new file mode 100644
index 00000000..d818c6ad
--- /dev/null
+++ b/tuts/184-ec2-ebs-volume-types/REVISION-HISTORY.md
@@ -0,0 +1,8 @@
+# Revision History: 184-ec2-ebs-volume-types
+
+## Shell (CLI script)
+
+### 2026-04-14 v1 published
+- Type: functional
+- Initial version
+
diff --git a/tuts/184-ec2-ebs-volume-types/ec2-ebs-types.sh b/tuts/184-ec2-ebs-volume-types/ec2-ebs-types.sh
index f12d748f..69493fb5 100644
--- a/tuts/184-ec2-ebs-volume-types/ec2-ebs-types.sh
+++ b/tuts/184-ec2-ebs-volume-types/ec2-ebs-types.sh
@@ -1,6 +1,6 @@
 #!/bin/bash
 WORK_DIR=$(mktemp -d); exec > >(tee -a "$WORK_DIR/tut.log") 2>&1
-REGION=${AWS_DEFAULT_REGION:-$(aws configure get region 2>/dev/null)}; [ -z "$REGION" ] && echo "ERROR: No region" && exit 1; export AWS_DEFAULT_REGION="$REGION"; echo "Region: $REGION"
+REGION=${AWS_DEFAULT_REGION:-${AWS_REGION:-$(aws configure get region 2>/dev/null))}; [ -z "$REGION" ] && echo "ERROR: No region" && exit 1; export AWS_DEFAULT_REGION="$REGION"; echo "Region: $REGION"
 echo "Step 1: Listing EBS volume types"
 echo "  gp3: General Purpose SSD (default)"
 echo "  gp2: Previous gen General Purpose SSD"
diff --git a/tuts/185-lambda-dead-letter-queue/REVISION-HISTORY.md b/tuts/185-lambda-dead-letter-queue/REVISION-HISTORY.md
new file mode 100644
index 00000000..75078d5d
--- /dev/null
+++ b/tuts/185-lambda-dead-letter-queue/REVISION-HISTORY.md
@@ -0,0 +1,8 @@
+# Revision History: 185-lambda-dead-letter-queue
+
+## Shell (CLI script)
+
+### 2026-04-14 v1 published
+- Type: functional
+- Initial version
+
diff --git a/tuts/185-lambda-dead-letter-queue/lambda-dead-letter.sh b/tuts/185-lambda-dead-letter-queue/lambda-dead-letter.sh
index a76b660e..6328210f 100644
--- a/tuts/185-lambda-dead-letter-queue/lambda-dead-letter.sh
+++ b/tuts/185-lambda-dead-letter-queue/lambda-dead-letter.sh
@@ -1,7 +1,7 @@
 #!/bin/bash
 WORK_DIR=$(mktemp -d); exec > >(tee -a "$WORK_DIR/tut.log") 2>&1
-REGION=${AWS_DEFAULT_REGION:-$(aws configure get region 2>/dev/null)}; [ -z "$REGION" ] && echo "ERROR: No region" && exit 1; export AWS_DEFAULT_REGION="$REGION"; echo "Region: $REGION"
-RANDOM_ID=$(openssl rand -hex 4); F="dlq-func-${RANDOM_ID}"; R="dlq-func-role-${RANDOM_ID}"; Q="dlq-func-q-${RANDOM_ID}"
+REGION=${AWS_DEFAULT_REGION:-${AWS_REGION:-$(aws configure get region 2>/dev/null))}; [ -z "$REGION" ] && echo "ERROR: No region" && exit 1; export AWS_DEFAULT_REGION="$REGION"; echo "Region: $REGION"
+RANDOM_ID=$(cat /dev/urandom | tr -dc 'a-z0-9' | fold -w 8 | head -n 1); F="dlq-func-${RANDOM_ID}"; R="dlq-func-role-${RANDOM_ID}"; Q="dlq-func-q-${RANDOM_ID}"
 handle_error() { echo "ERROR on line $1"; trap - ERR; cleanup; exit 1; }; trap 'handle_error $LINENO' ERR
 cleanup() { echo "Cleaning up..."; aws lambda delete-function --function-name "$F" 2>/dev/null; [ -n "$QU" ] && aws sqs delete-queue --queue-url "$QU" 2>/dev/null; aws iam detach-role-policy --role-name "$R" --policy-arn arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole 2>/dev/null; aws iam detach-role-policy --role-name "$R" --policy-arn arn:aws:iam::aws:policy/AmazonSQSFullAccess 2>/dev/null; aws iam delete-role --role-name "$R" 2>/dev/null; rm -rf "$WORK_DIR"; echo "Done."; }
 RA=$(aws iam create-role --role-name "$R" --assume-role-policy-document '{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Principal":{"Service":"lambda.amazonaws.com"},"Action":"sts:AssumeRole"}]}' --query Role.Arn --output text)
diff --git a/tuts/187-ec2-instance-types/REVISION-HISTORY.md b/tuts/187-ec2-instance-types/REVISION-HISTORY.md
new file mode 100644
index 00000000..d89e52ea
--- /dev/null
+++ b/tuts/187-ec2-instance-types/REVISION-HISTORY.md
@@ -0,0 +1,8 @@
+# Revision History: 187-ec2-instance-types
+
+## Shell (CLI script)
+
+### 2026-04-14 v1 published
+- Type: functional
+- Initial version
+
diff --git a/tuts/187-ec2-instance-types/ec2-instance-types.sh b/tuts/187-ec2-instance-types/ec2-instance-types.sh
index d2200fec..f57e5c2a 100644
--- a/tuts/187-ec2-instance-types/ec2-instance-types.sh
+++ b/tuts/187-ec2-instance-types/ec2-instance-types.sh
@@ -1,6 +1,6 @@
 #!/bin/bash
 WORK_DIR=$(mktemp -d); exec > >(tee -a "$WORK_DIR/tut.log") 2>&1
-REGION=${AWS_DEFAULT_REGION:-$(aws configure get region 2>/dev/null)}; [ -z "$REGION" ] && echo "ERROR: No region" && exit 1; export AWS_DEFAULT_REGION="$REGION"; echo "Region: $REGION"
+REGION=${AWS_DEFAULT_REGION:-${AWS_REGION:-$(aws configure get region 2>/dev/null))}; [ -z "$REGION" ] && echo "ERROR: No region" && exit 1; export AWS_DEFAULT_REGION="$REGION"; echo "Region: $REGION"
 echo "Step 1: Listing instance type families"
 aws ec2 describe-instance-types --filters "Name=instance-type,Values=t3.*" --query 'InstanceTypes[].{Type:InstanceType,vCPUs:VCpuInfo.DefaultVCpus,Memory:MemoryInfo.SizeInMiB}' --output table
 echo "Step 2: Describing a specific type"
diff --git a/tuts/192-lambda-runtimes-and-quotas/REVISION-HISTORY.md b/tuts/192-lambda-runtimes-and-quotas/REVISION-HISTORY.md
new file mode 100644
index 00000000..4a8ab946
--- /dev/null
+++ b/tuts/192-lambda-runtimes-and-quotas/REVISION-HISTORY.md
@@ -0,0 +1,8 @@
+# Revision History: 192-lambda-runtimes-and-quotas
+
+## Shell (CLI script)
+
+### 2026-04-14 v1 published
+- Type: functional
+- Initial version
+
diff --git a/tuts/192-lambda-runtimes-and-quotas/lambda-container.sh b/tuts/192-lambda-runtimes-and-quotas/lambda-container.sh
index f2aa8c58..7335e08b 100644
--- a/tuts/192-lambda-runtimes-and-quotas/lambda-container.sh
+++ b/tuts/192-lambda-runtimes-and-quotas/lambda-container.sh
@@ -1,6 +1,6 @@
 #!/bin/bash
 WORK_DIR=$(mktemp -d); exec > >(tee -a "$WORK_DIR/tut.log") 2>&1
-REGION=${AWS_DEFAULT_REGION:-$(aws configure get region 2>/dev/null)}; [ -z "$REGION" ] && echo "ERROR: No region" && exit 1; export AWS_DEFAULT_REGION="$REGION"; echo "Region: $REGION"
+REGION=${AWS_DEFAULT_REGION:-${AWS_REGION:-$(aws configure get region 2>/dev/null))}; [ -z "$REGION" ] && echo "ERROR: No region" && exit 1; export AWS_DEFAULT_REGION="$REGION"; echo "Region: $REGION"
 echo "Step 1: Listing Lambda runtimes"
 aws lambda list-layers --compatible-runtime python3.12 --query 'Layers[:5].{Name:LayerName,Version:LatestMatchingVersion.Version}' --output table 2>/dev/null || echo "  No compatible layers"
 echo "Step 2: Getting Lambda service quotas"
diff --git a/tuts/193-ec2-regions-and-zones/REVISION-HISTORY.md b/tuts/193-ec2-regions-and-zones/REVISION-HISTORY.md
new file mode 100644
index 00000000..96422242
--- /dev/null
+++ b/tuts/193-ec2-regions-and-zones/REVISION-HISTORY.md
@@ -0,0 +1,8 @@
+# Revision History: 193-ec2-regions-and-zones
+
+## Shell (CLI script)
+
+### 2026-04-14 v1 published
+- Type: functional
+- Initial version
+
diff --git a/tuts/193-ec2-regions-and-zones/ec2-metadata.sh b/tuts/193-ec2-regions-and-zones/ec2-metadata.sh
index 4af9fbba..b67ad461 100644
--- a/tuts/193-ec2-regions-and-zones/ec2-metadata.sh
+++ b/tuts/193-ec2-regions-and-zones/ec2-metadata.sh
@@ -1,6 +1,6 @@
 #!/bin/bash
 WORK_DIR=$(mktemp -d); exec > >(tee -a "$WORK_DIR/tut.log") 2>&1
-REGION=${AWS_DEFAULT_REGION:-$(aws configure get region 2>/dev/null)}; [ -z "$REGION" ] && echo "ERROR: No region" && exit 1; export AWS_DEFAULT_REGION="$REGION"; echo "Region: $REGION"
+REGION=${AWS_DEFAULT_REGION:-${AWS_REGION:-$(aws configure get region 2>/dev/null))}; [ -z "$REGION" ] && echo "ERROR: No region" && exit 1; export AWS_DEFAULT_REGION="$REGION"; echo "Region: $REGION"
 echo "Step 1: Describing your running instances"
 aws ec2 describe-instances --filters "Name=instance-state-name,Values=running" --query 'Reservations[].Instances[:3].{Id:InstanceId,Type:InstanceType,State:State.Name,AZ:Placement.AvailabilityZone}' --output table 2>/dev/null || echo "  No running instances"
 echo "Step 2: Describing instance status"

From 350258d3749c702611307e16c7b025a41452e013 Mon Sep 17 00:00:00 2001
From: Michael Wunderlich <mwunderl@amazon.com>
Date: Tue, 21 Apr 2026 05:38:00 +0000
Subject: [PATCH 3/3] Add README.md and tutorial walkthrough for script-only
 tutorials

---
 tuts/184-ec2-ebs-volume-types/README.md       | 28 +++++++++++++
 .../184-ec2-ebs-volume-types/ec2-ebs-types.md | 19 +++++++++
 tuts/185-lambda-dead-letter-queue/README.md   | 40 +++++++++++++++++++
 .../lambda-dead-letter.md                     | 23 +++++++++++
 tuts/187-ec2-instance-types/README.md         | 28 +++++++++++++
 .../ec2-instance-types.md                     | 19 +++++++++
 tuts/192-lambda-runtimes-and-quotas/README.md | 29 ++++++++++++++
 .../lambda-container.md                       | 23 +++++++++++
 tuts/193-ec2-regions-and-zones/README.md      | 29 ++++++++++++++
 .../193-ec2-regions-and-zones/ec2-metadata.md | 23 +++++++++++
 10 files changed, 261 insertions(+)
 create mode 100644 tuts/184-ec2-ebs-volume-types/README.md
 create mode 100644 tuts/184-ec2-ebs-volume-types/ec2-ebs-types.md
 create mode 100644 tuts/185-lambda-dead-letter-queue/README.md
 create mode 100644 tuts/185-lambda-dead-letter-queue/lambda-dead-letter.md
 create mode 100644 tuts/187-ec2-instance-types/README.md
 create mode 100644 tuts/187-ec2-instance-types/ec2-instance-types.md
 create mode 100644 tuts/192-lambda-runtimes-and-quotas/README.md
 create mode 100644 tuts/192-lambda-runtimes-and-quotas/lambda-container.md
 create mode 100644 tuts/193-ec2-regions-and-zones/README.md
 create mode 100644 tuts/193-ec2-regions-and-zones/ec2-metadata.md

diff --git a/tuts/184-ec2-ebs-volume-types/README.md b/tuts/184-ec2-ebs-volume-types/README.md
new file mode 100644
index 00000000..a5338c7d
--- /dev/null
+++ b/tuts/184-ec2-ebs-volume-types/README.md
@@ -0,0 +1,28 @@
+# Ec2 Ebs Types
+
+A read-only script that queries Ec2 resources and displays information.
+
+## Running
+
+```bash
+bash ec2-ebs-types.sh
+```
+
+## What it does
+
+1. Listing EBS volume types
+2. Listing your volumes by type
+3. Describing volume modifications
+
+## Resources created
+
+None — this script is read-only.
+
+## Cost
+
+No cost. This script only reads existing resources.
+
+## Related docs
+
+- [AWS CLI ec2 reference](https://docs.aws.amazon.com/cli/latest/reference/ec2/index.html)
+
diff --git a/tuts/184-ec2-ebs-volume-types/ec2-ebs-types.md b/tuts/184-ec2-ebs-volume-types/ec2-ebs-types.md
new file mode 100644
index 00000000..b85ebac7
--- /dev/null
+++ b/tuts/184-ec2-ebs-volume-types/ec2-ebs-types.md
@@ -0,0 +1,19 @@
+# Ec2 Ebs Types
+
+## Prerequisites
+
+1. AWS CLI installed and configured (`aws configure`)
+2. Appropriate IAM permissions for the AWS services used
+
+## Step 1: Listing EBS volume types
+
+The script handles this step automatically. See `ec2-ebs-types.sh` for the exact CLI commands.
+
+## Step 2: Listing your volumes by type
+
+The script handles this step automatically. See `ec2-ebs-types.sh` for the exact CLI commands.
+
+## Step 3: Describing volume modifications
+
+The script handles this step automatically. See `ec2-ebs-types.sh` for the exact CLI commands.
+
diff --git a/tuts/185-lambda-dead-letter-queue/README.md b/tuts/185-lambda-dead-letter-queue/README.md
new file mode 100644
index 00000000..783dd63b
--- /dev/null
+++ b/tuts/185-lambda-dead-letter-queue/README.md
@@ -0,0 +1,40 @@
+# Lambda Dead Letter
+
+An AWS CLI tutorial that demonstrates Iam operations.
+
+## Running
+
+```bash
+bash lambda-dead-letter.sh
+```
+
+To auto-run with cleanup:
+
+```bash
+echo 'y' | bash lambda-dead-letter.sh
+```
+
+## What it does
+
+1. Creating function that always fails
+2. Invoking async (will fail and go to DLQ)
+3. Checking DLQ (after retries, ~3 min)
+
+## Resources created
+
+- Function
+- Queue
+- Role
+
+The script prompts you to clean up resources when it finishes.
+
+## Cost
+
+Free tier eligible for most operations. Clean up resources after use to avoid charges.
+
+## Related docs
+
+- [AWS CLI iam reference](https://docs.aws.amazon.com/cli/latest/reference/iam/index.html)
+- [AWS CLI lambda reference](https://docs.aws.amazon.com/cli/latest/reference/lambda/index.html)
+- [AWS CLI sqs reference](https://docs.aws.amazon.com/cli/latest/reference/sqs/index.html)
+
diff --git a/tuts/185-lambda-dead-letter-queue/lambda-dead-letter.md b/tuts/185-lambda-dead-letter-queue/lambda-dead-letter.md
new file mode 100644
index 00000000..14b3dfc5
--- /dev/null
+++ b/tuts/185-lambda-dead-letter-queue/lambda-dead-letter.md
@@ -0,0 +1,23 @@
+# Lambda Dead Letter
+
+## Prerequisites
+
+1. AWS CLI installed and configured (`aws configure`)
+2. Appropriate IAM permissions for the AWS services used
+
+## Step 1: Creating function that always fails
+
+The script handles this step automatically. See `lambda-dead-letter.sh` for the exact CLI commands.
+
+## Step 2: Invoking async (will fail and go to DLQ)
+
+The script handles this step automatically. See `lambda-dead-letter.sh` for the exact CLI commands.
+
+## Step 3: Checking DLQ (after retries, ~3 min)
+
+The script handles this step automatically. See `lambda-dead-letter.sh` for the exact CLI commands.
+
+## Cleanup
+
+The script prompts you to clean up all created resources. If you need to clean up manually, check the script log for the resource names that were created.
+
diff --git a/tuts/187-ec2-instance-types/README.md b/tuts/187-ec2-instance-types/README.md
new file mode 100644
index 00000000..77a30fb7
--- /dev/null
+++ b/tuts/187-ec2-instance-types/README.md
@@ -0,0 +1,28 @@
+# Ec2 Instance Types
+
+A read-only script that queries Ec2 resources and displays information.
+
+## Running
+
+```bash
+bash ec2-instance-types.sh
+```
+
+## What it does
+
+1. Listing instance type families
+2. Describing a specific type
+3. Finding instances by criteria
+
+## Resources created
+
+None — this script is read-only.
+
+## Cost
+
+No cost. This script only reads existing resources.
+
+## Related docs
+
+- [AWS CLI ec2 reference](https://docs.aws.amazon.com/cli/latest/reference/ec2/index.html)
+
diff --git a/tuts/187-ec2-instance-types/ec2-instance-types.md b/tuts/187-ec2-instance-types/ec2-instance-types.md
new file mode 100644
index 00000000..f0f474d5
--- /dev/null
+++ b/tuts/187-ec2-instance-types/ec2-instance-types.md
@@ -0,0 +1,19 @@
+# Ec2 Instance Types
+
+## Prerequisites
+
+1. AWS CLI installed and configured (`aws configure`)
+2. Appropriate IAM permissions for the AWS services used
+
+## Step 1: Listing instance type families
+
+The script handles this step automatically. See `ec2-instance-types.sh` for the exact CLI commands.
+
+## Step 2: Describing a specific type
+
+The script handles this step automatically. See `ec2-instance-types.sh` for the exact CLI commands.
+
+## Step 3: Finding instances by criteria
+
+The script handles this step automatically. See `ec2-instance-types.sh` for the exact CLI commands.
+
diff --git a/tuts/192-lambda-runtimes-and-quotas/README.md b/tuts/192-lambda-runtimes-and-quotas/README.md
new file mode 100644
index 00000000..371208a7
--- /dev/null
+++ b/tuts/192-lambda-runtimes-and-quotas/README.md
@@ -0,0 +1,29 @@
+# Lambda Container
+
+A read-only script that queries Lambda resources and displays information.
+
+## Running
+
+```bash
+bash lambda-container.sh
+```
+
+## What it does
+
+1. Listing Lambda runtimes
+2. Getting Lambda service quotas
+3. Listing functions by runtime
+4. Listing event source mappings
+
+## Resources created
+
+None — this script is read-only.
+
+## Cost
+
+No cost. This script only reads existing resources.
+
+## Related docs
+
+- [AWS CLI lambda reference](https://docs.aws.amazon.com/cli/latest/reference/lambda/index.html)
+
diff --git a/tuts/192-lambda-runtimes-and-quotas/lambda-container.md b/tuts/192-lambda-runtimes-and-quotas/lambda-container.md
new file mode 100644
index 00000000..1e60d535
--- /dev/null
+++ b/tuts/192-lambda-runtimes-and-quotas/lambda-container.md
@@ -0,0 +1,23 @@
+# Lambda Container
+
+## Prerequisites
+
+1. AWS CLI installed and configured (`aws configure`)
+2. Appropriate IAM permissions for the AWS services used
+
+## Step 1: Listing Lambda runtimes
+
+The script handles this step automatically. See `lambda-container.sh` for the exact CLI commands.
+
+## Step 2: Getting Lambda service quotas
+
+The script handles this step automatically. See `lambda-container.sh` for the exact CLI commands.
+
+## Step 3: Listing functions by runtime
+
+The script handles this step automatically. See `lambda-container.sh` for the exact CLI commands.
+
+## Step 4: Listing event source mappings
+
+The script handles this step automatically. See `lambda-container.sh` for the exact CLI commands.
+
diff --git a/tuts/193-ec2-regions-and-zones/README.md b/tuts/193-ec2-regions-and-zones/README.md
new file mode 100644
index 00000000..b35f15e7
--- /dev/null
+++ b/tuts/193-ec2-regions-and-zones/README.md
@@ -0,0 +1,29 @@
+# Ec2 Metadata
+
+A read-only script that queries Ec2 resources and displays information.
+
+## Running
+
+```bash
+bash ec2-metadata.sh
+```
+
+## What it does
+
+1. Describing your running instances
+2. Describing instance status
+3. Listing regions
+4. Listing availability zones
+
+## Resources created
+
+None — this script is read-only.
+
+## Cost
+
+No cost. This script only reads existing resources.
+
+## Related docs
+
+- [AWS CLI ec2 reference](https://docs.aws.amazon.com/cli/latest/reference/ec2/index.html)
+
diff --git a/tuts/193-ec2-regions-and-zones/ec2-metadata.md b/tuts/193-ec2-regions-and-zones/ec2-metadata.md
new file mode 100644
index 00000000..b8fe7fc9
--- /dev/null
+++ b/tuts/193-ec2-regions-and-zones/ec2-metadata.md
@@ -0,0 +1,23 @@
+# Ec2 Metadata
+
+## Prerequisites
+
+1. AWS CLI installed and configured (`aws configure`)
+2. Appropriate IAM permissions for the AWS services used
+
+## Step 1: Describing your running instances
+
+The script handles this step automatically. See `ec2-metadata.sh` for the exact CLI commands.
+
+## Step 2: Describing instance status
+
+The script handles this step automatically. See `ec2-metadata.sh` for the exact CLI commands.
+
+## Step 3: Listing regions
+
+The script handles this step automatically. See `ec2-metadata.sh` for the exact CLI commands.
+
+## Step 4: Listing availability zones
+
+The script handles this step automatically. See `ec2-metadata.sh` for the exact CLI commands.
+