---
title: "Return recommended engine size based on the raw size of the expected raw dataset size and given engine size limits. (-- api-linter: core::0136::http-uri-suffix=disabled aip.dev/not-precedent: The linter is bugged. It requires incorrect suffix (\"H2o\" instead of \"H2O\") --)"
method: POST
path: "/v1/h2oEngines:calculateH2OEngineSizeRawDataset"
tags: ["H2OEngineService"]
---

# Return recommended engine size based on the raw size of the expected raw dataset size and given engine size limits. (-- api-linter: core::0136::http-uri-suffix=disabled aip.dev/not-precedent: The linter is bugged. It requires incorrect suffix ("H2o" instead of "H2O") --)

`POST /v1/h2oEngines:calculateH2OEngineSizeRawDataset`

## Request

- Base URL: `https://docs.h2o.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.h2o.ai/v1/h2oEngines:calculateH2OEngineSizeRawDataset`
- Auth: none declared
- TypeScript: <https://skmtc.dev/h2o/apis/ai-h2o-engine-sandbox-v1-filesystem-proto/docs/v1/h2oEngines:calculateH2OEngineSizeRawDataset/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- V1CalculateH2OEngineSizeRawDatasetRequest: Request message.
  - `datasetSizeBytes` string, int64, required: Estimated size of the dataset in bytes.
  - `limits` V1H2OEngineSizeLimits: Limits required for H2OEngine size calculation.
    - `memoryBytesPerNodeMin` string, int64, required: Memory bytes per node min constraint.
    - `memoryBytesPerNodeMax` string, int64, nullable: Memory bytes per node max constraint.
    - `nodeCountMin` string, int64, required: Node count min constraint.
    - `nodeCountMax` string, int64, nullable: Node count max constraint.

## Response `200`

A successful response.

- V1CalculateH2OEngineSizeRawDatasetResponse: Response message.
  - `h2oEngineSize` V1H2OEngineSize: Message representing recommended H2OEngine size.
    - `nodeCount` string, int64: The number of nodes recommended for the engine.
    - `memoryBytes` string, int64: The amount of memory in bytes per node recommended for the engine.

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/h2o/apis/ai-h2o-engine-sandbox-v1-filesystem-proto.md) - [All operations](https://skmtc.dev/h2o/apis/ai-h2o-engine-sandbox-v1-filesystem-proto/llms.txt) - [OpenAPI document](https://skmtc.dev/h2o/apis/ai-h2o-engine-sandbox-v1-filesystem-proto/revisions/297cfadc1d39?raw)