Skip to main content
← back to extensions

Aws/inventory

@webframp/aws/inventoryv2026.05.29.1· 1d agoMODELS
01README

Discover running AWS resources for cost estimation and inventory management.

Authentication

Uses the default AWS credential chain. Requires appropriate IAM permissions for each service being inventoried.

Required IAM Permissions

  • ec2:DescribeInstances
  • rds:DescribeDBInstances
  • dynamodb:ListTables, dynamodb:DescribeTable
  • lambda:ListFunctions
  • s3:ListBuckets

Usage

# Create inventory model
swamp model create @webframp/aws/inventory aws-inventory \
  --global region=us-east-1

# List running EC2 instances
swamp model method run aws-inventory list_ec2

# List RDS databases
swamp model method run aws-inventory list_rds

# Full inventory across all resource types
swamp model method run aws-inventory inventory_all

Supported Resources

  • EC2 - Instances with state, type, tags
  • RDS - Database instances with engine, storage, Multi-AZ
  • DynamoDB - Tables with billing mode, capacity, size
  • Lambda - Functions with runtime, memory, timeout
  • S3 - Buckets (global listing)
02Models1
@webframp/aws/inventoryv2026.05.29.1aws/inventory.ts
fn list_ec2()
List running EC2 instances
fn list_rds()
List RDS database instances
fn list_dynamodb()
List DynamoDB tables with capacity details
fn list_lambda()
List Lambda functions
fn list_s3()
List S3 buckets (global, ignores region)
fn list_ebs()
List EBS volumes with attachment status
fn inventory_all()
Run full inventory across all supported resource types
fn inventory_scan(source: enum)
Discover all resources across all types using Resource Explorer, Config, or Tag API (cascading fallback)
ArgumentTypeDescription
sourceenumData source to use. 'auto' tries Resource Explorer → Config → Tag API
fn inventory_diff()
Compare current inventory scan against previous scan to detect new and removed resources. Suppresses output when the source changes between runs to prevent false positives from coverage differences.

Resources

inventory(1h)— Inventory of AWS resources
scan(24h)— Cross-type inventory scan from Resource Explorer, Config, or Tag API
scanDiff(24h)— Diff between two inventory scans showing new and removed resources
03Previous Versions7
2026.05.20.1May 20, 2026
2026.05.13.1May 13, 2026
2026.04.22.1Apr 22, 2026

updated platforms

2026.04.14.1Apr 14, 2026

Modified 1 models

2026.04.13.1Apr 13, 2026
2026.03.31.1Mar 31, 2026
2026.03.30.1Mar 30, 2026
04Stats
A
100 / 100
Downloads
55
Archive size
861.6 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types1/1earned
  • Dependencies pass trust audit2/2earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License declared1/1earned
  • Verified public repository2/2earned
Repository
https://github.com/webframp/swamp-extensions
05Platforms
06Labels
#aws#inventory#cost#finops#cloud#infrastructure