Multi-Cloud Strategy

Fetch partial multi-cloud results from a running job

Retrieve strategies accumulated so far for a multi-cloud exploration job, even while the job is still running.

This endpoint is the dedicated channel for polling partial results during job execution. The /results endpoint requires the job to be completed; use this endpoint instead when you want to start analyzing strategies before the full exploration finishes.

Polling pattern:

while true:
  data = GET /api/multi-cloud/jobs/{jobId}/partial-results
  show data.allStrategies to user
  if data.isComplete: break
  sleep(2s)
# Fetch ranked results and comparison report from /results once complete
full = GET /api/multi-cloud/jobs/{jobId}/results

isComplete flag:

  • false — job is still pending or running; more strategies may arrive
  • true — job has reached a terminal state (completed, failed, or cancelled)

When isComplete is true and status is completed, fetch the ranked topStrategies and comparisonReport from GET /api/multi-cloud/jobs/{jobId}/results.

get/multi-cloud/jobs/{jobId}/partial-results

Request

  • Base URL: https://www.cloudworldmodel.ai/api
  • URL: https://www.cloudworldmodel.ai/api/multi-cloud/jobs/{jobId}/partial-results
  • Auth: one of:
    • HTTP bearer
    • API key in header X-PAYMENT
    • API key in header PAYMENT-SIGNATURE

Path parameters

jobIdstring uuid required

ID of the multi-cloud job

Query parameters

providersstring
Example:digitalocean,aws

Comma-separated list of cloud provider names to filter results by preferred primary provider. A strategy is included if any of the specified providers holds ≥ 50 % of the traffic allocation. Supported values: aws, gcp, azure, digitalocean, oci. If omitted, all strategies are returned.

Response

Partial or terminal results for the job

jobIdstring required
status'pending' | 'running' | 'completed' | 'failed' | 'cancelled' required
progressnumber required

Job progress percentage (0-100)

isCompleteboolean required

True if job has reached a terminal state, false if still pending or running

strategiesGeneratednumber required

Number of strategies generated so far

providerTrustLevelsobject

Per-provider rate trust level — the worst rateProvenance.basis across the pricing constants behind that provider's cost figures, derived from strategies accumulated so far. "on-demand" means every contributing rate is a verified published list price; "estimated" means at least one contributing rate is a flat or usage-based floor approximation (e.g. Aurora Serverless v2/DSQL, GPU inference families). Present for every job status; updates as strategies accumulate. Empty object while no strategies exist yet.

errorstring

Error message — only present when status is failed

Example response

{
  "allStrategies": [
    {
      "id": "strategy-1",
      "name": "AWS-Primary Multi-Region",
      "description": "AWS-heavy deployment with GCP for data redundancy and reduced vendor lock-in",
      "allocations": [
        {
          "provider": "aws",
          "computeInstances": 6,
          "databaseInstances": 1,
          "storageGB": 300,
          "trafficPercentage": 60,
          "regions": [
            "us-east-1",
            "us-west-2"
          ],
          "skuClass": "bare-metal-compute",
          "computeSkuClass": "bare-metal-compute",
          "databaseSkuClass": "serverless-db"
        }
      ],
      "metrics": {
        "totalCostPerHour": 12.5,
        "avgLatencyMs": 45.2,
        "p95LatencyMs": 67.8,
        "vendorLockInScore": 72,
        "dataPortabilityScore": 75,
        "geographicCoverage": 85,
        "compositeScore": 8.5,
        "migrationEgressCost": 18,
        "egressCostPerHour": 0.162,
        "latencyHeadroomPct": 13.75
      },
      "tradeoffs": [
        "Higher cost for improved redundancy",
        "Lower vendor lock-in at expense of complexity"
      ],
      "recommendations": [
        "Best for workloads requiring high availability",
        "Consider multi-region replication for databases"
      ],
      "suggestedResources": [
        {
          "provider": "aws",
          "resourceType": "compute",
          "size": "t3.medium",
          "count": 4,
          "hourlyRate": 0.096
        },
        {
          "provider": "aws",
          "resourceType": "database",
          "size": "db.t3.medium",
          "count": 1,
          "hourlyRate": 0.27
        }
      ],
      "securityRecommendations": [
        "aws-waf"
      ],
      "crossClassNote": "This strategy mixes non-equivalent compute product tiers (bare-metal-compute, general-compute). Cost and latency estimates may not be directly comparable across allocations; validate each provider's tier independently before committing.\n",
      "costBreakdown": [
        {
          "provider": "aws",
          "computeCostPerHour": 0.384,
          "databaseCostPerHour": 0.54,
          "storageCostPerHour": 0.0115,
          "egressCostPerHour": 0.0162,
          "totalCostPerHour": 0.9517,
          "computeInstances": 4,
          "databaseInstances": 2,
          "storageGB": 500,
          "computeUnitRate": 0.096,
          "databaseUnitRate": 0.27,
          "storageUnitRate": 0.023,
          "egressFreeTierExhaustedAtRPS": 19,
          "databaseServiceFamily": "aurora-serverless"
        }
      ]
    }
  ],
  "methodology": {
    "dataSource": "simulation-model",
    "validationBasis": "simulation_only",
    "externallyValidated": false,
    "seedCount": 1,
    "note": "Results describe Cloud World Model simulation outcomes and should not be interpreted as measured cloud-provider benchmarks. Consistency across multiple independent runs confirms model stability, not external performance validation."
  },
  "interpretationScope": {
    "providerPerformanceScope": "simulation-only",
    "externalValidation": false,
    "crossSeedConsistencyMeans": "simulation-model-consistency",
    "untestedLoadExtrapolationAllowed": false,
    "prohibitedClaimCategories": [
      "provider-performance-superiority",
      "real-world-benchmark-equivalence",
      "untested-load-extrapolation",
      "cross-seed-as-external-validation"
    ],
    "permittedUses": [
      "compare simulation-model cost and latency trade-offs under the tested scenarios",
      "identify which provider the model favours given the configured resource shapes and traffic levels",
      "use rankings as a structured starting point for further empirical benchmarking"
    ],
    "testedLoadLevels": [
      "200 RPS (baseline)"
    ],
    "untestedScenariosNote": "Load levels or failure modes not present in testedLoadLevels are hypotheses requiring a new simulation run, not conclusions derivable from this result."
  }
}

Changes

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