Simulations

Validate simulation cost accuracy against provider benchmarks

Compares the simulation's cost estimates against known real-world provider pricing benchmarks. Returns a validation result indicating whether the simulated cost per hour is within the acceptable tolerance (±10%).

Useful for confirming the simulation is faithfully modelling provider pricing before using it for cost-optimisation decisions.

Skip semantics: Resources without a serviceFamily characteristic, or whose provider/serviceFamily/size combination has no pricing benchmark entry, are silently skipped. When all resources are skipped, validations is empty, summary.total is 0, and checked is false. In that state valid: true means "no failures among the zero resources checked" — it does not mean the simulation's cost accuracy was verified. Always check checked: true before acting on valid.

Requires read scope and ownership.

get/simulations/{simulationId}/validate-cost-accuracy

Request

  • Base URL: https://www.cloudworldmodel.ai/api
  • URL: https://www.cloudworldmodel.ai/api/simulations/{simulationId}/validate-cost-accuracy
  • Auth: none required

Path parameters

simulationIdstring required

Simulation UUID

Response

Cost accuracy validation result

validboolean

Whether all checked resources are within the ±10% cost tolerance. Only meaningful when checked is true.

checkedboolean

true when at least one resource had a matching pricing benchmark and was evaluated. false means no comparable data was found — the simulation resources may lack serviceFamily or have no pricing benchmark entry. When checked is false, valid: true does not mean accuracy was verified.

Example response

{
  "valid": true,
  "checked": true,
  "validations": [
    {
      "resource": "web-server",
      "provider": "aws",
      "serviceFamily": "compute",
      "size": "m5.large",
      "simulatedCost": 0.095,
      "benchmarkCost": 0.096,
      "deviation": 1.04,
      "withinThreshold": true,
      "source": "AWS EC2 On-Demand pricing (us-east-1)"
    }
  ],
  "summary": {
    "total": 3,
    "passed": 3,
    "avgDeviation": 0.82,
    "skippedCount": 1,
    "skippedReasons": [
      "\"cache-layer\": no serviceFamily set"
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.