Multi-Cloud Strategy

Fetch multi-cloud exploration results

Retrieve the final results from a multi-cloud exploration job.

Only returns data once the job has finished. This endpoint returns results exclusively when the job status is completed. While the job is still pending or running it returns 400 INVALID_REQUEST; a failed job returns 500.

Polling pattern:

  • Poll GET /multi-cloud/jobs/{jobId} (or subscribe to /stream) until status is completed, then call this endpoint once for the final ranked strategies and comparison report.
  • To read strategies as they accumulate while the job is still running, use GET /multi-cloud/jobs/{jobId}/partial-results instead — that endpoint returns isComplete: false until the job reaches a terminal state.
  • For real-time streaming of progress, use the /stream endpoint.

Response field names: The successful 200 response contains topStrategies (the highest-scoring strategies, sorted by metrics.compositeScore descending) and allStrategies (every strategy evaluated, also sorted). Do not use the field names variants, strategies, or ranked — those do not exist in the response.

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

Request

  • Base URL: https://www.cloudworldmodel.ai/api
  • URL: https://www.cloudworldmodel.ai/api/multi-cloud/jobs/{jobId}/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

Job results (partial or complete based on job status)

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

Job progress percentage (0-100)

isCompleteboolean

True if job is finished, false if still running or pending

strategiesGeneratednumber

Number of strategies generated so far

comparisonReportstring

Markdown comparison report (only available when complete)

providerTrustLevelsobject

Per-provider rate trust level — the worst rateProvenance.basis across the pricing constants behind that provider's cost figures. "on-demand" means every contributing rate is a verified published list price; "estimated" means at least one contributing rate is a flat estimate, so treat that provider's ranking as approximate.

completedAtstring date-time
estimateDisclaimerstring

Reminder that cost and latency figures are baseline planning estimates; validate with materialize + step under production load.

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"
        }
      ]
    }
  ],
  "topStrategies": [
    {
      "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"
        }
      ]
    }
  ],
  "providerTrustLevels": {
    "aws": "on-demand",
    "gcp": "on-demand"
  },
  "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.