Create from scenarioId (scenario.list → scenario.get), or resources/connections for a custom graph. Returns id for simulation.step. Never blindly retry a timeout: creation may have succeeded. No API key required; demo limits apply. Read resource cwm://guides/public/simulation.create GCP gcpFitPrediction: holdout-validated for one us-central1 topology at 300–500 RPS; see guide.
View input schema
{
"type": "object",
"properties": {
"costAssumptions": {
"type": "object",
"additionalProperties": true
},
"name": {
"type": "string",
"maxLength": 120
},
"appWeight": {
"type": "string",
"enum": [
"lean",
"typical",
"heavy"
]
},
"description": {
"type": "string",
"maxLength": 500
},
"scenarioId": {
"type": "string",
"minLength": 1,
"description": "Scenario ID from scenario.list."
},
"scenarioOverrides": {},
"resources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"compute",
"database",
"storage",
"network",
"cache",
"queue",
"kubernetes"
]
},
"name": {
"type": "string"
},
"characteristics": {
"type": "object",
"properties": {
"databaseConnectionModel": {
"type": "string",
"const": "held-pools",
"description": "Physical database opt-in: held-pools uses current running host replicas for named/legacy pools; static binding preserves independent consumers. Explicit managedPoolId deduplicates backend pools; dedicated proxy server slots never multiply by tasks. Inspect runtimeConnections, pools and connectionLimitProvenance."
},
"maxConnections": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 1000000,
"description": "Fixed concurrent DB connection budget; Aurora Serverless defaults from maximum configured ACU."
},
"appDbPoolSize": {
"type": "integer",
"exclusiveMinimum": 0,
"description": "Owned typical: pool size 250 on each app."
},
"databaseConsumers": {
"type": "array",
"description": "Named logical pools, not billed resources. On the target database select held-pools to assume full pools retained by current running host replicas. Static binding preserves independent replicas. Explicit managedPoolId/mode shares backend slots once; proxy is dedicated. Full constraints and transaction client/server limits: linked tool guide. Results: metrics.databases[].runtimeConnections, pools, firstSaturation and connectionLimitProvenance; ASSUMED/MODELED, not measured sessions.",
"items": {
"type": "object",
"additionalProperties": true,
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9_.:/#-]{0,511}$"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 128
},
"databaseId": {
"$ref": "#/properties/resources/items/properties/characteristics/properties/databaseConsumers/items/properties/id"
},
"poolSize": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 1000000
},
"replicas": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 1000,
"default": 1
},
"replicaBinding": {
"type": "string",
"enum": [
"host-runtime",
"static"
]
},
"managedPoolId": {
"$ref": "#/properties/resources/items/properties/characteristics/properties/databaseConsumers/items/properties/id"
}
}
}
},
"gpuReadiness": {
"type": "object",
"description": "EKS assumptions, not measured performance. initialReadyNodes required; warmSpareNodes adds ready reserve. autoscalerReaction/nodeProvision/imagePull/modelLoad: {seconds,provenance}. capacity: {unit:'requests-per-second'|'concurrent-calls',perNode,provenance}; concurrent-calls needs meanCallDurationSeconds. servedRequestP99Ms: {value,provenance}. provenance: user-supplied|estimated. Missing phases/capacity stay not_evaluated; omit for legacy behavior. Full constraints: linked guide."
},
"nodePools": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"description": "EKS GPU pools: id/name, size, nodeCount/minNodes/maxNodes; each has gpuReadiness as above."
}
},
"additionalProperties": true
}
},
"required": [
"id",
"type",
"name"
],
"additionalProperties": true
}
},
"connections": {
"type": "array",
"items": {
"type": "object",
"properties": {
"sourceId": {
"type": "string"
},
"targetId": {
"type": "string"
}
},
"required": [
"sourceId",
"targetId"
],
"additionalProperties": true
}
},
"traffic": {
"type": "number"
},
"seed": {
"type": "integer",
"minimum": 0
},
"autoscalingConfig": {
"type": "object",
"properties": {
"scaleOutCpuThreshold": {
"type": "number",
"minimum": 0
},
"scaleInCpuThreshold": {
"type": "number",
"minimum": 0
},
"scaleOutThroughputThreshold": {
"type": "number",
"minimum": 0
},
"scaleInThroughputThreshold": {
"type": "number",
"minimum": 0
},
"scaleOutLatencyThreshold": {
"type": "number",
"minimum": 0
},
"cooldownSeconds": {
"type": "number",
"minimum": 0
},
"ecsCpuTargetTracking": {
"type": "boolean"
},
"scaleOutCooldownSeconds": {
"type": "integer",
"minimum": 0,
"maximum": 86400
},
"scaleInCooldownSeconds": {
"type": "integer",
"minimum": 0,
"maximum": 86400
},
"simulationSecondsPerStep": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 60
},
"minInstances": {
"type": "integer",
"minimum": 0
},
"maxInstances": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"required": [
"scaleOutCpuThreshold",
"scaleInCpuThreshold",
"scaleOutThroughputThreshold",
"scaleInThroughputThreshold",
"scaleOutLatencyThreshold",
"cooldownSeconds",
"minInstances",
"maxInstances"
],
"additionalProperties": false,
"description": "Complete autoscaling policy, including min/max bounds, thresholds and cooldowns. Preserved without duplicate top-level bounds; explicit top-level bounds and CPU targets take precedence. Unknown fields are rejected. Pass scenario.get's config when copying its graph."
},
"maxInstances": {
"type": "integer",
"minimum": 1
},
"minInstances": {
"type": "integer",
"minimum": 1
},
"autoscalingTargetCpu": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"scaleOutCpuThreshold": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"scaleOutCpuPercent": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"autoscaleTargetCpuPercent": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"ecsCpuTargetTracking": {
"type": "boolean",
"description": "Opt into CPU-only ECS Fargate target tracking; requires an AWS Fargate compute resource. Required for scaleOutCooldownSeconds, scaleInCooldownSeconds and top-level simulationSecondsPerStep; other providers keep their existing policy."
},
"scaleOutCooldownSeconds": {
"type": "integer",
"minimum": 0,
"maximum": 86400,
"description": "ECS scale-out cooldown in simulated seconds; requires ecsCpuTargetTracking: true with an AWS Fargate compute resource. Defaults to cooldownSeconds."
},
"scaleInCooldownSeconds": {
"type": "integer",
"minimum": 0,
"maximum": 86400,
"description": "ECS scale-in cooldown in simulated seconds; requires ecsCpuTargetTracking: true with an AWS Fargate compute resource. Defaults to cooldownSeconds."
},
"simulationSecondsPerStep": {
"type": "number",
"maximum": 60,
"description": "Requires ecsCpuTargetTracking: true with an AWS Fargate compute resource. Converts ECS cooldown seconds into step counts only (default 1); not a global simulation clock."
},
"resilienceConfig": {
"type": "object",
"additionalProperties": true
},
"responseMode": {
"type": "string",
"default": "compact",
"enum": [
"compact",
"full"
]
}
},
"additionalProperties": false
}