BATCH INSPECTION: run up to 32 AWS inspect probes in one call.
⚠️ **PREREQUISITE**: Same as awsinspect — deploy attempt required.
Check convostatus for hasDeployAttempt=true before calling.
Use this when you need to check more than ~3 resources. The backend fetches
Oracle credentials ONCE per batch and fans out probes against a single AWS
config — for a 12-resource health check this is ~5–8× faster and 12× fewer
Oracle round-trips than calling awsinspect 12 times.
BUDGETS:
- Up to 32 sub-probes per call (subs array length).
- 30s per-sub timeout; 60s total batch wall-clock.
- Concurrency cap 8 — sub-probes run in parallel but never saturate AWS.
- 512 KB response cap: subs past the cap keep their envelope
(index/service/action/ok) but have result replaced with truncated=true.
PARTIAL FAILURE IS EXPECTED. The response is an ordered results array;
each entry has {index, service, action, ok, result, error}. Inspect each
result — do NOT abort on the first error. A credential fetch failure
leaves cred-less probes (list-actions, list-metrics) succeeding anyway.
REQUIRES: session_id from convoopen response (format: sess_v2_...).
Supported services: account, alb, apigateway, backup, bedrock, cloudfront, cloudwatchlogs, cognito, cost-explorer, dynamodb, ebs, ec2, ecs, eks, elasticache, kms, lambda, msk, opensearch, rds, s3, secretsmanager, sqs, vpc, waf
For a specific service's actions, use awsinspect (singular) with
action="list-actions" — batch is not the place for discovery.
Batch responses are always summarized (no detail/raw per-sub); use
singular awsinspect when you need full metadata or raw API output for one
resource.
EXAMPLES:
- awsinspect_batch(session_id=..., subs=[
{"service":"ec2","action":"describe-instances"},
{"service":"rds","action":"describe-db-instances"},
{"service":"vpc","action":"describe-vpcs"},
{"service":"s3","action":"list-buckets"}])
- awsinspect_batch(session_id=..., subs=[
{"service":"ec2","action":"get-metrics","filters":"{\"hours\":6}"},
{"service":"rds","action":"get-metrics","filters":"{\"hours\":6}"}])